Due: 5pm Monday 28 August 2023

Worth 40% of COMP636 grade

Submit via Akoraka  | Learn

Introduction

The Bankside-Rakaia Motorkhana Mavens (BRMM) car club has asked for a system to help manage  its August ‘Have-a-go Fun Motorkhana’ event.  You are provided with an outline of the code for the system to complete.

Some of the runs have not had their results entered yet for time, number of cones hit and wrong   direction (WD), e.g., Driver 220 Andy Pickles did record 3 run times (run numbers 11, 22, 31), but   they have not been entered in the provided data file yet.  You can use those blank runs for testing your Add/Update Run Data menu option (see below).

Remember that we may use a different set of drivers and runs for marking in brmm_data.py with different data but the same structure.  So do not hard-code values (such as run 11 or 22, or which times are missing in particular runs, etc.) because we may mark with different drivers and runs.

File Download:

Download the following files from the COMP636 Assessment block on Akoraka  | Learn:

-      brmm_admin_your_name.py – This is the initial code to begin from.

Include your own name in the filename (e.g., brmm_admin_Anna_Lee.py), and your name    and student ID in a comment at the start of the file. Do not change the menu numbering or existing function names, although you may add new functions of your own.

-      brmm_data.py – The driver and run data. Do not change the structure of this data

(col_drivers, etc).  Although you may add extra drivers and runs to db_drivers and dbRuns,

that is not necessary.  We will use our own copy of brmm_data when marking, with different driver and run data, but with the same col_drivers, db_drivers, col_runs, db_runs structure    as provided.

Requirements

The system needs to keep a record of drivers, their run results for each course, and the overall results for the day, as well as recording juniors and their nominated parent or caregiver, if appropriate.

- Drivers arestored as a dictionary of key:value pairs.  Each key is the driver ID.  Each value

part contains a tuple (First Name, Surname, Category, Age, Caregiver).  Category is ‘J’ for any junior drivers.  Drivers who are not juniors do not have an age recorded.  Caregiver is the driver ID of an adult driver in the list (for drivers aged 12-16).

- Runs arestored as a dictionary of key:value pairs.  Each key is a run ID.  Each value part

contains a tuple (Course, Driver, Time, Cones, WD).  Driver is a driver ID.  Time is recorded to the nearest 0.01 of a second.  Cones contains the number of cones hit, if any.  WD (wrong direction) is either 1 (went the wrong direction around one or more cones) or 0 (no wrong direction).

-      Missing data values are recorded as None.

-      One function (list_drivers) for menu option 1 has already been provided for you.  This lists all of the drivers and displays Driver ID, First Name, Last Name and Age.

-     You must use the provided column_output function for all on-screen display of data (except for the graph of cones hit).  You will need to convert your dictionary data into the correct format for this function (the list_drivers function gives an example of how to do this). Do not modify this function.

-     Validate all user input appropriately.  If data of the wrong type is entered by the user, this should be captured without causing the program to crash or any other type of error.  Also ensure that only valid values that make sense can be entered.

Tasks

50 marks available in total.

Add the following features to the system: (Marks shown are an indication and may change a little.)

1. Menu enhancement (1 mark): Modify the code so that the user can enter an upper- or lower-case X (i.e., X or x) to exit the program.

2. Junior driver list (5 marks): List the junior drivers, in order of increasing age.  Combine

their full names (first name and surname) in one column (e.g., ‘Kiri Smith’, not ‘Kiri’ ‘Smith’). For juniors aged 12-16, display their caregiver’s full name, not the caregiver’s driver ID.

3. List results of runs (8 marks): List the run results.  For each run, include the time, cones hit and WD status, and then the calculated Run Total time.  Ensure your list shows all Course A runs first, then B thenC, ordered from best to worst Run Total for each course.

4. Enter or update run data (15 marks): First display the run results (from Task 3 above), then allow the user to add or update the times, cones hit and WD, for the existing runs.  Ask the   user for the ID of the run you want to update and check that the run ID exists.  The user can enter the number of cones hit, but 0 is entered automatically if no value is entered.  Ensure  the time and number of cones is in a sensible range.  The user types in ‘wd’ to enter a

wrong direction (in upper or lowercase), otherwise no value for WD should default to 0. After updating a run, a user has the option to update another run or return to the menu. (Note:  Your code does not need to add new runs – it just updates existing runs.  You can assume that all of the runs are already in the system.)

5. Display overall results (8 marks): Calculate and display the overall results for the August   ‘ Have a Go’ .  For each driver show the sum of their best two runs.  Show results from best to worst, with any "HAG" results at the bottom of the list.  Show each driver’s full name in one column and show ‘(J)’ after the name for junior drivers (e.g., ‘Edward Cooper (J)’).

6. Cone graph (8 marks): Display a graph of the number of cones hit by each driver.  Exclude drivers who did not hit any cones.  Choose any symbol or character (e.g., Δ, C, o) to

represent each cone hit, with a space between each symbol or character.    For example, using σ as a symbol (you will use a better headings and a better symbol than this!):

Additional notes:

-     The quality of the user experience will betaken into account, for each of the tasks above.

Full marks for any item will require validation of data entered (for data type and sensible values) and details in the interface that demonstrate some consideration of what would work well for the user (within the limitations of the terminal window output in VS Code).

-     The provided brmm_admin_your_name.py Python file contains a menu structure and    partially completed functions.  These must not be deleted or renamed, but you may add   arguments/parameters to these functions.  You may also add additional functions of your own.  Remember to rename the file to include your name.

-     You are expected to apply problem solving skills to practically solve issues as they arise.