GSGT uses several environment variables for its configuration, such as to control location of scenarios and location of exported scenarios.
Table 1. Environment Variables
| Variable | Description |
|---|---|
ADAPTATION_PATH
| Path to where adaptations are located. |
ATCOACH_GRID_PADDING
| Variable is used to extend ATCoach weather grid and magvar grid size by a padding in all directions. |
DSSC_REL
| Variable is set by "set_dssc" script on ERAM. It is used to limit adaptation display/selection based on national release on SCDP processors. |
exerciseStartTimeoutMin
| ATCoach environment variable that is used to set ATCoach engine start timeout. Needed by GSGT to set the same timeout as ATCoach. |
EXPORT_OPS_PATH
| Path where SIME OPS scenarios are exported. |
EXPORT_TTS_PATH
| Path where SIME TTS scenarios are exported. |
GSGT_PREVIEW_PATH
| Path to where temporary ATCoach preview files will be created when running with ATCoach engine. If the variable is not defined and ATCoach engine is used, the temporary files will be created in /tmp directory |
GSGT_SITE_DEFAULTS
| Path to where shared site definitions (atcoach.xml) and shared control file are located. |
GSGT_UTIL_PATH
| Path to where log and temporary files are stored by guplex utility. |
GSGT_WORK_PATH
| Path to where scenarios are located. |
SDRR_SCENARIO_PATH
| Path where SDRR scenarios are exported in EES mode. |
WX_PATH
| Path to where weather scenarios are located. |
GSGT can be started from the command line. The exact location of the executable can vary depending on the installation and environment.
Example 1. Start specific GSGT version
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
If the location of installed gsgt was added to the PATH, gsgt can be simply started using:
> gsgt
![[Note]](note.png) | Note |
|---|---|
|
Starting GSGT Editor from a command line while inside the scenario directory will automatically open that scenario. |
GSGT installed on the Linux systems can also be started form the program menu and icon located in the task bar. The menu lists a selection of all available GSGT version installed on the given system.
GSGT (SGET) version installed on the SCDP processors is started using set_dssc script that upon determination of the national release launches appropriate SGET version for the selected release.
GSGT can be started with various options which control its operation. The options are specified by typing a dash and then the desired letter(s) after gsgt on the command line. GSGT can also operate in several different modes (see Section 2.2.2, “GSGT Modes”)
Table 2. Program Parameters
| Parameter | Description | |||
|---|---|---|---|---|
| d# | ATCoach debug level. The debug level for the ATCoach engine will be set to '#', which must be an integer between 0 and 112. The default is 0. | |||
| -f, --nofullscreen | Not Full screen mode. GSGT will be stared in a window roughly half the size of the screen. | |||
| -v, --version | Displays GSGT version | |||
| -j, --jvn | JVN Rhumb engine mode. GSGT will be run using the JVN 'internal'engine, instead of the ATCoach engine.
| |||
| -r | Same as "-j" option (kept for backwards compatibility). | |||
| -S, --stereo | JVN Stereo engine mode. GSGT will be run using the JVN 'internal'engine, instead of the ATCoach engine. | |||
| -s, --sitedefMode | Site Definition editor mode. (see Section 2.2.2, “GSGT Modes” and Section 6, “Site Definition Editor”) | |||
| -T, --terminal | Terminal mode. (see Section 2.2.2, “GSGT Modes”) | |||
| -p, --proxy=[server/port] | Proxy server/port if needed to connect to Internet through proxy. (Linux version) | |||
| -G, --training | Training mode. (see Section 2.2.2, “GSGT Modes”) | |||
| -w, --wx or --wxMode | Weather editor mode. (see Section 2.2.2, “GSGT Modes” and Section 5, “Weather Editor”) | |||
| -n, --native | Use native graphics display. Default when running application remotely, unless explicitly specified otherwise. When running application remotely this is recommended for performance. | |||
| -R, --raster | Use raster graphics display. Default when running application locally, unless explicitly specified otherwise. | |||
| -g, --opengl | Use OpenGL rendering. | |||
| -a, --adsb=[version] | Explicitly specifying the version will force that version regardless what is adapted. Omitting the option will set adapted ADSB version if present, otherwise defaults to version 3. (Linux version) | |||
| -b | Same as "-a". (AIX version) | |||
| -h, --help | Display application parameters |
GSGT operates in several modes that are tailored to specific functionality, such as Terminal facility, or editing a limited portion of scenario, such as weather.
Table 3. GSGT Operation Modes
| Mode | Description |
|---|---|
| Normal Mode |
This mode is tailored to working with scenarios that simulate a Enroute (ERAM) system, the facility under test. The scenarios generate a set of non-radar messages per specification of ERAM system. |
| Terminal Mode |
This mode is tailored to working with scenarios that simulate a Terminal (Arts) system, the facility under test. The scenarios generate a set of non-radar messages per specification of Arts system. |
| Training Mode |
This mode in general works the same as Normal Mode with exception that when parsing adaptation GSGT will eliminate duplicate item names and the public names of the items will be used when exported SIME scenario. Additionally adapted aircraft characteristics are ignored and in their place specifically predefined list of aircraft characteristics is used with modified aircraft dynamics. Also instead of true north headings, a magnetic north heading with magnetic variation grid is used for heading specification. |
| Weather Mode |
This mode is designed for editing weather scenarios. Weather scenarios are adaptation independent and can be included in any normal scenario for weather simulation. |
| Site Definition Mode |
This mode is designed for editing shared ATCoach site definitions. It only
allows to create and edit ATCoach site definition scenario file in the directory
specified by the environment variable |
| EES Mode (ERAM Evaluation System) |
This mode is designed for running with ERAM Evaluation System (EES) and it's only available in a special build of GSGT. |
-
Provides options to create a New scenario, Open an existing scenario, Reload current scenario, Edit the current scenario, Save the current scenario, Save As the current scenario with a different name, launch the Scenario Manager, Update Database with information about the current scenario, or Exit the GSGT application. (see Section 3, “GSGT Scenarios”)
-
Preview allows you to review scenarios. The options presented are and . The Target preview displays only the targets over the map during scenario playback. The Full preview displays targets and also creates a logs which allow review of messages as they occur during scenario playback. (see Section 7, “Preview”)
-
The 'Import' menu provides options to import from a Gsgt Scenario, NAS SIM files, DYSIM files, TGF, SAR data, and RTF SIM files. (see Section 8, “Import Functions”)
-
The 'Export' menu provides options to export to SDRR (HCS version only), Write Sim Tape (HCS version only), SIME, FIRS (HCS version only), and TGF (HCS version only). (see Section 9, “Export Functions”)
-
The 'Reports' menu provides options to generate various reports based on currently open scenario. (see Section 10, “Reports and Tools”
-
The Help menu provides options to select (F1), (F2) and (F3). The GSGT Help brings up the GSGT on-line help system, About displays the About Gsgt dialog, Scenario Info displays the Scenario Information dialog, and Supplemental Help launches a user-customizable help function.
GSGT graphically displays various adaptation elements in the adaptation window, which is the main window for a GSGT session.
-
The pull-down menu is used to select map data for background display. The background functions may be displayed individually or in combinations. Possible background displays are:
-
Wind (WHITE arrows), Temperature (various colors), Pressure (BLUE and RED contours), Precip (various colors)
-
US Map (BLUE), ARTCC Map (ORANGE), Canada (BLUE), Mexico (BLUE), Satellite Map or Street Map (both require Internet connection)
-
range displayed as a filled shaded circle
-
range displayed as a filled shaded circle
-
contains a sub-menu with options to display data that applies to the entire airspace (every Center)
Fixes - contains a sub-menu with the following
VORs (White and PURPLE dots) VOR Labels (PURPLE letters) TACANs (OLIVE dots) TACANs Labels (OLIVE letters) NDBs (White and BLUE dots) NDB Labels (BLUE letters) Waypoint (TURQUOISE dots) Waypoint Labels (TURQUOISE letters) Fix Aliases (TURQUOISE dots) Fix Alias Labels (TURQUOISE letters) Airports - contains a sub-menu with the following
Airports (GREEN triangles) Airport Labels (GREEN letters) Airport Aliases (GREEN triangles) Airport Alias Labels (GREEN letters) Airways - contains a sub-menu with the following
High Airways (TAN lines and TURQUOISE points) Low Airways (TAN lines and TURQUOISE points) Other Airways (TAN lines and TURQUOISE points) Coded Routes (OLIVE lines with TURQUOISE points)
DPs (TURQUOISE lines and points)
STARs (TURQUOISE lines and points)
ADRs (TEAL lines, GRAY points and TURQUOISE points)
AARs (TEAL lines, GRAY points and TURQUOISE points)
ADARs (TEAL lines, GRAY points and TURQUOISE points)
ALines (GREEN lines and GRAY points)
DLines (GREEN lines and GRAY points)
-
Each center adaptation has its own sub-menu with options to display data that applies only to it. (see Section 3.1.2, “Adaptation Selection”)
- FAVs (FPAs) - Fixed Airspace Volumes/Fix Posting Area (GRAY: ARTCC controlled, ORANGE: Terminal controlled)
- Boundary (RED) - Area of responsibility (AOR) boundary.
- FP AOI (GREEN) - FP area of interest boundary
- Service Volume AOI (BLUE) - Service Volume area of interest boundary
- Service Volume Grid (TEAL) - Service Volume ATCoach grid represented by the default 16 nm cells
- Service Volume Cert Grid (TEAL) - Service Volume ATCoach grid for Cert represented by the default 16 nm cells
- Surv AOI (TEAL) - Surveillance area of interest boundary
- APD Boundary (YELLOW)
- Surv Sort Cells (GREEN grid) - When a radar is displayed along with the Surveillance Sort Cells, the cells that belong to the displayed radar will have cross-hatching of a matching color.
- TAVs (RED outline with YELLOW cross-hatching)
- SAAs (solid ORANGE lines, with dotted-line buffer area)
- AAVs (PURPLE)
- Clutter Zone Filters (GRAY)
- Adapted and scenario sector plans (GREEN)
- Scenario Sector Plan (GREEN) - Center sector boundaries.
Note Each level of the menu has a dashed line at the first item. Selecting the dashed line will "tear off" the menu and continue to display the menu after a selection is made.
-
Allows the user to enter any airspace item (such as a Fix or Airway) and will highlight the item and display a context box for it.
-
A selection for the Flight Level displayed in the GSGT Adaptation Window.
-
Provides a zoom function for the GSGT Adaptation Window. The zoom function is controlled two ways. The slide bar on the top right area of the window can be moved to set the zoom level. Clicking on the slide bar and then pressing the Page Down and Page Up keys will zoom the view in and out, respectively.
The scenario toolbar includes icons for most common options under the Scenario menu. The toolbar can be displayed or hidden by right-clicking anywhere on the main menu bar and selecting .
By clicking and dragging the toolbar handle (which looks like a double separator), the toolbar can be docked to either the top, bottom, left, or right of the main GSGT window or it can be left to float above the adaptation window below.
Status Bar, also referred to as Measurement Bar, located on the bottom of the main window is used to display measurement information from the map. The bar is automatically displayed and updated upon user action that triggers the measurement information.
To display lat/lon and X/Y system coordinates at any specific point, hold down the SHIFT key while mouse clicking in any particular location on the map. Holding down the SHIFT key and left-click dragging the mouse will additionally display spherical distance in nmi, heading, both true and magnetic, and delta X/Y system coordinates.
Right-clicking on any airspace item (such as a Fix, Airport, or FAV) will cause a context box to be displayed. A context box displays information about the airspace item. The contents of each context box depend on the type of item it refers to. For example, a context box for an Airport will display the Lat/Long (LL) and ICAO Code of the Airport. Context boxes also have a menu that is displayed by clicking on the buttons in the upper section of the box. The items listed in the menu depend on the item type.
When an item is selected, the color of the displayed item and the context box will match. The color used will be chosen from a list of colors, so that if multiple items are selected, they will be displayed with different colors (up to the number of colors in the list).
A context box can be closed by right-clicking again on the item, or by simply selecting x button on the window.
The About Gsgt dialog displays license information and the GSGT version. Additionally ADS-B version is also displayed if ADS-B is enabled.
Select from the GSGT Main Window.
-
Closes the About Gsgt dialog.
GSGT uses specialized dialogs (Editors) to create and edit various messages and data included in the scenario. The dialogs are designed to hide complexity of messages or binary data and to limit user errors and provide easier representation of the data in the form of plain language. Most of the fields in the dialogs were configured in a way to limit data to a valid input via drop down selection boxes, format limitation or range limitation. Required fields are colored YELLOW until they are filled in with valid data. Until all required fields are not filled in, the dialog may not be saved to prevent invalid or incomplete data in simulation.