Documentation‐English - dsasp/ArcheryTournamentManagerSupport GitHub Wiki

Archery Tournament Manager

An application to manage archery tournaments.

This documentation describes Archery Tournament Manager Version 1.1.2.

Features

  • Manage archery tournaments of any size. Use the app to manage your club championships with only a few archers, or manage a multi-day tournament with multiple competitions on each day.
  • Define tournament days and competitions taking place on each day.
  • Manage tournament registrations. Enter registrations individually and import registrations from a CSV file.
  • Configure bow styles and age groups for the tournament, or use the built-in options.
  • Group management. Manually assign registered archers to groups or use the automatic, rule-based assignment of archers to groups. The rule(s) for automatic group assignment can be easily defined in the app.
  • Configure tournament scoring. Use result categories to define which archers are scored together. The categories can be easily defined in the app.
  • Team support. Define teams and display the team results.
  • Tie-break support. Configure rules to apply when archers have the same number of points scored.
  • Results are available for each competition and as an overall result of the tournament.
  • Print registrations, archer groups and results.
  • Export registrations, archer groups and results as PDF file.
  • Export results as CSV (comma-separated-values) file. CSV file can be imported into a spreadsheet app.
  • Archive tournaments and their settings and restore them from the archive. You can export the archive to a file, and import the archive from a file.
  • The app runs on MacOS devices and requires no internet connection to run. However, access to online documentation and in-app-purchase require your device is connected to the internet.

App Versions

The app is available from the Apple App Store. Get Archery Tournament Manager from the App Store

There are two versions of the application. The free, limited version and the Pro version.

The free version of the app allows you to try out the app before you buy it. When you download and install the app from the App Store you always get the free version. The free version has the the following limitations:

  • the supported number of archers is limited to 50
  • the archive feature is disabled

Buy Pro Version

You can buy the Pro version via 'in-app purchase'. Download and install the app from the App Store. Check if it does what you need, then click 'Buy Pro Version' on the start screen.

Steps to manage a tournament

Notice: it is recommended to read through this documentation before carrying out the steps below.

The recommended steps to successfully manage a tournament are:

  1. Configure app settings.
    • Configure custom bow styles and age groups, or use the built-in settings. It is recommended to perform this step before configuring grouping and evaluation rules.
    • Configure rule(s) for automated group assignment. 1)
    • Configure result categories. 1)
    • Configure tie-break rules being applied when archers have same number of points scored.
    • Set 'organized by'. Setting is show in results, printouts and exported PDF documents.
  2. Create a new tournament.
  3. Configure tournament settings.
  4. Define tournament days and competitions on each day.
  5. Manage registrations.
  6. Define teams.

The following steps need to be done for each competition:

  1. Define the archers participating in the competition.
  2. Assign archers to groups.
  3. Enter scores.
  4. Ensure result categories and tie-break rules are correct.
  5. Display the result.

For a multi-day / multi-competition tournament you can also

  • Display the overall result

Note 1): Make sure you update grouping rules and result categories if new age groups or new bow styles are added after rules/categories have been defined.

Tournament

A tournament consists of one or more tournament days. Each tournament day can comprise one or more competitions. A tournament also contains registrations, i.e. the archers who have registered for the tournament.

There is one 'active tournament' at a time. The active tournament is the tournament you are working with. The active tournament is automatically saved when you close the app. When the app is opened, the status of the active tournament at the time of closing is restored.

The active tournament can be archived and you can restore the active tournament from the archive. Archive entries contain the tournament data and the settings available at the time of archiving.

The right-hand side of the start screen shows data for the active tournament. The navigation section on the left provides direct access to active tournament elements and other functions.

Manage the active tournament from the start screen. Click on 'Tournament' on the left to define basic tournament settings and to manage tournament days and competitions on each day.

Registrations

You need to register archers for the tournament before you can assign them to competitions or add them to teams. During the registration process you capture archer name, gender, age group, bow style and optional club information.

You can register archers individually or you can import registrations from a CSV (comma separated values) file. You can also use a combination of both.

The CSV file for import must have a specific format. Please check information in section Importing registrations.

You can deregister archer(s) if needed. This does remove archer(s) from all competitions, teams and results.

Manage registrations from the start screen. Click on 'Registrations' on the left.

Start number

Each archer receives a unique start number when being registered.

The app automatically assigns the start number when archers are registered individually. Automatically assigned start number have at least 3 digits (101, 102, ...).

If you import registrations from a csv file, the allocation of the start number depends on various conditions (see section 'Importing registrations' below).

Search

You can use the search function to search for specific archers. Enter a search term (start number, first name, last name, bow style, age group or club name) in the search field. Click on X to delete the search term.

Sorting

You can display archers sorted by properties. To do this, click on the symbol for sorting (arrow up,arrow down) and select the type of sorting.

Importing registrations

You can import registrations from a csv file. The import function is available on the registration screen. Click on the import icon to open the import screen.

Each line of the csv file must contain the following data fields, separated by a comma or semicolon:

   Start number, Last name, First name, Bow style, Age group, Gender

Please note: All data fields must contain a valid value. Empty data fields are not permitted.

Examples:

101, Doe, Jane, BHR, Adult, female
102, Doe, Monica, BHR, Senior, f
103, Doe, John, LB, Adult, male
104, Doe, Frank, LB, Adult, m

The separator used, i.e. comma or semicolon, must not appear in the actual data/values. Only one of the possible separators, i.e. comma or semicolon, may be used in a file.

The first line of the csv file can be a header line, i.e. the line does not contain any data but only the description/heading of the data fields.

Following the data field 'Gender', the file may contain further data fields, also separated by separators. However, these are not taken into account.

Start number

Only numbers are permitted. The start number is a positive, whole number. Zero is not allowed. The start number must be unique, i.e. it must not appear more than once in the file.

The start numbers from the csv file is used only if the following conditions apply:

  • Start numbers in the csv file are unique, and
  • There are no registrations at the time of the import

If registrations already exist, new start numbers are assigned. If the start numbers in the csv file are not unique, you will receive a message. You must correct the start numbers in the file to be able to carry out the import.

Last name

Allowed are letters, numbers and special characters. The separator must not be included.

First name

Allowed are letters, numbers and special characters. The separator must not be included.

Bow style

  • Letters, numbers and special characters are permitted. The separator must not be included.
  • The maximum length is 8 characters.
  • The spelling does not matter. Letters are automatically converted to capital letters.
  • Values for bow type in the file must be configured in the settings before importing.

Age group

  • Letters, numbers and special characters are permitted. The separator must not be included.
  • The maximum length is 12 characters.
  • The spelling is important. Upper/lower case is taken into account.
  • Values for age group in the file must be configured in the settings before importing.

Gender

  • Permitted values for the male gender are “m” and “male”, “men” and “gentlemen” are also accepted.
  • Permitted values for the female gender are “f” and “female”, “ladies” and “women” are also accepted.
  • Values “d” and ‘diverse’ are also permitted.

Upper/lower case is ignored for 'Gender', i.e. all spellings for the above values are permitted in the csv file. The input values for gender in the csv file are converted to either “male”, “female” or “diverse” during import, depending on the value.

Steps for importing registrations

  • Make sure that the file has the required format.
  • Make sure that the file has the extension “.csv”.
  • Select the separator used in the file (comma or semicolon).
  • Select “File contains a header line” if the first line of the file is a header line.
  • Click on the folder icon to select the import file. The dialog only shows '.csv' files.
  • Select the correct file and click on Open.
  • Check the information displayed. If the application was able to read the file, you will see a list of the registrations contained in the file. Each line contains the archer's name and columns for gender, age group and bow.
    • A green checkmark means that the value has been recognized and is valid.
    • A red X means that the value is unknown or not allowed ( see note 1 below )
  • Click on the import icon to import the displayed data.

Note 1):

A red X for “Age group” and “Bow” means that the value in the file has not yet been configured in the settings. You must configure all values in the csv file for the age group and bow style in the App settings before importing, or adjust the values in the file. Otherwise, the red X marks an invalid value.

Teams

You can create teams and add archers to these teams. Competition results will include the team results ( see 1) ). The team score is the sum of the team member scores. An archer can only be in one team at a time. Team members can be of any age or gender, and can use any bow type.

Use the search function to search for teams and team members. Enter the search term in the search field at the top right. Click on the ‘X’ to delete the search term.

You can use the sort function (icon with the double up/down arrow) to display the teams in alphabetical order.

Manage teams from the start screen. Click on 'Teams' on the left.

Note 1): To include team results in the result you have to checkmark result category 'Teams'. You do not have to create this special result category, it is automatically available as soon as teams are available.

Tournament day

A tournament day has a date and comprises one or multiple competitions taking place on that date.

Manage tournament days from the start screen. Click on 'Tournament' on the left to create, update and delete tournament days.

Competitions

A competition is the unit you will be working with most of the time when using the app.

The competition screen allows to manage participants, to manage archer groups, to enter points scored and to display the competition result.

Manage competitions from the start screen.

  • to create or delete competitions, click on 'Tournament' on the left.
  • to manage participants, archer groups, archer scores and to display the result of a competition click on 'competition name' on the left.

Define participants

You must define the participants of a competition. Participants in a competition are selected from the existing tournament registrations.

Go to the start screen and click on “Competition name” on the left, then click on Participants "Edit”.

The participants screen shows the archers registered for the tournament. The green symbol means the archer is taking part in the competition. Registered archers who are not selected for the competition are marked with a red symbol.

Click on the name to select an archer. Hold down the command key and click on several names to select several archers. Then click on the person icon with the “+” sign to add the selected archers to the competition.

Click on the person icon with the “-” sign to remove selected archers from the competition. Click on “Done” to save your updates and close the screen.

Search funktion

You can use the search function to find specific archers. Enter a search term (start number, first name, last name, bow style or age group) in the search field. Click on X to delete the search term.

The search function only searches the currently visible archers. If a filter is set, filtered out archers are not included in the search.

Define participants using a filter

Use a filter to display only archers with certain characteristics.

This is useful if you only want archers with certain characteristics to take part in the competition.

To set a filter, click on the 'filter' icon (3 horizontal lines) at the top, select the appropriate characteristics on the next screen. When done click 'Apply' to apply the filter. Only archers with the selected characteristics will be displayed.

To reset the filter, click on 'Clear filter' icon.

Example:

The example assumes that the age group 'Seniors' and the bow styles 'BHR' and 'LB' exist in the settings.

As part of your tournament, you have a competition in which only seniors (both, male and female) using bow styles BHR or LB take part.

  • Click on 'Filter'
  • Select 'Seniors' as age group
  • Select 'BHR' and 'LB' as bow styles
  • Select 'male' and 'female' as gender
  • Click on 'Apply'. Only archers with the above characteristics are displayed.
  • Click on 'Select all'
  • Click the person icon with the "+" sign to add the selection as participants.
The above steps can be repeated several times if necessary. This allows you to find archers with certain characteristics, and add them as participants to the competition.

Archer Groups

Archers taking part in a competition are organized into groups. The archers in a group shoot together. All archers in the competition must be assigned to a group. Only archers who are in a group can be scored and will be part of the result.

Each group has a number, i.e. the groups are named 'Group 1', 'Group 2', etc.

The grouping can be done manually or you can do an automatic, rule-based grouping. You can also use a combination of both methods. Please note that you must perform the automatic group assignment before you create groups manually. The automatic group assignment is only available as long as no groups exist.

You can move archers between groups by 'drag & drop'. The list on the right side of the groups screen (heading 'In no group') shows all archers that are not in any group. Use 'Drag & Drop' to move archers from the list to a group.

The number of archers in a group is not checked when manually moving archers into a group. It is up to you to ensure that the number of archers in a group is correct. The current number of archers in the group is displayed to the right of the group number.

You can remove a single group if the group is empty, or you can remove all groups at once.

Removing groups only removes the assignment of archers to groups. The archers in the removed groups are still included in the list of participants in the competition.

The app come with one built-in rule for arbitrary automated group assignment. You can define your rule(s) for automated assignment of archers to groups in the Settings.

Manage archer groups from the groups screen. Go to the start screen and click on the competition name on the left to open the screen. Then click Groups 'Edit'.

Groups screen

Groups are managed from the groups screen.

The group screen consists of two parts. The left-hand side of the screen shows the existing groups. The right-hand side shows a list of archers who have been defined as participants in the competition but have not yet been assigned to a group.

With the buttons at the bottom of the screen you can

  • Add a new, empty group manually.
  • Run automated, rule-based grouping. This function is only available as long as no groups have been created.
  • Exclude group numbers from the assignment. The function is only available as long as no groups have been created.
  • Move groups, including archers in the groups, to another competition.
  • Delete all groups. This function only deletes the group assignment. The archers in the groups remain as participants in the competition.
  • Remove all archers who are not assigned to a group from the competition.

You can use the icons at the top of the screen to

  • Return to the start screen (house icon).
  • Reset the group numbering. The groups are then renumbered starting with group number 1.
  • Print groups (printer icon).
  • Open the settings screen (gear wheel icon).

The groups screen supports “drag & drop” and has a search function.

Search function

To search, you must first define the search scope.

Click on 'Search in...' and select the search scope:

  • Groups - to search in groups (left side)
  • Archers - to search in the list of archers who are not in any group (right-hand side)
You can change the search scope at any time.

Enter the search text and then press enter to start the search.

Drag & Drop

The group screen supports 'Drag & Drop'. Click on an element, move the element to the desired location while holding down the mouse button and then release the mouse button.

You can use 'drag & drop' to

  • move an archer between groups
  • move an archer from the list of archers without a group (right) to a group
  • move an archer from a group to the list of archers without a group (on the right)
  • rearrange the order of groups

To change the order of the archers within a group, you must edit the group. To do this, click on the 'Edit' symbol of the group.

Excluding groups from archer assignment

The app allows to exclude groups from archer assignment.

This feature is useful if group numbers correspond to station numbers in a round, i.e. the group number identifies the station where an archer group will start the round. This approach is often used for 3D archery tournaments.

Excluding group numbers allows to leave some stations open when starting the round.

Group exclusion is managed from the event competition groups screen. Go to the start screen and click on the competition name on the left to open the screen. Then click Groups 'Edit'.

Example:

Let's assume there are 25 stations in a round and there are 20 groups of archers. You decided you don't want groups to start the round at stations 13, 14 and 15.

  • Ensure you have no groups defined. The feature is disabled if groups exist.
  • Click on the button showing a numbered crossed-out list.
  • Select group numbers 13, 14 and 15.
  • Click 'Done' to save your selection.

Moving groups to another competition

You can move groups and the archers in them from one competition to another if required.

Important, moving groups does reset the scores of the archers in the groups being moved.

Moved groups are always placed after existing groups in the target competition. The new group numbers in the target competition depend on the circumstances, but are usually not the original group numbers.

Groups can only be moved if the archers in the groups to be moved are not yet participants in the target competition. The app will display a warning and moving groups will fail.

To move groups, go to the start screen and click on the name of the competition on the left-hand side. Then click on Groups ‘Edit’. Click on the button that shows two person icons with an arrow pointing to the right. The screen for moving groups opens.

Example

Let's assume you are organizing a large tournament. There are so many archers that you have to divide them into two parallel competitions on each tournament day. You would first like to carry out the automatic grouping for all archers registered for the tournament, and then decided how the groups are to be divided between the two competitions.

For the following example, we will call the two competitions ‘Round-blue’ and ‘Round-red’.

  • Make sure that both competitions have been created in the tournament, but do not yet contain any participants or groups.
  • Make sure that all registrations have been entered.
  • Make sure that the required rules for automatic grouping have been created.
  • Go to the start screen and click on “Round-blue” on the left, then click on Participants ‘Edit’.
  • Add all registrations as participants to the competition. Close the participant screen.
  • Click on Groups ‘Edit’ to open the groups screen.
  • Make sure that there are no groups.
  • Run the automatic grouping with the rules you created.
  • Check the automatically created groups and decide how you want to divide the groups into the competitions.
  • Click on the button at the bottom that shows two person icons with an arrow pointing to the right. The screen for moving groups opens.
  • Select the groups you want to move.
  • Select 'Round-red' as target competition.
  • Click on ‘Move’ and confirm the action.
  • Check the participants and groups in ‘Round-red’. Done.

Reset group numbering

You can reset the group numbering. The existing groups are renumbered, starting with group number 1. If you have excluded some group numbers from archer assignment (see above), these will be omitted. The archers in the groups are not changed by this process.

To reset the group numbering, click on the button with the numbered list at the top of the screen. Confirm the reset in the dialog box that appears.

Archer Scores

An archer score consists of three components.

  • points scored
  • tie-breaker 1
  • tie-breaker 2

The tie-break values are used for ranking only if two or more archers do have the same number of points scored. You can configure tie-break values in app settings.

Once shooting is over, you collect the scoring sheets and enter points scored and tie-break values on the scoring screen.

Manage archer scores from the competition scoring screen. Go to the start screen and click on the competition name on the left to open the screen. Then click Scores 'Edit'.

Scoring screen

The scoring screen allows to enter points scored and tie-break values for the competition.

The scoring screen is organized by groups. When opening the scoring screen all groups are collapsed, i.e. you see only the group names. Click on '>' to display archers in a group. Click on '^' to hide archers.

The colored circle in front of each group indicates the status of the group. Red means no scores set. Yellow means some scores set. Green means scores for all archers in the group are set.

Use the search bar to find archers. Enter the search text, then press Enter. The search is not case-sensitive. Click on the 'X' in the search bar to clear the search text.

You can search for just first name or just last name, or you can search for 'firstname lastname'. You can also search for start numbers.

If you know the archer's group number you can go straight to the group, open the group and enter points scored.

Result

There is a result for each competition and there is an overall result if the tournament comprises more than one competition. Ranking in the overall result is done based on the sum of the points scored for each archer.

Each result consists of a set of user-defined result categories, e.g. 'Senior - male, BHR & TR' or 'Women, LB & HB'. Result categories are defined in app settings (see section below).

You do configure the result categories in app settings and then select the categories you want to actually include in the result on the result screen. The result is dynamic. You select the categories to be included. Make sure you define result categories covering all archers. Archers not covered by a category will not show in the result.

You can view the competition result from the competition result screen. Go to the start screen and click on the competition name on the left. Then click Result 'Show'.

The result screen displays the selected result categories.

The icons on the title bar of the screen allow to:

  • Navigate to the start screen by clicking on the house symbol.
  • Select result categories to be included in result. Click on 'Result Categories' at the top and check the categories you want to include.
  • Open the settings screen by clicking on the gearwheel icon. This is useful in case you want to check or update result categories.
  • Print the result. Click on the printer icon.
  • Export the result as PDF file. Click on the printer icon, in the print dialog select PDF - save as PDF.
  • Share the result.
  • Export the result as csv file.
  • Find archers and teams in the result. Enter a search term into the search text field on the top right. Click on X to clear the search.

The overall result is available from the start screen.

App settings

App settings are critical. They allow you to control key features of the app. Take the time to read the information below. You need to understand how app settings work and what they can do for you.

Manage app settings from the start screen. Click on 'Settings'.

Note: access to app setting is also available from various other screens via the gearwheel icon.

Bow styles

The bow types/styles used in a tournament.

The app does show WA/IFAA bow types at first start. You can use these built-in bow types, but you likely want to create custom bow styles. You can delete some or all of the IFAA bow types if you do not use them.

Bow style name is limited to 8 characters in length and must be all uppercase. The app will automatically convert mixed / lowercase input to uppercase.

Note: if you plan to import registrations from a csv file you must ensure values for bow style in the csv file are defined in settings before starting the import. The spelling in the csv file does not matter. The app automatically converts the values to capital letters.

Age groups

The age groups used in a tournament.

The app comes with a set of built-in age groups. You can use these built-in age groups, but you likely want to create custom age groups. You can delete some or all of the built-in age groups if you do not use them.

Age group name is limited to 12 characters. The name must be unique.

Note: if you plan to import registrations from a csv file you must ensure values for age group in the csv file are defined in settings before starting the import. Please note that values are case-sensitive. The age group defined in the settings must correspond exactly to the value in the file.

Result categories

Result categories define how scoring is done, i.e. the categories determine which archers are scored together. This applies to competition results and to the overall tournament result.

The app comes with one built-in result category named 'All together'. This category puts all archers, regardless of gender, age or bow style, into one result category. This is an example for a result category and most likely not what you need, but you can easily define custom categories in the app.

Important: archers do only show in the result if there is a category which includes the archer. Make sure you define result categories for all combinations of gender, age group and bow style used in the tournament.

Result category setup

A result category has the following properties

  • Category name. Name is required. Set a useful name to recognize the category later on. The name does appear as heading in the result.
  • Gender. Archer gender. Select one or multiple values.
  • Age. Archer age group. Select one or multiple values.
  • Bow style. Archer bow style. Select one or multiple values.

Your choice for gender, age and bow style determines which archers are scored together.

Note: result categories very often correspond to grouping rules (see below), i.e. you have a set of result categories and you have a set of grouping rules using similar choices for gender, age and bow styles. When using corresponding categories and rules, archers shooting together will also be in the same result category.

Result category order

Once you are done defining your result categories you should reorder them. The order defines where the corresponding category will appear in a result. The category at the top will be the first category in the result. You can reorder categories on the settings screen using 'drag & drop'.

You can select the categories you want to include in a result on the result screen. At the top of the result screen you will find 'Result Categories'. Click on it. You will see a list of all categories that have been defined in settings. Check the categories you want to include in the result.

Result category example

This example assumes age groups 'Adult', 'Senior' and bow type 'BHR' do exist.
Let's assume you want to score all male archers in age groups 'Adult' and 'Senior' using bow type 'BHR' together.

  • Go to the settings screen.
  • Click on the plus sign under Result Categories. This will add a new category called 'New category'.
  • Click on the name to edit the new category.
  • Enter a category name, e.g. 'Adults and Seniors - BHR'.
  • Select 'male' as gender.
  • Select 'Adult' and 'Senior' as age.
  • Select 'BHR' as bow style.
  • Click 'Done' to save the category.
  • Use 'drag & drop' to reorder categories if needed
  • Click 'Done' to close the settings screen.

Go to the result screen and click on 'Result Categories' at the top. You will see the new category in the list. Checkmark it to include it in the result, uncheck to exclude.

Archers missing from result

If you find some archers are not included in the result, you must check the bow styles and age groups of these archers and ensure there is a result category that covers them.

Archers do only show in the result if there is a result category which tells the app to include the archer in the result. Ensure you have categories for all combinations of gender, age group and bow style.

Note: the app will show information at the bottom of the result screen if there are archers who have been registered for the competition but are not included in the result.

Grouping rules

Grouping rules determine how archers will be assigned to groups when using the automated group assignment feature of the app.

You can manually change group assignment after automated group assignment is completed. You can also create additional groups and assign archers to or remove archers from groups.

Use drag & drop to move archers between groups. To adjust order of archers within a group click the edit symbol for the group and use drag & drop to reorder archers within the group.

Automated group assignment can be started only if no groups exists. You need to delete all existing groups to re-run automated archer group assignment.

Grouping rule setup

A grouping rule has the following parameters

  • Rule name. Rule name is required. Set a useful name to recognize the rule later on.
  • Rule description. Optional extended rule description.
  • Group size. The maximum number of archers in a group.
  • Gender. Archer gender. Select one or multiple values.
  • Age. Archer age group. Select one or multiple values.
  • Bow style. Archer bow style. Select one or multiple values.

Your choice for gender, age and bow style determines which archers can be put into a group. The groups created based on a rule do only contain archers with these properties.

Grouping rule 'Arbitrary'

The app comes with one built-in grouping rule named 'Arbitrary'. The group does perform arbitrary assignment of archers to groups. It will, if applied, automatically assign all archers participating in a competition to groups. You can only set the group size parameter. Archers are randomly picked and assigned to groups of the specified size.

This special group cannot be deleted and the rule is always applied after custom rules. You cannot move it from the end of the list via drag & drop.

Grouping rule example

This example assumes age group 'Adults' and bow types 'TR' and 'LB' exist.
Assume you want to get groups including female archers with age group 'Adults' and bow style 'TR' or 'LB'.

  • Go to the settings screen.
  • Click on the plus sign under Grouping Rules. A new, undefined rule is created.
  • Click on the new rule to edit.
  • Enter a rule name, e.g. 'Women - Adults, TR & LB'.
  • Select 'female' as gender.
  • Select 'Adults' as age.
  • Select 'TR' and 'LB' as bow style.
  • Click 'Done' to save the rule.
  • Click 'Done' again to close the settings screen.

The rule will now appear on the screen where you start automated archer group assignment. Checkmark the rule to apply it, uncheck if you do not want to use it.

Grouping rule order

Once you are done defining your grouping rules you should reorder them. The order defines the sequence in which rules will be applied. The rule at the top is applied first. Reordering can be done in app settings, or immediately before starting automated group assignment.

The app will apply the first grouping rule to all archers participating in a competition. Once this is completed, the next rule is applied to the remaining archers. This process is repeated until all archers matching a rule have been assigned.

Archers not assigned to a group

It is possible that not all archers were assigned to one of the groups after automated group assignment is completed. Archers not assigned do appear under 'Archers in no group' on the right.

If this is the case, you must check the bow types and age groups of these archers.

Make sure that

  1. bow types and age groups are defined in settings
  2. bow types and age groups are covered by a rule

Extended grouping options

The following grouping options are not available on the settings screen.
You can select them on the screen where you start automated group assignment.

Group padding

Automated group assignment does create groups including archers with selected properties only. The last group created by a rule can have less archers than specified in the rule's group size because there might be not enough archers with matching properties.
Checkmark 'Allow group padding', to allow adding of archers with any bow style to the last, incomplete group generated by a rule. Archers will be added until the group size set in the rule is reached. Archer gender and age must match the rule, but bow style can be anything.

Group by score

This feature allows to consider the result of an already completed competition for group assignment. There must be at least one other competition to use this feature.

If you checkmark 'Group by score', you will get a list of competitions to pick from. You will only see competitions with a date before the date of the current competition.

Select the competition you want to use, then start automated group assignment.

Archers who comply with the rule are divided into groups in descending order according to their previous score, i.e. archers with the highest score are placed in the first group. The last group contains the archers with the lowest score. Within a group, the first archer has the highest score.

Tie-breaking

There might be scenarios where multiple archers do have the same number of points scored. The app supports two criteria (tie-breakers) to define how to deal with such scenarios.

A tie-breaker is a positive number. You can use the number of misses, the number of shots w/ highest possible score, or something else.

The app first compares the total number of points to obtain the result of a competition. If two or more archers have the same number of points, 'Tie-breaker 1' is evaluated. If there is still no clear result, 'Tie-breaker 2' is also evaluated.

Tie-breaker values are entered on the scoring screen, i.e. you enter them when entering points scored. There are two columns for tie-break values on the scoring screen and in each result screen. The default column header is 'TB1' and 'TB2'. You can customize the headings (see below).

You can set a name for each tie-breaker. The default names are 'TB1' and 'TB2'. You can change the names. Name length is limited to 6 character.

The name is displayed on the scoring screen and in results.

Options:

  • Show in results. Select this option if you want to display the value in the results. A column with the value will then appear in the result.
  • Higher value is better. Check this option if a higher value of the criterion is better. Uncheck this option if a lower value is better.
Note: You can suppress the display of tie-break criteria in results (e.g. if you do not use them). However, the tie-break criteria will always be displayed on the scoring screen.

Tie-break criteria are defined on the settings screen.

Example:

You want to use the number of shots with the highest possible score (e.g. 20 points) and the number of misses as tie-break criteria for your tournament.

  • Go to the start screen and click on Settings
  • Enter '20s' as name for 'Tie-breaker 1'
  • Make sure 'Show in result' is checked
  • Make sure 'Higher is better' is checked
  • Enter 'Misses' as name for 'Tie-breaker 2'
  • Make sure 'Show in result' is checked
  • Make sure 'Higher is better' is not marked.
  • Click Done to save settings

The column headers for tie-break values on the scoring screen and in results are now '20s' and 'Misses'.

Paper size

Ensure the paper size is what is used in your printer. The parameter should be set automatically based on you system region setting, but you change it here if needed.

Organization

Enter an optional organization name. The organization name, if provided, will show on printed docs and other screens of the app.

Archive

The app offers the option of saving the active tournament with the settings valid at the time of archiving.

You can also restore an archived tournament with its settings from the archive. The currently active tournament and the settings will be overwritten.

Archive export/import is also supported. You can export the archive to a file, and import an archive from a file. Imported archive elements are marked with '(*)'. Existing archive elements remain unchanged.

The archive function is available on the start screen.

Click on 'Archive tournament' to archive the current state of the active tournament with the current settings.

Click on 'Archive', find the archive record you want to restore and click 'Load'. Confirm loading the archive record.

Printing

The app does support printing of selected data like registrations, groups and event / overall result. A printer icon is shown when information can be printed.

You can use the printing dialog to export data as PDF file instead of printing it.

Note: check the paper size in app settings before printing. Ensure paper size is what you use in your printer.

Privacy Information

All data is stored locally on the device. Removing the app does erase all user data. There is no automated transfer of data to other devices. The app can be used offline w/o any restrictions, but In-App-Purchase and access to documentation do require internet access.

Questions, Reporting Issues, Suggestions for improvement

There are 2 options how you can report issues, ask questions about the app or suggest features to improve the app.

  • Send an E-Mail to the contact E-Mail address available from the 'About' information.
  • Open an issue in this GitHub repository (if you know how to use GitHub)

If reporting an issue, please make sure to put the following information into the email / issue:

  • Description of issue along w/ a description of the scenario (flow of actions) causing the issue.
  • App version (see About screen)
  • MacOS version and type of your Apple computer
⚠️ **GitHub.com Fallback** ⚠️