OpenRadarGuide: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
m (→‎Communication: change to FGCom3.0 and add Mumble)
No edit summary
(38 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[OpenRadar| Back to mainpage]]
[[OpenRadar|Back to mainpage]]
 
=='''''Preface'''''==
=='''''Preface'''''==
[[OpenRadar]] is a prototype to support Flight-Simulator ATCs in their work on our airports.
[[OpenRadar]] supports [[FlightGear]]-[[ATC#Air_Traffic_Control|ATCs]] when guiding/controlling [[Howto:Multiplayer|Multiplayer]]-traffic within FlighGear.  
<br /><br />
 
Some words to our project targets:
Some words to our project targets:
* '''Realism:''' That means we show all the data a real live ATC would need. For instance we simulate a radar antenna and perform one position update per antenna rotation. But we don't have professional ATCs, neither do we have professional pilots contacting our ATCs. So we have to make some compromises...  
* '''Realism:''' That means we show all the data a Real-Live ATC would need for his job. For instance we simulate a radar antenna and perform one position update per antenna rotation. But we don't have professional ATCs, neither do we have professional pilots contacting our ATCs. So we have to make some compromises to a Real-Life operation.  
* '''Usability:''' The application should be handy, behave consistently, and require almost no training. The ATC has other things to do than to fight with the application
* '''Usability:''' The application should be handy, behave consistently, and require almost no training. The ATC has other things to do than to fight with the application.


We hope that we met your needs and are happy to get feedback!
We hope that we met your needs and are happy to get feedback!


'''Important:''' We support you with tooltip texts, that appear when you hover over an active area with your mouse. They shall remind you of possible interactions that you may have forgotten. Try pointing your mouse everywhere - maybe there is something available that you missed until now...
'''Important:''' We support you with tooltip texts, that appear when you hover over an active area with your mouse. They shall remind you of possible interactions that you may have been forgotten. Try pointing your mouse everywhere - maybe there is something available that you missed until now...
<br /><br />
<br /><br />
----
----
=='''''Prerequisites'''''==
=='''''Prerequisites'''''==
===Internet===
===Internet===
Line 21: Line 23:
*as well for you ''(who hopefully will control many pilots at the same time)''
*as well for you ''(who hopefully will control many pilots at the same time)''
*as also for the pilots ''(who need both hands to control their plane)''.
*as also for the pilots ''(who need both hands to control their plane)''.
There may not be enough time for typing!


*'''MPchat''' is an integral part of FGFS and OpenRadar and needs no further installations. (ref.: http://wiki.flightgear.org/Howto:Multiplayer ) - so it is always available for communication between you and all pilots.
Typically available ways of communication are:
*'''MPchat''' is an integral part of FGFS and OpenRadar and needs no further installations. (ref.: http://wiki.flightgear.org/Howto:Multiplayer ) - so it is always available for communication between you and all pilots. You always should offer this option ''(and try to convince pilots to use a Radio-Option!)''.
*A '''Radio''' is not directly integrated into OpenRadar but must be installed in addition. Right now there are 2 versions in use:
*A '''Radio''' is not directly integrated into OpenRadar but must be installed in addition. Right now there are 2 versions in use:
**'''FGcom''' is the more realistic Radio-operation with realistic frequencies for each function and a limited work-range based on frequency.
**'''FGcom''' is the more realistic Radio-operation with realistic frequencies for each function and a limited work-range based on frequency.
:::If FGCOM is not yet installed, you need to install a "standalone version of FGCom 3.0", which then can be controlled directely from within OpenRadar. For installation see http://wiki.flightgear.org/FGCom_3.0, item "3 FGCom standalone".   
:::If FGCOM is not yet installed, you need to install a "standalone version of FGCom 3.0", which then can be controlled directly from within OpenRadar. For installation see http://wiki.flightgear.org/FGCom_3.0, item "3 FGCom standalone".   
:*'''Mumble''' is an easier to handle application, that provides "named groups" that people with the same reason move/change into. Thus Mumble is not limited by range and much easier to use for defining by "groups" which people will communicate with each other.
:*'''Mumble''' is an easier to handle application, that provides "named groups" that people with the same reason move/change into. Thus Mumble is not limited by range and much easier to use for defining by "groups" which people will communicate with each other.
:::If Mumble is not installed you may install it according to http://mumble.sourceforge.net/Installing_Mumble.
:::If Mumble is not installed you may install it according to http://mumble.sourceforge.net/Installing_Mumble.
:::To activate it see http://mumble.sourceforge.net/Mumbleguide
:::To activate it see http://mumble.sourceforge.net/Mumbleguide
:::The most used Mumble-server is "mumble.allfex.org"
:::The most used Mumble-server is "itpns.ddns.net"


===Java V7===
=== Java V7 ===
Make sure you have installed at least Version 7 of Java.  Verify and or Download the installation packages from:  http://www.java.com/en/download/index.jsp  
Make sure you have installed at least Version 7 of Java.  Verify and or Download the installation packages from:  http://www.java.com/en/download/index.jsp  


===OpenRadar===
=== OpenRadar ===
For the currently available Prototype of OpenRadar see http://wagnerw.de/OpenRadar.zip. Extract the content of this ZIP to a place where it is easy to find. Make sure you have read and write permissions for that directory.
For the latest stable version of OpenRadar see https://sourceforge.net/projects/openradar/files/
* Download "Latest Release" for the latest version prior to the new "Flight-Strip-Bay" version
* Download "Next Release" for the really newest version.
Prior to extracting move the ZIP to a place where it is easy to find. Make sure you have read and write permissions for that directory.
<br /><br />
<br /><br />
If you did already work with an OpenRadar installation you may want to
If you did already work with an OpenRadar installation you may want to
Line 44: Line 49:
** if you expect changes in the scenery etc. do not copy the the Airport (ICAO) directories
** if you expect changes in the scenery etc. do not copy the the Airport (ICAO) directories
* delete the BU-version only after you are sure you verified that all your personal data were transferred, i.e. still accessible!
* delete the BU-version only after you are sure you verified that all your personal data were transferred, i.e. still accessible!
<br /><br />
 
----
== '''''Startup''''' ==
== '''''Startup''''' ==
Inside the downloaded OpenRadar base-directory you will find start-scripts. See
Inside the downloaded OpenRadar base-directory you will find start-scripts. See
*for Windows: OpenRadar.bat
* for Windows: OpenRadar.bat
*for Linux: OpenRadar.sh
* for Linux: OpenRadar.sh
*for OSX: OpenRadar.jar
* for OSX: OpenRadar.jar
At Startup you will always be welcomed by the “OpenRadar – Welcome”. That window presents 3 TABs to define your preferences:
<br clear=all>
{|
=== OpenRadar-Welcome - Select Airport ===
|-
[[File:OpenRadar - Welcome-Linux.png|thumb|right|Welcome - Select Airport]]  
|[[File:OpenRadar - Welcome-Linux.png|thumb|Welcome ''(Linux)'']] || [[File:OpenRadar- Settings-linux.png|thumb|Settings tab ''(Linux)'']] || [[File:OpenRadar - Tweaks.png|thumb|Tweaks tab ''(Linux)'']]
OpenRadar will always start with this Window in which you define the airport on which you want to operate:
|}
* '''If this is the first time you work with OpenRadar you first must check/set your options also in all the other tabs!'''
For all data there are standard values given as defaults. If you do change any values, they will be saved and presented to you during the next start.
* If the wanted airport is not yet listed:
<br />
** type the wanted airport ICAO (e.g. KSFO or EDDF or ...) into the inputline left of "search" and click onto "search"
If this is the very first time you start OpenRadar, then you have to verify your “Settings” first, thus click onto the “Settings”-tab:
*** if that ICAO code is available, then OpenRadar will add it to the list
*** then a single mouseclick onto one of the listed airports will activate that selection
*** and will set a default into the "CallSign" field at the lower right corner. You may overwrite that here or later on during the session <small>(ref. chapter [[#Status_Informations]])</small>
** then you can review all settings prior you click onto Start
* If the wanted airport is already in the list of airports then you may directly start with a mouse-double-click onto that ICAO-code ''(or single click and then "Start" at the bottom)''
** a double-click on it will order OpenRadar to search and load all the required data <small>(into your local file "OpenRadar/Data/ICAO")</small>
** that may take some time → wait till the "Ready" appears in the lower Textfield → then click onto "Start"
* To delete an airport form your PC delete its ICAO code out of your local directory "OpenRadar/Data/"
 
<br clear=all>
=== Settings (Communication) ===
[[File:OpenRadar- Settings-linux.png|thumb|right|Settings - Communication]]
This window lets you define your communication settings:


=== OpenRadar-Welcome - Settings ===
==== ''FGCom (Radio/Voice Communication)'' ====
These settings are grouped into 3 parts:
===='''1) FGcom'''====
:OpenRadar can support up to 4 instances of FGcom in 2 ways:
:OpenRadar can support up to 4 instances of FGcom in 2 ways:
:#It can start and control FgCom instances that operate in the background as sub-tasks of OpenRadar (except for OSX where FgCom must be run in a separate Terminal window)
:#It can start and control FgCom instances that operate in the background as sub-tasks of OpenRadar (except for OSX where FgCom must be run in a separate Terminal window)
Line 69: Line 83:
:You select these modes of operation by the “'''FgComMode'''” selection:
:You select these modes of operation by the “'''FgComMode'''” selection:
<br />
<br />
:'''a) Internal:''' FGCom(s) are started and controlled internally by OpenRadar
:'''1a) Internal:''' FGCom(s) are started and controlled internally by OpenRadar
::For this mode you have to define all available fields to tell OpenRadar where your FGcom resides and what options shall be used:
::For this mode you have to define all available fields to tell OpenRadar where your FGcom resides and what options shall be used:
::'''Path:''' Here you define where your FGcom is installed.
::'''Path:''' Here you define where your FGcom is installed.
Line 86: Line 100:
|on a LAN-server || \\''ServerName''\Central\FGFS || /home/YourName//.gvfs/fgfs on nas-server/fgcom||*)
|on a LAN-server || \\''ServerName''\Central\FGFS || /home/YourName//.gvfs/fgfs on nas-server/fgcom||*)
|}
|}
::::'''*) for OSX this does not apply because you will be starting FgCom in a Terminal window before starting OpenRadar'''
::::'''*) for OSX this does not apply because you will be starting FgCom in a Terminal window before starting OpenRadar, see 1b'''
</small>
</small>
::'''Executable:''' Here you define the program-name that shall be started
::'''Executable:''' Here you define the program-name that shall be started
:::*For Windows: "fgcom.exe" or  "anyName.bat"
:::*For Windows: "fgcom.exe" or  "anyName.bat"
:::*for Linux: "fgcom"  or  "anyName.sh"
:::*for Linux: "fgcom"  or  "anyName.sh"
:::*OSX: ''again for OSX this doe not apply''
:::*OSX: ''again for OSX this does not apply, see 1b''
::'''Server:''' There are 2 FGcom-servers available as of today:
:::Do not forgett to mark "FGCom3" if you are using the new FGCom versions (e.g. with FGFS ver.3.0)
::*delta384.server4you.de <small>''(we do suggest this one)''</small>
::'''Server:''' As of today there is only one FGCom-server available that also supports FGFS ver.3.0: fgcom.flightgear.org
::*fgcom.flightgear.org
:::''You still may be using fgcom01.flightgear.org in a group in that all users use this server''
::'''Client:'''  must always be “localhost”
::'''Client:'''  must always be “localhost”
::'''FGcom Ports:''' The here defined values are crucial for the operation because:  
::'''FGcom Ports:''' The here defined values are crucial for the operation because:  
::*They are the only connection between the OpenRadar and FGcom. So you must define those the same in OpenRadar as well as in FGcom !!
::*They are the only connection between the OpenRadar and FGcom. So you must define those the same in OpenRadar as well as in FGcom !!
::*They also define how many “Radio Units” (COM0, COM1, etc.) are generated within OpenRadar
::*They also define how many “Radio Units” (COM0, COM1, etc.) are generated within OpenRadar
::Simply provide a coma separated list of UDP Ports to be used by FGcom. But be warned: More than two are hard to handle!
:::Simply provide a coma separated list of UDP Ports to be used by FGcom. But be warned: More than two are hard to handle!
:::::e.g. 16661,16662
:::::e.g. 16661,16662
<br />
<br />
:'''b) External:''' OpenRadar controls a manually started instance of FGcom - via the defined Port.
:'''1b) External:''' OpenRadar controls a manually started instance of FGcom - via the defined Port.
::For this one you only need to define where that FGcom is running and what the connecting port is. e.g.:
::For this one you only need to define where that FGcom is running and what the connecting port is. e.g.:
::*'''Client:''' localhost
::*'''Client:''' localhost
::::<small>If you want to run FGcom on a different PC you must define here the IP of the remote PC and you must start FGCOM on that PC with the option -s,
::::<small>If you want to run FGcom on a different PC you must define here the IP of the remote PC and you must start FGCOM on that PC with the option -s,
:::::e.g. "fgcom -Sdelta384.server4you.de  -p16662  -i1 -o1 -s192.168.178.23" </small>
:::::e.g. "fgcom -Sfgcom.flightgear.org/  -p16662  -i1 -o1 -s192.168.178.23" </small>
::*'''FGcom Ports:''' 16661,16662  ''(if e.g. 2 FGcom instances were started)''
::*'''FGcom Ports:''' 16661,16662  ''(if e.g. 2 FGcom instances were started)''
<br />
<br />
:'''c) OFF:''' No FGcom support
:'''1c) OFF:''' No FGcom support (e.g. using MUMBLE or similar)
::That means that You do not want to work with FGcom during your ATC-session – thus you do not need to define any of the fields and there will not be defined any Radio (e.g. COM0) in OpenRadar. This mode is not suggested!
::That means that You do not want to work with FGcom during your ATC-session – thus you do not need to define any of the FGCOM-fields.  


===='''2) FG Multiplayer'''====
==== ''Alternative Radios (e.g. '''Mumble''')'' ====
:Here you find the server and connection port of FlightGears multiplayer server. It delivers the radar contact position informations and is used for chat. You won't have to change the settings, as long as the server won't change.
:Mark this option if you want to use e.g. Mumble - that has no functional implications, but will add an information to that effect onto your OpenRadar Operating-Panel.
:In case you experience problems with the outside you may check and/or choose any "'''''Server'''''" that is listed in http://mpmap01.flightgear.org/mpstatus/: Look for a server nearest to your location that has a status of "OK" and shows the most "totals".  
:If you want to use mumble see http://wiki.mumble.info/wiki/Main_Page and/or http://www.emmerich-j.de/Mumble/mumble.html for installation and operation
 
==== ''FG Multiplayer'' ====
:Here you find the server and connection port for the "FlightGear multiplayer server". It delivers the radar contact position informations and is used for chat. You won't have to change the settings, as long as the server won't change.
:In case you experience problems with the outside you may check and/or choose any "'''''Server'''''" that is listed in http://mpserver15.flightgear.org/mpserverstatus/: Look for a server nearest to your location that has a status of "OK" and shows the most "totals".  
:'''''PLEASE NOTE:''''' The "'''''Client port'''''" is the port used by your computer to talk with that server. If you want to use FlightGears internal chat parallel to OpenRadar, you must use a different port than FlightGear. Because of that, the default port of OpenRadar is 5001 ''(in order to differentiate it to the 5000 used in FGFS)''.
:'''''PLEASE NOTE:''''' The "'''''Client port'''''" is the port used by your computer to talk with that server. If you want to use FlightGears internal chat parallel to OpenRadar, you must use a different port than FlightGear. Because of that, the default port of OpenRadar is 5001 ''(in order to differentiate it to the 5000 used in FGFS)''.


===='''3) METAR'''====
==== ''Multiplayer Chat'' ====
:In addition to the standard List of ATC-commands selected out of of the drop-down-select-list (right click onto a target) there is a list of codes that you can type into the MPchat. See the list in "../OpenRadar/data/atcMessages/alias.txt". This list you may extend for any (standard) messages you want to sent to pilots via MPchat.
::Define as "Prefix" any character that you will use to indicate that the following is a command (default is a dot ".").
:::e.g. if you type ".rs" →  MPchat will replace that with "Reduce speed to ".
 
==== ''METAR'' ====
:OpenRadar retrieves the weather information via METAR messages from a server in the INTERNET. This information is being displayed and used to calculate the usability of runways and the air speed of the radar contacts.
:OpenRadar retrieves the weather information via METAR messages from a server in the INTERNET. This information is being displayed and used to calculate the usability of runways and the air speed of the radar contacts.
:If your airport is too small to be in that worldwide list, you can provide the code of another bigger airport with METAR data nearby in the sector.property file. But be aware that then your customers weather-settings may differ to yours, because they may use the standard FGFS-METAR-Source!
:If your airport is too small to be in that worldwide list, you can provide the code of another bigger airport with METAR data nearby in the sector.property file. But be aware that then your customers weather-settings may differ to yours, because they may use the standard FGFS-METAR-Source!


<br clear=all>
=== Flightplans ===
[[File:OpenRadar-Flightplans-Linux.png|thumb|tight|Flightplans]]
In order to exchange information’s about targets with other OpenRadar-locations, You must define the Server for the distribution of FlightPlan data between all OpenRadar-ATCs. So activate "enable flightplan exchange" and insert the server address:
<br>http://h2281805.stratoserver.net/FgFpServer/
<br>Under this address you can also check where ATC's are offering services right now.


Please click on the verify button to have your settings checked prior to returning to the left/primary tab:
Please click on the "Check Settings" button to have your settings checked prior to continue:


===Select Airport===
<br clear=all>
This is always the first window that you will see after starting OpenRadar.
=== Tweaks ===
<br />
[[File:OpenRadar - Tweaks.png|thumb|right|Tweaks]]
Select/enable according to the descriptions.
<br />Be aware that these option may influence the responstimes of your PC drastically!


But at first, the available airport list (e.g. EDDF, KOAK,..) in the center will be empty. So at first define a location:
<br clear=all>
<br />
=== FGFS ORCAM ===
[[File:OpenRadar_-_FGFS_ORCAM.png|thumb|right|FGFS ORCAM]]
This is an additive feature to OpenRadar, that enables you to view OpenRadar targets as Models - e.g. while they are taxiing on GND or are approaching/departing your airport. For this you can position your "Viewpoint" where you want and watch from there.


In order to '''define a new work-location''' simply enter the airport code (ICAO) or a part of the name into the search field and hit “search”: The list below then shows the results found in the airport database delivered with OpenRadar. There may be found several, so click on the one wanted and then activate the button "Download Scenery". Be patient and watch the Info-Field at the bottom: This first download of the required scenery will take some time before you see a "Ready"!
For details on how to install and operate see: [[OpenRadar_FGFS_ORCAM]]
<br />
 
'''If the airport wanted does already exist''', it will be shown in the big center-field, with an "(exists)" at the end.
Double click onto the one wanted (or select it with one click and then click onto start) and you are in the ATC seat.
<br /><br />
----


<br clear=all>
== '''''Operating''''' ==
== '''''Operating''''' ==
[[File:OpenRadar Prototype.png|thumb|270px|Oakland international used in new OpenRadar]]
[[File:OpenRadar Prototype.png|right|270px]]
'''Note: As of this version when the main screen starts in OSX it is completely minimized at the bottom left corner of the screen and you must expand this window.'''
'''Note: As of this version when the main screen starts in OSX it is completely minimized at the bottom left corner of the screen and you must expand this window.'''


The OpenRadar main screen is divided into three regions:
The OpenRadar main screen is divided into four regions:
#Top left you see the big '''Radar Map''' showing the airport, its surrounding, the navaids and the radar targets.
#Top left you see the big '''Radar Map''' showing the airport, its surrounding, the navaids, and the radar targets.
#Below it, bottom left, you see the '''MPchat Area''' for the FlightGear multiplayer chat feature.
#At the bottom of that Radar Map there is a line for '''Radar Options'''
#Bottom left you see the '''MPchat Area''' for the FlightGear MultiPlayer chat feature
#On the right side you see the '''Service Area''' with 4 subparts. From top to bottom those are  
#On the right side you see the '''Service Area''' with 4 subparts. From top to bottom those are  
##'''Status Information'''
##'''Status Information'''
##'''COM-Radios'''  <small>''(only if you have defined one or more)''</small>
##'''Radios for Communication'''  <small>''(only if you have defined one or more in chapter [[#Settings]] )''</small>
##'''Runway Manager''' to set up runways used  
##'''Runway Manager''' to set up runways used  
##the '''Flight Strip Manager''', where you can manage your radar targets.
##the '''Flight Strip Manager''', where you can manage your radar targets.
<span style="background: lightblue;">Please notice in the following description the lightblue background at some items, indicating changes that may not yet be available in your version of the OpenRadar!</span>
To see examples of actual ATC-events with OpenRadar you may visit http://www.emmerich-j.de/EDDF/Films/Films.html.
 
==== Radar Map ====
==== Radar Map ====
The radar map is the most complex part of OpenRadar, thus you have many options to zoom in on any area you are interested in. You can:
The radar map is the most complex part of OpenRadar, thus you have many options to zoom into any detailed area you are interested in. To do that you can:
* set four functional zoom levels by clicking onto '''''GROUND, TOWER, APP and SECTOR.''''' 
* zoom in and out using your mouse wheel <small>''(Mac: hold your right mousebutton pushed while moving over the radar-background in NorthWest respectively SouthEast)''</small>
* zoom in and out using your mouse wheel <small>''(Mac: hold your right mousebutton pushed while moving over the radar-background in NorthWest respectively SouthEast)''</small>
* adjust the map-center by dragging it with your mouse (click-hold left and drag)
* adjust the map-center by dragging it with your mouse (click-hold left and drag)
<span style="background: lightblue;">
* a double mouse-click onto the scope will move that point into the center of the scope
* <span style="background: lightblue;">a double mouse-click onto the scope will move that point into the center of the scope
* a double right mouse-click will center the scope back to your location
* <span style="background: lightblue;">a double right mouse-click will center the scope back to your location
* a double mouse-click onto a Flightstrip will center the "Target and Airport" into the center of the map and resize accordingly
</span>
* set the four functional zoom levels '''''GROUND, TOWER, APP and SECTOR''''' by zooming the radar map to your taste and then do a "right mouse-click" onto the zoom level wanted for it. Then you can always resize the map to that zoom again by just clicking onto the wanted zoom-level.
You may assign any current settings to any of the 4 zoom levels <small>(GROUND, TOWER, APP and SECTOR)</small> by a right mouse-click onto the wanted level''
 
<br /><br />
<br />
[[File:OpenRadar-Approach.png|thumb|right|250px|A typical tower operation]]
[[File:OpenRadar-Approach.png|thumb|right|250px|A typical tower operation]]
The '''''Radar-targets'''''  
The standard '''''Radar-targets'''''  
*do have a label attached with the following informations
*do have a label attached with the following informations:
::<small>''(See also the chapter [[#Flight-management]])''</small>
:{| class="wikitable" style="text-align:center"
:{| class="wikitable" style="text-align:center"
|-
|-
|UID||heading direction
|UID||heading direction
|-
|Airplane type||Flightplan||controlling ATC <small>(if not you)</small>
|-
|-
|Flight Level||Airspeed
|Flight Level||Airspeed
|}
|}
*and are displayed in 5 different colors:  
*and are displayed in 6 different colors:  
::<small>''(See also the chapter "Flight Strip Manager")''</small>
:{| class="wikitable"
:{| class="wikitable"
|-
|-
|align="center"|white||always the currently selected target, it's UID is also shown in the MPchat inputline <small>(e.g. see "D-Leon" who just is getting his "clear to land")</small>
|align="middle"|blue||That are all targets that you controll
<small>see e.g. "KL-666" on approach and "B777-20" ready for TakeOff
<br>their Flightstrips are placed to the left</small>
|-
|-
|align="middle"|blue||targets who's Flight-Stripe is placed to the left <small>(e.g. see "Side" (just started) and "D-AHGM" just going to intercept the ILS: These 2 PLUS the white "D-LEON" are actively controlled right then!)</small>
|align="center"|white||That is always the currently selected target for ATC messages. It's UID is also placed into the MPchat inputline for immediate messages
<small>see e.g. "G-MNKY" who just gets his taxi-instructions from you
<br>his Flightstrip may be in any position - it's control-status does not matter because you can talk to any target on the screen (but please do not interfere with the operation of other ATC's in the area!) </small>
|-
|-
|align="center"|yellow||targets who's Flight-Stripe is placed in the middle <small>(e.g. could be assigned to "jomo2" as an indication that we wait for him to "wake up" soon - because then he may become a danger to others when taxiing uncontrolled)</small>
|align="center"|yellow||may be used for targets that are not under your controll - but may ask for your attation soon or may become hazardous for your operations!
<small>their Flightstripes are placed into the middle</small>
|-
|-
|align="center"|green||targets who's Flight-Stripe is placed to the right <small>(e.g. see "jomo2" just parking - not actively controlled right now)</small>
|align="center"|green||targets who are not controlled by you
<small>see e.g. "CEMI198" just crossing in high altitude - outside your control
<br>their Flightstrips are placed to the right - that is also the position in which all new targets are placed initially</small>
|-
|-
|align="center"|gray||a neglected target or one for which there were no refresh data received from the MPserver for some time. In those cases the aircraft-type will be replaced by either "neglected" or by the time that elapsed since the last MPserver-update.
|align="center"|gray||is a neglected target or one for which there were no refresh data received from the MPserver for some time. In those cases the aircraft-type will be replaced by either "neglected" or by the time that elapsed since the last MPserver-update.
|}
|}


==== ''Radar-Options'' ====
[[File:OpenRadar-GND.png|thumb|right|250px|A GND layout with active PPN's]]
[[File:OpenRadar-GND.png|thumb|right|250px|A GND layout with active PPN's]]
The radar map has so many details to display, that it is impossible to display all at once. Because of that we display details depending on the zoom level. For instance we hide Fixes and/or Runway Numbers etc. at a certain level of zoom. Thus OpenRadar features an adaptive detail level. In addition you can hide types of data by the following buttons:
The radar map has so many details to display, that it is impossible to display all at once. Because of that we display details depending on the zoom level. For instance we hide Fixes and/or Runway Numbers etc. at a certain level of zoom. Thus OpenRadar features an adaptive detail level. In addition you can show/noShow types of data by the following buttons at the lower botton of the radar-scope:
<br />
[[File:OpenRadar-Radar-Options.png|250px]]
<br /><br />
'''''a) map:'''''
{| class="wikitable"
{| class="wikitable"
|-
|-
| '''''FIX''''' || Show/NoShow FIX's <small>(they will automatically be set "NoShow" above distinct scale-settings!)</small>
| style="text-align:center;" | STP || Show/NoShow the "Selected (target) To Pointer" ''(doggy)'', <small>an attachment to the mousepointer, showing
*the direction from the "active target" to the mouse-position (and reverse)
*and the distance and the calculated time for the target to get there|</small>
|-
|  style="text-align:center;" | PPN || Show/NoShow Parking/Gate names  <small>(those will automatically be set "NoShow" above distinct scale-settings!)</small>
|-
|  style="text-align:center;" | FIX || Show/NoShow FIX's <small>(those will automatically be set "NoShow" above distinct scale-settings!)</small>
|-
|  style="text-align:center;" | RW-FIX || Special Waypoints for automatic approaches/departures <small>(those will automatically be set "NoShow" above distinct scale-settings!)</small>
|-
|  style="text-align:center;" | NDB || Show/NoShow NDB's
|-
|  style="text-align:center;" | VOR || Show/NoShow VOR's
|-
|  style="text-align:center;" | Airports || Show/NoShow Airports, inclusive their groundlayout <small>(You may double-click onto a wanted airport and zoom in to see the layout)</small>
|-
|-
| '''''NDB''''' || Show/NoShow NDB's <small>(they will automatically be set "NoShow" above distinct scale-settings!)</small>
| style="text-align:center;" | Circles || Show/NoShow circles at distinct distances around your present location. The distance between the circles shown depends on the chosen zoom-factor!
|-
|-
| '''''VOR''''' || Show/NoShow VOR's
| style="text-align:center;" | GS Heights || Show/NoShow Glide-Slope-Heights along the centerline of the runway for landings. <small>(They will automatically be set "NoShow" above distinct scale-settings!)</small>
|-
|-
| '''''APT''''' || Show/NoShow Airports, inclusive their groundlayout <small>(You may double-click onto a wanted airport and zoom in to see the layout)</small>
| style="text-align:center;" | data mode || Defines different modes of Transponder-operations. <small>Try it and notice the differences in the Target-tags and Flightstrips.</small>
|-
|-
| '''''CIRC''''' || Show/NoShow circles at distinct distances around your present location. The distance between the circles shown depends on the chosen zoom-factor!
| style="text-align:center;" | update frequencies || allows you to vary the timespan between refreshing the radar-picture
|-
|-
| '''''GSH''''' || Show/NoShow Glide-Slope-Heights along the centerline of the runway for landings. <small>They will automatically be set "NoShow" above distinct scale-settings!)</small>
| style="text-align:center;" | contact tail || adds a tail of points to the targets - thus indicating the past way of the target
|-
|-
| '''''PPN''''' || Show/NoShow the "Park Position Numbers", ''those may not yet be available on all airports!''. <small>The PPNs will automatically be set "NoShow" above distinct scale-settings!)</small>
| style="text-align:center;" | layers || lets you select to add overlays to the radar:
|- style="background:lightblue"
*landmass = costlines and similar
| '''''StP''''' || Show/NoShow the "Selected (target) To Pointer" ''(doggy)'', <small>an attachment to the mousepointer, showing some data about the relation of the selected target to the location of the mouse-pointer (similar to line 3 in the "Status Informations", see above)</small>
*taramacs = the GND-shape of airports
|}
|}
<br />
'''''b) sounds:'''''
<br>Here you can select which "happenings" will produce an additional sound <small>(This list may change in further releases)</small>
<br /><br />
'''''c) STP:'''''
<br>
Show/NoShow the "Selected (target) To Pointer" ''(doggy)'' <small>(Same as in table above - just for faster access)</small>
<br /><br />
'''''d) STAR/SID:'''''
<br>
Show/NoShow the unique Waypoints defined in the STAR/SID's
<br /><br />
'''''e) PPN:'''''
<br>
Show/NoShow Parking/Gate names <small>(Same as in table above)</small>


The "Runway Manager" <small>(on the right side of the screen)</small> allows you to define which runway(s) should be used for landing and/or starting. This status is shown with little green/red dots at the runway end. See in the picture "A typical tower operation" above:
<br /><br />
*25L, 25R, and 18 are active (see the green and red dots at the ends)
*25L has in addition the blue approach center line and funnel, i.e. it is assigned for landings. This center line is drawn out for 100mi, helping you to align the arriving airplanes with the runway. In addition there is shown some kind of a funnel in a definable distance that may help you to align the planes coming via a base-leg for landing.
 
==== MPchat area ====
==== MPchat area ====
[[File:OpenRadar-MPchat.png|thumb|right|270px|The MPchat area]]
[[File:OpenRadar-MPchat.png|thumb|right|270px|The MPchat area]]
Line 221: Line 288:
**A '''''left''''' mouse-click onto a Flight-Stripe or onto a Radar-Target will place the Target-UID at the beginning of the entry-line
**A '''''left''''' mouse-click onto a Flight-Stripe or onto a Radar-Target will place the Target-UID at the beginning of the entry-line
**Then you may type or copy/past anything behind that - and send it out by ENTER
**Then you may type or copy/past anything behind that - and send it out by ENTER
*** The font-color will change to red if the message becomes too long for the multiplayer distribution - shortly bevor that the font-color changes to blue as an early warning.
*Generate a standard message:
*Generate a standard message:
**A '''''right''''' mouse-click onto a Flight-Stripe or onto a Radar-Target ''(or the TAB-key if the target is already active)'' will open a list with the available messages - select one with a left mouse-click
**A '''''right''''' mouse-click onto a Flight-Stripe or onto a Radar-Target ''(or the TAB-key if the target is already active)'' will open a list with the available messages - select one with a left mouse-click
**That will place the message into the entry-line - you may now review/edit it and then send it out by ENTER
**That will place the message into the entry-line - you may now review/edit it and then send it out by ENTER
*Repeat a message:
**With the '''cursor-keys "up" and "down"''' you can scroll thru the list of messages and place them into the '''''entry-line''''' - then you may edit it and send it out by ENTER.
*OpenRadar will always set the ATC-name <small>(as it appears on the very top of the service area - see the following chapter)</small> in front of the message.  
*OpenRadar will always set the ATC-name <small>(as it appears on the very top of the service area - see the following chapter)</small> in front of the message.  


Below that entry-line is the '''''scrollable list''''' of exchanged MPchat-messages. In that list the messages related to the selected target are colored cyan. With the button "'''''SEL'''''" you set a filter to show only the messages related to the selected target. This filter will be reset as soon as you select another target - or by clicking onto "'''''ALL'''''".
Below that entry-line is the '''''scrollable list''''' of exchanged MPchat-messages. In that list the messages related to the selected target are colored cyan. With the button "'''''SEL'''''" you set a filter to show only the messages related to the selected target. This filter will be reset as soon as you select another target - or by clicking onto "'''''ALL'''''".


You may enlarge that area by grabbing the upper edge with the left mouse-button and move it upward. Of course that will reduce the size of the radar-screen -- so use it with care!
You may enlarge that MPchat-area by grabbing the upper edge with the left mouse-button and move it upward. Of course that will reduce the size of the radar-screen -- so use it with care!


==== Service Area ====
==== Service Area ====
Line 234: Line 305:


=====Status Informations=====  
=====Status Informations=====  
[[File:OpenRadar-Status_2.png|thumb|right|200px|The general Status Informations]]
[[File:OpenRadar-Status_2.png|thumb|right|200px|The general Status Informations (the here 3rd line will be removed soon!)]]
This area shows in 4 lines the most used status-informations:
 
<ol><li>A text box that allows you to see and change your MP-callsign. So you can quickly change it, if a second ATC takes another role at the same airport (TW/APP/GND/RADAR, etc). At the right of it is placed a clock with the UTC-time. Because you probably will always have international guests you should refer to that modern "Coordinated Universal Time" <small>(replacing nowadays the formerly used "Greenwich Mean Time" (GMT))</small>
This area shows in 4 lines the status-informations of your session <small>''(compare the picture)''</small>:
</li><li>In the second line you see the ICAO <small>(the international Code for airports)</small> and the long name of your airport. In addition you see  on the right the currently selected radar contact <small>(e.g. "jomo")</small>.
* The first line contains several informations:
</li><li>The third line lets you predict several values for that "radar contact" <small>(e.g. "jomo")</small>. Whenever you place your mousepointer somewhere on the Radar Map, the third line will give you several informations about that target:
::* "19:46 '''UTC'''" is the actual "Coordinated Universal Time" <small>''(replacing nowadays the formerly used "Greenwich Mean Time" (GMT))''</small>
*StP = "Selection to Pointer": That is the compass direction between the target and the mousepointer, in both ways (TO/FROM)
::* "5000/TL055" is the so called '''Transition Altitude''' for that airport/area, in which:
*Miles: The distance between the target and the mouspointer.
:::* 5000 gives the "Transition Altitude" in feet when climbing
*min: The time the target needs to get to that mousepointed area - '''IF''' the speed remains steady as is!! <small>In this example there is given a "n/a" (not available) which most probably means the plane is not moving (may be parked)!</small>
:::* TL055 gives the "Transition Level" when descending into that area <small>''(in FlightLevels: 1 FL = 100 feet))''</small>
</li><li>The fourth line shows the mostly needed weather information '''Wind''', '''Pressure''' and '''Visibility'''. If you hover your mouse over it, you can see the complete last METAR-message received, in it's original form. <small>(For help ref to http://wiki.flightgear.org/METAR#METAR)</small>. Please note that these values are similar to ATIS information: METAR directions is given in TRUE, ATIS in magnetic...
:::: Above that level the altimeter must be set to the standard pressure setting of '''1013''' hectopascals (millibars) or '''29.92''' inches of mercury
</li></ol>
::* At the very right is a text box that allows you to see and change your current '''MP-callsign'''. So you can quickly change it, if e.g. a second ATC takes another role at the same airport (TW/APP/GND/RADAR, etc). You may change that ID also when starting the OpenRadar. <small>(ref. chapter [[#Startup]])</small>
* The second line displays the '''[[http://en.wikipedia.org/wiki/International_Civil_Aviation_Organization_airport_code ICAO]]''' and the long name of your airport.
* The last 2 lines show the current '''[[Weather_reports]]''' <small>(also called ATIS or METAR)</small>:  
::* At the begining there will be placed a short summary of the flight-conditions:
::::{| class="wikitable" style="text-align:center"
!Code
!Meaning
!Cloud Ceiling
!Visibility
|-
|LIFR||Limited IFR||<500 ft|| visibility <1 nm
|-
|IFR||Instrument Flight Rules||<1000 ft || visibility <3 nm
|-
|MVFR||Marginal VFR||<3000 ft|| visibility <5 nm
|-
|VFR||Visual Flight Rules||>3000 ft||>5 nm
|}
::* With a mouse-click on the upper line only that line will be sent to the target
::* A mouse-click to the lower line will send both lines to the target
 
====='''COM-Radios'''=====
====='''COM-Radios'''=====
'''''if FGCOM'''''
[[File:OpenRadar-COM_2.png|thumb|right|200px|The COM-Setting (that can be none or up to 4)]]
[[File:OpenRadar-COM_2.png|thumb|right|200px|The COM-Setting (that can be none or up to 4)]]
According to the amount of FGcom-Ports you defined during setup <small>(compare chapter "3.1.1 FGcom")</small> you find here as many COM-Units (COM0 to max COM3). Each of them has a PopUp-List of Radio-frequencies available for the airport you are located on. You may
:According to the amount of FGcom-Ports you defined during [[#FGCom_.28Radio.2FVoice_Communication.29|setup]] you find here as many COM-Units (COM0 to max COM3). Each of them has a PopUp-List of Radio-frequencies available for the airport you are located on. You may
*choose a frequency out of the list by clicking onto the arrow at the right of the input-field
:*choose a frequency out of the list by clicking onto the arrow at the right of the input-field
*or empty the field by a right mouseclick and enter any other frequency wanted.
:*or empty the field by a right mouseclick and enter any other frequency wanted.
At the right of that field you find a "Push To Talk" (PTT) button that you can operate by mouseclick -- or you can use the shortcuts given in the following table.
:At the right of that field you find a "Push To Talk" (PTT) button that you can operate by mouseclick -- or you can use the shortcuts given in the following table.
:{| class="wikitable" style="text-align:center"
::{| class="wikitable" style="text-align:center"
!COMx
!COMx
!left on keyboard
!left on keyboard
Line 263: Line 355:
|COM3|| ||NumOff+Num7
|COM3|| ||NumOff+Num7
|}
|}
Please watch the color change of the PTT buttons to know, when you can speak.  
:Please watch the color change of the PTT buttons to know, when you can speak.  


In case you operate the FGcom in the "'''''controlled by OpenRadar'''''" mode <small>(compare the "FGComMode" in chapter "Startup")</small>, then
:In case you operate the FGcom in the "'''''controlled by OpenRadar'''''" mode <small>(compare the [[#FGCom_.28Radio.2FVoice_Communication.29|Setup]])</small>, then
*the radio label turns to red when FGcom is unable to establish a connection on this frequency. (Remember: OpenRadar has more frequencies available than FGcom knows of!!)
:*the radio label turns to red when FGcom is unable to establish a connection on this frequency. (Remember: OpenRadar has more frequencies available than FGcom knows of!!)
*you have an additional "'''''Restart'''''"-button: In case the communication becomes chopped or interrupted, you may click here to restart the FGCOM-program.
:*you have an additional "'''''Restart'''''"-button: In case the communication becomes chopped or interrupted, you may click here to restart the FGCOM-program.
<br />
<br />
'''''if e.g. MUMBLE'''''
:In case you use mumble there will be just a blank input-field. Into that field you may insert any text that will then show up in your advises to pilots. We suggest e.g. the to use the mumble-server:
::: '''itpns.ddns.net'''
====='''Runway Settings'''=====
====='''Runway Settings'''=====
[[File:OpenRadar-Runways_2.png|thumb|right|200px|The Runway Manager]]
[[File:OpenRadar-Runways_2.png|thumb|right|200px|The Runway Manager]]
[[File:OpenRadar-Runway-Settings.png|thumb|right|200px|The Runway Manager Settings]]
[[File:OpenRadar-Runway-Settings.png|thumb|right|200px|The Runway Manager Settings]]
Here you define the major variables for your airport operations: That are the assignments of the runways! For this purpose OpenRadar gives you a lot of precalculated and or default values to support your decisions findings and/or informations pilots may ask you about. See e.g. the pictures on the right:
Here you define the major variables for your airport operations: That are the assignments of the runways! For this purpose OpenRadar gives you a lot of precalculated and or default values to support your decisions. See e.g. the pictures on the right:
*From top to bottom OpenRadar lists all runways available for that airport. For each runway you may define unique operating/display values. For these values see the picture "OpenRadar-Runway-Settings" below, e.g. see the 07C <small>''(you open that by a right mouseclick onto the runway-name (07C))''</small>:
*From top to bottom OpenRadar lists all runways available for that airport. For each runway you may define unique operating/display values <small>''(see the picture "The Runway Manager Settings" below)''</small>. You open these settings by a right-mouse-click onto the runway-number ''(in the following describtion we clicked onto the "07R" in EDDF)'':
**In the header line you see left the now chosen runway to be edited, and at the left a button "'''''Copy to All'''''". With this switch you can copy the settings you make here to all the other runways - so e.g. for EDDF with its 8 settings you can save a lot! Only the values will be changed - all the selection-markers will remain as are in each unique setting table! These settings will then be saved separately for each unique airport in you private settings.
**In the header line you see left the now chosen runway to be edited, and at the right a button "'''''Copy to All'''''". With this button you can copy the settings you make here to all the other runways - so e.g. for EDDF with its 8 runways you can save a lot of time! With that copy only the numeric-values will be changed - all the selection-markers will remain as are in each unique setting table. ''<small>(e.g. the length-definitions will be copied for all - the markers "Landing" will remain unique!)</small>''. These settings will then be saved separately for each unique runway and airport in you private settings.
**With "'''''Main switches'''''" you define which functions may be available for that runway. Usually you can define for each runway as well a "Starting" as also a "Landing" function. In the given example for EDDF there is a complication: Per Law you are forbidden
**With "'''''Main switches'''''" you define which functions may be available for that runway. Usually you can define for each runway as well a "Starting" as also a "Landing" function. In the given example for EDDF there is a complication: Per Law you may
:::to use runway 36 at all --> thus disable both lines: All data for that runway disappear
:::'''not use''' runway 36 at all --> thus disable both lines: All data for that runway disappear
:::to use runway 18 for "Landing" only --> thus disable only "Landing": Just the Land-Option disappears
:::'''use''' runway 18 for "Starts" only --> thus enable "Starts" only
:::<small>''(How do you know those details? Well, as a good ATC you prepare yourself by reading the official airport data (or look for something like e.g. http://en.wikipedia.org/wiki/Frankfurt_Airport, see on that page in the right column)''.</small>
:::'''use''' runway 07L and 25R for "Landings" only --> thus enable only "Landing"
:*The "'''''Extended center line'''''" is the line you see in the above picture ''"A typical tower operation"'' at the right. If you want that line you may define how long it should be. Some people do not want it reaching over the whole screen. We suggest to limit it to the MPserver-range of 100 mi. It will only be visible for the runways defined for "Landing"!
:::<small>(Compare the picture "The Runway Manager" on the right: The left marks enable the function - the right ones enable the SID/STAR functions)
:::''(How do you know those details? Well, as a good ATC you prepare yourself by reading the official airport data (or look for something like e.g. http://en.wikipedia.org/wiki/Frankfurt_Airport, see on that page in the right column)''.</small>
:*The "'''''Extended center line'''''" are the blue lines you see in the picture "Typical runway/approach definitions" [[File:OpenRadar-Approach.png|thumb|right|250px|Typical runway/approach definitions]] at the right. If you want that line you may define how long it should be. Some people do not want it reaching over the whole screen. We suggest to limit it to the MPserver-range of 100 mi. It will only be visible for the runways defined for "Landing"!
:*The "'''''Distance markers'''''" are measurement markers on that "Extended center line". Here you define from were to were you want to have such markers ''(they may restrain your eyes if you use them all over!)''.
:*The "'''''Distance markers'''''" are measurement markers on that "Extended center line". Here you define from were to were you want to have such markers ''(they may restrain your eyes if you use them all over!)''.
:*"'''''Vectoring and base leg'''''" define that funnel that you also see in the above picture ''"A typical tower operation"''. Also this will be shown only for the "Landing" runways.
:*"'''''Vectoring and base leg'''''" define that funnel that you also see in that picture ''"Typical runway/approach definitions"''. Also this will be shown only for the "Landing" runways.
:One tip to the handling of the "Landing" runways: Those are always shown in the "ATIS" message. If you define two (or even more) - in that "ATIS" message appear all those with the ILS data, etc.! So if you use mainly one we suggest to define only one - and activate more if you actually assign an additional one. Otherwise the pilots may become confused of that many informations and you yourself may have problems to differentiate which line the target should follow!
<br>
 
Finally your picture will look similar to the right/above shown "The Runway Manager"!
*From left to right you see the following informations for each runway (if available):
*In that one you see from left to right the following informations for each runway:
:*The runway-name  
:*The runway-name  
:*Check-boxes to define if that runway is used at all, may be just for landings or just for starts or for both. The program prevents you from assigning a runway in both directions (e.g. 25R and 07L)
:*Check-boxes to define if that runway is used at all, may be just for landings or just for starts or for both. The program prevents you from assigning a runway in both directions (e.g. 25R and 07L)
:*A second check-box to display SID/STAR graphics for that runway <small>(if they are defined, check for them in .../OpenRadar/data/routes/''ICAO''/''ICAO''.xml)</small>.
:*A graphical display of the cross winds and and gusts: They are green from 0-5kn, orange 5-10kn and red above. When there are significant gusts that color-bar is divided into two. Typically the gusts then will be represented by the longer bar!
:*A graphical display of the cross winds and and gusts: They are green from 0-5kn, orange 5-10kn and red above. When there are significant gusts that color-bar is divided into two. Typically the gusts then will be represented by the longer bar!
:*Above that bar you see the fractions of head- and crosswind. You may use especially the crosswind-fraction to warn pilots if those are => 10 kn! <small>(Remember: You find the normal wind values in the METAR-data further up in the Status Informations)</small>
:*Above that bar you see the fractions of head- and crosswind. You may use especially the crosswind-fraction to warn pilots if those are => 10 kn! <small>(Remember: You find the normal wind values in the METAR-data further up in the [[#Status_Informations]])</small>
:*To the right follows
:*To the right follows
::*in the upper line the exact runway heading (as needed for older type autopilots)
::*in the upper line the exact runway heading (as needed for older type autopilots)
::*in the lower line the length and width of the runway in feet!  
::*in the lower line the length and width of the runway in feet!  
:*Then follow the ILS informations, if ILS is available for that runway. The data shown are: the ILS-beacon-name, the frequency, the glideslope, and the altitude at the threshold.
:*Then follow the ILS informations, if ILS is available for that runway. The data shown are: the ILS-beacon-name, the frequency, the glideslope, and the altitude at the threshold.
After you have defined all runways and activated your choice of active runways, you will exit the "Runway Manager" by moving the mouse-pointer out of it. Then the "Runway Manager" will reduce and show only the active runways. <small>(You may move the mouse very fast - then all runways remain visible)</small>. Click into that remaining "Runway Manager" to show again all runways.


====='''Flight Strip Manager'''=====
====='''Flight Strip Manager'''=====
Line 303: Line 404:
|distance to it||IAS+GND speed||Altitude (FL)||current heading
|distance to it||IAS+GND speed||Altitude (FL)||current heading
|}
|}
In addition the user may add some more informations in additional lines. We urge you to reduce these additional lines to a minimum, because already with 2 lines the list will become that long, that you must scroll constantly! These additional lines will be saved as target-data and inserted each time a new stripe is created for that target! We suggest to maintain some target-data and some flight data for all frequent visitors. See as a suggestion several 3rd line examples:
In addition You may add some more unique informations in additional lines. We urge you to reduce these additional lines to a minimum, because already with 2 lines the list may become that long, that you must scroll constantly! These additional lines will be saved as target-data <small>''(see ../OpenRadar/Settings/atcComments.xml)''</small> and inserted each time a new stripe is created for that target! See as a suggestion a typical last line for a unique target name:
:"ILS VOR FGC NRW || and personal remark"
:<small>This pilot knows how to use ILS, VOR, FGcom, the new Runway at EDDF || and personal remark</small>


"ILS VOR FGC NRW || GED MTR"
You are absolutely free to define your own codes and whatever. To do so:
<br /><small>This pilot knows how to use ILS, VOR, FGcom, the new Runway at EDDF || he is advised to approach via VOR GED and MTR.</small>  
* enter/edit those data by opening the "'''''Note Editor'''''" with a '''center mouse-click''' ''<small>(Mac: Alt + right mouse-click)</small>'' onto the stripe. There you have several areas to add unique informations:
:* At the top of this editor you can
::* select in which '''''native language''''' the "standard commands" shall be transmitted (in addition) to that target
::* mark if that target uses Radio ''(the label now says "FgCom", but you may use that for any Radio-usage)''
:* the upper, larger input-block at the bottom is planed to be used for additonal FligtPlan-data or extended lists of waypoints.
:<small>''The above data may be distributed to all ATC's.''</small>
:* the lower, smaller input-block you may use for your personal requirements, they will not be distributed, but they will be retrieved automatically each time that target reappears on your screen.
:* all other (Flight-Plan) data will be explained in the next chapter: [[#Flight-Plan & Flight-Management]]
* exit the Flight-Stripe-Editor clicking into any area outside of it.
<br>
You can '''''manipulate the listing''''' regarding the vertical and horizontal position of the flight strips:
* New radar-targets will always appear at the end of the list on the right side and will be colored in lightgreen (that green will disappear when you touch that lable first time - thus you always know which ones you have already actively noticed!)
* You can move the stripes in vertical order by drag and drop
* You can place them in three horizontal columns (left, middle and right) either by dragging them with the hold-down mouse button or by mouse-clicks left or right of the stripes ''(you may double-click to move directly from one side to the other)''
* with the "'''''AUTO'''''"-button at the upper edge of this area you can define that the stripes will be sorted automatically into groups according to their left/center/right position. This may be very irritating at first - so you may want to switch that "AUTO" off at first usages!
* The radar-targets will change their color according to the horizontal position of their stripe:
** the radar-targets for stripes at the right side will be '''green''' - these are all targets when initialized - i.e. they are not under your controll - any ATC in the area can take control of them
** the radar-targets for stripes in the center will be '''yellow'''
** the radar-targets for stripes at the left side will be '''cyan'''
On the radar-map the "cyan targets" will overlay the "yellow targets" - and the "yellow targets" will overlay the "green" ones!


"ILS VOR FGC NRW || KJFK 280° f510"
<br /><small>This pilot also can use ILS, VOR, FGcom, NRW || and will depart to JFK on a straight course of 280° on FL510"</small>
You are absolutely free to define your own codes and whatever. To do so
*enter/edit those data by opening the "'''''Note Editor'''''" with a right mouse-click ''<small>(Mac: Alt + right mouse-click)</small>'' while pressing  onto the stripe
*add additional lines by Strg+ENTER (remember: Not more than 2, please!)
*Always exit that Editor with the ENTER-key in order to transfer the data to the stripe!
*At the bottom of this editor you can also select in which '''''additional language''''' the "standard commands" shall be transmitted to that target.
You can '''''manipulate the listing''''' of the flight strips:
*New radar-targets will always appear at the end of the list on the right side
*You can move the stripes in vertical order by drag and drop
*You can place them in three horizontal columns (left, middle and right) either by dragging them with the hold-down mouse button or by mouse-clicks left or right of the stripes ''(you may double-click to move directly from one side to the other)''
*with the "'''''AUTO'''''"-button at the upper edge of this area you can define that the stripes will be sorted automatically into groups according to their left/center/right position. This may be very irritating at first - so you may want to switch that "AUTO" off at first usages!
*The radar-targets will change their color according to the horizontal position of their stripe:
**the radar-targets for stripes at the right side will be '''green''' - these are all targets when initialized!
**the radar-targets for stripes in the center will be '''yellow'''
**the radar-targets for stripes at the left side will be '''cyan'''
On the radar-map the "cyan targets" will overlay the "yellow targets" - and the "yellow targets" will overlay the "green" ones!
<br /> <br />
You cannot change these combinations of color and position -- but you might define your own definition of what the positions mean! We suggest the following:
You cannot change these combinations of color and position -- but you might define your own definition of what the positions mean! We suggest the following:
:'''''green''''' = right = initial position: Means not yet defined or not under my control (e.g. passing through on high altitude, is controlled by another ATC, etc.)
:'''''green''''' = right = initial position: Means not yet defined or not under my control (e.g. passing through on high altitude, is controlled by another ATC, etc.)
:'''''yellow''''' = center = I expect him to get under my control when in range (e.g. 60 mi), or he may be transfered to me by another ATC soon, etc. He may become a danger to the traffic controlled by me if he continues uncontrolled!
:'''''yellow''''' = center = I expect him to get under my control when in range (e.g. 60 mi), or he may be transfered to me by another ATC soon, or he may become a danger to the traffic controlled by me if he continues uncontrolled! etc.
:'''''cyan''''' = left = under my control (light cyan when active in the MPchat input-line!)
:'''''cyan''''' = left = under my control.
Again: That is a proposal - you can define your on assignments!
Again: That is a proposal - you can define your on meanings!


You can apply the following mouse-actions onto the stripes as well as onto the radar-targets:
You can '''apply the following mouse-actions''' onto the stripes as well as onto the radar-targets:
*a '''''single left''''' mouse-click '''''selects/activates''''' it, i.e. its radar-target becomes "light cyan" and its UID is set into the MPchat input-line. In addition
* a '''''single left''''' mouse-click '''''selects/activates''''' it, i.e. its radar-target becomes "light cyan" and its UID is set into the MPchat input-line. In addition
**its listed messages in the MPchat-list become colored cyan
**its listed messages in the MPchat-list become colored cyan
**<span style="background: lightblue;">and the "doggy" at the mouse-pointer displays data about the relation between that target and the mouse-pointer
**<span style="background: lightblue;">and the "doggy" at the mouse-pointer displays data about the relation between that target and the mouse-pointer
Line 342: Line 444:
*a '''''right''''' mouse-click shows the dialog to choose pre-defined ATC messages to be sent to the current contact
*a '''''right''''' mouse-click shows the dialog to choose pre-defined ATC messages to be sent to the current contact
*a '''''CTRL+left''''' mouse-click will define that target as '''''neglected'''''. Thus his radar-target will become just a light gray color, that will not overlay or otherwise disturb the radar-views.
*a '''''CTRL+left''''' mouse-click will define that target as '''''neglected'''''. Thus his radar-target will become just a light gray color, that will not overlay or otherwise disturb the radar-views.
<br /> <br />
 
----
=='''''Flight-Plan & Flight-Management'''''==
=='''''Flight-Plan & Flight-Management'''''==
There is now a Flight-Plan feature inside OpenRadar. With this you can define internal Flight-Plans that get distributed to all ATC's within the range of the target, as it moves from area to area. Thus every ATC can decide on first sight whether that flight affects his duties and how. This Flight-Plan can only be generated and/or edited by the ATC that is actually controlling the target at the given time. In future there will be added a common interface to existing Flight-Plan-Programs, so that the pilot himself can pre-define his flights – and OpenRadar takes over that data automatically in its internal Flight-Plan.  
There is now a Flight-Plan feature inside OpenRadar. With this you can define OpenRadar-internal Flight-Plans ("OR-FP") that get distributed to all ATC's within the range of the target, as it moves from area to area. Thus every ATC can decide on first sight whether that flight affects his duties and how. This Flight-Plan can only be generated and/or edited by the ATC that is actually controlling the target at the given time. Due to time-restraints/workload ATC's will only input the most required data (see in the following the "Mandatory fields") - thus that will never substitute a thorough flightplanning by the pilot - nor will ATC take the time to type ALL flightdata as dictated by the pilot!
<br /><br />
In future there will be added a common interface to existing Flight-Plan-Programs, so that the pilot himself can pre-define all data for his flights – and OpenRadar takes over that data automatically in its internal Flight-Plan. As of Feb.2015 this is already functional with the Flighplanning on "http://flightgear-atc.alwaysdata.net".


==='''Define/Edit a Flight-Plan:'''===
==='''Define/Edit a Flight-Plan:'''===
[[File:OpenRadar-Flightplanning.png|thumb|270px|The Flightplanning feature input sheet for OpenRadar]]
[[File:OpenRadar-Flightplanning.png|thumb|270px|The Flightplanning feature input sheet for OpenRadar]]
You open the Flight-Plan for a target by clicking with the “center mouse-button”
You open the Flight-Plan for a target by clicking with the “center mouse-button”
*onto the Flight-Strip of the target
*onto the Flight-Strip of the target
*or the target on the radar-screen
*or the target on the radar-screen
You can also open the "active" target by the '''^'''-key
*You can also open the "active" target by the '''^'''-key
 
'''Before''' you start defining a new plan
# click onto the button "Retrieve FP" - that will load any Flightplan that may be available on a compatable FP-system
# otherwise you should make sure all data become "newly intialized" click onto the button "Reset FP"
 
'''After''' the Pilot "Landed" and "closes" his FP you should use the "Close FP" so that plan will also be closed in the OpebRadar server


'''Controlling the ownership:'''<br>
'''Controlling the ownership:'''<br>
Line 360: Line 470:
* If it is “'''uncontrolled'''” click onto “control” and that field will indicate your “ownership” and avoid others to change
* If it is “'''uncontrolled'''” click onto “control” and that field will indicate your “ownership” and avoid others to change


*If it is “'''Controlled by …..'''” you must wait till the ATC controlling it now will
*If it is “'''Controlled by …..'''”
**either remove his “ownership” by   
**you must wait till the ATC controlling it now will
***clicking onto “Handover to” and selecting  
***either remove his “ownership” by   
****another ATC for takeover  
****clicking onto “Handover to” and selecting  
****or the “blank” for just removing that control.  
*****another ATC for takeover  
***or clicking onto the button “UnControl”
*****or the “blank” for just removing his control.  
****or clicking onto the button “Control” (besides the lable "Uncontrolled...")
**or the target gets outside the range of the indicated “Owner”. In that case the Flight-Plan  will be set to “Uncontrolled” automatically
**or the target gets outside the range of the indicated “Owner”. In that case the Flight-Plan  will be set to “Uncontrolled” automatically
**or you send the controlling ATC a mail asking him to release the target
**or you send the controlling ATC a mail asking him to release the target
Line 376: Line 487:
'''Mandatory fields of the OR-Flight-Plan:'''
'''Mandatory fields of the OR-Flight-Plan:'''
*'''Contact''' is the FGFS-UID of the target  (will be set automatically)
*'''Contact''' is the FGFS-UID of the target  (will be set automatically)
*'''Radio''' <span style="font-weight: bold; font-style: italic; color: rgb(255,0,0)">needs</span> to indicate that the target can use Radio (FGCom or Mumble or ..)
*'''Aircraft''' is the model-code of the target  (will be set automatically)
*'''Aircraft''' is the model-code of the target  (will be set automatically)
*'''Assgnd RWY''' <span style="font-weight: bold; font-style: italic; color: rgb(255,0,0)">needs</span> the planned runway for departure or landing. You assign the runway either by the PullDown or by DoubleClick onto the runway number in the “Runway Settings”
*'''SID/STAR'''  <span style="font-weight: bold; font-style: italic; color: rgb(255,0,0)">needs</span> the name of the SID/STAR, if requested by the pilot
*'''Departure''' is the departure Airport  (will be set automatically to your airport if on GND - or manual)
*'''Departure''' is the departure Airport  (will be set automatically to your airport if on GND - or manual)
*'''Destination''' needs the IATA-code of the destination (e.g. EDDF for Frankfurt)
*'''Destination''' <span style="font-weight: bold; font-style: italic; color: rgb(255,0,0)">needs</span> the ICAO-code of the destination (e.g. EDDF for Frankfurt)
*'''ETA''' is the “Estimated Time of Arrival” - it is automatically calculated based on the given aircraft type, altitude (CrsgAlt) and speed (Crsg.TAS)  (will be calculated automatically - you might override it if you know/want it more realistic)
*'''Crsg Alt''' <span style="font-weight: bold; font-style: italic; color: rgb(255,0,0)">needs</span> the planned (initial) cruising altitude for that flight (usually in FL)
*'''ETA''' is the “Estimated Time of Arrival” - that is automatically calculated based on the given aircraft type, altitude (CrsgAlt) and speed (Crsg.TAS)  (You might override it if you know/want it more realistic)


'''Optional fields of the OR-Flight-Plan:'''
'''Optional fields of the OR-Flight-Plan:'''
*'''native language''' is per default “en” for English. If you choose another language, then all your selected MPchat advises to that target will be sent in English and then repeated in that chosen “native language”
*'''native language''' is per default “en” for English. If you choose another language, then all your selected MPchat advises to that target will be sent in English and then repeated in that chosen “native language”  
*'''FgCom''' indicates that target can use Radio (FGCom or Mumble)
*'''Squawk''' shows the Squawk-Code you assigned to the target <small>(for details see [[Transponder]])</small>
*'''Squawk''' shows the Squake-Code you assigned to the target
*'''Waypoints''' keeps predefined waypoints (if required or sent by other flightplanning systems)
*'''Assgnd RWY''' shows the runway assigned to that target, as well for landing as for starting. You assign the runway either by the PullDown or by DoubleClick onto the runway number in the “Runway Settings”
*'''Route''' defines the SID, STAR, etc. assigned
*'''Altitude''' as assigned by ATC from time to time (not the planned/constant "Crsg.Alt"! (compare below))
*'''Altitude''' as assigned by ATC from time to time (not the planned/constant "Crsg.Alt"! (compare below))
*'''Code''' will be used in future when given by a more professional Flight-Planning system
*'''Code''' will be used in future when given by a more professional Flight-Planning system
*'''IFR/VFR''' may be defined by the PullDown
*'''IFR/VFR''' may be defined by the PullDown
*'''Route''' can be used to document a preplanned route
*'''Crsg.Alt.:''' Define the planned cruising altitude en route (usually in FL)
*'''Crsg.TAS.:'''  Define the planned TAS en route (usually as GND-speed)
*'''Crsg.TAS.:'''  Define the planned TAS en route (usually as GND-speed)
*'''Alt.Airports''' can be defined as needed deviations in case of bad weather etc.  
*'''Alt.Airports''' can be defined as a needed deviation in case of bad weather etc. at the planned destination airport
*'''Comments''' these are comments that will be kept together with the Flight-Plan
*'''Comments''' here you enter comments that will be kept together with the Flight-Plan - and are visible to all ATCs en-route
*'''Private notes''' are comments that remain with the ATC making these (stored then in the local file OpenRadar/settings/atcComments.xml) and will always be re-inserted whenever that target is visible to the unique ATC, independent of if he is the “active controller” or not.
*'''Private notes''' are comments that remain with the ATC making these (stored then in the local file OpenRadar/settings/atcComments.xml). These will always be re-inserted whenever that target is visible to the unique ATC, independent of if he is the “active controller” or not.


==='''Flight-management:'''===
==='''Flight-management:'''===
Line 402: Line 513:
* you can also use the '''^'''-key to open the FlightPlan of the active target.  
* you can also use the '''^'''-key to open the FlightPlan of the active target.  
Then continue as described in the following scenarios:
Then continue as described in the following scenarios:
<small>''(In these scenarios only the "Simulation" labels are shown - to see all possibilities see the summary at the end)''</small>


'''''1. A target appears on your airport'''''
'''''1. A target appears on your airport'''''
:[[File:OpenRadar-Flightplanning-lables-1.png|thumb|270px]]
:[[File:OpenRadar-Flightplanning-lables-1.png|500px]]
:There are no data filled in yet into the flight-plan from any ATC, and there is no ATC assigned yet. Thus
:There are no data yet filled in yet into the flight-plan from any ATC, and there is no ATC assigned yet. Thus
:*the tag-color is “green”
:*the text in the tag-color is “green” - i.e. you did not yet take control
:*the flight-strip background color is light green, in order to indicate that you did not yet do anything with it.
:*the flight-strip background color is light green, in order to indicate that you did not yet do anything with it - i.e. it asks for attention from you to decide what to do with it
:*a simple mouse-click or any other action will remove the green background.  
:*a simple mouse-click or any other action will remove the green background (and activate that target as usual - i.e. showing the lable-text and the MPchat messages for this target in cyan).


'''''2. You define a new Flight Plan'''''
'''''2. You define a new Flight Plan'''''
*Pull the Flight-stripe all the way to the left (mouse-drag or double click left of the FlightStrip). ''(If there is still another ATC the owner in charge, then you cannot take over prior that the other ATC released or transferred that target!)''
*Pull the Flight-stripe all the way to the left (mouse-drag or double click left of the FlightStrip). ''(If there is still another ATC the owner, then you cannot take over prior that the other ATC released or transferred that target!)''
*'''Generate the Flight-Plan:'''  
*'''Generate the Flight-Plan:'''  
:See the Informations given in the target-label and the stripe. e.g. when there is defined (just below the scope) in “map → data mode → Simulation (Transponder enabled)” it could look like:
:Compare the Informations given in the target-label and the stripe:
::[[File:OpenRadar-Flightplanning-lables-2.png|thumb|270px]]
::<small>''e.g. when there is defined (just below the scope) in “map → data mode → Simulation (Transponder enabled)”''</small>
:[[File:OpenRadar-Flightplanning-lables-2.png|400px]]
::{| class="wikitable"
::{| class="wikitable"
|-
|-
Line 420: Line 533:
|the pilot FGFS-UID
|the pilot FGFS-UID
|-
|-
|160*
|160°
|the current heading (now on ramp!)
|the current heading (now on ramp!)
|-
|-
|HaedSet-sign
|HeadSet-sign
|that pilot uses radio (FGCom or Mumble)
|that pilot uses radio (FGCom or Mumble)
|-
|-
Line 433: Line 546:
|-
|-
|260°
|260°
|is the straight heading EDDF (departure) to KJFK (destination)
|is the straight heading EDDF<small> (departure)</small> to KJFK<small> (destination)</small>
|-
|-
|BIBTI
|BIBTI
Line 447: Line 560:
|is the speed (still parking!)
|is the speed (still parking!)
|}
|}
:Also see the two fields for comments:
:*in the upper line at the bottom are the same data as in the target-label center-line
:*in the lower line are private comments from yourself to that FGFS-UID - they remain within your PC
<br>
<br>
*'''Departing:'''
*'''Departing:'''
**GND will use the data as shown to bring the plane to the HoldingPoint
**GND will use the data as shown above, to bring the plane to the HoldingPoint
**TWR will take over  
**TWR will take over  
**The runway-assignment will be removed automatically after Take-Off
**The runway-assignment will be removed automatically after Take-Off
<br>
<br>
*'''Transfer Control to next ATC (or blank) '''
*'''Transfer Control to next ATC (or blank) '''
::[[File:OpenRadar-Flightplanning-lables-3.png|thumb|270px]]
::[[File:OpenRadar-Flightplanning-lables-3.png|500px]]
*grab-move the FlightStrip left into the Scope and select the next ATC ''(or open the Flight-plan and select at “Handover to:”)''.
*grab-move the FlightStrip to the left into the Scope and select the next ATC ''(or open the Flight-plan and select at “Handover to:”)''.
*if there is no “next ATC” available select the blank entry – the target is then free to be picked by another ATC en-route.
*if there is no “next ATC” available select the blank entry – the target is then free to be picked up by another ATC en-route.
*the FlightStrip will indicate the pending transfer by showing  
*the FlightStrip will indicate the pending transfer by showing  
:::“current ATC” => “next ATC”
:::“current ATC” => “next ATC”
:The FlightStrip on the console of the “next ATC” will change the background-color to yellow – to grab his attention!
:The FlightStrip on the console of the “next ATC” will change the background-color to yellow – to grab his attention!
*as soon as the “next ATC” has taken over the Flight-Strip will turn back to normal – indicating the “next ATC” is active -- and you cannot do any more changes!
*as soon as the “next ATC” has taken over the Flight-Strip will turn back to normal – indicating the “next ATC” is active -- and you cannot do any more changes!
<br>
 
'''''3. A target appears in your airspace:'''''
'''''3. A target appears in your airspace:'''''
*take over the control if there is no ATC assigned or the FlightStrip indicates that the current ATC wants you to take over the control ''(i.e. move the Flight-Strip all the way to the left)''  
*take over the control (i.e. move the Flight-Strip all the way to the left)'' if
*if the target has no owner yet and is just crossing your airspace and tells you his destination, you may open the FlightPlan and insert that destination so that all the other ATCs know about it.
:* there is no ATC assigned yet
*If the target lands on your airport:
:* or the FlightStrip indicates that the current ATC wants you to take over the control '' <small>''(see above  “current ATC” => “next ATC” indication)''</small>
**assign a STAR and/or RW
* if the target has no owner yet and is just crossing your airspace and tells you his destination, you may open the FlightPlan and insert that destination so that all the other ATCs know about it.
**the needed GND-traffic (Taxiways, Parkinglots, Gates, etc) is not part of the FlightPlan. ''(But you can always add your remarks for your own usage).''
* If the target lands on your airport:
** assign a RW and optional a STAR  
** the needed GND-traffic (Taxiways, Parkinglots, Gates, etc) is not part of the FlightPlan. ''(But you can always add your remarks for your own usage).''


'''''4. A ATC forgets to “reassign” or “free” a target'''''
'''''4. A ATC forgets to “reassign” or “free” a target:'''''
the ownership will automaticalle be removed as soon as the tagets gets out of the rang of that ATC (~100mi). After that any other ATC may take over.
* The ownership will automatically be removed as soon as the targets gets out of the rang of that ATC (~100mi). After that any other ATC may take over.
* or you contact that ATC and require to release that target out of his control
<br>
==='''Summery of Flight-Strips and Target-Tags'''===
Depending on what you selected in "map" -> "data mode" ''<small>(see the menu above the MPchat entry-line, at the very left)</small>'' the Radar labels may look different. See the summary in the following table:
{| class="wikitable"
|+
!width="30%"|<small>Status</small>
!width="30%"|<small>FlightStrip</small>
!width="20%"|<small>Traditional
(no transponder interaction)</small>
!width="20%"|<small>Simulation
(Transponder enabled)</small>
!width="20%"|<small>Pure Simulation
(Transponder enforced)</small>
|-
|<small>'''''Target appears on EDDF airport:'''''
no ATC and no Flight-Data are assigned yet</small>
|align="center"|[[File:OpenRadar-target-lables-10.png]]
|align="center"|[[File:OpenRadar-target-lables-11.png]]
|align="center"|[[File:OpenRadar-target-lables-12.png]]
|align="center"|[[File:OpenRadar-target-lables-13.png]]
|-
|<small>'''''jomoATC inputs a Flightplan:'''''
from EDDF to KJFK via SID BIBTI straight hdg EDDF -> KJFK 260° on Cruise Alt. FL250
Rw for TakeOff 25C</small>
|align="center"|[[File:OpenRadar-target-lables-20.png]]
|align="center"|[[File:OpenRadar-target-lables-21.png]]
|align="center"|[[File:OpenRadar-target-lables-22.png]]
|align="center"|[[File:OpenRadar-target-lables-23.png]]
|-
|<small>'''''After TakeOff:'''''
notice that RW25C has been canceled</small>
|align="center"|[[File:OpenRadar-target-lables-30.png]]
|align="center"|[[File:OpenRadar-target-lables-31.png]]
|align="center"|[[File:OpenRadar-target-lables-32.png]]
|align="center"|[[File:OpenRadar-target-lables-33.png]]
|}
<small>'''''EDDF forwards the target to EDDK:'''''</small>
{| class="wikitable"
|-
|<small>'''in EDDK''' it appears with a yellow background to enforce attantion
after ATC-EDDK has taken over, that yellow will disappear
and the "lastATC ==> "newATC" will be replaced by "currentATC"
and the "private Notes" will be replaced with those of the newATC (if he has some)</small>
|align="center"|[[File:OpenRadar-target-lables-41.png]]
|-
|<small>'''in EDDF''' that private notes remain,
but the new ATC is shown, indicating “no changes any more accepted from EDDF!”</small>
|align="center"|[[File:OpenRadar-target-lables-42.png]]
|align="center"|[[File:OpenRadar-target-lables-43.png]]
|}


== '''''Useful Features''''' ==
== '''''Functional Keys''''' ==
'''Radar Map'''
'''Radar Map'''
* On contact
* On contact
Line 506: Line 669:


''' Shortcuts '''
''' Shortcuts '''
{| class="wikitable"
{| class="keytable"
|-
|-
! Shortcut !! Action
! Shortcut !! Action
|-
|-
| '''ESC''' || Close all open dialogs and cancel the text input (reset chat input field)
| {{key press|ESC}} || Close all open dialogs and cancel the text input (reset chat input field)
 
|-
| {{key press|ESC}},{{key press|ESC}} || Deselects the current contact


|-
|-
| ALT + L || Toggle FGCom Log Window (only if you run FgCom started by OpenRadar)
| {{key press|ALT}} + {{key press|L}} || Toggle FGCom Log Window (only if you run FgCom started by OpenRadar)


|-
|-
| '''Left CTRL''' || PTT Radio COM0 (if it has been activated via Port in Settings)
| '''Left {{key press|CTRL}}''' || PTT Radio COM0 (if it has been activated via Port in Settings)
|-
|-
| NUM off: Num0 || PTT Radio COM0 (if it has been activated via Port in Settings)
| NUM off: Num0 || PTT Radio COM0 (if it has been activated via Port in Settings)
|-
|-
| '''Left SHIFT''' || PTT Radio COM1 (if it has been activated via Port in Settings)
| '''Left {{key press|SHIFT}}''' || PTT Radio COM1 (if it has been activated via Port in Settings)
|-
|-
| NUM off: Num1 || PTT Radio COM1 (if it has been activated via Port in Settings)
| NUM off: Num1 || PTT Radio COM1 (if it has been activated via Port in Settings)
Line 527: Line 693:
|-
|-
| NUM off: Num3 || PTT Radio COM3 (if it has been activated via Port in Settings)
| NUM off: Num3 || PTT Radio COM3 (if it has been activated via Port in Settings)
|-
| {{key press|F1}} || Zoom Level GROUND
|-
| {{key press|F2}} || Zoom Level TOWER
|-
| {{key press|F3}} || Zoom Level APP
|-
| {{key press|F4}} || Zoom Level SECTOR
|-
| {{key press|F11}} || play new Chat, new Contact and new METAR sound (for sound testing)
|-
| {{key press|F12}} || Copy mouse location (geo coordinates) to clipboard (for route design)
|-
| {{key press|Shift|F12}} || Reload and update standard route
definitions and texts (for development)
|}
|}
<br /> <br />
----


== Related content ==
== Related content ==
* [[sourceforge.net/projects/openradar/files|'''Download''' OpenRadar]]
* [[OpenRadar_FGFS_ORCAM|'''ORCAM''' = View the targets as model]]
* [[OpenRadar:_Transponder|Using '''Transponder'''-Codes]]
* [[OpenRadar: Editing routes|Editing '''STAR/SID''' routes]]
* [[OpenRadar:_Flightstrip|'''Flightstrips''']]
* [[OpenRadar:_Flightstrips-Bay|'''Flightstrips-Bay''']]
* [[OpenRadar:_Chat_aliases|'''Chat_aliases''']]
* [[OpenRadarKnownIssues|FAQ / Known Issues]]
* [[OpenRadar|The Design-Rules for OpenRadar]]
* [[OpenRadar|The Design-Rules for OpenRadar]]
* [[OpenRadar: Editing routes|Editing STAR/SID routes]]
* [[OpenRadarFeatureWishlist|OpenRadarFeatureWishlist]]
* [[OpenRadarKnownIssues|FAQ / Known Issues]]
 
[[Category:Air Traffic Control]]
[[Category:Java]]
[[Category:OpenRadar| ]]
[[Category:OpenRadar|Guide]]
[[Category:OpenRadar|Guide]]

Revision as of 06:00, 7 April 2019

Back to mainpage

Preface

OpenRadar supports FlightGear-ATCs when guiding/controlling Multiplayer-traffic within FlighGear.

Some words to our project targets:

  • Realism: That means we show all the data a Real-Live ATC would need for his job. For instance we simulate a radar antenna and perform one position update per antenna rotation. But we don't have professional ATCs, neither do we have professional pilots contacting our ATCs. So we have to make some compromises to a Real-Life operation.
  • Usability: The application should be handy, behave consistently, and require almost no training. The ATC has other things to do than to fight with the application.

We hope that we met your needs and are happy to get feedback!

Important: We support you with tooltip texts, that appear when you hover over an active area with your mouse. They shall remind you of possible interactions that you may have been forgotten. Try pointing your mouse everywhere - maybe there is something available that you missed until now...


Prerequisites

Internet

Of course you need an uninterrupted Internet access to exchange data between You and your clients/targets. The requirements for that connection are not very high -- but they must be uninterrupted!

Communication

We urge you to always offer your services as well in typing (MPchat) as also in speaking (Radio). You will soon discover, that using a Radio-application makes it much easier to communicate

  • as well for you (who hopefully will control many pilots at the same time)
  • as also for the pilots (who need both hands to control their plane).

Typically available ways of communication are:

  • MPchat is an integral part of FGFS and OpenRadar and needs no further installations. (ref.: http://wiki.flightgear.org/Howto:Multiplayer ) - so it is always available for communication between you and all pilots. You always should offer this option (and try to convince pilots to use a Radio-Option!).
  • A Radio is not directly integrated into OpenRadar but must be installed in addition. Right now there are 2 versions in use:
    • FGcom is the more realistic Radio-operation with realistic frequencies for each function and a limited work-range based on frequency.
If FGCOM is not yet installed, you need to install a "standalone version of FGCom 3.0", which then can be controlled directly from within OpenRadar. For installation see http://wiki.flightgear.org/FGCom_3.0, item "3 FGCom standalone".
  • Mumble is an easier to handle application, that provides "named groups" that people with the same reason move/change into. Thus Mumble is not limited by range and much easier to use for defining by "groups" which people will communicate with each other.
If Mumble is not installed you may install it according to http://mumble.sourceforge.net/Installing_Mumble.
To activate it see http://mumble.sourceforge.net/Mumbleguide
The most used Mumble-server is "itpns.ddns.net"

Java V7

Make sure you have installed at least Version 7 of Java. Verify and or Download the installation packages from: http://www.java.com/en/download/index.jsp

OpenRadar

For the latest stable version of OpenRadar see https://sourceforge.net/projects/openradar/files/

  • Download "Latest Release" for the latest version prior to the new "Flight-Strip-Bay" version
  • Download "Next Release" for the really newest version.

Prior to extracting move the ZIP to a place where it is easy to find. Make sure you have read and write permissions for that directory.

If you did already work with an OpenRadar installation you may want to

  • RENAME your current OpenRadar-directory (i.e. to "OpenRadar-BU")
  • then download and extract the new version into a newly created directory with the name of the old one (without the "-BU")
  • now you can replace all data in the new "OpenRadar/data" directory with the ones in the "OpenRadar-BU/data"
    • if you expect changes in the scenery etc. do not copy the the Airport (ICAO) directories
  • delete the BU-version only after you are sure you verified that all your personal data were transferred, i.e. still accessible!

Startup

Inside the downloaded OpenRadar base-directory you will find start-scripts. See

  • for Windows: OpenRadar.bat
  • for Linux: OpenRadar.sh
  • for OSX: OpenRadar.jar


OpenRadar-Welcome - Select Airport

Welcome - Select Airport

OpenRadar will always start with this Window in which you define the airport on which you want to operate:

  • If this is the first time you work with OpenRadar you first must check/set your options also in all the other tabs!
  • If the wanted airport is not yet listed:
    • type the wanted airport ICAO (e.g. KSFO or EDDF or ...) into the inputline left of "search" and click onto "search"
      • if that ICAO code is available, then OpenRadar will add it to the list
      • then a single mouseclick onto one of the listed airports will activate that selection
      • and will set a default into the "CallSign" field at the lower right corner. You may overwrite that here or later on during the session (ref. chapter #Status_Informations)
    • then you can review all settings prior you click onto Start
  • If the wanted airport is already in the list of airports then you may directly start with a mouse-double-click onto that ICAO-code (or single click and then "Start" at the bottom)
    • a double-click on it will order OpenRadar to search and load all the required data (into your local file "OpenRadar/Data/ICAO")
    • that may take some time → wait till the "Ready" appears in the lower Textfield → then click onto "Start"
  • To delete an airport form your PC delete its ICAO code out of your local directory "OpenRadar/Data/"


Settings (Communication)

Settings - Communication

This window lets you define your communication settings:

FGCom (Radio/Voice Communication)

OpenRadar can support up to 4 instances of FGcom in 2 ways:
  1. It can start and control FgCom instances that operate in the background as sub-tasks of OpenRadar (except for OSX where FgCom must be run in a separate Terminal window)
  2. or just control manually started FgCom-sessions.
You select these modes of operation by the “FgComMode” selection:


1a) Internal: FGCom(s) are started and controlled internally by OpenRadar
For this mode you have to define all available fields to tell OpenRadar where your FGcom resides and what options shall be used:
Path: Here you define where your FGcom is installed.
In the following some examples:

type Windows Linux OSX
a standard installation C:\Programs\FGcom /home/YourName/fgcom *)
on another disk D:\FlighGear_2.6\FGcom /media/DiskName/FGFS/fgcom *)
on a LAN-server \\ServerName\Central\FGFS /home/YourName//.gvfs/fgfs on nas-server/fgcom *)
*) for OSX this does not apply because you will be starting FgCom in a Terminal window before starting OpenRadar, see 1b

Executable: Here you define the program-name that shall be started
  • For Windows: "fgcom.exe" or "anyName.bat"
  • for Linux: "fgcom" or "anyName.sh"
  • OSX: again for OSX this does not apply, see 1b
Do not forgett to mark "FGCom3" if you are using the new FGCom versions (e.g. with FGFS ver.3.0)
Server: As of today there is only one FGCom-server available that also supports FGFS ver.3.0: fgcom.flightgear.org
You still may be using fgcom01.flightgear.org in a group in that all users use this server
Client: must always be “localhost”
FGcom Ports: The here defined values are crucial for the operation because:
  • They are the only connection between the OpenRadar and FGcom. So you must define those the same in OpenRadar as well as in FGcom !!
  • They also define how many “Radio Units” (COM0, COM1, etc.) are generated within OpenRadar
Simply provide a coma separated list of UDP Ports to be used by FGcom. But be warned: More than two are hard to handle!
e.g. 16661,16662


1b) External: OpenRadar controls a manually started instance of FGcom - via the defined Port.
For this one you only need to define where that FGcom is running and what the connecting port is. e.g.:
  • Client: localhost
If you want to run FGcom on a different PC you must define here the IP of the remote PC and you must start FGCOM on that PC with the option -s,
e.g. "fgcom -Sfgcom.flightgear.org/  -p16662  -i1 -o1 -s192.168.178.23"
  • FGcom Ports: 16661,16662 (if e.g. 2 FGcom instances were started)


1c) OFF: No FGcom support (e.g. using MUMBLE or similar)
That means that You do not want to work with FGcom during your ATC-session – thus you do not need to define any of the FGCOM-fields.

Alternative Radios (e.g. Mumble)

Mark this option if you want to use e.g. Mumble - that has no functional implications, but will add an information to that effect onto your OpenRadar Operating-Panel.
If you want to use mumble see http://wiki.mumble.info/wiki/Main_Page and/or http://www.emmerich-j.de/Mumble/mumble.html for installation and operation

FG Multiplayer

Here you find the server and connection port for the "FlightGear multiplayer server". It delivers the radar contact position informations and is used for chat. You won't have to change the settings, as long as the server won't change.
In case you experience problems with the outside you may check and/or choose any "Server" that is listed in http://mpserver15.flightgear.org/mpserverstatus/: Look for a server nearest to your location that has a status of "OK" and shows the most "totals".
PLEASE NOTE: The "Client port" is the port used by your computer to talk with that server. If you want to use FlightGears internal chat parallel to OpenRadar, you must use a different port than FlightGear. Because of that, the default port of OpenRadar is 5001 (in order to differentiate it to the 5000 used in FGFS).

Multiplayer Chat

In addition to the standard List of ATC-commands selected out of of the drop-down-select-list (right click onto a target) there is a list of codes that you can type into the MPchat. See the list in "../OpenRadar/data/atcMessages/alias.txt". This list you may extend for any (standard) messages you want to sent to pilots via MPchat.
Define as "Prefix" any character that you will use to indicate that the following is a command (default is a dot ".").
e.g. if you type ".rs" → MPchat will replace that with "Reduce speed to ".

METAR

OpenRadar retrieves the weather information via METAR messages from a server in the INTERNET. This information is being displayed and used to calculate the usability of runways and the air speed of the radar contacts.
If your airport is too small to be in that worldwide list, you can provide the code of another bigger airport with METAR data nearby in the sector.property file. But be aware that then your customers weather-settings may differ to yours, because they may use the standard FGFS-METAR-Source!


Flightplans

Flightplans

In order to exchange information’s about targets with other OpenRadar-locations, You must define the Server for the distribution of FlightPlan data between all OpenRadar-ATCs. So activate "enable flightplan exchange" and insert the server address:
http://h2281805.stratoserver.net/FgFpServer/
Under this address you can also check where ATC's are offering services right now.

Please click on the "Check Settings" button to have your settings checked prior to continue:


Tweaks

Tweaks

Select/enable according to the descriptions.
Be aware that these option may influence the responstimes of your PC drastically!


FGFS ORCAM

FGFS ORCAM

This is an additive feature to OpenRadar, that enables you to view OpenRadar targets as Models - e.g. while they are taxiing on GND or are approaching/departing your airport. For this you can position your "Viewpoint" where you want and watch from there.

For details on how to install and operate see: OpenRadar_FGFS_ORCAM


Operating

OpenRadar Prototype.png

Note: As of this version when the main screen starts in OSX it is completely minimized at the bottom left corner of the screen and you must expand this window.

The OpenRadar main screen is divided into four regions:

  1. Top left you see the big Radar Map showing the airport, its surrounding, the navaids, and the radar targets.
  2. At the bottom of that Radar Map there is a line for Radar Options
  3. Bottom left you see the MPchat Area for the FlightGear MultiPlayer chat feature
  4. On the right side you see the Service Area with 4 subparts. From top to bottom those are
    1. Status Information
    2. Radios for Communication (only if you have defined one or more in chapter #Settings )
    3. Runway Manager to set up runways used
    4. the Flight Strip Manager, where you can manage your radar targets.

To see examples of actual ATC-events with OpenRadar you may visit http://www.emmerich-j.de/EDDF/Films/Films.html.

Radar Map

The radar map is the most complex part of OpenRadar, thus you have many options to zoom into any detailed area you are interested in. To do that you can:

  • zoom in and out using your mouse wheel (Mac: hold your right mousebutton pushed while moving over the radar-background in NorthWest respectively SouthEast)
  • adjust the map-center by dragging it with your mouse (click-hold left and drag)
  • a double mouse-click onto the scope will move that point into the center of the scope
  • a double right mouse-click will center the scope back to your location
  • a double mouse-click onto a Flightstrip will center the "Target and Airport" into the center of the map and resize accordingly
  • set the four functional zoom levels GROUND, TOWER, APP and SECTOR by zooming the radar map to your taste and then do a "right mouse-click" onto the zoom level wanted for it. Then you can always resize the map to that zoom again by just clicking onto the wanted zoom-level.


A typical tower operation

The standard Radar-targets

  • do have a label attached with the following informations:
(See also the chapter #Flight-management)
UID heading direction
Airplane type Flightplan controlling ATC (if not you)
Flight Level Airspeed
  • and are displayed in 6 different colors:
blue That are all targets that you controll

see e.g. "KL-666" on approach and "B777-20" ready for TakeOff
their Flightstrips are placed to the left

white That is always the currently selected target for ATC messages. It's UID is also placed into the MPchat inputline for immediate messages

see e.g. "G-MNKY" who just gets his taxi-instructions from you
his Flightstrip may be in any position - it's control-status does not matter because you can talk to any target on the screen (but please do not interfere with the operation of other ATC's in the area!)

yellow may be used for targets that are not under your controll - but may ask for your attation soon or may become hazardous for your operations!

their Flightstripes are placed into the middle

green targets who are not controlled by you

see e.g. "CEMI198" just crossing in high altitude - outside your control
their Flightstrips are placed to the right - that is also the position in which all new targets are placed initially

gray is a neglected target or one for which there were no refresh data received from the MPserver for some time. In those cases the aircraft-type will be replaced by either "neglected" or by the time that elapsed since the last MPserver-update.

Radar-Options

A GND layout with active PPN's

The radar map has so many details to display, that it is impossible to display all at once. Because of that we display details depending on the zoom level. For instance we hide Fixes and/or Runway Numbers etc. at a certain level of zoom. Thus OpenRadar features an adaptive detail level. In addition you can show/noShow types of data by the following buttons at the lower botton of the radar-scope:
OpenRadar-Radar-Options.png

a) map:

STP Show/NoShow the "Selected (target) To Pointer" (doggy), an attachment to the mousepointer, showing
  • the direction from the "active target" to the mouse-position (and reverse)
  • and the distance and the calculated time for the target to get there|
PPN Show/NoShow Parking/Gate names (those will automatically be set "NoShow" above distinct scale-settings!)
FIX Show/NoShow FIX's (those will automatically be set "NoShow" above distinct scale-settings!)
RW-FIX Special Waypoints for automatic approaches/departures (those will automatically be set "NoShow" above distinct scale-settings!)
NDB Show/NoShow NDB's
VOR Show/NoShow VOR's
Airports Show/NoShow Airports, inclusive their groundlayout (You may double-click onto a wanted airport and zoom in to see the layout)
Circles Show/NoShow circles at distinct distances around your present location. The distance between the circles shown depends on the chosen zoom-factor!
GS Heights Show/NoShow Glide-Slope-Heights along the centerline of the runway for landings. (They will automatically be set "NoShow" above distinct scale-settings!)
data mode Defines different modes of Transponder-operations. Try it and notice the differences in the Target-tags and Flightstrips.
update frequencies allows you to vary the timespan between refreshing the radar-picture
contact tail adds a tail of points to the targets - thus indicating the past way of the target
layers lets you select to add overlays to the radar:
  • landmass = costlines and similar
  • taramacs = the GND-shape of airports


b) sounds:
Here you can select which "happenings" will produce an additional sound (This list may change in further releases)

c) STP:
Show/NoShow the "Selected (target) To Pointer" (doggy) (Same as in table above - just for faster access)

d) STAR/SID:
Show/NoShow the unique Waypoints defined in the STAR/SID's

e) PPN:
Show/NoShow Parking/Gate names (Same as in table above)



MPchat area

The MPchat area

This area allows you to enter chat messages, view the chat history and filter it.
In the entry-line atop you define your messages to any radar-target by:

  • Manually typing a message:
    • A left mouse-click onto a Flight-Stripe or onto a Radar-Target will place the Target-UID at the beginning of the entry-line
    • Then you may type or copy/past anything behind that - and send it out by ENTER
      • The font-color will change to red if the message becomes too long for the multiplayer distribution - shortly bevor that the font-color changes to blue as an early warning.
  • Generate a standard message:
    • A right mouse-click onto a Flight-Stripe or onto a Radar-Target (or the TAB-key if the target is already active) will open a list with the available messages - select one with a left mouse-click
    • That will place the message into the entry-line - you may now review/edit it and then send it out by ENTER
  • Repeat a message:
    • With the cursor-keys "up" and "down" you can scroll thru the list of messages and place them into the entry-line - then you may edit it and send it out by ENTER.
  • OpenRadar will always set the ATC-name (as it appears on the very top of the service area - see the following chapter) in front of the message.

Below that entry-line is the scrollable list of exchanged MPchat-messages. In that list the messages related to the selected target are colored cyan. With the button "SEL" you set a filter to show only the messages related to the selected target. This filter will be reset as soon as you select another target - or by clicking onto "ALL".

You may enlarge that MPchat-area by grabbing the upper edge with the left mouse-button and move it upward. Of course that will reduce the size of the radar-screen -- so use it with care!

Service Area

This column at the right side of the screen is for setting up the base-data for the operation, display needed data for traffic-guidance, and provide tools for guiding the pilots.

Status Informations
The general Status Informations (the here 3rd line will be removed soon!)

This area shows in 4 lines the status-informations of your session (compare the picture):

  • The first line contains several informations:
  • "19:46 UTC" is the actual "Coordinated Universal Time" (replacing nowadays the formerly used "Greenwich Mean Time" (GMT))
  • "5000/TL055" is the so called Transition Altitude for that airport/area, in which:
  • 5000 gives the "Transition Altitude" in feet when climbing
  • TL055 gives the "Transition Level" when descending into that area (in FlightLevels: 1 FL = 100 feet))
Above that level the altimeter must be set to the standard pressure setting of 1013 hectopascals (millibars) or 29.92 inches of mercury
  • At the very right is a text box that allows you to see and change your current MP-callsign. So you can quickly change it, if e.g. a second ATC takes another role at the same airport (TW/APP/GND/RADAR, etc). You may change that ID also when starting the OpenRadar. (ref. chapter #Startup)
  • The second line displays the [ICAO] and the long name of your airport.
  • The last 2 lines show the current Weather_reports (also called ATIS or METAR):
  • At the begining there will be placed a short summary of the flight-conditions:
Code Meaning Cloud Ceiling Visibility
LIFR Limited IFR <500 ft  visibility <1 nm
IFR Instrument Flight Rules <1000 ft visibility <3 nm
MVFR Marginal VFR <3000 ft visibility <5 nm
VFR Visual Flight Rules >3000 ft >5 nm
  • With a mouse-click on the upper line only that line will be sent to the target
  • A mouse-click to the lower line will send both lines to the target
COM-Radios

if FGCOM

The COM-Setting (that can be none or up to 4)
According to the amount of FGcom-Ports you defined during setup you find here as many COM-Units (COM0 to max COM3). Each of them has a PopUp-List of Radio-frequencies available for the airport you are located on. You may
  • choose a frequency out of the list by clicking onto the arrow at the right of the input-field
  • or empty the field by a right mouseclick and enter any other frequency wanted.
At the right of that field you find a "Push To Talk" (PTT) button that you can operate by mouseclick -- or you can use the shortcuts given in the following table.
COMx left on keyboard right on keyboard
COM0 Ctrl NumOff+Num0
COM1 SHIFT NumOff+Num1
COM2 NumOff+Num2
COM3 NumOff+Num7
Please watch the color change of the PTT buttons to know, when you can speak.
In case you operate the FGcom in the "controlled by OpenRadar" mode (compare the Setup), then
  • the radio label turns to red when FGcom is unable to establish a connection on this frequency. (Remember: OpenRadar has more frequencies available than FGcom knows of!!)
  • you have an additional "Restart"-button: In case the communication becomes chopped or interrupted, you may click here to restart the FGCOM-program.


if e.g. MUMBLE

In case you use mumble there will be just a blank input-field. Into that field you may insert any text that will then show up in your advises to pilots. We suggest e.g. the to use the mumble-server:
itpns.ddns.net
Runway Settings
The Runway Manager
The Runway Manager Settings

Here you define the major variables for your airport operations: That are the assignments of the runways! For this purpose OpenRadar gives you a lot of precalculated and or default values to support your decisions. See e.g. the pictures on the right:

  • From top to bottom OpenRadar lists all runways available for that airport. For each runway you may define unique operating/display values (see the picture "The Runway Manager Settings" below). You open these settings by a right-mouse-click onto the runway-number (in the following describtion we clicked onto the "07R" in EDDF):
    • In the header line you see left the now chosen runway to be edited, and at the right a button "Copy to All". With this button you can copy the settings you make here to all the other runways - so e.g. for EDDF with its 8 runways you can save a lot of time! With that copy only the numeric-values will be changed - all the selection-markers will remain as are in each unique setting table. (e.g. the length-definitions will be copied for all - the markers "Landing" will remain unique!). These settings will then be saved separately for each unique runway and airport in you private settings.
    • With "Main switches" you define which functions may be available for that runway. Usually you can define for each runway as well a "Starting" as also a "Landing" function. In the given example for EDDF there is a complication: Per Law you may
not use runway 36 at all --> thus disable both lines: All data for that runway disappear
use runway 18 for "Starts" only --> thus enable "Starts" only
use runway 07L and 25R for "Landings" only --> thus enable only "Landing"
(Compare the picture "The Runway Manager" on the right: The left marks enable the function - the right ones enable the SID/STAR functions)
(How do you know those details? Well, as a good ATC you prepare yourself by reading the official airport data (or look for something like e.g. http://en.wikipedia.org/wiki/Frankfurt_Airport, see on that page in the right column).
  • The "Extended center line" are the blue lines you see in the picture "Typical runway/approach definitions"
    Typical runway/approach definitions
    at the right. If you want that line you may define how long it should be. Some people do not want it reaching over the whole screen. We suggest to limit it to the MPserver-range of 100 mi. It will only be visible for the runways defined for "Landing"!
  • The "Distance markers" are measurement markers on that "Extended center line". Here you define from were to were you want to have such markers (they may restrain your eyes if you use them all over!).
  • "Vectoring and base leg" define that funnel that you also see in that picture "Typical runway/approach definitions". Also this will be shown only for the "Landing" runways.


Finally your picture will look similar to the right/above shown "The Runway Manager"!

  • In that one you see from left to right the following informations for each runway:
  • The runway-name
  • Check-boxes to define if that runway is used at all, may be just for landings or just for starts or for both. The program prevents you from assigning a runway in both directions (e.g. 25R and 07L)
  • A second check-box to display SID/STAR graphics for that runway (if they are defined, check for them in .../OpenRadar/data/routes/ICAO/ICAO.xml).
  • A graphical display of the cross winds and and gusts: They are green from 0-5kn, orange 5-10kn and red above. When there are significant gusts that color-bar is divided into two. Typically the gusts then will be represented by the longer bar!
  • Above that bar you see the fractions of head- and crosswind. You may use especially the crosswind-fraction to warn pilots if those are => 10 kn! (Remember: You find the normal wind values in the METAR-data further up in the #Status_Informations)
  • To the right follows
  • in the upper line the exact runway heading (as needed for older type autopilots)
  • in the lower line the length and width of the runway in feet!
  • Then follow the ILS informations, if ILS is available for that runway. The data shown are: the ILS-beacon-name, the frequency, the glideslope, and the altitude at the threshold.

After you have defined all runways and activated your choice of active runways, you will exit the "Runway Manager" by moving the mouse-pointer out of it. Then the "Runway Manager" will reduce and show only the active runways. (You may move the mouse very fast - then all runways remain visible). Click into that remaining "Runway Manager" to show again all runways.

Flight Strip Manager
Handling the Flight-Stripes

Paper Flight Strips are the ATCs help to coordinate his traffic. In reality those strips contain many details about the flight, that we do not have (yet). Based on vertical space-limitations we have gathered the most critical informations into 2 lines, which are automatically initiated and controlled by the program. Those are:

Target UID Aircraft Type direction to it from ATC
distance to it IAS+GND speed Altitude (FL) current heading

In addition You may add some more unique informations in additional lines. We urge you to reduce these additional lines to a minimum, because already with 2 lines the list may become that long, that you must scroll constantly! These additional lines will be saved as target-data (see ../OpenRadar/Settings/atcComments.xml) and inserted each time a new stripe is created for that target! See as a suggestion a typical last line for a unique target name:

"ILS VOR FGC NRW || and personal remark"
This pilot knows how to use ILS, VOR, FGcom, the new Runway at EDDF || and personal remark

You are absolutely free to define your own codes and whatever. To do so:

  • enter/edit those data by opening the "Note Editor" with a center mouse-click (Mac: Alt + right mouse-click) onto the stripe. There you have several areas to add unique informations:
  • At the top of this editor you can
  • select in which native language the "standard commands" shall be transmitted (in addition) to that target
  • mark if that target uses Radio (the label now says "FgCom", but you may use that for any Radio-usage)
  • the upper, larger input-block at the bottom is planed to be used for additonal FligtPlan-data or extended lists of waypoints.
The above data may be distributed to all ATC's.
  • the lower, smaller input-block you may use for your personal requirements, they will not be distributed, but they will be retrieved automatically each time that target reappears on your screen.
  • all other (Flight-Plan) data will be explained in the next chapter: #Flight-Plan & Flight-Management
  • exit the Flight-Stripe-Editor clicking into any area outside of it.


You can manipulate the listing regarding the vertical and horizontal position of the flight strips:

  • New radar-targets will always appear at the end of the list on the right side and will be colored in lightgreen (that green will disappear when you touch that lable first time - thus you always know which ones you have already actively noticed!)
  • You can move the stripes in vertical order by drag and drop
  • You can place them in three horizontal columns (left, middle and right) either by dragging them with the hold-down mouse button or by mouse-clicks left or right of the stripes (you may double-click to move directly from one side to the other)
  • with the "AUTO"-button at the upper edge of this area you can define that the stripes will be sorted automatically into groups according to their left/center/right position. This may be very irritating at first - so you may want to switch that "AUTO" off at first usages!
  • The radar-targets will change their color according to the horizontal position of their stripe:
    • the radar-targets for stripes at the right side will be green - these are all targets when initialized - i.e. they are not under your controll - any ATC in the area can take control of them
    • the radar-targets for stripes in the center will be yellow
    • the radar-targets for stripes at the left side will be cyan

On the radar-map the "cyan targets" will overlay the "yellow targets" - and the "yellow targets" will overlay the "green" ones!

You cannot change these combinations of color and position -- but you might define your own definition of what the positions mean! We suggest the following:

green = right = initial position: Means not yet defined or not under my control (e.g. passing through on high altitude, is controlled by another ATC, etc.)
yellow = center = I expect him to get under my control when in range (e.g. 60 mi), or he may be transfered to me by another ATC soon, or he may become a danger to the traffic controlled by me if he continues uncontrolled! etc.
cyan = left = under my control.

Again: That is a proposal - you can define your on meanings!

You can apply the following mouse-actions onto the stripes as well as onto the radar-targets:

  • a single left mouse-click selects/activates it, i.e. its radar-target becomes "light cyan" and its UID is set into the MPchat input-line. In addition
    • its listed messages in the MPchat-list become colored cyan
    • and the "doggy" at the mouse-pointer displays data about the relation between that target and the mouse-pointer
  • a double left mouse-click helps you to find the target by highlighting the target on the scope. It also changes the radar-range to show both: The Target and your location. The selection of any of the "preset zoom levels" (GROUND, TOWER, APP, Sector) will reset the map-position again to its center!
  • a center mouse-click opens the Note Editor (see above)
  • a right mouse-click shows the dialog to choose pre-defined ATC messages to be sent to the current contact
  • a CTRL+left mouse-click will define that target as neglected. Thus his radar-target will become just a light gray color, that will not overlay or otherwise disturb the radar-views.

Flight-Plan & Flight-Management

There is now a Flight-Plan feature inside OpenRadar. With this you can define OpenRadar-internal Flight-Plans ("OR-FP") that get distributed to all ATC's within the range of the target, as it moves from area to area. Thus every ATC can decide on first sight whether that flight affects his duties and how. This Flight-Plan can only be generated and/or edited by the ATC that is actually controlling the target at the given time. Due to time-restraints/workload ATC's will only input the most required data (see in the following the "Mandatory fields") - thus that will never substitute a thorough flightplanning by the pilot - nor will ATC take the time to type ALL flightdata as dictated by the pilot!

In future there will be added a common interface to existing Flight-Plan-Programs, so that the pilot himself can pre-define all data for his flights – and OpenRadar takes over that data automatically in its internal Flight-Plan. As of Feb.2015 this is already functional with the Flighplanning on "http://flightgear-atc.alwaysdata.net".

Define/Edit a Flight-Plan:

The Flightplanning feature input sheet for OpenRadar

You open the Flight-Plan for a target by clicking with the “center mouse-button”

  • onto the Flight-Strip of the target
  • or the target on the radar-screen
  • You can also open the "active" target by the ^-key

Before you start defining a new plan

  1. click onto the button "Retrieve FP" - that will load any Flightplan that may be available on a compatable FP-system
  2. otherwise you should make sure all data become "newly intialized" click onto the button "Reset FP"

After the Pilot "Landed" and "closes" his FP you should use the "Close FP" so that plan will also be closed in the OpebRadar server

Controlling the ownership:
You can only define/edit a Flight-Plan for a target that is under your Control. i.e. the field “Controlled/Uncontrolled" must state “controlled by me”!

  • If it is “uncontrolled” click onto “control” and that field will indicate your “ownership” and avoid others to change
  • If it is “Controlled by …..
    • you must wait till the ATC controlling it now will
      • either remove his “ownership” by
        • clicking onto “Handover to” and selecting
          • another ATC for takeover
          • or the “blank” for just removing his control.
        • or clicking onto the button “Control” (besides the lable "Uncontrolled...")
    • or the target gets outside the range of the indicated “Owner”. In that case the Flight-Plan will be set to “Uncontrolled” automatically
    • or you send the controlling ATC a mail asking him to release the target
  • If it shows “Controlled by me” you can release the target
    • by clicking onto “Handover to” and selecting another ATC (or “blank”) for takeover
    • or you grab the Flight-Strip with the mouse and move it to the left into the radar-scope and select an ATC (or “blank”)
    • or you move the Flight-Strip all the way to the right – that will just remove your ownership

Mandatory fields of the OR-Flight-Plan:

  • Contact is the FGFS-UID of the target (will be set automatically)
  • Radio needs to indicate that the target can use Radio (FGCom or Mumble or ..)
  • Aircraft is the model-code of the target (will be set automatically)
  • Assgnd RWY needs the planned runway for departure or landing. You assign the runway either by the PullDown or by DoubleClick onto the runway number in the “Runway Settings”
  • SID/STAR needs the name of the SID/STAR, if requested by the pilot
  • Departure is the departure Airport (will be set automatically to your airport if on GND - or manual)
  • Destination needs the ICAO-code of the destination (e.g. EDDF for Frankfurt)
  • Crsg Alt needs the planned (initial) cruising altitude for that flight (usually in FL)
  • ETA is the “Estimated Time of Arrival” - that is automatically calculated based on the given aircraft type, altitude (CrsgAlt) and speed (Crsg.TAS) (You might override it if you know/want it more realistic)

Optional fields of the OR-Flight-Plan:

  • native language is per default “en” for English. If you choose another language, then all your selected MPchat advises to that target will be sent in English and then repeated in that chosen “native language”
  • Squawk shows the Squawk-Code you assigned to the target (for details see Transponder)
  • Waypoints keeps predefined waypoints (if required or sent by other flightplanning systems)
  • Altitude as assigned by ATC from time to time (not the planned/constant "Crsg.Alt"! (compare below))
  • Code will be used in future when given by a more professional Flight-Planning system
  • IFR/VFR may be defined by the PullDown
  • Crsg.TAS.: Define the planned TAS en route (usually as GND-speed)
  • Alt.Airports can be defined as a needed deviation in case of bad weather etc. at the planned destination airport
  • Comments here you enter comments that will be kept together with the Flight-Plan - and are visible to all ATCs en-route
  • Private notes are comments that remain with the ATC making these (stored then in the local file OpenRadar/settings/atcComments.xml). These will always be re-inserted whenever that target is visible to the unique ATC, independent of if he is the “active controller” or not.

Flight-management:

Open the wanted Flight-Plan

  • by a center-mouse-click onto the radar-target or the FlightStrip
  • you can also use the ^-key to open the FlightPlan of the active target.

Then continue as described in the following scenarios: (In these scenarios only the "Simulation" labels are shown - to see all possibilities see the summary at the end)

1. A target appears on your airport

OpenRadar-Flightplanning-lables-1.png
There are no data yet filled in yet into the flight-plan from any ATC, and there is no ATC assigned yet. Thus
  • the text in the tag-color is “green” - i.e. you did not yet take control
  • the flight-strip background color is light green, in order to indicate that you did not yet do anything with it - i.e. it asks for attention from you to decide what to do with it
  • a simple mouse-click or any other action will remove the green background (and activate that target as usual - i.e. showing the lable-text and the MPchat messages for this target in cyan).

2. You define a new Flight Plan

  • Pull the Flight-stripe all the way to the left (mouse-drag or double click left of the FlightStrip). (If there is still another ATC the owner, then you cannot take over prior that the other ATC released or transferred that target!)
  • Generate the Flight-Plan:
Compare the Informations given in the target-label and the stripe:
e.g. when there is defined (just below the scope) in “map → data mode → Simulation (Transponder enabled)”
OpenRadar-Flightplanning-lables-2.png
jomo the pilot FGFS-UID
160° the current heading (now on ramp!)
HeadSet-sign that pilot uses radio (FGCom or Mumble)
CONC the FGFS-model is the Concorde
KJFK is the planned destination
260° is the straight heading EDDF (departure) to KJFK (destination)
BIBTI is the SID planned for departure (on arrival here would be the STAR)
RW25C is the runway assigned for departure (or for arrival)
0400* is the current altitude (on GND in EDDF!)
00 is the speed (still parking!)


  • Departing:
    • GND will use the data as shown above, to bring the plane to the HoldingPoint
    • TWR will take over
    • The runway-assignment will be removed automatically after Take-Off


  • Transfer Control to next ATC (or blank)
OpenRadar-Flightplanning-lables-3.png
  • grab-move the FlightStrip to the left into the Scope and select the next ATC (or open the Flight-plan and select at “Handover to:”).
  • if there is no “next ATC” available select the blank entry – the target is then free to be picked up by another ATC en-route.
  • the FlightStrip will indicate the pending transfer by showing
“current ATC” => “next ATC”
The FlightStrip on the console of the “next ATC” will change the background-color to yellow – to grab his attention!
  • as soon as the “next ATC” has taken over the Flight-Strip will turn back to normal – indicating the “next ATC” is active -- and you cannot do any more changes!

3. A target appears in your airspace:

  • take over the control (i.e. move the Flight-Strip all the way to the left) if
  • there is no ATC assigned yet
  • or the FlightStrip indicates that the current ATC wants you to take over the control (see above “current ATC” => “next ATC” indication)
  • if the target has no owner yet and is just crossing your airspace and tells you his destination, you may open the FlightPlan and insert that destination so that all the other ATCs know about it.
  • If the target lands on your airport:
    • assign a RW and optional a STAR
    • the needed GND-traffic (Taxiways, Parkinglots, Gates, etc) is not part of the FlightPlan. (But you can always add your remarks for your own usage).

4. A ATC forgets to “reassign” or “free” a target:

  • The ownership will automatically be removed as soon as the targets gets out of the rang of that ATC (~100mi). After that any other ATC may take over.
  • or you contact that ATC and require to release that target out of his control


Summery of Flight-Strips and Target-Tags

Depending on what you selected in "map" -> "data mode" (see the menu above the MPchat entry-line, at the very left) the Radar labels may look different. See the summary in the following table:

Status FlightStrip Traditional

(no transponder interaction)

Simulation

(Transponder enabled)

Pure Simulation

(Transponder enforced)

Target appears on EDDF airport:

no ATC and no Flight-Data are assigned yet

OpenRadar-target-lables-10.png OpenRadar-target-lables-11.png OpenRadar-target-lables-12.png OpenRadar-target-lables-13.png
jomoATC inputs a Flightplan:

from EDDF to KJFK via SID BIBTI straight hdg EDDF -> KJFK 260° on Cruise Alt. FL250 Rw for TakeOff 25C

OpenRadar-target-lables-20.png OpenRadar-target-lables-21.png OpenRadar-target-lables-22.png OpenRadar-target-lables-23.png
After TakeOff:

notice that RW25C has been canceled

OpenRadar-target-lables-30.png OpenRadar-target-lables-31.png OpenRadar-target-lables-32.png OpenRadar-target-lables-33.png

EDDF forwards the target to EDDK:

in EDDK it appears with a yellow background to enforce attantion

after ATC-EDDK has taken over, that yellow will disappear and the "lastATC ==> "newATC" will be replaced by "currentATC" and the "private Notes" will be replaced with those of the newATC (if he has some)

OpenRadar-target-lables-41.png
in EDDF that private notes remain,

but the new ATC is shown, indicating “no changes any more accepted from EDDF!”

OpenRadar-target-lables-42.png OpenRadar-target-lables-43.png

Functional Keys

Radar Map

  • On contact
  • left click selects and sets cursor into the chat input field
  • middle click opens the radar contact settings (ATC note and native language)
  • right click opens the ATC messages selection box
  • left double click on map to center it on airport (return to airport)
  • middle click on zoom level defines the current view as new center and zoom setting (stored in a file)
  • a click on the texts, on the lower left, toggle display of FIX, NDB, VOR,...

Flight Strip Area

  • On flight strip
  • left click selects the contact and sets cursor into the chat input field
  • middle click opens the radar contact settings (ATC note and native language)
  • right click (or the TAB-key) opens the ATC messages selection box
  • left double click centers radar map on the contact (to find contact)
  • CTRL+left click sets the contact to be neglected
  • a click beside the flight strips moves the flight strips between the three columns (right, middle, left)

Runway area

  • right click on runway number opens the runway settings dialog to define the centerline and vectoring settings
  • If at least one runway is active you may double click the runway panel background to hide the inactive runways (frees space for flight strips)

Radios

  • a right click on the frequency list changes the input to be editable, so you can define the frequencies by yourself


Shortcuts

Shortcut Action
ESC Close all open dialogs and cancel the text input (reset chat input field)
ESC,ESC Deselects the current contact
ALT + L Toggle FGCom Log Window (only if you run FgCom started by OpenRadar)
Left CTRL PTT Radio COM0 (if it has been activated via Port in Settings)
NUM off: Num0 PTT Radio COM0 (if it has been activated via Port in Settings)
Left Shift PTT Radio COM1 (if it has been activated via Port in Settings)
NUM off: Num1 PTT Radio COM1 (if it has been activated via Port in Settings)
NUM off: Num2 PTT Radio COM2 (if it has been activated via Port in Settings)
NUM off: Num3 PTT Radio COM3 (if it has been activated via Port in Settings)
F1 Zoom Level GROUND
F2 Zoom Level TOWER
F3 Zoom Level APP
F4 Zoom Level SECTOR
F11 play new Chat, new Contact and new METAR sound (for sound testing)
F12 Copy mouse location (geo coordinates) to clipboard (for route design)
Shift+F12 Reload and update standard route

definitions and texts (for development)

Related content