Ground Radar Plugin For EuroScope - General
Ground Radar Plugin For EuroScope - General
- version 1.5 -
General
1
Table of Contents
1 Acknowledgements ................................................................................................................................... 3
2 Getting started .......................................................................................................................................... 3
2.1 Plugin updates ................................................................................................................................... 3
3 Global Menu .............................................................................................................................................. 4
3.1 Pin ...................................................................................................................................................... 4
3.2 Settings menu .................................................................................................................................... 4
3.3 Window menu ................................................................................................................................... 7
3.4 Functions menu ................................................................................................................................. 7
3.5 QNH ................................................................................................................................................... 8
3.6 Low Visibility Procedures status ........................................................................................................ 8
3.7 Safety Nets......................................................................................................................................... 8
3.8 Developer menu ................................................................................................................................ 8
4 Track presentation..................................................................................................................................... 9
4.1 Ground mode .................................................................................................................................... 9
4.2 Tower mode..................................................................................................................................... 10
4.3 Label field mouse functions............................................................................................................. 10
5 Track label menus .................................................................................................................................... 11
5.1 Callsign menu .................................................................................................................................. 11
5.2 Ground state menu ......................................................................................................................... 11
5.3 Stand assignment menu .................................................................................................................. 12
5.4 Manual stand assignment menu ..................................................................................................... 12
6 Windows .................................................................................................................................................. 13
6.1 2nd Traffic Situation Window .......................................................................................................... 13
6.2 Approach Window ........................................................................................................................... 13
6.3 Approach Path Window................................................................................................................... 15
6.4 Runway Configuration Window....................................................................................................... 16
6.5 RVR Window .................................................................................................................................... 17
7 Lists .......................................................................................................................................................... 18
7.1 Time To Threshold List..................................................................................................................... 18
7.2 Departure Timer List ........................................................................................................................ 19
7.3 Alerts List ......................................................................................................................................... 19
7.4 Arrival List ........................................................................................................................................ 20
7.5 Departure List .................................................................................................................................. 20
7.6 Stands List ........................................................................................................................................ 21
8 Safety Nets............................................................................................................................................... 22
8.1 Runway Monitoring and Conflict Alerting (RMCA) .......................................................................... 22
8.2 Conformance Monitoring Alerts for Controllers (CMAC) ................................................................ 22
9 Tag items and functions .......................................................................................................................... 24
9.1 Tag items ......................................................................................................................................... 24
9.2 Tag functions ................................................................................................................................... 24
2
1 Acknowledgements
This plugin contains code and/or ideas from the following sources:
- Raw radar data aircraft shapes are based on Pierre Ferran’s work on his vSMR plugin
- JSON parsing uses the JSON for Modern C++ library
- File transfers use the libcurl library
2 Getting started
The Ground Radar plugin has two modes. “Ground” mode is based on the SAAB A3000 A-SMGCS system,
and “Tower” mode on the SAAB RDP air situation display. Some settings are required in the used ASR file to
determine which mode to use, and to set up some of the necessary parameters.
If the plugin was provided in a package, all the necessary settings are most likely set already. If not, refer to
the Developer Guide for information on how to install and set up the plugin.
In case the plugin fails to load, download the latest runtime libraries.
When an update is available, the message box will show where to download the current version. The
update package contains the plugin dll, the current manual set and the plugin data files that are common to
all setups. Replace the existing files with the new ones but do not delete any files unless specifically asked
to do so.
3
3 Global Menu
3.1 Pin
Left-click to toggle permanently displaying the Global Menu on the screen. A box will be displayed around
the pin symbol when so. When not permanently displayed, the Global Menu will be hidden when the cursor
is outside the menu area and none of its submenus are open.
The ‘Pro mode’ setting determines what data will be displayed and how the radar tracks are correlated to
flight plans. With the setting off, the airport area will have perfect primary and secondary radar coverage
and all the aircraft are shown correctly correlated.
When ‘Pro mode’ is selected on, the radar coverage depends on the plugin and EuroScope setup, and for
the correlation the plugin first checks mode S availability (radar coverage and flight plan equipment suffix).
If available, it will be used for correlation. If not, the correlation state as reported by EuroScope (depending
on the ‘Professional mode’ settings in EuroScope’s General Settings) will be used.
The heading line is a 10 pixels long line drawn from the position symbol showing the heading of the aircraft.
“Auto” rotation for the 2nd Traffic Situation Window and APP Window sets the rotation to match the
primary window.
4
3.2.1.2 Tower mode
- Tracks
o History Sets the number of history dots to display (0-19)
o Prediction Sets the length of the prediction line in minutes (0-99)
o AltFilter Hi Hides labels above specified level in 100’s of feet (-10-999)
o AltFilter Lo Hides labels below specified level in 100’s of feet (-10-999)
The four label filtering options for the ground mode only apply to stationary tracks. The filters can be
temporarily disabled by moving the mouse cursor over an empty part of the Global Menu. When the cursor
leaves the area, the filters will be automatically re-enabled.
5
3.2.3 Lists submenu
- TTT
o DTT Toggles the DTT column on/off
o TYPE Toggles the TYPE column on/off
o WTC Toggles the WTC column on/off
o ETA Toggles the ETA column on/off
o STAND Toggles the STAND column on/off
- Dep Timer
o TYPE Toggles the TYPE column on/off
o WTC Toggles the WTC column on/off
o SID Toggles the SID column on/off
o ADES Toggles the ADES column on/off
- Alerts
o Items Number of flights to display
- ARR
o Items Number of flights to display
o RWY Toggles the RWY column on/off
o TYPE Toggles the TYPE column on/off
o WTC Toggles the WTC column on/off
o ADEP Toggles the ADEP column on/off
o ETA Toggles the ETA column on/off
o STAND Toggles the STAND column on/off
- DEP
o Items Number of flights to display
o TYPE Toggles the TYPE column on/off
o WTC Toggles the WTC column on/off
o EOBT Toggles the EOBT column on/off
o STAND Toggles the STAND column on/off
o ADES Toggles the ADES column on/off
o RWY Toggles the RWY column on/off
o SID Toggles the SID column on/off
- Stands
o Items Number of stands to display
6
3.3 Window menu
- 2nd Opens the 2nd Traffic Situation Window
- APP Opens the Approach Window
- Approach Path > Opens an Approach Path Window (select approach from list)
- TTT > Opens a Time To Threshold List (select runway from list)
- Dep Timer > Opens a Departure Timer List (select runway from list)
- Lists > Opens the Lists submenu
- Runway Conf Opens the Runway Configuration Window
- RVR Opens the RVR Window
The items in the Window menu are active only in the ground mode of the plugin, “Approach Path” only
when at least one approach has been defined in the plugin settings.
It is possible to insert text notes on the radar screen to act as reminders. They will stay fixed at the
geographical coordinates they are inserted to, the coordinates defining the center point of the note.
When creating a note, a text entry field opens to enter the note text. When the [Enter] key is pressed, the
note will be created at the current mouse cursor position.
The notes can be deleted one by one or all of them at the same time. When deleting one by one, the notes
are boxed to display their click areas. Clicking on one will delete the note. Pressing the [Esc] key or selecting
the “Delete…” menu item again will abort the operation.
The map list can be undocked from the menu by dragging it, the list then becomes the Maps Window. The
active folder must still be selected using the maps submenu.
7
3.5 QNH
Displays the latest QNH if a METAR for the airport has been received by EuroScope. When the QNH
changes, the background will be set to yellow color. Left-click to acknowledge the change.
When a safety net is switched off, its button is shown with a yellow background. See the Safety Nets
chapter for information on which alerts are connected to which system.
When selected on, the airport data displays the following for development use:
- Airport reference point (green crosshairs and circle), ICAO code and elevation
- Airport area, i.e. airport radius circle around the reference point (green dotted line)
- Runway end and threshold locations (marked with runway id in red color)
- Runway areas (red polygons, LVP versions with dotted lines)
- Runway buffer areas (yellow polygons, LVP versions with dotted lines)
- Runway crossings (red crosses)
- Aircraft stands
o Occupied and blocked in red
o Assigned in yellow
o Free but blocked from automatic assignment in dotted green
o Free and available for automatic assignment in solid green
8
4 Track presentation
In both the ground and tower modes, the track symbols and labels are colored according to the flight’s
status (arrival, departure or overflight/unknown). By default, the arrivals are yellow, departures light blue
and overflight/unknown tracks light grey. In the tower mode also the history dots and prediction lines use
the same coloring. In the ground mode all history dots use the overflight/unknown color and there is no
prediction line available. Hovering the mouse cursor over a label will show all data fields even if not
selected on in the settings.
ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM
CALLSIGN DRWY DEP CALLSIGN STAND CALLSIGN
ATYP WTC RMK ATYP WTC RMK ATYP WTC RMK
9
- WTC Wake turbulence category
10
5 Track label menus
5.1 Callsign menu
The Callsign menu for correlated tracks contains the following (unavailable ones shown with grey text):
- <Ground state> (Displays current ground state) Opens the Ground state menu
- Assume Assumes the track
- Trans <ID> Transfers the track to the indicated controller
- Man Tfr Opens a menu to manually transfer the track to any controller
- Free Drops the track
- FPL Opens the EuroScope Flight plan setting dialog
- Stand Opens the Stand assignment menu
- Uncorrelate Uncorrelates the flight plan from the radar track
- Correlate Correlate the radar track with a flight plan (enter the callsign)
Departure:
Arrival:
For compatibility reasons, the custom states set the following default states:
- On Freq Clears any default state if one had already been set
- De-Ice Clears any default state if one had already been set
- Line Up “Taxi Out”
- (empty) Departure: Clears any default state if one had already been set
Arrival: If “Parked” state had been set, sets “Taxi In”.
11
5.3 Stand assignment menu
The Stand assignment menu is used for various tasks related to arrival stand assignment. It will not open if
another controller is tracking the aircraft. The menu contains the following options:
12
6 Windows
To move a window, drag it from the title bar. To close it, click on the [X] button in the top right corner. To
resize (where available), drag the box in the bottom right corner.
A second Traffic Situation Window can be opened to display another view of the airport. It can be set up to
display the same background as the primary one but requires specific plugin maps to be created.
Left-clicking on the [+] button zooms the display in, [-] zooms it out. The available zoom range is 1-100000
pixels/nm, the initial value being 100 pixels/nm. Each click increases or decreases the scale by 25%.
The Approach Window displays traffic around the airport (traffic on the ground at the airport is hidden).
The window displays the runway centerlines, and optionally extended centerlines and various maps.
To pan the view, drag somewhere on the display area. The panning is limited so that the airport reference
point must stay within the display area.
Left-clicking on the [+] button zooms the display in, [-] zooms it out. The available zoom range is 1-100
pixels/nm, the initial value being 10 pixels/nm. Each click increases or decreases the scale by 25%.
The arrow below the scale, shown if the display has been rotated, points to true north.
13
Hovering the mouse cursor over a label will display all data fields even if not selected on in the settings.
For the mouse functions in labels, refer to Label field mouse functions
ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM
CALLSIGN DRWY DEP CALLSIGN ARWY STAND CALLSIGN
AFL GS AFL GS AFL GS
ATYP WTC RMK ATYP WTC RMK ATYP WTC RMK
14
- RMK Scratchpad contents
- STAND Assigned arrival stand
• Highlighted after a change until acknowledged
- WTC Wake turbulence category
The Approach Path Window displays a vertical and horizontal view of a pre-defined approach. Distance
lines are shown at 1 nm intervals.
Hovering the mouse cursor over a label will display all data fields even if not selected on in the settings.
For the mouse functions in labels, refer to Label field mouse functions
15
6.3.2 Correlated track label
Departure Arrival Overflight/unknown
ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM ALRT FLTID_E ASSR_E COMM
CALLSIGN DRWY DEP CALLSIGN ARWY STAND CALLSIGN
AFL GS AFL GS AFL GS
ATYP WTC RMK ATYP WTC RMK ATYP WTC RMK
The Runway Configuration Window displays the current activity state of the airport’s runways as either
“DEP”, “ARR”, “DEP/ARR” or empty.
16
6.5 RVR Window
The RVR Window displays the RVR values if available in a received VATSIM METAR. For values reported as
variable, the minimum value is shown.
17
7 Lists
To move the lists, drag from the title bar. To close them, click on the [X] button in the top right corner.
When a scrollbar is displayed, the displayed items can be scrolled one at a time by using the “up” and
“down” triangle buttons above and below the scrollbar, by dragging the scrollbar or by clicking the scrollbar
area above or below the scrollbar itself (left-clicking scrolls by the number of items displayed, right-clicking
moves the scrollbar to the clicked position).
The Time To Threshold List displays a list of aircraft approaching that runway. The aircraft are added to the
list when they are established on the extended centerline (less than 0.6nm cross track error and ground
track within 20 degrees of the runway heading), are less than 30nm from the threshold and at an altitude
not more than 5000ft above the airport elevation. The list is sorted according to distance from the
threshold, with the closest aircraft at the top.
When an aircraft is on final to a runway other than the one it is supposed to land on, it will be added to the
list when it is a bit closer to the threshold, when the plugin code assumes that it will land on the runway
regardless of the runway assignment (less than 0.3nm cross track error, ground track within 10 degrees of
the runway heading and less than 4nm from the runway threshold).
18
7.2 Departure Timer List
The Departure Timer List displays aircraft that have recently departed from that runway. The aircraft are
added to the list when their groundspeed exceeds 40 knots and are automatically removed after a defined
time, 10 minutes by default. They can also be manually removed at any time by left-double-clicking on the
DT field. The list is sorted according to departure time, with the most recently departed aircraft at the top.
The Alerts List displays the active alerts and informations provided by the safety nets. The list is sorted to
display the alerts first, sorted according to the callsign, and then the informations.
- C/S Callsign
- ALERT Alert or information type
It is possible to cancel APM “Area penetration” and RVM “Restriction” alerts for a stationary track by left-
clicking the callsign in the Alerts List. The alerts will be automatically activated again when the track starts
moving.
19
7.4 Arrival List
The Arrival List displays flights inbound to the airport, estimated to arrive within the next 60 minutes. The
list is sorted according the estimated time of arrival, with the first to arrive on top. Setting a flight’s ground
state to “Parked” will remove it from the list.
The Departure List displays flights departing from the airport. The list is sorted alphabetically on C/S.
- C/S Callsign
- TYPE Type (selectable field)
- W Wake turbulence category (selectable field)
- EOBT Estimated off-block time (hh:mm) (selectable field)
- STAND Departure stand (selectable field)
- ADES Destination airport ICAO code (selectable field)
- RWY Departure runway (selectable field)
- SID SID designator (selectable field)
20
7.6 Stands List
The Stands List shows an overview of the stand allocation status at the airport. It also allows to manually
assign arrival stands, mark stands as occupied by a specific aircraft, or to block stands from automatic
allocation. Blocked stands are displayed with grey text if automatically blocked, red text if manually
blocked.
In addition to the Settings menu, the number of displayed stands can be adjusted by dragging the “down”
triangle button below the scrollbar when it’s visible.
Stands defined as an area (capable of parking multiple aircraft) will display the number of aircraft parked
and assigned to park there in the “PARKED” and “INBOUND” columns. It is not possible to manually set an
area stand as occupied by an aircraft.
The “Parked” menu shows all aircraft within 5nm of the airport reference point, and the “Inbound” menu
all aircraft arriving at that airport regardless of distance to the airport. When assigning a stand, it may take
a couple of seconds until it shows in the window as the stand assignments are refreshed every 5 seconds
within the plugin.
21
8 Safety Nets
In the ground mode of the plugin, the following potentially unsafe situations are highlighted by presenting
an alert indication in the track label. If more than one alert is active simultaneously, the first one in the
below order is shown. The alerts are also shown in the Alerts List, and by coloring the callsign item
appropriately in other lists. The safety nets can be toggled on/off using the buttons on the Global Menu
bar. The button that controls each alert is shown boxed before the alert name in the list below.
22
TWY CLOSED APM Taxiway closed alert
Aircraft on a closed taxiway
STATIONARY RPA CVM Stationary within the runway protected area alert
Arriving aircraft stopped inside a runway protected area
23
9 Tag items and functions
The plugin includes a number of tag items and functions to use in EuroScope flight lists or track labels.
Departure stand Displays the departure stand (only as long as the aircraft is still there)
Ground state Displays the aircraft’s ground state using the plugin’s custom texts for them,
including the plugin specific ground states. The displayed text for each state is
adjustable using the plugin settings.
Open Stand menu Opens the Stand assignment menu. When the aircraft has a changed stand
assignment, instead of opening the menu, this tag function clears the
“Information” color.
24