A Q U I L O

Software for Student Riding Competitions

Installation and Documentation

Summer 2023

Preparing the Competition

Before You Start the Competition

The program has a couple of minimum requirements on how numbers for horses and riders are distributed.

  • The three riders in a team must have consecutive boot numbers, i.e. the program can NOT handle a team with boot numbers 4,5,9. The highest boot number of a team must be divisible by 3, i.e. 123,456,789,...
  • Horses have numbers. The first number of a horse in each round can be changed but the following horses are assumed to be numbered consecutively in the order of their appearance. Example: The 2nd round in a competition with 12 teams may have horses numbered 1,2,3,4 or 13,14,15,16 or 20,21,22,23. Before you create a round you will be able to specify the number of the first horse in the 'FirstHoNo' column.

Creating a New Competition

Start Aquilo. Select New Competition or Open from the File menu.

If you create a New Competition a window asking for general initial information about your competition will come up. Enter the name of the competition, its type and the number of teams. For any standard competition don't worry about the last setting "Start 2 riders per horse at".

You can open an Example Competition to see what it looks like when a competition is under way or all finished. The example directory is where you installed Aquilo.

The Empty Competition

What's under the mouse pointer? Move the mouse over a text field or table column to see a hint ('tooltip') on its meaning. Try this by moving the mouse to some editable area on the left or top and keep it in place for a short while without clicking. White table cells can be changed, gray ones not.

Fill in teams and riders on the left. Use the tooltips to find out where to put what. Please do not use nick names of riders, enter their complete first- and lastname. Save your work! Try the Print Team/Rider Table button at the bottom. Your web browser should display a table which you can use to make notes on teams and riders.

Creating Rounds: In the Define Rounds table at the top look at the parameters for the first round. Click Create on the very right to open a round window.

Viewing/Printing Output in web browser

All output is generated as HTML. HTML is the native document format of the web. You can view it with a web browser, edit it in a text processor (MS Word) or publish it directly on the Internet. To print the document please use the Print function of your browser.

All generated HTML files are saved in a directory named "htmlout" next to your data file and opened automatically in your standard web browser.

Tips for printing Aquilo output with your Browser:
  • - Disable header and footer lines, maybe except for date and time
  • - Enable something like "Print background colors/graphics/pictures".
  • - Use smaller/narrow margins(~10mm) on all sides.
  • - Some browsers let you scale the content in percent if it just doesn't fit on the page (90%)

Advanced: If you know HTML you may want to customize the title or style of all created HTML documents: Edit the file DocTitleTemplate.html in the "htmlout" directory. Aquilo inserts this file at the beginning of every HTML-page it generates.

Running Rounds

A New Empty Round

After creating a new round with the Create button in Define Rounds table you should check the grouping, numbers and starting order of all horses !!!

  • Are the horse numbers as expected? Does your Horse Manager know about them?
    No: Click Reset Round and adjust the FirstHoNo column in the Define Rounds table before re-creating the round.
  • Is the result-type correct for this round?
    No: Click Reset Round and adjust the Result column in the Define Rounds table before re-creating the round.
  • Are the groups of horses (Abteilungen) ordered correctly?
    Example: 15 horses = 6+9 = 9+6 = 6+6+3 = ...
    No: Click Reset Round and adjust the HoPerGrp column in the Define Rounds table before re-creating the round.
Once you are sure the round is configured correctly enter the names of horses in the Horse column. If you are not sure a horse will go at a certain position it's better to not enter a name and go with the head number only. Before the horses are presented, make sure with your "horse manager" that the groups and head numbers are correct.
For the dressage team competition, Aquilo will always list the horses in the same order you enter them - for ALL teams. If each team may choose it's own order for presenting the horses this might not correspond to the order on the starting list.

Draw Slips

To get the draw slips click Print Lots. Cut the pages with scissors to make the draw slips.
If you do not know all horses when you print the draw slips - the program will not mind.
During the draw don't forget to note which team/rider got which draw! You might want to print an empty starting list or a second copy of the draw slips for your notes.

Assigning Riders to Horses

Enter the riders boot no into the Rider column of the round window. You can also drag a boot no (gray area) from the team list on the left to the desired row in the round window.

To change a rider: Riders can also be dragged between rows inside the round window. To enter a new boot number double-click on the very left of the rider column in front of the old boot number and enter the new one. You do not need to delete the entire line, but for the new boot number to be recognized there must be a space between it and the rest of the line. To remove a rider delete the complete line.

To print a part of the round, drag over a gray column and then click Print Selected. The judges are very happy if they have a starting order before the first team/rider starts riding!

Enter Results and Finish Round

Enter the result value or a character for special results:
'e' eliminated; eg. 3 refusals in showjumping
'r' retired during course or disqualified
'n' no ranking for rider and his team (rider drunk? ;-)
For the dressage team competition, the team mark must be entered where you entered the team names, in the small field on the right.
To avoid the ranking of a team without influencing the individual rankings of its members use 'n' as dressage team mark.

The rows in the round window can be sorted by clicking on the column headers. This allows you to see the starting order, group by horse or team, or bring all results with diff=0.0 to the top. The order is maintained if you print the round.

Hint for next round: You can open two round windows side by side and drag riders from one round to the next.

Ranking

Preliminary Ranking

You may select any of the items in the Ranking menu at any time during the competition. Aquilo will assign ranking-points to eliminated riders once a round is complete. A round is complete when all results in this round are available. For all riders which are still competing Aquilo displays the minimum and maximum of possible ranking-points.

After the first two rounds of dressage and showjumping Team Result Details should give you a good preliminary impression of the final standings. Teams with riders still competing are shown with the minimal and maximal possible ranking-points. A rank is show once there is no theoretical chance that one team will overtake (will be overtaken by) another one, i.e. the maximum points of one team are smaller than the minimum of the team that will be ranked next.

You should print one of the "Individual Rankings" or "Team Result Details" sheets regularly. With those sheets in hand you are save even if all computers break down. Be careful not to show such a sheet to anyone, as this may spoil the excitement of the competition and the price- giving ceremony.

"Team Result Details" for a 12 team competition is tailored to fit on a single A4 landscape page if you reduce font size and margins (5mm). The ranking reports are also saved as HTML-files in the 'htmlout' folder.

Final Ranking

If you have entered all results in all rounds the word "Preliminary" and the list of the completed rounds should disappear from the title of the ranking pages. All Final Rankings, Overview and Team Result Details by Team Combined Ranking are meant to be handed out to all participants and to be published on the Internet.


Congratulations! You have done it! If you have a headache I hope it's not because you had to use this program but because you've had the hell of a time last night and a couple to many...

A Q U I L O