ATC-pie FAQ: Difference between revisions

no edit summary
(r10h)
No edit summary
Line 4: Line 4:


== Things "not working" ==
== Things "not working" ==
=== How do I start anywhere else than bl*ody KSFO? ===
Use a command line argument: <code>./ATC-pie.py ICAO</code>
The way to do this from a graphical desktop is system-dependant, but there is always a way. Otherwise, open a shell terminal to type the command above.


=== Why am I not seeing this aircraft on my radar? ===
=== Why am I not seeing this aircraft on my radar? ===


'''I know it is there: the pilot is sending chat messages and/or is visible on the online live map...'''
Connected to FGMS: '''I know it is there: the pilot is sending chat messages and/or is visible on the online live map...'''


You only see an aircraft on your screen if your radar picks up a transponder signal from it. The two following cases will therefore prevent you from seeing a connected aircraft:
You only see an aircraft on your screen if your radar picks up a transponder signal from it. The two following cases will therefore prevent you from seeing a connected aircraft:
* The aircraft is out of radar range, i.e. under the radar floor (minimum signal pick-up height) or too far out. Open the ''General settings'' dialog, check the NM range setting and set the floor to "SFC" to pick up all signals.
* The aircraft is out of radar range, i.e. under the radar floor (minimum signal pick-up height) or too far out. Open the ''General settings'' dialog, check the NM range setting and set the floor to "SFC" to pick up all signals.
* Its onboard transponder is turned off; see [https://www.youtube.com/watch?v=kpPzRiwzx9Q&list=PL1EQKKHhDVJvvWpcX_BqeOIsmeW2A_8Yb&index=1 ATC-pie video tutorial 1]. You should tell the pilot to switch it on. Alternatively, you can switch on the primary radar system if you want to see all aircraft's positions, or activate the "radar cheat mode" if you want to go the radical way ([https://www.youtube.com/watch?v=lSyH88HR-4w&index=3&list=PL1EQKKHhDVJvvWpcX_BqeOIsmeW2A_8Yb tutorial 3]). NB: If the aircraft model does not support the transponder feature, it will be simulated by ATC-pie according to the fallback mode you have selected in the settings dialog. A non-equipped aircraft and a zero fallback mode will therefore make the aircraft invisible as well.
* Its onboard transponder is turned off; see [https://www.youtube.com/watch?v=kpPzRiwzx9Q&list=PL1EQKKHhDVJvvWpcX_BqeOIsmeW2A_8Yb&index=1 ATC-pie video tutorial 1]. You should tell the pilot to switch it on. Alternatively, you can switch on the primary radar system if you want to see all aircraft's positions, or activate the "radar cheat mode" if you want to go the radical way ([https://www.youtube.com/watch?v=lSyH88HR-4w&index=3&list=PL1EQKKHhDVJvvWpcX_BqeOIsmeW2A_8Yb tutorial 3]).
 
NB: If the aircraft model does not support the transponder feature, it will be simulated by ATC-pie according to the fallback mode you have selected in the settings dialog. A non-equipped aircraft and a zero fallback mode will therefore make the aircraft invisible as well.


=== FGCom radio is not working. What is going on? ===
=== FGCom radio is not working. What is going on? ===
Line 42: Line 38:
Ruling out that FlightGear is not installed at all, your system path settings are probably wrong. From a terminal, find the right command to start FlightGear and enter it as ''FlightGear executable'' from the system settings. Do not add options of any kind; they will be taken care of internally. You may have to enter a ''FlightGear root directory'' as well, especially if you have the program files installed somewhere unexpected. Your entries will be saved after that.
Ruling out that FlightGear is not installed at all, your system path settings are probably wrong. From a terminal, find the right command to start FlightGear and enter it as ''FlightGear executable'' from the system settings. Do not add options of any kind; they will be taken care of internally. You may have to enter a ''FlightGear root directory'' as well, especially if you have the program files installed somewhere unexpected. Your entries will be saved after that.


=== Why is my tower in the middle of the sea, and aircraft floating/landing on water? ===
=== My tower is in the middle of the sea, and aircraft floating/landing on water! ===


You are missing the FlightGear scenery data for your location, or ATC-pie does not know where it is. Check out the ''Tower viewing'' feature note in this article.
You are missing the FlightGear scenery data for your location, or ATC-pie does not know where it is. Check out the ''Tower viewing'' feature note in this article.
Line 62: Line 58:
=== What nickname should I use for FlightGear multi-player? ===
=== What nickname should I use for FlightGear multi-player? ===


Choose any name you would like to be recognised by as playing the ATC. It will appear in a tooltip over your callsign in the ATC neighbours list of those connecting near enough to see you. In a sense, this feature is more social than technical, but makes sense as typical ATC callsigns (e.g. "VHHHtwr") remain mostly anonymous over MP. Use this field so that other players can identify you.
Choose any name you would like to be recognised by on the network. In ATC-pie, it will appear in the tooltip over your callsign in the neighbours list of ATCs connecting near enough to see you. In a sense, this feature is more social than technical, but makes sense as typical ATC callsigns (e.g. "VHHHtwr") remain mostly anonymous over MP. Use this field so that other players can identify you.


== Where is ...? How to ...? ==
== Where is ...? How to ...? ==
=== How do I start anywhere else than bl*ody KSFO? ===
Use a command line argument: <code>./ATC-pie.py ICAO</code>
The way to do this from a graphical desktop is system-dependant, but there is always a way. Otherwise, open a shell terminal to type the command above.


=== Can I draw SID and STAR procedures on the radar? ===
=== Can I draw SID and STAR procedures on the radar? ===
Line 73: Line 75:
* examine the (otherwise useless) packaged KSFO example.
* examine the (otherwise useless) packaged KSFO example.


'''If you have a sector file''' of the ".sct" format used in VATSIM/IVAO, you should try the included <code>sectorExtract.py</code> script. Probably your best solution if you know your procedures are included. Here is how to use it:
'''If you have a sector file''' of the ".sct" format used in VATSIM/IVAO, you should try the included <code>sectorExtract.py</code> script. It will extract most of the contents, including SID/STAR procedures, and translate them into ATC-pie's native drawing format. Probably your best solution if you know your procedures are included. Here is how to use it:
# Choose an output directory
# Run the script: <code>sectorExtract.py sector_file centre:radius output_dir</code>.
#: It is where you want the output files to be generated. You can create your own target directory, or choose the <code>output</code> directory of ATC-pie but mind that it is probably not empty (NB: the <code>cleanUp.sh</code> script will clean it nicely). It is ''not'' recommended to choose <code>resources/bg-img</code> directly.
#: In this command:
# Run the script: <code>sectorExtract.py sector_file centre:radius output_dir</code> where ''centre'' (Earth coordinates) and ''radius'' (range in nautical miles) specify the wanted coverage of the input sector file, centred on a point.
#:* ''sector_file'' is the input sector file you wish to extract from;
#:* ''centre'' (Earth coordinates) and ''radius'' (range in nautical miles) specify the wanted coverage of the input sector file;
#:* ''output_dir'' is where you want the output files to be generated.
#: In the output directory, the resulting files are:
#: In the output directory, the resulting files are:
#:* <code>geo-*</code>, <code>proc-*</code>, <code>boundaries-*</code>, containing the extracted drawings translated for ATC-pie;
#:* <code>geo-*</code>, <code>proc-*</code>, <code>boundaries-*</code>, containing the extracted drawings translated for ATC-pie;
#:* <code>extract.lst</code>, a list of the generated drawing files in the expected format;
#:* <code>extract.lst</code>, a list of the generated drawing files in the expected format;
#:* <code>extract.err</code>, a log of the errors detected in your sector file (do not be alarmed as they often have many).
#:* <code>extract.err</code>, a log of the errors detected in your sector file (do not be alarmed as they often contain many).
# Import the results:
# Import the results:
#* move the drawing files under <code>resources/bg-img</code> and adjust the paths in <code>extract.lst</code> if you create subdirectories;
#* rename the .lst file to <code>resources/bg-img/ICAO.lst</code>, replacing ''ICAO'' with the location code of where to import the drawings;
#* rename the latter to <code>resources/bg-img/ICAO.lst</code> replacing ''ICAO'' by the location code where to draw the imported files.
#* move the drawing files under <code>resources/bg-img</code>, adjusting the paths in <code>extract.lst</code> if you create subdirectories.
# Post-editing
# Post-editing (cleaning)
#: Each drawing block (point list under a colour) is labelled automatically with something that describes it best, and contains the line number it was sourced from in the sector file. ATC-pie does its best to understand the objects that are in the sector and to group things together depending on their type. But not everything can be guessed automatically, so you get a lot a files and useless things. This last step is now where you must merge, split, delete objects, rename points, change colours, etc. to your liking.
#: ATC-pie does its best to understand the objects in the sector and to group things together depending on their type. But not everything can be guessed automatically, so you get a lot a files and useless things. This last step is where you merge, split, delete objects, rename points, change colours, etc. to your liking.
#: Each generated drawing block (point list under a colour) is automatically given a label, ending with the line number it was sourced from in the sector file so you can easily trace it (<code>@nnn</code>). A tool like ''sed'' will help you get rid of all these unwanted suffixes once you have sorted and renamed your objects:
#:: <code>sed -ri 's/ @[0-9]+$//' file_to_clean</code>


=== How do I assign SIDs and STARs to aircraft? ===
=== How do I assign SIDs and STARs to aircraft? ===
Line 121: Line 127:
Often followed with: '''(you must understand that) this is not VATSIM!'''
Often followed with: '''(you must understand that) this is not VATSIM!'''


We do have a [https://sourceforge.net/p/atc-pie/wiki/Wishlist wish list] and will consider any feature or help request. However, though it has a few cheats, ATC-pie has always choosen realism as a criterion for implementation and design, over the mere incentive of converting otherwise happy users of other programs. It is a good thing that different philosophies and work flows are available out there, and there would be much less interest in having them all copy each other, fighting over users rather than understanding that not all of them wish for the same game experience. If serious simulation or learning new skills sound like threats to fun for you, you have a perfectly valid reason not to opt for ATC-pie.
We do have a [https://sourceforge.net/p/atc-pie/wiki/Wishlist wish list] and will consider any feature or help request. However, though it has a few cheats, ATC-pie has always choosen realism as a criterion for implementation and design, over the mere incentive of converting otherwise happy users of other programs. It is a good thing that different philosophies and work flows are available out there, and there would be much less interest in having them all copy each other, fighting over users instead of understanding that not all of them wish for the same game experience. If serious simulation or learning new skills sound like threats to fun for you, you have a perfectly valid reason not to opt for ATC-pie.


[[Category:ATC-pie]]
[[Category:ATC-pie]]
265

edits