ATC-pie user guide: Difference between revisions

m
no edit summary
(v 1.5.0)
mNo edit summary
Line 42: Line 42:


Besides, there are two other places a strip can be dropped on, usually when releasing a contact:
Besides, there are two other places a strip can be dropped on, usually when releasing a contact:
* a connected ATC (if accepting strip exchange), to initiate a handover;
* a connected ATC to initiate a handover;
* the '''strip shelf''' (visible at the bottom of loose and racked strip panels), which clears the strip from your work bench and stores it as shelved.
* a '''strip shelf''' (flat button at the bottom of loose and racked strip panels), which clears the strip from your work bench and stores it as shelved.


== Airport scene rendering ==
== Airport scene rendering ==
Line 49: Line 49:
=== Tower view window ===
=== Tower view window ===
[[File:ATC-pie-screenshot-towerViewing.png|thumbnail|Tower viewing, following a departing aircraft]]
[[File:ATC-pie-screenshot-towerViewing.png|thumbnail|Tower viewing, following a departing aircraft]]
This feature allows you to overlook your airport and the connected (multi-player) or simulated (solo and teaching sessions) traffic, like a controller from a tower viewpoint. It allows to choose from the tower positions specified in the source data if any, otherwise defaults to somewhere over the airport to allow towering of all available airports. It is disabled in CTR mode. Additionally, more views can be hooked up to your scene.
This feature allows you to overlook your airport and the connected or simulated traffic, like a controller from a tower viewpoint. It allows to choose from the tower positions specified in the source data if any, otherwise defaults to somewhere over the airport to allow towering of all available airports. It is disabled in CTR mode. Additionally, more views can be hooked up to your scene.
There are two ways of activating a tower view. You may let ATC-pie start its own suitably configured FlightGear process, or have it connect to an external viewer, manually set up and accepting connections.
There are two ways of activating a tower view. You may let ATC-pie start its own suitably configured FlightGear process, or have it connect to an external viewer, manually set up and accepting connections.


'''Running internally''' only requires FlightGear installed on your computer. A basic installation is enough, but you will need the [[scenery]] for your airport if you want anything exciting to see (and not sea!). Also, aircraft will only be drawn properly if the appropriate [[Aircraft|models]] are available. In multi-player, the models required are those flown by the players. For simulated aircraft (AI traffic in solo-simulated and teacher-controlled aircraft), read about <code>icao2fgfs</code> in <code>resources/acft/Notice</code> to understand how ATC-pie chooses models and liveries for its viewers. Aircraft and scenery locations can be filled in the ''System'' settings dialog if they are not in your [[$FG_ROOT|FlightGear root directory]].
'''Running internally''' only requires FlightGear installed on your computer. A basic installation is enough, but you will need the [[scenery]] for your airport if you want anything exciting to see (and not sea!). Also, aircraft will only be drawn properly if the appropriate [[Aircraft|models]] are available. In multi-player, the models required are those flown by the players. For solo-simulated (AI) traffic and teacher-controlled aircraft, read about <code>icao2fgfs</code> in <code>resources/acft/Notice</code> to understand how ATC-pie chooses models and liveries for its viewers. Aircraft and scenery locations can be filled in the ''System'' settings dialog if they are not in your [[$FG_ROOT|FlightGear root directory]].


Connecting to an '''external viewer''' allows to run FlightGear on a different machine and thereby relieve your session from the CPU load a local instance induces. If you want to do so, get a hint of the required positioning options you should start your viewer with, from the tower view tab in the system settings dialog. Of course, scenery, models and liveries must also be available to the running process.
Connecting to an '''external viewer''' allows to run FlightGear on a different machine and thereby relieve your session from the CPU load a local instance induces. If you want to do so, get a hint of the required positioning options you should start your viewer with, from the tower view tab in the system settings dialog. Of course, scenery, models and liveries must also be available to the running process.
Line 69: Line 69:


ATC-pie can register and analyse issued vectors and routes to:
ATC-pie can register and analyse issued vectors and routes to:
* inform radar display and help monitor traffic, checking against
* inform strip and radar display;
* anticipate conflicts between controlled aircraft.
* help monitor traffic, checking against vectors;
* anticipate route and FL conflicts between controlled aircraft.


=== Vectors ===
=== Vectors ===
[[File:ATC-pie-screenshot-courseAndAssignmentsGraphics.png|thumbnail|Course/vector drawing for linked radar contact]]
[[File:ATC-pie-screenshot-courseAndAssignmentsGraphics.png|thumbnail|Course/vector drawing for linked radar contact]]
Registering vectors on strips enhances the drawing of linked radar contacts, enables easy monitoring of tracks and detection of aircraft flying off course. To register vectors automatically when a radar contact is linked to a strip (and suggest the appropriate text chat instruction), use the following mouse gestures:
Registering vectors on strips enhances the drawing of linked radar contacts, enables easy monitoring of tracks and detection of aircraft flying off course. To register vectors automatically when a radar contact is linked to a strip, use the following mouse gestures:
* click and drag out of a radar contact to issue a heading vector;
* click and drag out of a radar contact to issue a heading vector;
* hold SHIFT, click and drag vertically for altitude/FL vectors;
* hold SHIFT, click and drag vertically for altitude/FL vectors;
Line 80: Line 81:
* hold SHIFT and double-click to clear registered vecors from the linked strip.
* hold SHIFT and double-click to clear registered vecors from the linked strip.


See [https://www.youtube.com/watch?v=BvA3MRlGJjU video 5] of the tutorial for more on vectoring, and check the quick reference ''display conventions'' to interpret the lines and colours of the course and vector graphics drawn on the radar contact.
An appropriate text chat instruction is suggested for every registered vector. See [https://www.youtube.com/watch?v=BvA3MRlGJjU video 5] of the tutorial for more on vectoring, and check the quick reference ''display conventions'' to interpret the lines and colours of the course and vector graphics around radar contacts.


=== Routes ===
=== Routes ===
Line 99: Line 100:
** the current route leg is the last, and the keyword "STAR" appears in its specification: "STAR ''wp''" is displayed, where ''wp'' is the last en-route waypoint.
** the current route leg is the last, and the keyword "STAR" appears in its specification: "STAR ''wp''" is displayed, where ''wp'' is the last en-route waypoint.


NB: If either of the DEP or ARR airports are missing or unidentified, radar tags show the strip destination detail (ARR) if it is filled, possibly with a heading if it is recognised.
NB: If both DEP and ARR airports are not identified, radar tags show the strip destination detail if it is filled, possibly with a heading if it is recognised.


See tutorial [https://www.youtube.com/watch?v=LfdukpBc90w video 7] for a demonstration of routes.
See tutorial [https://www.youtube.com/watch?v=LfdukpBc90w video 7] for a demonstration of routes.
Line 125: Line 126:
== Playing solo ==
== Playing solo ==


In solo sessions, you control virtual IFR planes, receiving and handing over strips to virtual ATCs depending on your position and the aircraft's intentions. ATC-pie allows to train in different situations:
In solo sessions, you control virtual IFR planes, receiving and handing over strips to virtual ATCs depending on your position and the aircraft's intentions. You can train as an en-route controller in CTR mode, or as an airport controller in AD mode, where four combinable positions are available:
* as an en-route controller (CTR) if started in centre mode;
** ground (GND), to taxi aircraft between parking positions and runways;
* or in airport mode, where four combinable positions are available:
** ground (GND), to taxi aircraft between gates and runways;
** tower (TWR), to control runways and immediate surroundings;
** tower (TWR), to control runways and immediate surroundings;
** departure (DEP), to bring departing traffic to their exit point;
** departure (DEP), to bring departing traffic to their exit point;
Line 203: Line 202:
* etc.
* etc.


== ATC strip exchange (handovers) ==
== ATC coordination ==


=== Sending and receiving strips ===
"ATC coordination" refers to the following:
* strip exchange, i.e. sending and receiving strips (handovers);
* ATC text chat, to exchange messages between connected ATCs (see ''Communications'' section);
* ''who-has'' requests, to query the system and know who is claiming contact/control of callsigns.
 
=== Strip exchange ===
[[File:ATC-pie-screenshot-receivedStrip.png|thumbnail|Example of a strip received from "DEL"]]
[[File:ATC-pie-screenshot-receivedStrip.png|thumbnail|Example of a strip received from "DEL"]]
To hand a strip over, drag it and drop it on the recipient in the list of connected controllers. Received strips appear on their collecting rack (if defined), with an identification of the sender which disappears as soon as the strip is clicked on. Double-click on the rack tab or column header to add an ATC callsign from which to collect strips. They may link automatically to identified radar contacts, according to the auto-link configuration (general settings).
To hand a strip over, drag it and drop it on the recipient in the list of connected controllers. Received strips appear on their collecting rack (if defined), with an identification of the sender which disappears as soon as the strip is clicked on. They may link automatically to identified radar contacts, according to the auto-link configuration (general settings). Double-click on the rack name to add an ATC callsign from which to collect strips.


Check [https://www.youtube.com/watch?v=oQIud-cAlT4 tutorial video 6] for a presentation of the feature.
See [https://www.youtube.com/watch?v=oQIud-cAlT4 tutorial video 6] for a presentation of the feature.


=== Coexisting sub-systems in multi-player ===
=== Coexisting sub-systems in multi-player ===
On multi-player session start, there are two "sub-systems" that can be activated to enable strip exchange. They differ in terms of interoperability with other clients:
On multi-player session start, there are two "sub-systems" that can be activated. They differ in terms of provided features and interoperability with other clients:
* the '''IRC sub-system''' allows full flexibility with other ATC-pie clients (e.g. exchanging unlinked strips), but does not currently operate with any other software;
* the '''IRC sub-system''' allows full flexibility with other ATC-pie clients, but does not currently operate with other software;
* the '''handover service''' is [[OpenRadar]]'s native system, which ATC-pie implements to enable coordination with its users, but some limitations apply (see below).
* the '''OpenRadar handover service''' is [[OpenRadar]]'s native system, which ATC-pie implements to enable coordination with its users, but some limitations apply (see below).


Both systems can be enabled together. If so, ATC-pie will try to choose the most appropriate system through which to send the strips on handovers.
Both systems can be enabled together. If so, ATC-pie will try to choose the most appropriate system through which to send the strips on handovers.
Line 224: Line 228:
* in OpenRadar, a handover must be acknowledged by the receiver for the sender to lose ownership and for all neighbouring users to see it complete, whereas ATC-pie considers that a strip sent is gone and assumed to land on the receiver's rack, without anybody else necessarily to know.
* in OpenRadar, a handover must be acknowledged by the receiver for the sender to lose ownership and for all neighbouring users to see it complete, whereas ATC-pie considers that a strip sent is gone and assumed to land on the receiver's rack, without anybody else necessarily to know.


For most interactions to work while respecting both approaches as much as possible, the following principles and restrictions apply:
For most interactions to work while respecting both approaches as much as possible, the following principles and restrictions apply to strip exchange:
* ATC-pie users can only hand over strips that are linked to a radar contact;
* ATC-pie users can only hand over strips that are linked to a radar contact;
* aircraft under ATC-pie control are not shown as "owned" to OpenRadar users;
* aircraft under ATC-pie control are not shown as "owned" to OpenRadar users;
265

edits