Practice programming with file I/O

Practice using real-world data

Practice using binary and linear search

Practice writing a menu-driven program

Get more practice with top down design and writing functions

Get more practice with incremental implementation and testing

Your program should have many functions, including: reading in the data from the file, one for performing each operation, one for the main data processing loop, and some helper functions for reading in and checking input values in different ways. We leave many of the function definition and design up to you, but you should define others the way we specify.

Your program will use binary search on different data fields; note that the data in the file is sorted by countries' names.

You program should be well designed: use good modular design, have complete function comments, use descriptive variable names, have no line wrapping, and be robust to input errors; the requirements for each part of the assignment describe what types of bad input your program does and does not need to handle.

Use what you know about good Top-down design and incremental implementation and testing to implement this large program. Do not try to complete it all in one sitting! Rather, implement and test each piece a little bit at a time.

Refer to in-class code for examples. You likely need to refer to code from many different weeks depending on the example you are looking for, as we’ve covered functions, while loops, formatted output, file I/0, searching, strings, lists, etc. over many weeks.

Use the print() function to add debug statements to help you see what your program is doing as you try to find and fix bugs (and be sure to remove these after you fix the bugs, though!).

The first value is the name of the Country, which may include white space characters and other non-alphabetic characters. For example, European Union (27) is the name of one "country" in this list. Your program will use this value as a str.

The next five values are yearly total CO2 emission values for the years 1960, 1980, 2000, 2020, and 2022 (the most recent year in the data set). The amounts are in units of Mt (Megatons of CO2 emissions). Your program will use these as float values.

The next two values are the country’s populations for the years 1960 and 2020. These are in units of millions of people. Your program will use these as float values.

The final two values are the country’s total GDP for the years 1960 and 2020. These are in units of billions of US dollar equivalents. Your program will use these as float values.

name: the name of the country (str)

co2_vals: a list containing the five CO2 emission values for 1960, 1980, 2000, 2020, 2022 (a list of float)

pop_1960: 1960 population in Millions (float)

pop_2020: 2020 population in Millions (float)

gdp_1960: 1960 GDP in Billions of US dollars (float)

gdp_2020: 2020 GDP in Billions of US dollars (float)

Your program should list the 6 menu options in the exact order as the example shown above. Do not choose a different ordering of operations on the data (e.g., option 3 needs to show the country with the largest CO2 emissions per GDP for a given year).

Your program should gracefully handle, and re-prompt for, invalid menu options entered by the user.

Menu option 6 (quit) should be implemented with this step. Print out a good bye message and return from your main menu function back to main.

Your main menu looping should work at this point. For menu options not yet implemented, just print out the menu option selected by the user, and then your function should repeat its main actions: print out the menu; get the next selection from the user; repeat.

Feel free to add any other helper functions you’d like.

Implement and test your get_value_between function independently by adding some calls to it from main to test different values. Then add the call to this function to your main loop function. Try for values other than just 1 and 6, and for different instruction strings as well.

Refer to the in-class programs and to previous lab assignments that use while-loops and functions.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.

This option must be implemented in a separate function: don’t include its code in your function that gets the menu option. Instead, that function should make a call to your function that implements this feature when the user selects menu option 1.

Implement a helper function, get_value_in_set that takes a list of values and a prompt string and returns the user’s entered choice from one of the values in the set. You will use this function in many other menu options. For this one, you will use it to have the user enter a value for one of the two years for which there are population data (either 1960 or 2020).

You should handle missing values from the data set and ignore them in your output. Missing values are represented with -1 in the data file. Note: any field in a Country object that stores a numeric value could be missing (i.e, a CO2 value, a population value or a GDP value). A country’s name will note be a missing value.

You should print out each country’s name and the population, and a header line with the year in a format similar to our output.

Use methods of the Country class to access appropriate values from each country’s data: Section 1.3

Test your get_value_in_set function independently by adding some calls to it from main. Try passing different values to ensure that it works correctly.

Look at example in-class code for lists, searching, objects, and output formatting.

Try running your program on the smaller file to help you debug, then comment out this call from main and try on the bigger file.

You may add other helper functions to implement this feature if you’d like.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.

This option must be implemented in a separate function: don’t include its code in your function that gets the menu option. Instead, that function should make a call to your function that implements this feature when the user selects menu option 2.

Use your helper function, get_value_in_set to get a value for the year from the user (one of 1960, 1980, 2000, 2020 or 2022, which are the five years with CO2 emissions values).

Use your helper function, get_value_between to get a value for the lower limit (a value between 0 and 20000).

You should handle missing values (ignore them in your output). Missing values are represented with -1.

You should print out each country’s name and CO2 emissions in tabular format, and a header line with the year in a format similar to our output.

Try running your program on the smaller file to help you debug, then comment out this call from main and try on the bigger file.

You may add other helper functions to implement this feature if you’d like.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.

This option must be implemented in a separate function: don’t include its code in your function that gets the menu option. Instead, that function should make a call to the your function that implements this feature when the user selects menu option 3.

Use your helper function, get_value_in_set to get a value for the year from the user (one of 1960 or 2020, the two years with GDP info).

You should handle missing values (ignore them in your output). Missing values are represented with -1.

You should print out each country’s name and GDP, and a header line with the year in a format similar to our output.

Try running your program on the smaller file to help you debug, then comment out this call from main and try on the bigger file.

You may add other helper functions to implement this feature if you’d like.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.

This option must be implemented in a separate function: don’t include its code in your function that gets the menu option. Instead, that function should make a call to the your function that implements this feature when the user selects menu option 4.

Use your helper function, get_value_in_set to get a value for the year from the user (one of 1960 or 2020, the two years with population info).

Use your helper function, get_value_between to get a value for the lower bound for the population (a value between 0 and 8000).

You should handle missing values (ignore them in your output). Missing values are represented with -1.

You should print out each country’s name and the population in tabular format, and with a header line with the year. Your output should be similar to ours.

Try running your program on the smaller file to help you debug, then comment out this call from main and try on the bigger file.

You may add other helper functions to implement this feature if you’d like.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.

You must use binary search to find the country with a matching name in your list of Country objects.

This option must be implemented in a separate function: don’t include its code in your function that gets the menu option. Instead, that function should make a call to the your function that implements this feature when the user selects menu option 5.

You may print out the country’s information by calling print function passing in the Country object. (See the Country Class Documentation)

If the country is not in the database, print out a message saying it is not present.

Your program does not need to handle user’s entering a country’s name in the wrong case. For example, if the user enters greece instead of Greece, it is fine if your program prints out that greece is not in the database.

Try running your program on the smaller file to help you debug, then comment out this call from main and try on the bigger file.

You may add other helper functions to implement this feature if you’d like.

Refer to the Country Class Documentation for methods that might be helpful for implementing this menu option.