# Getting Started
## System Requirements

1. Microsoft Windows
2. Microsoft Office
   ```{admonition} Microsoft Office is optional on the CS laptop
   Competitions must be set up *initially* using an Excel Sheet, however Excel is not required to run the competition once it has been imported into Tempus
   ```

## Installation
Download and run the [Tempus Installer](https://tempus-releases.s3.amazonaws.com/Install+Tempus.exe).

An internet connection is required to install Tempus the first time, but is not required once the application
has been installed and run once.

The installer will download and install [.NET 7](https://dotnet.microsoft.com/en-us/download/dotnet/7.0) if it is not already installed on the machine.

## Setting up the Competition

1. Download the Competition Template from the [File Browser](ui.md#file-browser)

   ![Download Template](_static/FileBrowser_DownloadTemplate.png) 

2. Populate the [Skaters Tab](competitionsetup.md#skaters-tab)

   ![Skaters Tab](_static/GettingStarted_SkatersTab.png)

3. Populate the [Events Tab](competitionsetup.md#events-tab)

   ![Events Tab](_static/EventsList_Completed.png)

4. [Import the Excel File](competitionsetup.md#importing-the-excel-file) into Tempus

   ![Import Excel File](_static/ImportExcelFile.gif)

5. Configure the [Competition Settings](ui.md#competition-screen)

   The competition name, timing, and report settings should be configured prior to the meet.


## Running the Competition

1. Check the Competition settings.

   Multi-day competitions may have different settings for timing and reports which depend on the day. Check these settings at the start of the day.

2. Use the Races Screen

   The competition is managed mostly from the [Races Screen](ui.md#races).

3. Seed races, process results, rinse and repeat.

   The competition starts when all skaters are checked in; those who have not checked in are scratched. [Races are seeded](#seeding-races) and [reports are printed](ui.md#reports) & distributed. [Race results are entered](#processing-results), new [races are seeded](#seeding-races) and [printed](ui.md#reports), and this is repeated until the competition is complete. See the instructions below more details on these tasks.

### Save Periodically
Use the [Save Button](ui#header) to save the race periodically.

```{admonition} Tempus will allow you to close the application without saving
:class: warning

Tempus will not warn you if you close the application without saving. This is a feature that is planned, but not yet implemented. Saving the competition periodicially helps to mitigate any data loss if the application is closed accidentally, the application crashes, or if there's a hardware failure.

```

#### Save a Backup
It's sometimes helpful to save the file at competition milestones, such as the completion of a block, or the end of a day. Use the [File Browser and "Save As"](ui.md#save-as) button to save the competition at a given checkpoint.

### Scratching Skaters
Skaters who scratch ahead of the meet should be [removed from the Excel file](howto.md#how-to-scrath-a-skater-in-excel). Once the competition is imported, skaters must be [scratched from the Skaters screen](howto.md#how-to-scrath-a-skater-in-tempus). 

If a skater is scratched after a round has been seeded, it may be preferrable to mark them as DNS for the round. You may choose to [scratch the skater](howto.md#scratching-a-skater-in-tempus) and [reseed the round](howto.md#how-to-reseed-a-round) if you have time to reprint and redistribute [start lists](reports.md#start-list) and [timer & judges cards](reports.md#manual-judging-and-timer-sheets).

### Seeding Races
Races for regional competitions are often seeded in [blocks](glossary.md#block). Check the schedule to see which [blocks](glossary.md#block) of races is being seeded. 

Races for selection competitions are often seeded as-needed, usually only seeding one race per [racing group](glossary.md#racing-group). Seeding races in-advance can cause problems as races would need to be reseeded in the event of an injury or [scratched] skater(glossary.md#scratch).

#### At the start of the competition
  1. Shift-Click the races in the first block to select all races in a block. 
  2. Click the "Seed Races" button to seed the selected races.
  3. Print the seed report for each distance and verify the seeding
  4. Once seeding is verified, print the Start Lists for the selected races
  5. Publish the Start Lists (If a publish directory was specified)
  6. Print the judge and timer cards

#### At the start of a round
  1. Select a single race in the round to be seeded
  2. Click the green "Seed Round" button
  3. Print the seed report and verify the seeding
  4. Once seeding is verified, print the Start Lists for the selected races
  5. Publish the Start Lists (If a publish directory was specified)
  6. Print the judge and timer cards

### Processing Results
Both manual and electronic timers will deliver race results to the Competitor Stewards, who will use those results to seed subsequent rounds and print reports.

```{admonition} Qualifiers are identified by Tempus
Tempus will automatically qualify skaters based on the race results. Extra qualifiers are assigned after all races in a round have finished.

```

#### Manual Timing
  1. Compare the judge and timer cards to ensure the finishing order of the skaters across both sheets.
  2. Enter each skater number, starting from first-place.
  3. Enter each skater's finish time, starting from first-place.
  4. Enter any sanctions.
  5. Click the Save button
  6. Publish the race results (If a publish directory was specified)
  7. If the races was the last race in the round, print the results and seed the next round.
  8. Print the seed report and verify the seeding.
  9. If the round was a final, generate a distance classification report for the distance.

#### Manual Timing with Assistant
  1. Compare the judge and timer cards to ensure the finishing order of the skaters across both sheets.
  1. The assistant should each skater number, starting from first-place. Enter in the skater numbers as they're read.
  1. The assistant should each skater's time, starting from first-place. Enter in the skater times as they're read.
  2. The assistant should read any sanctions. Enter any sanctions.
  3. The CS should read each skater number, starting from first-place. The assistant will verify the skater number was recorded correctly.
  3. The CS should read each skater's time, starting from first-place. The assistant will verify the skater's time was recorded correctly.
  3. The CS should read read any sanctions. The assistant will verify the sanction was recoded correctly.
  4. Click the Save button
  5. Publish the race results (If a publish directory was specified)
  6. If the races was the last race in the round, print the results and seed the next round.
  7. Print the seed report and verify the seeding.
  8. If the round was a final, generate a distance classification report for the distance.

#### Electronic Timing
  1. Wait for the results to arrive. Press the "refresh" button to load results if they are not loaded automatically.
  2. Wait for the timing report to be printed by the timing team.
  3. Verify the results displayed in Tempus with the results printed on the timing report.
  3. Verify that any sanctions called by the officials are correct
  5. Publish the race results (If a publish directory was specified)
  6. If the races was the last race in the round, print the results and seed the next round.
  7. Print the seed report and verify the seeding.
  8. If the round was a final, generate a distance classification report for the distance.

## Post-Competition Tasks

1. Save the Meet File
2. Use "Save As" to Save a "FINAL" version of the meet file which can be shared with USS and the meet director.
3. Generate overall classifications for each division / racing group.
4. Generate and Save a protocol report
5. Send the protocol report to the meet director