The following is a sample data snapshot:

capitals.csv

This file contains geographical data for several countries around the world. The data is stored in a comma separated file (.CSV). Each line within the file contains 6 fields as the following:

univRanking.py

This file should contain all your work. In this file you need to write a set of functions that will help you complete the requirement  of this  assignment. The main objective is to read the content of the two .csv files and display information extracted from these files. This  information  is  used to  provide general  insights  on the  countries, continents, universities, and more specific information about a country determined by the user. All the required information should be written out to a file named output.txt

The following is the required information that should be presented within output.txt in order :

1. Universities count

You need to show the total number of the universities in the TopUni.csv file. The output should be Total number of universities => $$$where the $$$ should be replaced by the total number of the universities. The following                                                   is                                                   an                                                   example output:

2. Available countries

You need to show the list of all country names available in the TopUni.csv file in the order that they appear in the file. Each country name should be displayed only once without repetition. The names should be in upper case. Country names are separated by a comma and a space after it. The output should be as follows : Available countries => COUNTRY1, COUNTRY2, COUNTRY3,where  COUNTRY1,  COUNTRY2,  COUNTRY3, should be replaced by the list of all country names. If the printed list of countries end with a comma and a space,              that               is              fine.              The              following              is              an              example output:

3. Available continents

You need to show the list of all continent names available in the capitals.csv file. You must display the continents names corresponding to the countries listed in the previous point. For example, if the list of countries displayed in the previous point is CANADA, JORDAN, this means that the list of continents should be NORTH AMERICA, ASIA. Each continent name should be displayed only once without repetition. The names should be in upper case. Every two names are separated by a comma and a space after it (, ). The output   should   be   like Available continents => CONTINENT1, CONTINENT2, CONTINENT3,where CONTINENT1, CONTINENT2, CONTINENT3, should  be  replaced  by the  list of all continents  names. The following is an example output:

The following requirements requires the user to specify a country name to display the corresponding information. We will refer to this country as the term Selected Country

4. The university with top international rank

You need to show the world rank and the name of the university that has the highest international rank within the selected country. This means that you need to check the international rank of all unversities in the selected country and show the required information. The output should be as followsAt international rank => $$$ the university name is => UNIVERSITY where $$$ should be replaced by the international rank number,  and  UNIVERSITY  should  be  replaced  by  the  university  name.  The  following  is  an  example

output:

5. The university with top national rank

You need to show both the national rank and the name of the university that has the highest national rank within the selected country. This means that you need to check the national rank of all unversities in the selected country and show the required information. The output should be like At national rank => $$$ the university name is => UNIVERSITYwhere  $$$  should  be  replaced  by  the  national  rank  number,  and UNIVERSITY    should    be    replaced    by    the    university    name.    The    following    is    an    example output:

6. The average score

You need to show the average score of all universities within the selected country. The average score is calculated according to the following equation:

The average score value should be rounded to two decimal places. The output should be as follows: The average score => $$$%where $$$ should be replaced by the average score and a percentage symbol. The following is an

example

output:

7. The continent relative score

The relative score is defined as the ratio between the average score (calculated in the previous point) divided by the highest score within the continent where the selected university is located. This is defined

as:

This means that you need to check the scores of all universities in all countries that belong to the continent of the selected country. The relative score value should be rounded to two decimal places. The output should  be  likeThe relative score to the top university in CONTINENT is => ($$$ / &&&) x 100% = @@@%where CONTINENT is the continent of the selected country, $$$ should be replaced by the average score, &&& should be replaced by the highest score in the continent, @@@ should be replaced by the relative        score        and        a        percentage        symbol.        The        following        is        an        example output:

8. The capital city

You need to show the capital of the selected country. For example, if the selected country is CANADA, the capital should be OTTAWA. The output should be as follows: The capital is => CAPITALwhere CAPITAL is the capital        name        of        the        selected        country.        The        following        is        an        example output:

9. The universities that hold the capital name

You need to list all the universities names where the name contains (at any place) the capital name of the selected country. For example, if the selected country is CANADA, then the UNIVERSITY OF OTTAWA should be listed while UNIVERSITY OF TORONTO should NOT be listed. The output should be like the following

The universities that contain the capital name =>

#1UNIVERSITY1

#2UNIVERSITY2

#3 UNIVERSITY3

where UNIVERSITY1, UNIVERSITY2, UNIVERSITY3, are the names of the universities that must contain the complete capital name of the selected country. The following is an example output:

tester.py

This file is provided to you so that you will be able to test your work . It basically executes the following steps in the following order:

Imports the module you completed with the name univRanking.

Calls               the               one               function               from               your               module               as               follows:

univRanking.getInformation(selectedCountry, "TopUni.csv", "capitals.csv")

o  The function name MUST BE getInformation and pay attention to the case.

o  The second parameter is th ranking file name which is set by default to "TopUni.csv"

o  The third parameter is th capitals file name which is set by default to "capitals.csv"

The getInformation function  will  extract  all  the  required  information  according  to  the  specifications

explained in the previous section and store this information in the output.txt file according to the exact formatting specified earlier . Your code will be tested against three countries (USA, South Korea, Japan) and the  test  result  will  be  displayed  for  each  requited  information  accordingly.  After  the  complete  run for tester.py, the following will be printed:

Tips and Guidelines

This is a general guideline on how to implement your code.

First, download all the provided files into your working folder.

create the file univRanking.py in the same working folder. This way you now have 4 files in the same folder. Implement the function with the exact name:

getInformation(selectedCountry,rankingFileName,capitalsFileName)

Start by writing some code to write any text to output.txt

Test if tester.py is working and displaying the content of output.txt correctly.

Now,  start  implementing  the  required  code  for  the getInformation function.  This  function  reads  the

contents of both TopUni.csv and capitals.csv and converts it into an appropriate list representaion. If any of the files is missing, you must handle this as an exception by printing a "file not found" error message to the output file and exiting the program. You can use the quit() function to exit. You can use the following code as a guide to read the files:

Don't forget to use encoding='utf8' when reading the file to read special characters correctly.

It is a good idea to have a function that perform   some cleanup before using the data by removing the

unnecessary columns in the used data files.

It is also a good idea to combine both files in such a way that you include the capital and continent for each

university.

It will be easier to define at least one function for each of the requirements mentioned above. Then, you

call all the functions inside the getInformation function.

It is a very good practice to have some helper functions. Each of these functions is defined to accomplish a

relatively small task, while this task may be used by other functions multiple times. For example:

o  A       function       to       return       all       university       info       using       its       country       name       e.g.,

info = findUnivByName(selectedCountry)

o  A      function      to      return      the      continent      name      using      the      country      name      e.g.,

continent = findContinentByCountryName(selectedCountry)

o  And so on..

Debug...Debug... Debug...

Constants must be named with all uppercase letters .

Variables  should  be  named  in  lowercase  for  single  words  and  camel  case  for  multiple  words,  i.e.

extraToppingCost

All user input in this program should be case-insensitive, meaning that the user can type in lowercase or

uppercase or a mixture, and it should work the same regardless

Add comments throughout your code to explain what each section of the code is doing and/or how it works You can assume the following:

o  All the numbers presented in the examples above are for demonstration purposes only.

o  You must follow the exact labels (wording and case) used in the output requirements. These labels are highlighted in purple.

o  All the data that is coming from the .csv files should be displayed as UPPERCASE.

o  The provided examples of the output.txt file have some blurred text. This is done for the purpose of showing the corresponding output relative to the other outputs from the other requirements.

o  The selected country is always entered correctly by the user.

Rules

Read and follow the instructions carefully.

Only submit the Python file described in the Files section of this document.

Submit the assignment on time. Late submissions will receive a late penalty of 10% per day (except where

late coupons are used).

Forgetting to submit a finished assignment is not a valid excuse for submitting late.

Submissions must be done on Gradescope. They will not be accepted by email.

You may re-submit your code as many times as you would like. Gradescope uses your last submission as

the one for grading by default. There are no penalties for re-submitting. However, re-submissions that come in after the due date will be considered late and subject to penalties (or to the use of late coupons).

Assignments will be run through a similarity checking software to check for code that looks very similar to

that of other students. Sharing or copying code in any way is considered p lagiarism and may result in a mark of zero (0) on the assignment and/or reported to the Dean's Office. Plagiarism is a serious offence. Work is to be done individually.