CSCI 200 - Foundational Programming Concepts & Design - Fall 2022

Final Project

This assignment is due by Thursday, December 08, 2022, 11:59 PM.
NO LATE SUBMISSIONS WILL BE ACCEPTED

· Instructions · Rubric ·Submission ·

Each week this semester, you have been doing labs and homework assignments that emphasize specific aspects of the C++ programming language. For the last few weeks of the course, you will make use of these language skills in the context of a larger, more realistic project. The goals of this project are:

The final project is open-ended. You may choose to write a program that plays a game, reads large data files and does a complex calculation with the data, or anything in between. Some detailed requirements are given below, so please read this document carefully.


Requirements - Project Proposal
(due Tuesday, October 25, 2022 11:59 PM)


On Tuesday, October 25, 2022 11:59 PM, a short description of your project is due. You need to submit your description (as a PDF) to Canvas. This document needs to include the following sections WITH the section titles listed below.

The document you submit will specifically answer the following questions:

  1. What class will you create? What data attributes and member functions will it have?
  2. How will you use a data structure (array, linked-list, stack, queue) within your project?
  3. How will a data file be used?

You will not need to, and should not, do any coding to write this Project Proposal. The purpose of this Project Proposal is to get you to think about the initial design of your final project. (Note: we understand that the initial design you submit on Tuesday, October 25, 2022 11:59 PM is likely to change as you complete your project for the Thursday, December 08, 2022, 11:59 PM due date.)

NOTE: You have a bit of time to decide upon your topic and a big picture of your design, but then only over about three weeks for implementation. Because of the tight time period for implementation, we strongly encourage you to have most of your design plans done earlier than Tuesday, October 25, 2022 11:59 PM (to give you extra time for implementation). Many previous students have said "gosh, wish I had gotten started on the final project earlier."

Your instructor will give you feedback on your Project Proposal after you submit it (e.g., too complex or too simple).


Requirements - Project Code
(due Thursday, December 08, 2022, 11:59 PM)


Your program must use at least one original class, written specifically for this project. You are free to use other classes we have developed during the semester, such as the LinkedList class, or classes described in zyBooks, but you must also write and use one original class.

Your program must use at least one list. This list needs to be either a list within your class OR a list of objects of your class type.

Your program must make use of File I/O. Data may either be read from or written to a file, or both. Please place your data file in the same directory relative to your main.cpp file.

Your program must use functions where appropriate.

Your program must use constants where appropriate.

Your project must make use of ample commenting. There should be enough documentation to allow another programmer to easily make modifications or enhancements.

Your program must adhere to our CSCI 200 style guidelines.

Your program must adhere to our CSCI 200 best practice guidelines.


Requirements - Project Paper
(due Thursday, December 08, 2022, 11:59 PM)


Create a text file called final.txt which contains the following sections WITH the section titles listed below. This file is submitted with your code (see Submission instructions below).


Resources


While you may search on the Internet for hints as to how certain things are done in the C++ language, you cannot directly copy and paste code found from resources outside our course.

That said, any resources we have used in this class from previous labs and homework assignments are fair game for use in your project.


Incremental Development


Now that you are designing and writing a large project from scratch, the "Incremental Build" model of software development is more important than ever before. This is a software development methodology where the model is designed, implemented, and tested incrementally, adding a little more functionality each time, until the product is finished. In other words, write a small amount of code to do one specific task, then run the program to be sure what you have done so far works. Only when you are satisfied with what you have so far do you move on to the next part of the program.

In short, implement and test small parts of your program as you work!


Project Possibilities


There are numerous different project ideas possible. Here are a few examples:

Breakout

In the classic arcade game Breakout a layer of bricks lines the top third of the screen. A ball travels across the screen, bouncing off the top and side walls of the screen. When a brick is hit, the ball bounces away and the brick is destroyed. The player loses a turn when the ball touches the bottom of the screen. To prevent this from happening, the player has a movable paddle to bounce the ball upward, keeping it in play.

In this game, you might want to develop the following three classes: Paddle , Brick and Ball .

Frogger

Another classic arcade game, Frogger is a game in which the object is to direct frogs to their homes one by one. To do this, each frog must avoid cars while crossing a busy road and navigating a river full of hazards.

Classes such as Frog , Car , Truck , Log , Turtle , Crocodile , and others could be used in implementing this game.

Othello

There are several games with two-dimensional arrays as playing areas. Possibilities include Connect Four, Reversi (aka, Othello) and Battleship.

Non-Games

Finally, there is no requirement that your final project be a game. For example, if you are passionate about bike riding, you might create a program that calculates the optimum front and rear gears that should be selected on a bicycle, given a degree of incline and current velocity. Users select the type of bicycle, specify their speed, pain threshold, and degree of incline. The program then informs the user of the front and rear gears that should be selected.

Or maybe there is something you could write that would be useful for your major or other classes. Anything that meets the requirements of the project (see above) is fair game.

Other Ideas

If you have other ideas but need a bit of help with the design, please feel free to talk to your instructor or a tutor.


Best Practices To Follow



Grading Rubric


Your submission will be graded according to the following rubric.

PointsRequirement Description
25 Project behaves as expected.
20 Project makes appropriate use of a class.
15 Project makes appropriate use of a list (array/vector/linked list/stack/queue).
10 Project makes appropriate use of File I/O.
5 Project makes appropriate use of functions.
5 Project makes appropriate use of constants and data types.
5 Project description meets requirements (due Tuesday, October 25, 2022 11:59 PM).
5 final.txt meets requirements.
10 Best practices are followed:
  • +10 Code is easily readable, follows best practices, well structured
  • +8 Code is easy to follow, only a few small violations of best practices
  • +6 No egregiously bad practices
  • +4 Lots of violations of best practices
  • +2 Little effort to follow best practices
  • +0 No effort to follow best practices
100 Total Points

This assignment is due by Thursday, December 08, 2022, 11:59 PM.
NO LATE SUBMISSIONS WILL BE ACCEPTED


Submission


Always, always, ALWAYS update the header comments at the top of your main.cpp file. And if you ever get stuck, remember that there is LOTS of help available.

It is critical that you follow these steps when submitting homework.

If you do not follow these instructions, your assignment will receive a major deduction. Why all the fuss? Because we have several hundred of these assignments to grade, and we use computer tools to automate as much of the process as possible. If you deviate from these instructions, our grading tools will not work.


Submission Instructions



Here are step-by-step instructions for submitting your homework properly:

  1. Make sure you have the appropriate comment header block at the top of every source code file for this set. The header block should include the following information at a minimum.
    /* CSCI 200: Final Project
     *  * Author: XXXX (INSERT_NAME) * Resources used (Office Hours, Tutoring, Other Students, etc & in what capacity):  * // list here any outside assistance you used/received while following the * // CS@Mines Collaboration Policy and the Mines Academic Code of Honor *  * XXXXXXXX (MORE_COMPLETE_DESCRIPTION_HERE)  */
    Be sure to fill in the appropriate information, including:
    • Your name
    • If you received any type of assistance (office hours - whose, tutoring - when), then list where/what/who gave you the assistance and describe the assistance received
    • A description of the assignment task and what the code in this file accomplishes.

    Additionally, update the Makefile for FP to generate a target executable named FP.

  2. File and folder names are extremely important in this process. Please double-check carefully, to ensure things are named correctly.
    1. The top-level folder of your project must be named FP
    2. Copy your files into FP (steps 2-3), zip this FP folder (steps 4-5), and then submit the zipped file (steps 6-11) to Canvas.

  3. Using Windows Explorer (not to be confused with Internet Explorer), find the files named main.cpp, Makefile, *.hpp, *.h, *.cpp, final.txt.

    STOP: Are you really sure you are viewing the correct assignment's folder?

  4. Now, for FP, right click on main.cpp, Makefile, *.hpp, *.h, *.cpp, final.txt to copy the files. Then, return to the FP folder and right click to paste the files. In other words, put a copy of your homework's main.cpp, Makefile, *.hpp, *.h, *.cpp, final.txt source code into the FP folder.

    STOP: Are you sure your FP folder now has all your code to submit?


  5. Now, right-click on the "FP" folder.
    1. In the pop-up menu that opens, move the mouse "Send to..." and expand the sub-menu.
    2. In the sub-menu that opens, select "Compressed (zipped) folder".

    STOP: Are you really sure you are zipping a FP folder with a main.cpp file in it?

  6. After the previous step, you should now see a "FP.zip" file.

  7. Now visit the Canvas page for this course and click the "Assignments" button in the sidebar.

  8. Find FP, click on it, find the "Submit Assignment" area, and then click the "Choose File" button.

  9. Find the "FP.zip" file created earlier and click the "Open" button.

    STOP: Are you really sure you are selecting the right homework assignment? Are you double-sure?

  10. WAIT! There's one more super-important step. Click on the blue "Submit Assignment" button to submit your homework.

  11. No, really, make sure you click the "Submit Assignment" button to actually submit your homework. Clicking the "Choose File" button in the previous step kind of makes it feel like you're done, but you must click the Submit button as well! And you must allow the file time to upload before you turn off your computer!

  12. Canvas should say "Submitted!". Click "Submission Details" and you can download the zip file you just submitted. In other words, verify you submitted what you think you submitted!

In summary, you must zip the "FP" folder and only the "FP" folder, you must submit the correct zip file for this homework, and you must click the "Submit Assignment" button. Not doing these steps is like bringing your homework to class but forgetting to hand it in. No concessions will be made for incorrectly submitted work. If you incorrectly submit your homework, we will not be able to give you full credit. And that makes us unhappy.


This assignment is due by Thursday, December 08, 2022, 11:59 PM.
NO LATE SUBMISSIONS WILL BE ACCEPTED