FIT9136 S1 2024 – 教育课程

Assignment 3 - The Runner's Assertion [20%]
作业 3 - 跑步者的断言 [20%]

Description 描述

[Task 3] - Competition (25%)
[任务 3] - 竞争（25%）

You are NOT allowed to use try/except blocks in Task 3.
不允许在任务 3 中使用 try/except 块。

We have our runners, we have our races. Now, let's work towards creating a competition!
我们有我们的跑步者，我们有我们的比赛。现在，让我们努力创造一个比赛！

The competition class consists of one or several races with different runners competing for the title of the ultimate champion!
比赛组由一场或多场比赛组成，不同的选手争夺终极冠军头衔！

The Competition class has the following variables:
该 Competition 类具有以下变量：

MAX_ROUNDS : An integer class variable that holds the number of rounds for the competition. The default value of this is set to 3.
MAX_ROUNDS ：一个整数类变量，用于保存比赛的回合数。默认值设置为 3。
runners : A list of runners being passed to the constructor.
runners ：传递给构造函数的运行器列表。
rounds : A positive integer that determines how many rounds of races will be conducted in this competition. This cannot exceed MAX_ROUNDS.
rounds ：一个正整数，用于确定本次比赛将进行多少轮比赛。这不能超过 MAX_ROUNDS 。
distances_short : A list of positive floating values that serve as distances for the short_race (in km).
distances_short ：用作short_race距离（以 km 为单位）的正浮点值列表。
distances_marathon : A list of positive floating values that serve as distances for the marathon race (in km).
distances_marathon ：用作马拉松比赛距离的正浮点值列表（以公里为单位）。
leaderboard : A dictionary that contains the positions of the players in this competition.
leaderboard ：包含本次比赛中球员位置的字典。

It also has the following methods:
它还具有以下方法：

__init__(self, runners, rounds, distances_short, distances_marathon) : This method is the constructor of the competition class that takes in a list of runners (can be an empty list), number of rounds and a list each of distances for short races and marathon races, and initialises these variables. It should also fill in the leaderboard with keys as the positions ('1st', '2nd', '3rd', '4th', '5th', ... etc.) based on the number of runners but the values for all these keys should be set to None. This code has already been done for you. You need to ensure that the number of rounds does not exceed MAX_ROUNDS. You should also ensure that the length of both distances lists should be the same as rounds.
__init__(self, runners, rounds, distances_short, distances_marathon) ：此方法是竞赛类的构造函数，它接受跑步者列表（可以是空列表）、轮数以及短距离和马拉松比赛的距离列表，并初始化这些变量。它还应该在排行榜中填写键作为位置（“1st”、“2nd”、“3rd”、“4th”、“5th”......等）基于运行器的数量，但所有这些键的值都应设置为 None 。此代码已经为您完成。您需要确保轮数不超过 MAX_ROUNDS 。您还应该确保两个距离列表的长度应与 rounds 相同。
conduct_competition(self) : This method is the main method by which the competition will be conducted until and including the value of self.rounds is reached, starting at round 1. Each round contains a short race and a marathon race with the runners added at the start of the race. The distance for each round should be retrieved from the self.distances_short and self.distances_marathon variables. After each round, you should recover the racers who did not finish the race to maximum energy. This means only the runners who Did Not Finish should recover to maximum energy. This method should return the final leaderboard.
conduct_competition(self) ：这种方法是进行比赛的主要方法，直到从第一轮开始达到并包括价值 self.rounds 。每轮比赛包含一场短跑和一场马拉松比赛，在比赛开始时增加了跑步者。应从 self.distances_short 和 self.distances_marathon 变量中检索每个回合的距离。每一轮比赛结束后，您应该将未完成比赛的赛车手恢复到最大能量。这意味着只有未完成比赛的跑步者才能恢复到最大能量。此方法应返回最终排行榜。
conduct_race(self, race) : This method takes in an object of the race family and returns a list of the runners and their times taken to finish the race.
conduct_race(self, race) ：此方法接受比赛族的对象，并返回跑步者列表及其完成比赛所花费的时间。
update_leaderboard(self, results) : This method takes a list of results from the conduct_race method and updates the leaderboard according to the positions obtained by the runners. The leaderboard is set as follows:
update_leaderboard(self, results) ：此方法从 conduct_race 该方法中获取结果列表，并根据跑步者获得的位置更新排行榜。排行榜设置如下：
- Check the list of results and assign points based on the runner's position, inverse to the number of runners (For example, if 4 runners are running and you place first, you get 3 points. If you place second, you get 2 points; and so on). Any runner that does not finish (DNF) should get 0 points.
  检查结果列表并根据跑步者的位置分配分数，与跑步者的数量成反比（例如，如果 4 名跑步者正在跑步，而您排名第一，则获得 3 分。如果你排名第二，你会得到 2 分;等等）。任何未完成（DNF）的跑步者都应获得 0 分。
- If the leaderboard is empty; then you should assign the value as a tuple containing the name of the runner as well as their points.
  如果排行榜为空;然后，应将该值指定为包含运行器名称及其点的元组。
- If the leaderboard already has players, then you should update the runners' points and then re-assign the runners if their position has changed on the leaderboard.
  如果排行榜上已经有玩家，那么你应该更新跑步者的积分，然后如果他们在排行榜上的位置发生了变化，则重新分配跑步者。
print_leaderboard(self) : This method prints the leaderboard with the position, the name and the points (in brackets) of the runners. For example:
print_leaderboard(self) ：此方法打印排行榜，其中包含跑步者的位置、名称和积分（括号内）。例如：
Leaderboard 1st - Elijah (10) 2nd - Phoebe (7) 3rd - Lauren (4) 4th - Rupert (1) 5th - Chloe (0)
Text 发短信

Again, most of the methods are already done for you, your job is as follows:
同样，大多数方法已经为您完成，您的工作如下：

Copy and replace the code for runner.py and race.py that is given in the scaffold with your pristine code from the previous tasks.
复制脚手架中给出的 runner.py race.py 代码，并将其替换为先前任务中的原始代码。
Fix the logical errors that have been made in the class, variables, and methods given above.
修复上面给出的类、变量和方法中出现的逻辑错误。
Check the pre-conditions and post-conditions for each of the methods. Make sure to raise the relevant errors if incorrect values are passed to the functions
检查每种方法的前置条件和后置条件。如果将不正确的值传递给函数，请确保引发相关错误
Document your code including type-hinting for all variables and arguments for functions and methods, as well as include relevant docstrings for each method and class.
记录您的代码，包括函数和方法的所有变量和参数的类型提示，以及每个方法和类的相关文档字符串。
Build on the unit tests that have already been given to you in the file test_competition.py. You are expected to create at least three tests for each method. You should create these additional tests in a separate testing function in the given class.
基于文件中 test_competition.py 已提供给您的单元测试进行构建。应为每种方法创建至少三个测试。您应该在给定类的单独测试函数中创建这些附加测试。

Sample Competition 样品比赛

Here is the expected CUMULATIVE leaderboard after each race of each round after running the same runners that have been provided to you at the bottom of your file:
以下是每轮比赛后的预期累积排行榜，在运行文件底部提供给您的相同跑步者后：

SETUP 设置

runners = [ Runner("Elijah", 19, 'Australia', 6.4, 5.2), Runner("Rupert", 67, 'Botswana', 2.2, 1.8), Runner("Phoebe", 12, 'France', 3.4, 2.8), Runner("Lauren", 13, 'Iceland', 4.4, 5.1), Runner("Chloe", 21, 'Timor-Leste', 5.2, 1.9) ] competition = Competition(runners, 3, [0.5, 0.6, 1.2], [4.0, 9.0, 4.5])

Python 蟒

ROUND 1 回合 1

After Short Race: 短距离比赛后：

1st - Elijah (4) 2nd - Chloe (3) 3rd - Lauren (2) 4th - Phoebe (1) 5th - Rupert (0)

Text 发短信

After Marathon Race: 马拉松比赛后：

1st - Elijah (8) 2nd - Lauren (5) 3rd - Chloe (4) 4th - Phoebe (3) 5th - Rupert (0)

Text 发短信

ROUND 2 回合 2

After Short Race: 短距离比赛后：

1st - Elijah (12) 2nd - Chloe (7) 3rd - Lauren (7) 4th - Phoebe (4) 5th - Rupert (0)

Text 发短信

After Marathon Race (All DNF):
马拉松比赛后（所有DNF）：

1st - Elijah (12) 2nd - Lauren (7) 3rd - Chloe (7) 4th - Phoebe (4) 5th - Rupert (0)

Text 发短信

ROUND 3 回合 3

After Short Race: 短距离比赛后：

1st - Elijah (16) 2nd - Chloe (10) 3rd - Lauren (9) 4th - Phoebe (5) 5th - Rupert (0)

Text 发短信

After Marathon Race: 马拉松比赛后：

1st - Elijah (20) 2nd - Lauren (12) 3rd - Chloe (11) 4th - Phoebe (7) 5th - Rupert (0)

Text 发短信

FINAL LEADERBOARD 最终排行榜

1st - Elijah (20) 2nd - Lauren (12) 3rd - Chloe (11) 4th - Phoebe (7) 5th - Rupert (0)

Text 发短信

Description 描述

race.py

runner.py

competition.py

test_competition.py

/home/test_competition.py
/首页/test_competition.py All changes saved 保存所有更改

Console will be displayed here after running your code

Workspace 工作