6. Site Definition Editor

The Site Definitions Editor mode closely resembles the Scenario Editor, however it is designed only to create and edit ATCoach site definitions that can be shared by all training scenarios. Although the editor allows to create and edit multiple site definition files (atcoach.xml), only the default site definition file can be shared. The location where shared site definition files are stored is controlled by environment variable $GSGT_SITE_DEFAULTS.

The shared site definitions file is automatically loaded by all training scenarios when GSGT is started in Training Mode (see Section 2.2.2, “GSGT Modes”). The site definitions loaded from shared file are included in the scenario as read-only and can't be modified or deleted.

The GSGT Site Definitions Editor is executed using the same executable as GSGT but with option "-s". The exact location of the executable can vary depending on the installation and environment.

Example 5. Start GSGT in Site Definition Editor Mode

To execute GSGT version 7.4.1.2 that has been installed to the default location, type:

> /usr/local/gsgt.7.4.1.2/bin/gsgt -s

The main window of the Site Definitions Editor is very similar to the main window GSGT running in normal mode. Since it requires an adaptation to edit site definition files, all of the adapted items can view previewed on the display to guide the user when creating site definitions.

6.1. Load adaptation

Site Definitions Mode requires adaptation to be loaded to provide guide for the user to construct valid definitions. The selected adaptation is not saved with site definitions file so every time GSGT is started in this mode it requires the user to select a desired adaptation.

The adaptation selection is performed in same matter as when selecting adaptation for regular scenario (see Section 3.1.2, “Adaptation Selection”). Multiple adaptations can be selected to better aid creation of site definitions. Once the adaptation is loaded it may not be changed to a different adaptation during the same session. To change adaptation, close the GSGT editor and restart it to select a different adaptation.

To load adaptation select File->Load Adaptation from the Site Definition Editor Main Window.

6.2. Create new site definition file

The editor allows to create multiple site definitions files, however only the default, atcoach.xml, file is used for sharing site definitions among all training scenarios. The default file is automatically loaded by all training scenarios, and it's contents appears as read-only. Site Definitions editor is the only place where the contents of this file can be modified.

To create a new site definitions file, select File->New Site Definitions from the Site Definition Editor Main Window.

6.3. Open existing site definition file

The editor allows to edit multiple site definition files, but only one file can be open at a time. Note that only the default site definitions file, atcoach.xml, is used for sharing site definitions among all training scenarios.

To open a site definitions file, select File->Open Site Definitions from the Site Definition Editor Main Window.

6.4. Edit site definitions

The editing of individual ATCoach Pilot Positions, Pilot Prompts, Pre-Programmed Events and Site Definitions objects is identical to editing of the ATCoach site definition while running in Normal Mode (see Section 4.9, “ATCoach”).

To open Scenario editor to edit site definitions, select File->Edit Site Definitions or Edit toolbar button from the Site Definition Editor Main Window.

6.5. Save site definition file

After making changes in the site definitions, the file needs to be saved. The editor allows to save the site definitions under a new file or overwrite the existing file. Every time the definitions are saved user needs to select a file where they should be saved. Note that GSGT will always use the default file atcoach.xml in the save dialog.

To save current changes, select File->Save Site Definitions or Save toolbar icon from the Site Definition Editor Main Window.