CSSE1001 / 7030 統計詳細解釋

時間 2021-06-19

標籤 web spring session app less electron ide oop this 欄目 HTML 简体版

原文原文鏈接

CSSE1001 / 7030 Semester 1, 2019
Assignment 1 (15 Marks)
Due: Friday 29 March 2019 at 20:30
Introduction
Welcome to Travel Inspiration!
We are going to be building a travel recommendation program. Out of ideas where to travel? Travel
Inspiration has got you covered.
The program will ask the user questions about their preferences in a travel destination. It will use
these to recommend the best match in a database of potential travel destinations.
You are provided with a file travel.py, which serves as a template for the assignment. This file is
where you should write the code for your solution. The file also provides an example of how to read
the data from the database, one destination at a time. You need to implement the functionality to
question the user and perform the matching. The database is in the form of a text file,
destinations.csv. You may edit this text file to add more destinations for testing.
Overview
Tasks
This assignment is broken down into six main tasks, grouped into two categories: Coreweb

Questions & Inputs
First Exact Match
Climate & Season Factor
Interests
? Advanced
Input Validation
Multiple Inputs
Do not attempt the advanced tasks unless you have implemented all the core tasks. Most of the
marks for this assignment are assigned to the core tasks.
Getting Started
The archive a1_files.zip contains all the necessary files to start this assignment. It contains:
travel.py: The main assignment file. Add your code to this file.
destinations.csv: The destinations database, in Comma Separated Value (CSV) format.
destinations.py: Code to help Python read from a database. You are not expected to
understand the code in the destinations.py file. The provided travel.py demonstrates
everything you need to do to use this code.
Core Tasks
Questions & Inputs
The first task involves creating the questionnaire and prompting the user for input. Your program
must duplicate the functionality demonstrated below.
The final line of output is the recommended destination. For now, this should be None, but in the
following tasks this should be replaced with the recommended destination.
You may assume that the user will only enter valid input.
CSSE1001 / 7030 Semester 1, 2019
Required Output
Welcome to Travel Inspiration!
What is your name? Dora
Hi, Dora!
Which continent would you like to travel to?
1) Asia
2) Africa
3) North America
4) South America
5) Europe
6) Oceania
7) Antarcticaspring

4
What is money to you?
$$$) No object
$$) Spendable, so long as I get value from doing so
$) Extremely important; I want to spend as little as possible
$$$
How much crime is acceptable when you travel?
1) Low
2) Average
3) High
3
Will you be travelling with children?
1) Yes
2) No
2
Which season do you plan to travel in?
1) Spring
2) Summer
3) Autumn
4) Winter
1
What climate do you prefer?
1) Cold
2) Cool
3) Moderate
4) Warm
5) Hot
4
Now we would like to ask you some questions about your interests, on a scale
of -5 to 5. -5 indicates strong dislike, whereas 5 indicates strong interest,
and 0 indicates indifference.
How much do you like sports? (-5 to 5)
-5
CSSE1001 / 7030 Semester 1, 2019
How much do you like wildlife? (-5 to 5)
-2
How much do you like nature? (-5 to 5)
-4
How much do you like historical sites? (-5 to 5)
-1
How much do you like fine dining? (-5 to 5)
-3
How much do you like adventure activities? (-5 to 5)
-4
How much do you like the beach? (-5 to 5)
-2
Thank you for answering all our questions. Your next travel destination is:
None
User input is bold, italic and blue.
Your program must match this output exactly. Including spaces, spelling and punctuation. Your
programs will be tested using an automated system that will match your program’s output with the
expected output. A mismatch in the output will result in the test failing. Note: Option lines, i.e.
「 1) Spring」, should begin with two spaces.
Input Requirements
For name, anything is valid. For general questions, the user input will be the value to the left of the
parenthesis (i.e. 1-7 for continent; $, $$ or $$$ for money; etc.). For interest questions, the user
input will be an integer between -5 and 5, inclusive. For tasks 1 to 4, you may assume that the user
input is always valid.
First Exact Match
Extend your program to output a recommended destination on the final line, instead of None.
For this task, the recommended destination should be the first destination that meets the following
criteria:
The continent must match exactly (destination.get_continent()).
If the user will be travelling with children, it must be kid friendly
(destination.is_kid_friendly()).
Cost must be less than or equal to the user's response to the money question
(destination.get_cost()).
Crime cannot be greater than is acceptable to the user (destination.get_crime()).
If no exact match is found, the recommended destination should be None.
There is no difference between varying levels of cost and crime, provided they meet the above
requirements. For example, if the user’s money response is $$, then a cost of either $ or $$ would
be equally valid.
CSSE1001 / 7030 Semester 1, 2019
Climate & Season Factor
In addition to the requirements from 2. First Exact Match, the program must look for the best match
from all destinations, according to the following criteria:
Matches the user’s climate preference exactly (destination.get_climate()).
Has the greatest season_factor, for the user’s selected season (e.g.
destination.get_season_factor('spring')).
As above, if no exact match is found, the recommended destination should be None.
Interests
Extend the matching criteria from task 3 to consider the user’s interests as well as the season factor.
To do this, let score = season_factor * interest_score, where season_factor is
defined above (e.g. destination.get_season_factor('summer')) and the interest score is
the sum of the user’s response multiplied by the destination’s score, for each interest (sports,
wildlife, nature, historical, cuisine, adventure, beach). More specifically:
interest_score = responsesports * scoresportssession
- responsewildlife * scorewildlife
- responsenature * scorenature
- responsehistorical * scorehistorical
- responsecuisine * scorecuisine
- responseadventure * scoreadventure
- responsebeach * scorebeach
Where responseinterest is the user’s response for the given interest, and scoreinterest is the
destination’s score for the given interest (e.g. destination.get_interest_score('beach')).
Advanced Tasksapp
Input Validation
For this task you may no longer assume that the user will enter valid input.
If, for any question, the user enters invalid input, they should be asked the question again until they
enter valid input, as demonstrated in the example below.
Input Validation Example
...
How much crime is acceptable when you travel?
1) Low
2) Average
3) Highless

5
I'm sorry, but 5 is not a valid choice. Please try again.
How much crime is acceptable when you travel?
1) Low
2) Average
3) High
1
...
CSSE1001 / 7030 Semester 1, 2019
Multiple Inputs
Extend the continent and season questions to accept multiple inputs, so that the user can type in
multiple options separated by a comma, as shown below.
A destination is now considered a match if it’s continent matches one of the user’s choices (there is
no ordering; each choice is considered equally).
The season factor used in calculating the score is now the greatest factor of those matching the
user’s choice.
Extend your input validation to handle multiple inputs.
Values can be repeated (i.e. 「2,3,2」 is a valid input).
Numbers can have spaces around them (i.e. 「2, 3 ,4」 is a valid input).
Numbers can be unordered (i.e. 「1,4,3」 is a valid input).
You should first implement this task to handle the simple case, where the input does not have
repeated values, spaces or is unordered. Once this is working, then implement each type of
validation in turn. Marking will test to determine how much of the validation your implement, and
you can obtain part marks for partially implementing the validation for this section.
Multiple Inputs Example
...
Which continents would you like to travel to?
1) Asia
2) Africa
3) North America
4) South America
5) Europe
6) Oceania
7) Antarcticaelectron

1,2,7,3
...
Which seasons do you plan to travel in?
1) Spring
2) Summer
3) Autumn
4) Winter
1, 3
...
Note that the words 「continents」 and 「seasons」 are now plural.
Utility Functions
To implement the assignment you will need to use some utility functions provided in the
destinations.py file. The specific functions that you need to use for each task have been
identified in the description above. The initial code inside travel.py provides an example of using
all of these functions. The following table indicates the type of the value returned by each of the
functions.
CSSE1001 / 7030 Semester 1, 2019
Function Parameter Return Type
destination.get_name() no parameter string
destination.get_crime() no parameter string
destination.is_kid_friendly() no parameter boolean
destination.get_cost() no parameter string
destination.get_climate() no parameter string
destination.get_continent() no parameter string
destination.get_interest_score() string that is the name of the
interest
int
destination.get_season_factor() string that is the name of the
season
float
Interview
In addition to providing a working solution to the assignment problem, the assessment will involve
discussing your code submission with a tutor. This discussion will take place in week 6, during the
practical session to which you have signed up. You must attend your allocated practical session,
swapping to another session is not possible. In preparation for your discussion with a tutor you
should consider:
any parts of the assignment that you found particularly difficult, and how you overcame them
to arrive at a solution; or, if you did not overcome the difficulty, what you would like to ask the
tutor about the problem;
whether you considered any alternative ways of implementing a given function;
where you have known errors in your code, their cause and possible solutions (if known).
It is important that you can explain to your tutor the algorithmic logic of your program and how
each of the functions that you have written operates. (For example, if you have used a while loop in
a function, why this was an appropriate choice).
In the interview you must demonstrate understanding of your code. If you cannot demonstrate
understanding of your code, this may affect the final mark you achieve for the assignment. A
technically correct solution may not achieve a pass mark unless you can demonstrate that you
understand its operation.
Submission
You must submit your assignment electronically via the assignment one submission link on
Blackboard. For information on submitting through Blackboard, please read:
https://web.library.uq.edu.au...
You must submit your assignment as a single Python file called travel.py (use this name – all
lower case), and nothing else. Do not submit the destinations.csv or destinations.py files.
Do not submit any sort of archive file (e.g. zip, rar, 7z, etc.).
Late submissions of the assignment will not be marked. Do not wait until the last minute to submit
your assignment, as the time to upload it may make it late. Multiple submissions are allowed, so
ensure that you have submitted an almost complete version of the assignment well before the
submission deadline of 20:30. Your latest, on time, submission will be marked. Ensure that you
submit the correct version of your assignment.
CSSE1001 / 7030 Semester 1, 2019
In the event of exceptional personal or medical circumstances that prevent you from handing in the
assignment on time, you may submit a request for an extension. See the course profile for details
of how to apply for an extension.
Requests for extensions must be made no later than 48 hours prior to the submission deadline. The
application and supporting documentation (e.g. medical certificate) must be submitted via my.UQ.
You must retain the original documentation for a minimum period of six months to provide as
verification, should you be requested to do so.
Assessment and Marking Criteria
This assignment assesses course learning objectives:
apply program constructs such as variables, selection, iteration and sub-routines,
read and analyse code written by others,
read and analyse a design and be able to translate the design into a working program,
apply techniques for testing and debugging
Criteria Mark
Programming Constructs
Program is well structured and readable
Identifier names are meaningful and informative
Algorithmic logic is appropriate
Functions are used to split logic into meaningful and useful blocks, with data
passed as parameters and returned appropriately
Functions are well-designed, simple cohesive blocks of logic
Sub-Total 5.5
Functionality
Questions and Inputs
First Exact Match
Climate and Season Factor
Travel Interests
Input Validation
Multiple InputsSub-Total 7Documentation Comments are clear and concise, without excessive or extraneous text Program, and all functions having informative docstring comments Significant blocks of program logic are clearly explained by comments0.51.50.5Sub-Total 2.5Total / 15Your total mark will be constrained if your program does not implement all the core functionality(tasks 1 to 4). The following table indicates a multiplier that will be applied to your programmingconstructs and documentation marks based on how much of the core functionality your programcorrectly implements.CSSE1001 / 7030 Semester 1, 2019Functionality Correctly Implemented MultiplierTask 1 does not execute at all 25%Task 1 is partially working 35%Task 1 is completely working 50%Task 2 is mostly working 75%Task 3 is mostly working 85%Task 4 is mostly working 100%It is your responsibility to ensure that you have adequately tested your program to ensure that it isworking correctly.A partial solution will be marked. If your partial solution causes problems in the Python interpreterplease comment out the code causing the issue and we will mark what is working. Python 3.7.2 willbe used to test your program. If your program works correctly with another version of Python butdoes not work correctly with Python 3.7.2, you will lose at least all the marks for the functionalitycriteria.Please read the section in the course profile about plagiarism. Submitted assignments will beelectronically checked for potential plagiarism.CSSE1001 / 7030 Semester 1, 2019Detailed Marking CriteriaCriteria MarkProgramming Constructs 1 0.5 0 Program is well structured and readable Code structure highlights logical blocksand is easy to understand. Code doesnot employ global variables. Constantsclarify code meaning.Code structure corresponds to somelogical intent and does not make thecode too difficult to read. Code doesnot employ global variables.Code structure makes the code difficultto read. Identifier names are meaningful andinformativeAll variable and function names areclear and informative, increasingreadability of the code.Most identifier names are informative,aiding code readability to some extent.Most identifier names are not clear orinformative, detracting from codereadability. Algorithmic logic is appropriate Algorithm design is simple, appropriate,and has no logical errors.Control structures are well used toimplement expected logic.Algorithm design is not too complex orhas minor logical errors.A few control structures are a littleconvoluted.Algorithm design is overly complex orhas significant errors.Many control structures are used in aconvoluted manner (e.g. unnecessarynesting, multiple looping, …). Functions are used to split logic intosome meaningful and useful blocks, withdata passed as parameters and returnedappropriatelyFunctions represent useful logical functionalityand parameters and returnvalues are appropriate.Functions represent some useful logicalfunctionality and parameters and returnvalues are usually appropriate (e.g. toofunctions or they are too large).Functions are not used or are not usefullogical blocks. Parameters or returnvalues are not used or are notappropriate.Programming Constructs 1.5 1 0.5 0 Functions are welldesigned,simplecohesive blocks oflogicProgram is well-designed, splittingthe logic into an appropriatenumber of general functions,where each function performs asingle cohesive logical task.Program is split into a reasonablenumber of general functions.None are too complex or large.Program may use functionscorrectly, but some functions arelarge blocks of logic thatimplement multiple tasks. Or,parameters are not used well.Program makes little or no use offunctions. Functions implementedare often large and complexblocks of logic. Parameters maybe poorly used.CSSE1001 / 7030 Semester 1, 2019Functionality 1 0.5 0 Task 1: Questions & Inputs All prompts are correctly displayed andcan accept correct inputs.Most prompts are displayed and they canaccept correct inputFew prompts are displayed or mostcannot accept input. Task 2: First Exact Match In all cases finds the correct destinationmatch. (2 marks)In all simple cases finds the correctdestination match. (1 mark)In most cases does not find the correctdestination match. (0.5 or 0 marks) Task 3: Climate and Season Factor In all cases finds the correct destinationmatch.In all simple cases finds the correctdestination match.In most cases does not find the correctdestination match. Task 4: Travel Interests In all cases finds the correct destinationmatch.In all simple cases finds the correctdestination match.In most cases does not find the correctdestination match. Task 5: Input Validation Handles all invalid input strings Handles simple invalid inputs Does not handle any invalid inputs. Task 6: Multiple Inputs In all cases finds the correct destinationmatch.In all simple cases finds the correctdestination match.In most cases does not find the correctdestination match.Documentation 1.5 1 0.5 0 Comments are clearand concise, withoutexcessive or extraneoustextComments provide usefulinformation that elaborates onthe code. These are useful inunderstanding the logic and arenot verbose.Many comments are irrelevant ordo not provide any detail beyondwhat is already obvious in thecode. Excessive length of somecomments obscures the programlogic. All functions havinginformative docstringcommentsProgram docstring is a clearsummary of its purpose.All functions have docstrings thatprovide a complete,unambiguous, description of howit is to be used.Program docstring fairly clearlysummarises its purpose.All functions have docstrings thatprovide a complete and fairlyclear description of how it is tobe used.Most docstrings provide acomplete and fairly cleardescription.Some docstrings provide aninaccurate description, or thereare functions without docstrings. Significant blocks ofprogram logic areclearly explained bycommentsIn-line comments are used toexplain logical blocks of code(e.g. significant loops orconditionals).In-line comments are missing inplaces where they would havebeen useful. Or, in-linecomments are irrelevant orrepeat what is already clear inthe code.WX：codehelp