Description
This assignment demonstrates your understanding of the concepts from the CMIS 141 class.
Before attempting this project, be sure you have completed all of the reading assignments, hands-on labs, discussions, and assignments to date.
Design a Java application that will read a file containing data related to the US. Crime statistics from 1994-2013. The description of the file is at the end of this file. The application should provide statistical results on the data including:
-
Population growth in percentages from each consecutive year (e.g. 1994-1995 calculation is ((262803276 – 260327021)/260327021)*100 = 0.9512%, 1995-1996 would be ((265228572 – 262803276)/262803276)*100 = 0.9229%)
-
Years where the maximum and minimum Murder rates occurred.
-
Years where the maximum and minimum Robbery rates occurred.
The following are some design criteria and specific requirements that need to be addressed:
-
Use command line arguments to send in the name of the US Crime Data file.
-
You should also use Java classes to their full extent to include multiple methods and at least two classes
-
You are not allowed to modify the Crime.csv Statistic data file included in this assignment.
-
Use arrays and Java classes to store the data. (Hint: You can and should create a USCrimeClass to store the fields. You can also have an Array of US Crime Objects.)
-
You should create separate methods for each of the required functionality. (e.g. getMaxMurderYear() will return the Year where the Murder rate was highest. )
-
A user-friendly and well-organized menu should be used for users to select which data to return. A sample menu is shown in run example. You are free to enhance your design and you should add additional menu items and functionality.
-
The menu system should be displayed at the command prompt, and continue to redisplay after results are returned or until Q is selected. If a user enters an invalid menu item, the system should redisplay the menu with a prompt asking them to enter a valid menu selection
-
The application should keep track of the elapsed time (in seconds) between once the application starts and when the user quits the program. After the program is exited, the application should provide a prompt thanking the user for trying the US Crime Statistics program and providing the total time elapsed.
-
Hint: When reading the Crimes file, read one line at a time (See ReadEmail.java) and then within the loop parse each line into the USCrimeClass fields and then store that USCrimeClass Object into an array. Note you can use String.split(“,”) to split the CSV line into a the fields for setting the USCrimeClass Object.
Here is sample run:
java TestUSCrime Crime.csv
1
********** Welcome to the US Crime Statistical Application **************************
Enter the number of the question you want answered. Enter ‘Q’ to quit the program :
-
What were the percentages in population growth for each consecutive year from 1994 – 2013?
-
What year was the Murder rate the highest?
-
What year was the Murder rate the lowest?
-
What year was the Robbery rate the highest?
-
What year was the Robbery rate the lowest?
Q. Quit the program
Enter your selection: 2
The Murder rate was highest in 1994
Enter the number of the question you want answered. Enter ‘Q’ to quit the program :
-
What were the percentages in population growth for each consecutive year from 1994 – 2013?
-
What year was the Murder rate the highest?
-
What year was the Murder rate the lowest?
-
What year was the Robbery rate the highest?
-
What year was the Robbery rate the lowest?
Q. Quit the program
Enter your selection: 5
The Robbery rate was lowest in 2013
Enter the number of the question you want answered. Enter ‘Q’ to quit the program :
-
What were the percentages in population growth for each consecutive year from 1994 – 2013?
-
What year was the Murder rate the highest?
-
What year was the Murder rate the lowest?
-
What year was the Robbery rate the highest?
-
What year was the Robbery rate the lowest?
Q. Quit the program
Enter your selection: Q
Thank you for trying the US Crimes Statistics Program.
Elapsed time in seconds was: 32
The google recommended Java style guide, provided as link in the week 2 content, should be used to format and document your code. Specifically, the following style guide attributes should be addressed:
Header comments include filename, author, date and brief purpose of the program. In-line comments used to describe major functionality of the code.
Meaningful variable names and prompts applied.
2
Class names are written in UpperCamelCase.
Variable names are written in lowerCamelCase. Constant names are in written in All Capitals.
Braces use K&R style.
Submission requirements
Deliverables include all Java files (.java) and a single word (or PDF) document. The Java files should be named appropriately for your applications. The word (or PDF) document should include screen captures showing the successful compiling and running of each of the test cases. Each screen capture should be properly labeled clearly indicated what the screen capture represents. The test cases table should be included in your word or PDF document and properly labeled as well.
Submit your files to the Final Project area no later than the due date listed in your LEO classroom. You should include your name and FP in your word (or PDF) file submitted (e.g. firstnamelastnameFP.docx or firstnamelastnameFP.pdf)
Grading Rubric:
The following grading rubric will be used to determine your grade:
Attribute |
Meets |
Does not meet |
Crimes Class |
15 points |
0 points |
Population growth in |
Population growth in |
|
percentages is calculated from |
percentages is not calculated |
|
each consecutive year |
from each consecutive year |
|
Years where the maximum and |
Years where the maximum and |
|
minimum Murder rates |
minimum Murder rates |
|
occurred are calculated. |
occurred are not calculated. |
|
Years where the maximum and |
Years where the maximum and |
|
minimum Robbery rates |
minimum Robbery rates |
|
occurred are calculated. |
occurred are not calculated. |
|
Command line arguments to |
Command line arguments to |
|
send in the name of the US |
send in the name of the US |
|
Crime Data file were used. |
Crime Data file are not used. |
|
Java classes to their full extent |
Java classes to their full extent |
|
to include multiple methods |
to include multiple methods |
|
and at least two classes were |
and at least two classes are not |
|
used. |
used. |
|
3
Crime.csv Statistic data file was |
Crime.csv Statistic data file was |
|
not modified. |
modified. |
|
Use arrays and Java classes |
Use arrays and Java classes are |
|
were used to store the data. |
not used to store the data. |
|
Creates separate methods for |
Does not create separate |
|
each of the required |
methods for each of the |
|
functionality. |
required functionality. |
|
A user-friendly and well- |
A user-friendly and well- |
|
organized menu was used. |
organized menu was not used. |
|
The menu system is displayed at |
The menu system is not |
|
the command prompt. |
displayed at the command |
|
prompt. |
||
The menu system continues to |
||
redisplay after results are |
The menu system does not |
|
returned or until Q is selected. |
continue to redisplay after |
|
results are returned or until Q is |
||
If a user enters an invalid menu |
selected. |
|
item, the system redisplays the |
||
menu with a prompt asking |
If a user enters an invalid menu |
|
them to enter a valid menu |
item, the system does not |
|
selection. |
redisplay the menu with a |
|
prompt asking them to enter a |
||
The application keeps track of |
valid menu selection. |
|
the elapsed time (in seconds) |
||
between the application start |
The application does not keep |
|
and when the user quits the |
track of the elapsed time (in |
|
program. |
seconds) between the |
|
application start and when the |
||
After the program is exited, the |
user quits the program. |
|
application provides a prompt |
||
thanking the user for trying the |
After the program is exited, the |
|
US Crime Statistics program and |
application does not provides a |
|
providing the total time elapsed |
prompt thanking the user for |
|
in seconds. |
trying the US Crime Statistics |
|
program and providing the total |
||
time elapsed in seconds. |
||
Test Cases |
5 points |
0 points |
A minimum of 3 test cases was |
No test cases were provided. |
|
used in the form of table with |
||
columns indicating the input |
||
values, expected output, actual |
||
output and if the test case |
||
passed or failed. The table |
||
4 |
should contains 4 columns with |
||
appropriate labels and a row for |
||
each test case. |
||
Test cases were included in the |
||
supporting word or PDF |
||
documentation. |
||
Documentation and Style guide |
5 points |
0 points |
Screen captures were provided |
No documentation included |
|
and labeled for compiling your |
||
code, and running each of your |
Java style guide was not used to |
|
3 test cases. |
prepare the Java code. |
|
Header comments include |
||
filename, author, date and brief |
||
purpose of the program. |
||
In-line comments used to |
||
describe major functionality of |
||
the code. |
||
Meaningful variable names and |
||
prompts applied. |
||
Class names are written in |
||
UpperCamelCase. |
||
Variable names are written in |
||
lowerCamelCase. |
||
Constant names are in written |
||
in All Capitals. |
||
Braces use K&R style. |
||
US Crimes Data Description: |
The attached Comma delimited file, named Crime.csv contains US Crime data from 1994 – 2013. The first line in the file contains the field names. (Note: Do not modify this file in anyway. You should use it as is for input for your application)
The US Crime data were obtained from this Web Site:
https://www.fbi.gov/about-us/cjis/ucr/crime-in-the-u.s/2013/crime-in-the-u.s.-2013/tables/1tabledatadecoverviewpdf/table_1_crime_in_the_united_states_by_volume_and_rate_pe r_100000_inhabitants_1994-2013.xls#overview
5