Getting Started

The radar client interface that vice provides is based on STARS. For familiarity to VATSIM controllers, vice generally follows the keyboard command scheme implemented in CRC's STARS implementation; see the discussion of vice's STARS emulation below for more information.

The first time you launch vice, a window is shown for configuring the simulation. (After the first time, the window can be brought up by clicking the "replay" button in the menubar: .) A number of scenarios are available, some departure-only and some including both departures and arrivals. Here is an example:

After selecting an ARTCC, the available TRACONs and ATCT/TRACONs in that ARTCC are shown. Selecting one of those gives a number of scenarios to choose from. Here the ZNY ARTCC has been selected and then the PHL ATCT/TRACON. After choosing a scenario and clicking the "Next" button, a window with further settings is shown:

In the second configuration window, you can specify your initials, used to identify yourself to other controllers, as well as various additional settings. You can also adjust how heavy the traffic is; here, the departure rate settings are shown. (The PHL scenario only includes the Philadelphia Airport, though many other scenarios include multiple airports.) These rates are specified in terms of aircraft per hour, so an ADR of 30 corresponds to one aircraft departing every two minutes (on average). If you'd like an arrival-only scenario, for example, just set all of the departure rates to zero.

For arrivals, the "Go around probability" slider allows setting the probability that each arrival goes around. You may also select "Include random arrival pushes", which will periodically bump up the rate of arrivals to increase the challenge of vectoring aircraft. "Push frequency" sets how often arrival pushes happen and "Length of push" sets how long they last before traffic returns to regular levels.

After you have configured the simulation, click "Create" and you will have a STARS scope and flight strip window to work with. Use the usual STARS commands as appropriate (to initiate track, accept handoffs, handoff to other controllers, etc.), and the additional ATC commands below to issue control commands to aircraft.

After the simulation starts, you may click on the button in the menubar to show a window with information about the scenario, including the active controllers, the departures, arrivals, approaches and overflight routes, and airspace awareness rules. For this PHL scenario, four arrivals, two approaches, and three departures are active. Other scenarios may be more complex.

The approach codes—here, "27R" and "35"— are used in vice's aircraft control commands like "expect approach" and "cleared approach".

The Messages and Flight Strips windows can be toggled on and off using the and buttons in the menubar. Both windows can be repositioned and resized freely, and their layout is saved across sessions.

A number of buttons are available in the menu bar at the top of the window:

• / : pause or resume the simulation.
• : opens the window to select a new scenario and set its parameters.
• : open a window that allows changing various settings. The most useful one is the simulation rate: you can speed up time during slow times or to increase the challenge.
• : show the window that lists the currently active departures, arrivals, and approaches.
• : opens a window that shows a summary of vice's ATC commands and frequently-used STARS commands.
• : open a window with controls for launching aircraft, either automatically or manually.
• : toggle the Messages window, which displays system messages and alerts.
• : toggle the Flight Strips window.
• : open this webpage to review vice's documentation.
• : display information about the version of vice you have installed.
• : join the vice Discord.
• : Toggle full-screen mode.

When you exit vice, it remembers everything going on—all of the aircraft in flight, the instructions they have been given, etc. The next time you launch vice, it loads all of that back in and you can continue where you left off. If you'd like to start something new, just click and configure a new simulation.

When vice is paused, you can hover the mouse above a radar track to see information about the instructions the aircraft has been given so far—for example, altitude and speed assignments, whether it has been sent direct to a fix, the approach it has been assigned, etc. An example is shown below. This information is especially useful when resuming a vice session after you have been away from it for a while.

If you are signed in to Discord, vice can automatically update your activity status there with information about your current vice session (the number of arrivals and departures, the position you're controlling, etc.) When you first launch vice you are given the option to disable this feature if you would like. The settings window, available by clicking in the menubar, can also be used to enable or disable this feature.

Drawing Routes

vice can draw the active departures, approaches, and arrivals for the current simulation. This can be helpful when studying those for an airport, since they are drawn directly on the radar scope with annotations that give the fixes, any altitude or speed restrictions, and procedure turns.

To toggle whether a route is drawn on the scope, click the checkbox on the left next to it in the information window that is shown at the start or after clicking on the button in the menubar. For example, here is how the HVN RNAV Runway 2 approach is rendered:

We can see the procedure turn at PEPER and that it is both the IAF and the IF; altitude restrictions at both SALLT and PEPER, that SALLT is the FAF, and that arrivals from KEYED will not fly the procedure turn.

Launching Aircraft

When a new simulation starts, vice automatically launches new departures and arrivals based on the departure and arrival rates set in the "New Simulation" window. During a simulation, clicking on the departing plane icon in the menubar opens a window that allows more control over aircraft launches and also for issuing releases for airports where "hold for release" is in effect.

The rates for automatic launches can be adjusted in this window. Alternatively, aircraft can be launched manually. If manual launches are selected, the window shows all of the available departure runways and exits as well as all of the arrivals, as shown below. Clicking the aircraft icon for a departure or arrival causes the aircraft shown to be launched. If you'd like a different aircraft for the next launch (for example, to have a heavy aircraft), click the redo icon until you're happy with the selection. The window also shows the elapsed time since the launch of each type as well as how many miles in trail (MIT) there would be if the next aircraft was launched. To delete all of the aircraft from the simulation and restart, click the trash icon: .

Multiple Controllers

With vice you can also have multiple controllers working aircraft together. Select "Create a sim on the public vice server" in the "New Simulation" window and you can select an ARTCC, ATCT/TRACON, and scenario in the same way that you do with a single controller. For multi-controller scenarios, there are some additional settings, shown beneath the list of scenarios:

If you sign in with instructor/RPO (remote pilot operator) privileges, then you are able to issue control instructions to all aircraft. Each multi-controller simulation also has a name associated with it; vice chooses a random one (above, it's "plenty-manufacturer"). These names can be used so that you can tell other people which simulation to choose in order to join you. You may also enable "Require password" and enter a password for the simulation so that only people you allow can join it.

Selecting "Join a sim on the public vice server" shows a list of the simulations that are currently available, including how many controllers are signed into each one. Note that the simulation names are shown in the first column. After selecting one, the currently unoccupied radar workstations (TCWs) are shown, though if you select "Join as relief", you may connect to a TCW that is already in use; this allows relieving another controller, who may then disconnect after briefing you. After selecting a TCW, you can select one or more terminal control positions (TCPs) that you will be responsible for; your TCPs determine the airspace and which handoff flows are your responsibility. vice also allows you to join a simulation as an observer, in which case you have no control capabilities; to do so, select a free TCW and then do not select any TCPs.

ATC Instructions (Keyboard)

A variety of instructions can be issued to aircraft by an aircraft controller. To issue an instruction, first press the [TAB] key. This will place the STARS radar into "target generation" mode and the characters "TG" will appear above the text input area (which is by default on the left side of the STARS window, towards the top. STARS reverts to normal command entry mode after a valid ATC instruction is entered, though target generation can be locked by pressing [SHIFT][TAB].

The commands below can then be entered to issue control commands to aircraft. As you enter commands, they will be shown in the STARS input area. You can correct errors with the backspace key or press the [ESCAPE] key to exit target generation mode.

To indicate which aircraft should be given a command, you can either enter a command and click on an aircraft's radar track in the STARS window or you can enter the aircraft's callsign followed by a space before the command, and then press the "enter" key. You can also give just the callsign suffix, if that is enough to unambiguously identify a single aircraft. The callsign of the last aircraft you issued to a command to is shown after "TG" when target generation mode is activated. If you'd like to give another instruction to that aircraft, you can skip entering its callsign. Entering another aircraft's callsign causes the command to be issued to that aircraft instead.

After you issue a command, the virtual pilot's readback is shown in the readback window below the STARS window. After receiving an instruction, the aircraft will start following that instruction, to the best of its abilities. Unlike VATSIM, the pilots will always do exactly what you tell them to.

If you'd like to issue multiple commands to an aircraft at once, enter the commands one after another with a space between them. To open a window that shows the available ATC commands when using vice, click the button in the top menubar.

The following commands relate to the aircraft's lateral route:

And these commands are related to altitude:

These commands are for aircraft speed:

The transponder is managed using these commands:

And these commands are instructions related to changing radio frequencies and contacting different controllers:

A variety of commands are available related to approaches—specifying them and clearing aircraft for them.

For VFR aircraft that have been given vectors or altitude constraints, a few special instructions are available.

Finally, a few miscellaneous commands are available.

ATC Instructions (Spoken)

There is also support for issuing aircraft commands by speaking out loud (via speech to text, or STT). This is very much a work in progress but it is progressing quickly.

STT works best if you have a decent microphone and are not in a noisy environment (music or TV in the background, etc.) Results will generally be better if you have a discrete GPU in your computer (or a laptop with a powerful laptop GPU); parts of STT run on the GPU. In order to have good response times on machines with slower (or no) GPUs, we have to do less processing on spoken text and thus have more inaccurate transcriptions.

A few options related to STT may be controlled via the settings menu ( in the menubar):

It's important to make sure that the correct microphone is selected, if you have more than one (e.g. a headset and the built-in microphone). By default, the push-to-talk key is ;, though this can be changed to another key. The model allows selection of different speech-to-text transcription models; vice tries to choose one that gives a reasonable balance of accuracy and speed for your system. If you try a different model and are happier with the overall experience, please report your findings on the vice discord!

vice's STT system expects that proper (US FAA) phraseology will be used to issue aircraft instructions, specifically Section 2-4: Radio and Interphone Communications for the basics and then other instructions as specified in the 7110.65. It tries to be flexible to allow minor deviations as are used in practice (as well as to allow errors in the STT transcription of the audio), but if your phraseology is highly non-standard, you will likely not have a good experience.

STT is also mostly limited to the control commands that vice supports in general (i.e., those described in the previous section), though there are a few commands that are STT-only. More details about expected phraseology and supported commands in specific scenarios are in the following.

The following instructions are currently supported:

Altitude

SIDs and STARs

Lateral Navigation

Speed

When a speed instruction is given after an approach clearance, the following qualifiers may be added:

• "... until X mile final"
• "... until X DME"
• "... until (fix)" (generally, the FAF).

Altitude

Approaches

VFR Aircraft

Handoffs

Traffic Calls

Corrections

If STT misidentifies the callsign and sends a command to the wrong aircraft, you can correct it by saying "negative, that was for (correct callsign)" followed by the command for the correct aircraft. This will undo the command sent to the wrong aircraft and apply the new command to the correct one. Do not repeat the wrong aircraft's callsign—this avoids confusing them.

Advisories

Miscellaneous / Filler

The STT system is aware of variety of phrases that may be part of instructions or controller replies but do not correspond to instructions themselves. These include:

• "Radar contact"
• "Roger"
• "Good day", "Seeya", "Hello"
• "Altimeter ..."

Facility Engineering

Documentation for creating and editing vice scenario files, facility configurations, and video maps is available in the separate Facility Engineering guide.

Windows

To install vice on Windows, download and launch the installer below. After installation, vice will be available in the Windows Start menu and a shortcut will be added to your desktop.

Macintosh

On a Mac, download the zip file below; it contains a universal binary that runs on both Intel and Apple CPUs. Note that MacOS Big Sur or a more recent version of OSX is required. After opening the zip file, drag Vice.app to your Applications folder to install it.

Linux

Vice is packaged as a flatpak and published to flathub. Install it directly from GNOME Software/KDE Discover or follow the instructions from flathub. Run it from your application launcher or by running flatpak run io.github.mmp.Vice.

Reporting Bugs

If you encounter bugs in vice, apologies! It would be of great help if you would send in a report if vice crashes or if you see mistakes in how it simulates aircraft or the STARS interface.

The best way to report bugs is via the "bugs" channel on the vice discord. Alternatively, if you have a github account, you can file bugs directly in vice's issue tracker.

Release History

0.14.1 (9 Mar 2026)

• New scenarios: ZJX Consolidated (Jake Magee), ZNY Area B (Ryan G), ZJX areas 11 + 21 (manaphy), ZJX areas 14 + 15 (Michael Knight).
• Scenario updates: ZLA and ZHN (Ketan K), ZNY area A (Ryan G), JFK4 finals (Ryan G).
• Updated to latest AIRAC (Michael Knight).
• Long requested: you can actually move sub-windows outside of the main window.
  • The flight strip and messages windows are now sub-windows and now its just the radar scope in the main window.
• Text to speech now runs locally on your computer rather than in the cloud.
• Added ATIS simulation: see the ATIS/METAR tab in the scenario info window for what's current.
  • Aircraft will call in with the current ATIS; if it's changed and they call in with the old one, STT supports "information X is now current," "advise you have information X", etc., or with the keyboard you can issue the command ATIS/X to tell them X is current.
• Lots of small improvements to speech-to-text.
• Improved simulation of radio static / distortion.
• Added PTT test button (shows strength, plays back as it records).
• ERAM
  • Added support for giving aircraft speeds in mach (Michael Trokel).
• Bugfixes:
  • Handle Pacific "P" and Carribean "T" airports better.
  • Use sim time, not wallclock time for delayed changes heading so it works better when sped up (Jordan Williams).
  • "CSI" for cleared straight in approach without specifying the approach works now.
  • STARS force quicklook was unintentionally being applied to all controllers.
  • Handing off tracks before they call in should work better; they will still call in to your frequency first.
  • Fixed long stalls after clicking a new ARTCC/TRACON in the new sim window.
  • Fixed issues with crosswinds pushing aircraft off of the localizer/final approach course.
  • Fixed longstanding bug where aircraft sent direct to a fix on an approach but not cleared would start descending anyway (Jordan Williams).
  • Fixed bug where aircraft couldn't climb past FL332.
  • Fixed bug with ERAM cursor not displaying and STARS cursor disappearing over the DCB.
  • Fixed bug with characters doubled up in text entry boxes (Jordan Williams).
  • Fixed bug that caused delayed readbacks after contact transmissions.
  • Fixed bug with departures not being climbed by virtual controllers.
  • STARS DCBs are scaled better on screens where they don't fit normally.
• Flight strips have been reworked; right click to get a menu to push them to the next controller.
• Facility engineering updates:
  • Major rework of how facility-specific data is managed (Michael Trokel).
  • Added support for STARS FDAM (flight data auto-modify) filters: this allows setting things like scratchpad, leader line direction, for (selected) aircraft in a filter region.
  • Added qualifying attributes to quicklook filter regions: it can now depend on owning TCP, scratchpad, flight type, flight rules, CWT category, and a bunch of other things.
  • CRDA: no longer has to be tied to runways. Paths can include arcs and don't have to be straight lines. Convergence points can be arbitrary, don't have to be runway intersections.
  • Added "go_around" object to "arrival_runways" specifiers: can specify heading, altitude, and handoff controller for each arrival runway. If spacing is too tight on final, tower will send the trailing aircraft around.
  • The default "max_distance" for ARTCC scenarios is now 400nm.
  • Departures/arrivals can be assigned specific callsigns, not just an airline ICAO (Michael Trokel).
  • "areas" can now have video_maps, video_map_file, center, and radius.
  • Added "monitor" option under "config" in facility configuration types to specify a display monitor type to simulate; for STARS this determines the color scheme. Options are "legacy", "mdm3", and "mdm4".

0.14.0 (6 Feb 2026)

• Added speech-to-text support (Michael Trokel / Matt P)
• New Scenarios: ZLC Area C (JY_SUPn't), ZJX 30 (Jake Magee), CVG (manaphy), ZDV Area 3 (Andrew S)
• Scenario updates: BOS, ACK, MHT (radarcontacto), P50 (Ketan K), COS (Andrew S), BGR (Ryan G), M98 (Logan S), F11, ZJX 50 (Jud Lopez), DAB, F11 (Michael Knight), MIA (Gecko)
• Added search box to filter scenarios
• Improved pilot readbacks to be more natural / cohesive
• VFRs are better about not flying into terrain (and staying out of the flight levels)
• Added "at fix, intercept the localizer" command: AFIX/I
• Fixed bug with multi-controller scenarios where controllers could be locked out of issuing aircraft commands.
• STARS:
  • Fixed bug where interfacility handoffs would get a FORMAT error
  • Fixed keyboard input for DCB button values (e.g. RANGE)
• ERAM:
  • Added QF and QU commands
  • Added tearoffs, cursors, and clock
  • Added HSF data
  • Switched tertiary/primary mouse clicks to primary/secondary
• Facility engineering:
  • Headings leaving fixes in routes can be specified to be left or right turns: PUCKY/L320, ROSLY/R250, etc. (Xavier Caldwell)
  • Specific routes (not just the entire airport) can be marked hold for release
  • Departures' contact location can be defined in routes

0.13.3 (29 Dec 2025)

• New scenarios: PCT consolidated (Ketan K), MYR (Jud Lopez)
• Scenario updates: A80, C90, D01, D10, DAB, F11, JAX, MKE, ZJX (Jud Lopez), SAV (manaphy), DelRey, SNA, P50, L30 (Ketan K), ISP, ZNY Area D (Ryan G), P80 (Mike Fries), BOS (radarcontacto)
• STARS updates:
  • Added support for changing position consolidation during the sim: [multifunc]1A1B+[enter], etc.
    • New sign-on flow, allowing users to select a workstation and which positions to control.
    • Users can sign in as relief controllers at the same scope as another controller.
    • Instructor/RPO/observer has been rewritten and should work much better. overall
  • ATPA improvements: added enable/disable commands, improved various details.
  • Added support for middle-click-drag to move lists.
  • Also, middle clicking anywhere that's not inside a list or on a track shows the bounds of all visible lists.
  • Fixed bug with DCB spinners not disabling after a click.
• ERAM updates:
  • Added CRR (continuous range readout).
  • Added .drawroute
• Assorted improvements to emergency aircraft handling.
• Cleaned up and updated the new sim / sign in UI.
• "At fix, cleared approach" no longer requires naming the approach: AFIX/C is sufficient.
• Reinstated "/message" in TGT GEN mode to send a global chat message to all controllers.
• VFR updates:
  • Improved pronunciation for most GA aircraft types.
  • Sometimes aircraft start with "VFR request": use the new GA ("go ahead") command when ready for it.
• Bug fixes:
  • Fixed an occasional crash on startup.
  • Fixed a bug where hold for release wasn't actually happening.
  • Fixed a bug with auto-select of the scenario start time based on the runway config.
  • Fixed a bug where the first departure would almost always be an emergency aircraft.
  • Fixed a number of cases where the server was missing locks that could have led to rare crashes.
• Facility engineering
  • Added "max_distance" field for when far-away aircraft are culled (125nm default for STARS, 400nm for ERAM)
  • "solo_controller" and "multi_controllers" are both gone: "configuration"s are now specified in "config"; they give which arrival/departure flows go to which controller. Then each scenario has a "configuration" field as well; it references a configuration from "config" and also provides a default consolidation: the controller hierarchy.
  • Removed deprecated "arrivals" for specifying arrival rates; this is now "inbound_rates".

0.13.2 (22 November 2025)

• Fixed crash affecting a number of scenarios (Adam E)
• Fixed crash when the server can't be reached
• Added pilot radio mishaps (Michael Trokel): where pilots occasionally respond with confusion to controller commands
• Scenario updates A80, A90 (radarContacto), A80 (anguse), C90, DAB (Jud Lopez), M98 (Adam E.)
• New scenarios: ZJX (Jud Lopez), HNL, OGG TRACONs (Ketan K)
• Added emergency aircraft
• WX: improved support for Alaska and Hawaii (now have wind for Alaska and are collecting precip radar for both now)
• STARS:
  • 'C' command clears aircraft on the already-assigned approach 🎉
  • Only flash WHO for aircraft in departure filter volumes
  • Fixed crash with global leader lines.
• Facility engineering:
  • Virtual departure controllers ( @Michael Trokel | ZNY ): can assign specific virtual departure controllers for particular departure routes
  • HCF "TRACON": HCF is now recognized as a TRACON
  • Don't require controller "default_maps" to be in "video_maps"

0.13.1 (6 November 2025)

• Fix Windows installer build.
• Bugfix: when an aircraft in a hold is given a heading, they now fly the heading directly.

0.13.0 (5 November 2025)

• Added initial support for ERAM 🎉🎉🎉 (Michael Trokel)
  • Added ERAM scenarios: ZNY (Michael Trokel), ZLA (Ketan K), ZBW (Ryan G)
  • A functioning toolbar with real videomaps, brightness (including map brightness), DEST & TYPE line 4 DB fields, and the master toolbar menu.
  • Full and limited datablocks are simulated with line 4.
  • Leader lines
  • PTLs which can be extended using VECTOR or page up/down
  • Many ERAM commands are simulated, including:
  • QX (drop track. Note: QT for initiate track is not simulated).
  • Accept, recall, and send handoffs.
  • QU (including QU /M.)
  • J rings, both 5nm and 3nm.
  • Hard and temporary altitudes using QZ and QQ, respectively.
  • // for on frequency indicator
  • MR for geomaps
  • ERAM menu in vice settings, which contains:
  • Preference sets
  • Toggle for mapping ERAM commands to radio commands.
• New scenario: SAT (Trey Hensley, Xavier Caldwell)
• Scenario updates: PCT/DCA, CHP, RIC, NorCal, SoCal, P50 (Ketan K), JAX (Jud Lopez), D01 (Andrew S)
• Control commands can be entered—but still not issued—during pilot readbacks
• Wind/weather simulation is more accurate and based on historical real-world data
  • Winds aloft are much more accurate, thanks to hourly wind data from the NOAA.
  • Added STARS .WIND command to visualize wind fields.
  • VFR aircraft no longer launch in IMC
  • Aircraft climb performance is now affected by weather (temperature, relative humidity, air pressure)
• Added support for holds
  • Hfix to fly a published hold at a fix; see the documentation for how to specify arbitrary holds at fixes.
  • To cancel a hold: clear them for the approach (if they're holding at an approach fix), give them a heading, or give them direct to a fix and the hold will be canceled.
  • The available charted holds can be visualized via a new "Holds" section in the scenario "info" window.
• Single controller scenarios can now be run on the server, allowing RPO/Instructor sign ins for them.
• Bug fixes:
  • Fixed bugs with flight plan acquisition filters
  • Fixed issue with VNAV descent rates that meant that altitude restrictions were sometimes missed.
  • Fixed bug where airport departure rates were not being correctly followed.
  • Fix CT instruction parsing after C/A/S instruction (Adam Engebretson).
  • Prevent redundant altitutde assignment on arrivals (Adam Engebretson).
  • Cleaned up formatting in the departure table (Ethan Malimon).
  • Fix crash with dropped tracks.
  • The application on Windows is there again.
• Facility engineering:
  • Updated to Oct 30 2025 AIRAC.
  • In STARS filters, "arrival_acquisition" has been renamed to "auto_acquisition" to better describe what it does.
  • Added /cALT and /dALT route specifiers for virtual-controller issued climb and descend instructions in routes.
  • "wind" has changed: now "direction", "speed" and "flight_rules" can be specified; vice will randomly pick WX that matches. Ex: "wind": { "direction": "130-180", "speed": "5+", "flight_rules": "IMC" }. "speed" and "flight_rules" are optional. If no "wind" is specified, WX is selected based on the primary runway orientations.
  • Added crc2vice-eram command

Key Concepts

STARS uses RADAR to determine the location of objects in the sky; if an aircraft has a functioning transponder, it sends the radar additional information including its altitude, a beacon code it is squawking, and the aircraft's callsign (assuming an ADS-B transponder.) For many aircraft, the STARS system doesn't know anything more about them (e.g., the aircraft type, the planned route, etc.) Such radar tracks are rendered like this:

There is a position symbol (here, an asterisk), and a green leader line connecting the position symbol to the datablock, which here just shows the radar track's altitude, in hundreds of feet. The purple dots to the left are the history trail, showing the aircraft's position 5, 10, 15, ... seconds in the past.

Some radar tracks have flight plans associated with them; such tracks are called associated tracks (and tracks without a flight plan, as the one above, are unassociated.) Given a flight plan, STARS is able to provide more useful information in the aircraft's datablock, as shown here:

Here we see the datablock showing the aircraft's callsign, LXJ137, its altitude in hundreds of feet (040) multiplexing with its destination airport (CDW), and its groundspeed in tens of knots (28) multiplexing with its aircraft type, CL30. The "H" after groundspeed is the aircraft's consolidated wake turbulence (CWT) category—upper small. (See the section on datablocks for extensive documentation of datablocks and the information that they may show.) For this aircraft, the "P" in the middle of the circle (the position symbol) indicates which controller is the owner of the aircraft's track. (In contrast, unassociated tracks cannot be owned by a controller.)

Most IFR aircraft automatically have flight plans associated with them. For VFR aircraft or for VFRs that request pop-up IFR clearance, a variety of commands are available to create flight plans and associate them with aircraft; see the section on Flight Plans below.

A single controller may own an aircraft's track and a single controller may own control of an aircraft. The same controller may own both or two different controllers may own each track and control. A controller must have control of an aircraft in order to issue instructions to the pilot. See the discussion of Track Ownership below for more information about how control and track ownership are transferred between controllers.

Each controller in the terminal environment is responsible for at least one terminal control position (TCP). (A single controller may cover multiple positions when multiple positions have been consolidated.) Each TCP is identified by three characters:

• The first character gives the facility; more or less the TRACON or ATCT/TRACON where the position is located.
• Facilities are split into multiple areas; the second character which area the TCP is in.
• Finally, each area is split into sectors; these are denoted by the third character.

Consider for example the N4P TCP: the N indicates the N90 (New York) TRACON; the 4 is for the fourth area (which is the Newark area) of N90; finally, the P is the Yardley sector of the Newark area.

Controllers interact with the STARS system via a terminal controller workstation (TCW), which consists of a physical display and keyboard. Each TCW has an identifier that corresponds to a single TCP. Normally a TCW is responsible for just that one TCP, but through consolidation, a TCW may be responsible for multiple TCPs. (In many scenarios, a controller will be responsible for multiple TCPs.)

Other controllers, both real and virtual, may be signed in when you're running a vice scenario. The list of controllers is available in the "Controllers" drop-down in the scenario information window. Among other useful information, it shows the TCP identifier associated with each controller and whether the controller is human.

Entering Commands

Some STARS commands are entirely keyboard based: you enter a command and hit the [ENTER] key to issue the command. As you type, your input will be shown in the input area, which is by default on the left side of the screen. Entering a space starts a new line. To edit your input, the backspace key can be used. Alternatively, pressing [ESCAPE] clears the input and any errors that are displayed.

Many STARS commands involve selecting an aircraft that they apply to; in STARS this is called "slewing" the aircraft. To slew an aircraft in vice, click on its radar track with the left mouse button. You will often enter a command with the keyboard and then slew an aircraft; if the documentation below, [SLEW] indicates that an aircraft should be slewed to execute the command. In the following, if a listed command doesn't end with [SLEW], then it should be understood that [ENTER] must be pressed to execute the command.

Many STARS keyboard commands take additional parameters such as an aircraft callsign, a beacon code number, or a controller identifier. The following notation is used for these entries in the documentation below:

The STARS keyboard has a number of custom keys that are not present on standard keyboards. In the following documentation, when one of the STARS keys in square brackets below is shown, the corresponding regular keyboard key should be entered.

When issuing a command leads to an error, STARS prints an abbreviated message above the input area. These are the error codes that vice currently uses:

Specifying Controllers

A number of STARS commands take controller IDs to specify other controllers; examples include handoffs and point outs. The following rules apply to them:

• For pairs controllers in the same facility, the full TCP may be entered, or the facility may be omitted and only the area and sector given. Thus, for a handoff from Yardley, N4P, to LaGuardia departure, N1L, the Yardley controller could specify 1L for LaGaurdia departure.
• If the other controller is in the same area of the same facility, then only the sector needs to be entered: for example, N4P can hand off to N4A, the Newark North arrival position, just by specifying A for the TCP.
• For TCPs outside of the facility, the delta (∆) symbol must be specified before the TCP; in vice delta is mapped to the backtick key. The full three-letter TCP may be given, though the area and sector may be omitted if the facility only has one TCP.
• To handoff to an enroute controller, the enroute facility identifier and sector must be provided; enroute sectors are identified by two-digit numbers. For the home ARTCC, the facility identifier is generally C, unless a neighboring ARTCC's facility identifier is "C", in which case the facility identifier for the home ARTCC changes from a "C" to the regular facility identifier. Thus, for ZNY, "N" is used rather than "C". The sector may be omitted if there is only one enroute controller signed on.
• For handoffs, airspace awareness rules may be provided in the scenario definition; these are rules that associate specific controllers with departing aircraft based on their altitude, the fix they are flying to, and possibly their aircraft type. When such a rule applies to an aircraft, a handoff to a corresponding enroute controller can be initiated simply by entering the enroute facility identifier, without the sector. For a handoff to a controller in a neighboring facility where an airspace awareness rule applies, just ∆ and the facility id are sufficient.

The airspace awareness definitions in a scenario can be found in the scenario information window, accessed by clicking in the main menu bar.

The following STARS commands offer further control over how airspace awareness is applied:

The Cursor Home and Hiding the Cursor

After a keyboard command is entered, the STARS cursor may be optionally returned to a "home" position and hidden. It will then reappear when the mouse is moved. The "CURSOR HOME" button in the auxiliary DCB menu can be used to toggle this behavior. If not specified using one of the following commands, the default home position is at the upper-left of the SSA list.

Quick Reference

For basic controlling, a small number of STARS commands are used frequently. The following table lists them and gives a short description of their operation.

The DCB

The display control bar (DCB) is a menu that is shown by default at the top of the STARS window. Many aspects of STARS's behavior can be configured using the DCB.

There are four types of buttons in the DCB:

• Toggle buttons: these enable and disable various features. When enabled, they have a lighter color than usual and appear depressed (like the "OFF CNTR" and "WX 3", "WX 4", and "WX 5" buttons above.) Clicking them toggles whether they are enabled.
• Menu buttons: when clicked, they replace the contents of the DCB with those for another DCB menu. For example, clicking "MAPS" from the main DCB brings up a menu for configuring which STARS video maps are displayed.
• Spinners: these allow setting various STARS parameters using the mouse wheel. For example, clicking "RANGE" allows setting the radar's range in nautical miles. Spinners capture the mouse and don't allow the cursor to leave their button until the user either clicks the mouse or presses the [ESCAPE] key. When a spinner is active, it is also possible to enter a new value for it using the keyboard and then pressing [ENTER].
• Disabled buttons: these are shown in dark grey and represent STARS functionality that is not currently available in vice.

DCB submenus generally have buttons that return to the main DCB menu—look for a button labeled "DONE" or "SHIFT". Alternatively, pressing the [ESCAPE] key will return to the main DCB menu.

The main DCB menu offers the following controls:

• RANGE: sets the range of the radar scope (see STARS Configuration).
• PLACE CNTR/OFF CNTR: controls to set the center point of the radar scope (see STARS Configuration).
• RR/PLACE RR/RR CNTR: controls for range rings that are shown on the display
• MAPS (and the six buttons to the right): controls the visible video maps.
• WX*: controls which levels of weather intensity are displayed.
• BRITE: controls the brightness of various elements on the display.
• LDR DIR/LDR: configures leader lines from radar tracks to data blocks.
• CHAR SIZE: sets the character size for various elements on the display.
• PREF: allows loading and saving STARS preference sets.
• SITE: configures which radar sites are active.
• SSA FILTER/GI TEXT FILTER: configures which elements of the System Status Area list are displayed.
• SHIFT: displays the auxiliary DCB menu (documented below).

Here is the auxiliary DCB:

Many of its buttons are disabled; the enabled ones are:

• VOL: controls the volume of STARS audio alerts. A short test sound is played when it is changed.
• HISTORY: sets the number of dots drawn showing the aircraft's radar track history.
• H_RATE: sets the rate in seconds that a new dot is added to aircraft history trails.
• CURSOR HOME: controls whether the cursor is hidden and returned to home position after a keyboard command is entered.
• DCB LEFT/RIGHT/TOP/BOTTOM: sets the side of the radar scope where the DCB is displayed.
• PTL LNTH/PTL OWN/PTL ALL: controls Predicted Track Lines (PTLs).
• DWELL: enables or disables dwell mode.
• TPA/ATPA: displays a submenu to configure terminal proximity alerts (TPAs) and automated TPAs.
• SHIFT: returns to the main DCB menu.

Press the [DCB] key (control-F9) to Toggle whether the DCB is visible.

Track Ownership

Controllers must both own an aircraft's track and have control of the aircraft in order to issue instructions to the aircraft's pilot. Managing ownership of tracks and control of an aircraft is at the core of how multiple controllers work together to control an aircraft; it is crucial that controllers hand off both the track and control of an aircraft before it enters another controller's airspace.

Untracked Aircraft

When an aircraft departs an airport, its track and control may not be owned by any controller. VFR aircraft may also enter a controller's airspace without being tracked; these are known as unassociated tracks since there is no flight plan associated with them. These aircraft have a limited datablock, which only shows the aircraft's altitude in hundreds of feet. The datablock is drawn in green indicating that the current controller does not own it, and the asterisk shown in the position symbol at the center of its track (the blue dot) also indicates that its track is unowned.

If an unassociated track's transponder is turned off, it appears with a plus sign in its position symbol and no altitude is shown; such a track is also referred to as a primary-only or primary track, since no secondary information is returned by its transponder. If its transponder is on but it is not squawking altitude, a diamond is used for its position symbol. Here are some examples.

   

Departures contact the appropriate controller on the radio once they're a few hundred feet off the ground; look for a message in the input window below the STARS scope:

For departures, you may disable the "Auto track departures" checkbox in the "Settings" window to not automatically initiate track on the departing aircraft that you are responsible for in the current scenario.

When you own an aircraft's track, the datablock becomes white a full datablock and the letter corresponding to your position's TCP (here, "G") will appear at the center of the radar track.

Note that you can not issue control instructions to an aircraft unless it is on your radio frequency. If you track a departure before it contacts you, it is still under the tower's control and tuned to the tower's radio frequency. Once the (virtual) tower controller tells the aircraft to "contact departure", they will check in with a message on your radio frequency. It is at this point that you also have control of the aircraft and can start issuing control commands to it.

Inbound Handoffs

Aircraft entering your airspace will be generally owned by another controller (human or virtual) before they are handed off to you. Initially, they are displayed with a partial datablock that shows altitude in hundreds of feet, groundspeed in tens of knots, and the scratchpad, if set. Often it is a center controller who owns the aircraft and a "C" will be displayed for the position id, as in the example below:

The controller who owns the aircraft's track may eventually hand it off to you; at this point, the datablock will turn white, start flashing, and change to a full datablock as shown below.

The datablock will continue flashing until you accept the handoff by slewing the aircraft's radar track using one of the following commands:

After a handoff is accepted, the aircraft's datablock will stop flashing and remain white. However, as with departures, you do not have control of the aircraft until the other controller instructs the aircraft to contact you, transferring control as well. After the aircraft contacts you on the radio, you may start issuing control instructions to it.

Outbound Handoffs

When you are ready to hand off an aircraft's track to another controller, a number of commands are available to do so:

(For these commands, determining the correct controller ID to enter has a few subtleties and is discussed further below.) The datablocks of outbound handoffs have an identifier for the target controller stuffed into the second line of the datablock, four characters in. For JBU52 below, it is "V", corresponding to the intrafacility position "1V" that the aircraft is being handed off to, and for TAM9021, it is "C", corresponding to a center position. For handoffs outside the facility (including to center), the position identifier is shown in the datablock multiplexed with the altitude and scratchpad (it is "N86" for TAM9021.)

After the other controller accepts the handoff, control of the aircraft's track is transferred to them. The aircraft's datablock will start flashing to notify you of this and the letter on the track will switch to be the other controller's. After a few seconds the datablock will stop flashing. Note that at this point you still retain control of the aircraft and can issue control instructions to it since you haven't yet transferred control to the other controller.

When you are ready to transfer control of the aircraft to the controller who has accepted the track, enter the FC command in the command input window and slew the aircraft. This will instruct the aircraft to switch frequencies to the next controller. Clicking on the track of an aircraft that has been handed off causes the datablock color to switch to green; this can be used to remember that you have transferred communications of an aircraft to the other controller.

Redirecting Handoffs

An incoming handoff can be redirected to another TCP by entering the TCP's ID and slewing the aircraft, just as if you owned the track and were handing it off. Doing so will add RD to the datablock shown to the handoff initiator and the redirector, and show the TCP to where the track was redirected to. This also turns the datablock green for the redirector. Here is a datablock for a redirected handoff as seen by the original handoff initiator; we can see that it has been handed off to the "X" TCP at the facility.

Redirected handoffs can be canceled using the same commands as are used for canceling regular handoffs.

Terminating Control

In addition to handing off tracks to other controllers; a controller may terminate control, otherwise known as "radar services terminated, frequency change approved". The following commands are available:

Point Outs

Point outs let controllers direct another controller's attention to an aircraft; some facilities may have prearranged coordination procedures where an aircraft may pass through another controller's aircraft after a point out, or a point out may be performed before verbally coordinating with another controller. The following commands are available for point outs:

An outbound point out is shown on the originator's scope with "PO" to the right of the aircraft id, followed by one character identifying the other controller's TCP. (Here, "B", for TCP 1B.)

An inbound point out causes the corresponding aircraft's datablock to switch to a FDB and flash yellow, with "PO" shown after the aircraft id.

Clicking on a point out acknowledges it. This causes the datablock to stop flashing but leaves the datablock yellow. A second click reverts to a green datablock, but leaves it as a FDB. A third click will then change back to a regular green PDB.

On the originator's scope, an accepted point out causes a flashing "PO" to appear to the right of the aircraft id for a few seconds.

An inbound point out can be rejected by entering UN[SLEW]; a flashing "UN" is shown to the right of the datablock on the originator's scope in this case.

Position Consolidation

It is possible to change which human controller is responsible for which terminal control positions (TCPs) while a simulation is running—more specifically, which TCPs a terminal control workstation (TCW) is responsible for. One way this happens is when a new controller connects to a sim at an unoccupied TCW. Another way is through explicit STARS consolidation commands, which allow one TCW (the receiver) takes over the responsibilities of another position (the sender).

Consolidation operates at the level of terminal controller workstations (TCWs). Each TCW may have a primary TCP (the one that matches its identifier) and may have zero or more secondary TCPs that have been consolidated into it. (Instructors and RPOs may sit at a TCW with no TCPs assigned to it.) The controller at a TCW can control aircraft assigned to any the TCPs it owns, whether primary or secondary.

There are two types of consolidation:

• Basic: The receiving TCW takes control of inactive and future flights from the sender. Inactive flights are flight plans that are not yet associated with a radar track. Future flights are those that have not yet departed or entered the airspace.
• Full: The receiver takes control of all flights from the sender, including active flights that are currently being controlled.

The following commands are available for consolidation. In these commands, the triangle character (∆) can be entered to specify the current controller's TCW as the receiver. TCPs and TCWs are specified as 1 or 2 characters; if only 1 character (the sector) is given, the current controller's facility (controller subset) is assumed (e.g., a controller at 2G may specify 2K as either "K" or "2K", but must specify 3H as "3H".)

When positions are consolidated, the receiver's TCW gains responsibility for aircraft assigned to the sender TCP. The receiver controller sees and controls these aircraft alongside those assigned to their primary TCP. Note that aircraft tracks remain assigned to their original TCP; if the sender TCP is later deconsolidated (returned to its own TCW), those tracks will be controlled by whoever is at the sender's TCW.

Track Information

Much information is encoded in the radar track symbol of an aircraft and the datablock displayed next to it. STARS provides many different ways to configure how this information is presented in an effort to balance providing the necessary information about aircraft that are important to a controller while minimizing the visual clutter from aircraft that are less relevant.

Track Symbols

The location of each aircraft visible to RADAR is shown using a primary target symbol. Which shape is used for the symbol depends on which RADAR mode has been selected and which RADAR sites are active. FUSED is the default radar mode, in which case a small blue circle is used for aircraft tracks, as in the examples so far.

In MULTI mode, a small blue rectangle is used in place of the circle and the rectangle is oriented based on the aircraft's heading; this example is flying in a northeasterly direction:

In SINGLE mode, a blue rectangle is also used, but the size of the rectangle varies based on how close the track is to the RADAR site and the rectangle is oriented toward the RADAR site rather than according to the aircraft's heading. The track is bigger the farther away it is from the RADAR site, which helps show the degree of uncertainty in its position. SINGLE mode also includes a green line on the far side of the track with respect to the RADAR site's position. This track is 50 miles from the RADAR site so has a relatively large rectangle, and the RADAR site is to the East, so the green line is on the left:

In SINGLE mode, if the aircraft is very far from the RADAR site, only the outline of the blue rectangle is shown.

The brightness of track symbols is controlled using "PRI" in the DCB BRITE menu.

Track History

STARS can draw a trail of small purple circles behind a track to show its prior path. The number of circles drawn and the time between adding a new circle to the trail is set using the HISTORY and H_RATE buttons in the auxiliary DCB:

HISTORY sets the number of history dots; it may range from 0 to 10. Here is a track with a full complement of 10 history dots:

H_RATE sets the time in seconds before STARS tries to add another history dot. Note that after this time passes, STARS does not immediately add another dot; rather, it waits until the next RADAR position is received for the aircraft. Under FUSED RADAR mode, positions are received every second, and under MULTI and SINGLE modes they are received every 5 seconds. Thus, for example, under FUSED mode with a H_RATE of 4.5, a new history dot is added every 5 seconds: STARS waits 4.5 seconds since adding the previous dot, which by definition occurred when a new RADAR position was received. When the next arrives in 0.5 more seconds, a dot is added, leading to a 5 second overall rate.

The brightness of track symbols is controlled with "HST" in the DCB BRITE menu.

Position Symbols

All tracks have a single-character position symbol at their center that indicates which controller owns the track. Position symbols are determined as follows:

• If the track is owned by a controller in the current controller's facility, the controller's sector ID is used. (For example, if N4P is the current controller's TCP, an aircraft controlled by N1V would be shown with an "V".
• If the track is owned by a terminal controller in an adjacent facility, the facility id is shown.
• If the track is owned by an enroute controller, either "C" or the enroute facility ID is shown.

The brightness of track symbols is controlled using "POS" in the DCB BRITE menu.

For unassociated primary tracks that are not squawking altitude, the triangle that is normally drawn for their position symbol can be disabled.

For unassociated tracks that do have functioning transponders, is also possible to select individual beacon codes or beacon codes blocks; unassociated aircraft squawking matching beacon codes are then displayed with different position symbols than the usual. By default, all 12xx beacon codes are handled this way. In that case, aircraft not squawking altitude are drawn with a triangle position symbol and those that are are drawn with a square.

Datablock Types

There are three datablock formats that may be used, depending on circumstances: limited datablocks (LDBs), partial datablocks (PDBs), and full datablocks (FDBs)s.

Limited Datablocks (LDBs)

Limited datablocks are shown when a target is not tracked by a TCP. By default, they only display the altitude's altitude in hundreds of feet, though if the track is slewed, they display the aircraft's assigned squawk code and groundspeed for a short period of time.

A few commands are also available to control the display of squawk (beacon) codes in LDBs:

The brightness of LDBs is controlled using LDB in the DCB BRITE menu.

If a departing aircraft is squawking a non-1200 code but there is no flight plan for the code they are squawking, a flashing "WHO" is displayed in their LDB next to the code they are squawking:

Clicking on the track clears the "WHO".

If you're searching for an unassociated aircraft squawking a specific beacon code, the beacon code display command can be used to cause all aircraft squawking that code to flash it in yellow in their limited datablock.

Partial Datablock (PDBs)

Partial Datablocks are associated datablocks that are owned by another controller. They show the aircraft's altitude and groundspeed (in tens of knots), followed by a letter indicating its consolidated wake turbulence (CWT) category; see below for more information about CWT. The altitude may alternate with the aircraft's scratchpad or destination airport, as in the example below:

Some STARS facilities use variations on the above PDB format: they may also include the secondary scratchpad, time-share the aircraft type with the groundspeed and CWT category, not include the groundspeed, or show the groundspeed and CWT category separately.

Slewing a PDB converts it to a full datablock; a second slew returns it to a PDB.

The brightness of PDBs is also controlled using LDB in the DCB BRITE menu.

Full Datablock (FDBs)

Full datablocks provide the most information about aircraft; at minimum, they show the aircraft identifier (i.e., its callsign), its altitude in hundreds of feet, its groundspeed in tens of knots, a letter denoting its CWT category, and the aircraft type. Groundspeed and CWT category alternate with the aircraft type, as shown here:

Various other information may be present in a FDB. Here we see the primary scratchpad "L30" and the secondary scratchpad "DEP" alternating with the altitude, where a "+" after "DEP" indicates that the secondary scratchpad is shown. We also see a temporary controller-assigned altitude of 12,000 feet indicated by "A120" in the third line.

The brightness of FDBs is also controlled using FDB in the DCB BRITE menu.

The FDB is displayed for a track if any of the following is true:

• The track is owned by the current controller.
• The track is being handed off from another controller to the current controller.
• The track is a redirected handoff where the current controller has either redirected it or had it redirected to them.
• Another controller has pointed out the track to the current controller and the point out hasn't been cleared.
• The user has clicked on a track owned by another controller.
• The track is owned by a controller whose sector id the user has quicklooked.
• The track has been force quicklooked to the current controller by another controller.
• "Quick look all" has been enabled by the controller.
• The aircraft is squawking a special purpose code (e.g., 7700 for an emergency) or if it has an active safety alert (e.g., low altitude).
• The aircraft's beacon code matches one being displayed via the **#### command.
• The "overflight full datablocks" option is enabled and the track is an overflight.

Other than the commands related to modifying Flight Plans that can lead to changes in what entries are shown in the FDB, there is just one command to manage the FDB's contents:

A few commands are also available to control whether the FDB is displayed for overflights that are not under the user's control:

"Beaconator"

The "beaconator" feature is enabled by holding the Control and F1 keys on the keyboard. In full datablocks, it causes the aircraft id to be replaced with the code the aircraft is squawking. Partial datablocks show the sqwawk code in the first line, and limited datablocks show the squawk code and aircraft id. Here is an example of all three types of datablock, alternating with the beaconator enabled and disabled.

Datablock Control Commands

Additional Datablock Entries

A number of additional useful pieces of information can be found in datablocks, depending on the circumstances. (See also the section on STARS Flight Plans for information about a number of things such as scratchpads and altitude assignments that appear in datablocks and are managed along with the aircraft's STARS flight plan.)

Ident

If a controller has instructed an aircraft to ident, a flashing "ID" will appear in its datablock. In FDBs, "ID" replaces the CWT category next to the airspeed and the aircraft type is temporarily no longer displayed. LDBs display the aircraft's squawk code and "ID" for identing aircraft, and PDBs display "ID" at the end of the second line of the datablock.

Squawk Codes

If an aircraft is not squawking the beacon code assigned to it, the bottom line of the full datablock shows both the code it is squawking (on the left) and the code it has been assigned (on the right). The code that it should be squawking flashes to alert the controller. Slewing the aircraft makes its assigned squawk code the same as the code it is currently squawking.

Consolidated Wake Turbulence (CWT)

Each type of aircraft has been assigned a Consolidated Wake Turbulence (CWT) category by the FAA. CWT categories range from "A" to "I" and go in decreasing order of aircraft size. Aircraft CWT categories are shown in both PDBs and FDBs. This table lists the categories and has representative aircraft types for each one.

Special Purpose Codes (SPCs)

If an aircraft squawks a special purpose code (SPC) (e.g., 7600 for a radio failure, 7700 for an emergency, etc.), the corresponding two-letter code is shown in red at the top of the FDB and an alert sounds. The alert can be silenced by slewing the aircraft. Here is an example for an aircraft squawking 7700.

The controller may also associate an SPC with an aircraft regardless of what it is squawking by entering a SPC and slewing the aircraft. An alert sound is not played in this case. The following codes may be used:

It is also possible to add custom codes for a facility via "custom_spcs" in "datablocks". Custom SPCs are shown in yellow.

Leader Lines and Positioning Datablocks

Leader lines connect radar tracks to the datablocks of the associated aircraft. They may have eight orientations, corresponding to the eight cardinal and ordinal directions. Here is an example of a radar track with a leader line East of the aircraft (left) and Northwest of it (right):

The DCB offers two buttons for configuring leader lines:

The top button, LDR DIR, is a spinner that controls the default direction of leader lines for aircraft whose tracks that are owned by the current controller. The bottom button, LDR, controls the length of all leader lines. The leader line length can range from 0 to 7, with the range of lengths shown below:

A number of keyboard commands are available to specify leader lines, including ways to specify them for subsets of the aircraft. These all use the numbers 1-9 to specify a leader line direction; depending on the command, 5 may be used to clear a previously-set direction or it may be invalid.

If you have a numeric keypad on your keyboard, you have an easy reference to the association between numbers and directions; consider the aircraft to be at the position of the "5" key and then the other numbers specify the direction of the leader line relative to the aircraft. If you don't have a numeric keypad, visualize one, or refer to this figure:

A number of commands are available to configure leader lines, where all uses of (#) below correspond to a number following the above convention for specifying directions:

Quicklook

"Quicklook" makes it possible to specify that all tracks owned by another controller will be shown with a full datablock instead of a partial datablock. This can be useful when one controller is feeding aircraft to another; quicklook gives some more visibility into the flow of inbound aircraft. When "quicklook plus" is used, the datablocks of quicklooked aircraft are also shown in white rather than green. Facility engineers may also specify regions of airspace where quicklook automatically applies.

A number of commands are available to control quicklook:

Command	Function
(TCP)/ [MULTIFUNC]Q(TCP)	Toggles quicklook for the specified control position. Multiple positions may be specified, separated by spaces. If a "+" is included after the control position, quicklook plus is toggled. If the user's current TCP is entered, the currently-quicklooked positions and enabled/disabled regions are shown in the preview area—here is an example:
ALL/ [MULTIFUNC]QALL	Enables "quicklook all", where all aircraft are shown as being quicklooked.
ALL+/ [MULTIFUNC]QALL+	Enables quicklook all plus for all aircraft.
[MULTIFUNC]Q	Disables all active control position quicklooks.
[MULTIFUNC]Q(region) E	Enable the named quicklook region.
[MULTIFUNC]Q(region) I	Disable (inhibit) the named quicklook region.
[MULTIFUNC]Q(region)	Toggle whether the named quicklook region is enabled.
[MULTIFUNC]Q*	Disables all quicklook regions.

The currently-active quicklook positions can be shown in the SSA list, after "QL:".

To see which if any quicklook regions are available, select the "MAPS" menu from the DCB and then select "SYS PROC" to see the Processing Areas maps list. Quicklook regions can then be found among those maps; here we see that "QLRGNS" represents all quicklook regions and "QLCONEY" is an individual region:

Force Quicklook

A controller can also "force quicklook" a track that they own to cause its full datablock to be shown on another controller's display. Force quicklooked aircraft also have yellow datablocks for the recipient, until they clear the forced quicklook by slewing the track.

Dwell Mode

Dwell mode increases the brightness of the track and datablock of the aircraft closest to the mouse cursor, if the mouse is reasonably close to a radar track. Here is an example of it:

It can be configured using the DWELL button in the auxiliary DCB; it may take the value OFF, ON, or LOCK. OFF disables DWELL mode and ON enables it, with the increase in brightness lasting as long as the mouse cursor is close to a track. With LOCK mode, the increased brightness of a track persists, even after the mouse cursor moves away. Only when another track is approached by the mouse cursor does the brightness increase switch to it.

Dwell mode can also be configured using the keyboard:

Altitude Filters

Controllers can set altitude filters to hide the datablocks and leader lines of aircraft outside a range of altitudes of interest; doing so can help reduce the amount of clutter on the screen. Here is an example of a track that is outside the filter range:

Note that if an track is pointed out or is an inbound handoff, its full datablock will still be shown, even if it is outside of the current altitude filter.

STARS supports two filters, one for unassociated tracks and one for associated tracks. Each of these filters is a range of altitudes, specified in hundreds of feet. The following commands are available to manage altitude filters:

Flight Plans

vice offers a wide range of commands for creating flight plans on the fly for aircraft that didn't initially file one; the main example of this currently is VFR aircraft that call asking for flight following. A wide variety of are commands available to create flight plans in STARS—these are all documented in the following. In practice, however, it's just necessary to understand two main flows, depending on which type of flight plan is to be created:

• Local Flight Plans: these are intended for flights conducted wholly within delegated airspace of the current TRACON. These flight plans are not sent to the host (overlying) ARTCC computer to be processed and forwarded "downstream" to adjacent facilities. Examples include IFR/VFR pop up requests where the flight will not exit the delegated airspace of the TRACON. However, local flight plans are not eligible for automated hand off to ARTCC. If an adjacent TRACON is adapted to accept local flight plans, then they may be transferred via automated handoff.
• NAS Flight Plans: these are for aircraft that will enter adjacent facility airspace, for example, VFR aircraft requesting radar advisories/flight following from a point within delegated TRACON airspace to a location outside of it. STARS users are only permitted to create VFR NAS flight plans; IFR NAS flight plans would be entered via FDIO, which is a separate system from STARS and not yet simulated/not needed for vice (for now). VFR aircraft on NAS flight plans are eligible for automated handoff to adjacent facilities.

The most common way to enter a local flight plan is to type the aircraft's callsign, a space, the type of aircraft, and press [Enter]. For example: N123AB C172. (Additional fields may be entered; see the documentation below.) A summary of the flight plan will be printed in the preview area and the flight will appear in the tab list ("FLIGHT PLAN"). The beacon code assigned to the aircraft can be found in either place.

The usual way to create a NAS flight plan is to enter the callsign, the entry and exit fix separated by an asterisk, the aircraft type, and the requested altitude in hundreds of feet. Example: N123AB FRG*POU C172 085. The entry fix is usually the departure point of the aircraft or a point (VOR) near where they call for flight following and the exit fix is usually the VFR's destination; both must be three characters. When STARS sends the a VFR NAS flight plan to the ARTCC computer and it is accepted, "VFR" is displayed to the right of the aircraft's callsign in the "VFR LIST". The beacon code is displayed when received from ARTCC computer a few seconds later. The flight also appears in the "FLIGHT PLAN" list.

For the full documentation of the flight-plan related commands below, in addition to the command components defined above in Entering Commands, a few additional parameters are commonly-found in commands related to flight plans. Here are their definitions and syntax:

Creating Flight Plans

STARS offers numerous commands for controllers to enter new flight plans; most start with one or more required fields that are then followed by optional fields. Spaces separate all fields, both required and optional. See the table above of common components of flight plans for the rules for the format of the following entries.

The following create new flight plans that are not yet associated with an aircraft; these flight plans are shown in the FLIGHT PLAN system list and/or the VFR LIST, depending on their type.

It is also possible to create a new flight plan and immediately associate it with a track. For both of the following commands, if the beacon code isn't specified, the code that the track is currently squawking is used as the assigned code.

Activating Existing Flight Plans

If an unassociated track is squawking the beacon code associated with a flight plan, the flight plan will often automatically associate with the track. (This may not happen if the aircraft is outside of the predefined regions in a TRACON where flight plans automatically associate, but it is generally the case.) Alternatively, a command is available to associate an existing flight plan with a radar track.

Deleting Flight Plans

Two commands are available for deleting flight plans. If a flight plan is associated with a track, the track becomes unassociated if it is deleted.

Flight Plan / Beacon Code Display

After a flight plan is created (and in some cases, after it is modified), an abbreviated version of the flight plan is displayed in the preview area. Here is an example:

We have an aircraft with callsign ANA203 that has aircraft type A388. The "/A" is its CWT weight class—super. It has been assigned beacon code 1711 and controller 2G is responsible for it. It is departing JFK airport and its exit fix is GAYEL, shortened here to "GAY". Its expected departure time is 2230 zulu, and its requested altitude is 37,000'.

There are also commands to cause a selected flight plan to be displayed:

Modifying Flight Plans

For the following commands, if (FLT ID) is used to specify the flight plan, the command can be used both for associated and unassociated flight plans. The variants based on slewing a track can only be used on associated tracks, and apply to their associated flight plans.

Scratchpads

In STARS, scratchpads are used to convey information to controllers—for example, the departure exit gate, or an assigned approach. Each aircraft has a primary scratchpad and a secondary scratchpad. Either may be set independently. Scratchpads are three characters by default, but may be four at some facilities. They may contain letters, numbers, plus signs, periods, delta symbols, forward slashes, and asterisks, though they may not contain three numbers. The following commands can be used to manage scratchpads:

In PDBs and FDBs, the primary scratchpad multiplexes with the aircraft's altitude. The secondary scratchpad is only shown in FDBs, where it also multiplexes with the altitude and primary scratchpad, if set; it also has a plus sign displayed after it in the datablock. In the example below, the aircraft has "I2L" for its primary scratchpad and "SS" for its second.

Assigned (Temporary) Altitude

In order to help remember the altitudes they have assigned aircraft, controllers may associate an assigned altitude with each aircraft under their control. Assigned altitudes given in hundreds of feet and are shown on the right side of the bottom line of FDBs; here, we can see that AAL929, currently at 3,700', has been assigned a assigned altitude of 3,000'.

Two commands are available to manage the temporary altitudes associated with aircraft.

Requested Altitude

The requested final cruising altitudes of departing aircraft may optionally be displayed in FDBs, multiplexed with the airspeed and aircraft type. The following commands are available to control this:

Pilot-Reported Altitude

If an aircraft's transponder is not transmitting altitude, the altitude field in the full datablock is left blank. Further, "ISR" is shown in yellow, indicating that there is an increased separation requirement for the aircraft compared to regular IFR separation.

For such aircraft, the pilot may verbally report their current altitude to the controller. A few commands are available to record pilot-reported altitude so that it can be displayed in the datablock. Here, the aircraft has reported that they are at 9,000'. "ISR" is no longer displayed and an asterisk after the altitude indicates that it is pilot-reported and not from the transponder.

Suspended Flight Plans

It can be useful to suspend flight plans to reduce clutter on the radar scope, for example when a number of aircraft are in the same holding pattern. These functions are available:

When a track's flight plan is suspended, the flight plan appears in the COAST/SUSPEND list and its datablock just shows the list index of the flight plan in the COAST/SUSPEND list. Clicking on the datablock displays its altitude for a few seconds; alternatively the commands above can be used to enable the display of altitudes for all tracks with suspended flight plans.

Here is an example of the result of suspending and then unsuspending a track's flight plan:

Repositioning Tracks and Unsupported Datablocks

STARS has commands that allow transferring an associated flight plan from one track to another one or converting it to an unsupported datablock, which is effectively a flight plan temporarily places at a position on the radar scope.

Here is an example of an unsupported datablock. Note that the position symbol for the owning controller is shown (here, "G") as well as a full datablock, though without altitude and airspeed. There is no blue circle at the track position.

Unsupported datablocks may be repositioned back onto existing tracks or may be deleted using [TERM CNTL] and slewing or entering its associated ACID.

An unsupported datablock can also be created from a preexisting flight plan:

Held Flight Plans

vice currently has incomplete support for held flight plans. (These will be useful for IFR aircraft to controlled fields in the future.) That said, the following command is available.

Tools

STARS offers a variety of tools to help with vectoring aircraft and ensuring they remain separated. For most of the tools in this section, the font size is based on the TOOLS font size in the CHAR SIZE menu of the DCB and the brightness is based on the TLS setting in the BRITE menu of the DCB.

Position Reporting

Collision Alerts and Mode C Intruders

If there is a loss of separation between aircraft or if STARS predicts an imminent loss of separation, a collision alert will be issued where red text "CA" is shown in the aircraft datablocks and an alert sound will be played. The alert sound continues until one of the aircraft is slewed. Here is an example of a pair of aircraft with CA alerts:

An alert is also issued if an unassociated track loses separation with an associated track; in this case, the unassociated track is called a mode C intruder (MCI). No alerts are issued for pairs of unassociated tracks.

A few commands are available to enable and disable collision alerts and MCI alerts:

If collision alerts are globally disabled, "TW OFF: CA" will be displayed in the SSA list. If they are disabled for a particular aircraft, a triangle will be shown after the aircraft's callsign in its datablock. Here is a case where disabling CA for two aircraft was not a good idea.

Minimum Safe Altitude Warnings

If aircraft are beneath the minimum vectoring altitude at their location, a minimum safe altitude warning (MSAW) may be issued. Aircraft with MSAWs have "LA" (for "low altitude") displayed in red at the top of their datablocks. An alert sound is played when an MSAW is issued; it can be silenced by slewing the corresponding aircraft. Here is an example of such an aircraft:

MSAWs can be configured with these commands:

When MSAW is disabled or inhibited, an asterisk is shown after its datablock. (If both MSAW and CA is disabled for an aircraft, a plus sign will be shown after its datablock).

A map showing the minimum vectoring altitudes used for MSAWs is included in the "SYS PROC" maps available from the "MAPS" menu in the DCB.

Predicted Track Lines

PTLs (Predicted Track Lines) show the aircraft's predicted course over the course of 0.5 to 3 minutes into the future. Here is an example of a track with a PTL:

PTLs can be controlled using these buttons in the auxiliary DCB menu, which is shown by selecting SHIFT from the main DCB.

PTL OWN sets whether PTLs are shown for tracks that are owned by the TCP, and PTL ALL sets whether PTLs are shown all associated tracks in the current altitude filters. It is also possible to display or hide the PTL of individual aircraft using a keyboard command.

Range Bearing Lines

Range bearing lines (RBLs) track the distance and heading between aircraft and/or fixes. For example, the image below shows an RBL between two aircraft, indicating that N63A is 6.50nm miles along a 118 heading from AAL86. In this case, the RBL was drawn from AAL86 to N63A; if it had been drawn the other way, the label would be next to AAL86 and the heading would be 118+180=298. The "-1" at the end of the label indicates that this is RBL number 1. If additional RBLs were created, they would be given successive numbers to identify them.

RBLs may be created between pairs of aircraft, and aircraft and a fixed location, or a pair of fixed locations. When aircraft are involved, the corresponding RBL endpoint moves along with the aircraft.

The following commands are available to create and delete RBLs:

Minimum Separation

The predicted minimum separation between two aircraft can be shown. Below we see that based on their current routes the two aircraft are predicted to have a minimum separation of 2.15nm and that separation will occur when they are at the two points marked by small triangles.

The following commands are available for minimum separation display.

TPA/ATPA

The terminal proximity alert (TPA) and automated TPA (ATPA) tools provide graphical representations that aid in ensuring that there is sufficient separation between aircraft. A TPA cone can be associated with an aircraft to show a given distance in nautical miles in front of it; see the left image below for a TPA cone marking 4nm. A TPA J-ring is a circle around an aircraft's radar track of specified radius; the right image below shows a J-ring with a 4nm radius.

The following keyboard commands are also available to configure TPA cones and J-rings:

ATPA automatically generates cones for aircraft in the approach volume for a runway. (Approach volumes are generally along the glideslope for a runway.) For example, the image below shows a 5nm cone in front of BAW6895, indicating the required separation for a CWT F-class aircraft (upper large) behind an upper-heavy B-class aircraft. The current in-trail distance, 4.55nm, is shown in BAW6895's datablock, and both that distance and the cone are red, indicating an ATPA alert for loss of separation.

This table shows the minimum in-trail distances required by ATPA for aircraft on approaches; NOWGT is used if the weight class of an aircraft is unknown:

ATPA alerts are issued if a loss of separation is expected in the next 24 seconds, and ATPA warnings (which are drawn in yellow) are issued if a loss of separation is expected in the next 24-45 seconds.

TPA and ATPA can be configured by selecting "SHIFT" from the main DCB menu and then "TPA/ATPA". The following options are provided:

The first four buttons toggle a particular TPA/ATPA option and display "ENABLED" if the corresponding option is enabled, and "INHIBTD" if it is inhibited. "DONE" returns to the previous DCB menu.

• A/TPA MILEAGE: whether the respective radius or length are shown with TPA J-rings or TPA/APTA cones.
• INTRAIL DIST: determines whether the in-trail distance to the next aircraft is shown in the datablocks for arrivals in an ATPA volume.
• ALERT CONES: determines whether ATPA warning and alert cones are automatically created when insufficient separation is predicted. If disabled but monitor cones are enabled, monitor cones will be shown.
• MONITOR CONES: determines whether monitor cones may be automatically created for all arrivals in an ATPA volume.

The following keyboard commands are also available to configure ATPA:

The following supervisor commands are available for system-wide ATPA configuration:

For facility engineers, the ATPA approach volumes are listed in the "PROCESSING AREAS" map list, which can be selected via "SYS PROC" from the DCB "MAPS" menu. Individual maps can be displayed and then hidden by entering [MAPS](###) where ### is the map number associated with the volume.

Compass

To help with determining headings when vectoring aircraft, a compass rose may be displayed around the edges of the STARS radar scope:

The brightness of the compass rose is controlled by CMP in the BRITE DCB menu and the size of the font used is set based on TOOLS in the CHAR SIZE DCB menu.

Range Rings

Range rings are concentric circles drawn around a selected point with successive steps between their radii that are 2, 5, 10, or 20nm. With 5nm steps, the default, here are the 5 and 10nm range rings drawn around KEWR:

A few buttons on the main DCB make it possible to configure range rings. Clicking on RR activates a spinner that allows selecting the step between radii. If PLACE RR is clicked, then the next location clicked on the radar scope will become the range rings' center point. Finally, clicking RR CNTR causes the range rings to be centered on the point at the center of the radar scope; If the range rings are not currently centered, RR CNTR is drawn depressed.

The radius of the range rings can also be set by entering [RANGE] and then 2, 5, 10, or 20, and then pressing enter.

The brightness of range rings can be controlled with the "RR" spinner in the "BRITE" menu of the main DCB. If the brightness is set to 0, range rings are not drawn.

CRDA

The Converging Runway Display Aid (CRDA) helps ensure separation between aircraft on intersecting paths. It does so by drawing "ghost" aircraft on one course that correspond to aircraft on another course. Although originally designed for converging runways, CRDA regions can be defined for any pair of converging paths, including those based on fixes or curved routes. The idea is perhaps best understood with an example:

Here four aircraft are approaching KPHL, AAL45 and JZA868 landing runway 27R and JIA1524 and FFT5099 landing runway 17. With CRDA enabled, ghosts of the aircraft landing 27R are drawn on the runway 17 approach course at the same distance out as they are from the point where the two runways intersect. If we compare the separation of AAL45's ghost with FFT5099, we can see that there will be adequate separation between the two aircraft—FFT5099 will be well past where the runways intersect before AAL45 lands. It's a little tighter with JZA868 and JIA1524, though CRDA might give us the hint to slow down JZA868 to increase distance between them.

Ghost aircraft may be positioned via either "stagger" or "tie" mode. With stagger mode, the ghosts are the same difference from a common point (e.g., the intersection of two runways); the controller's goal is then to ensure adequate separation between ghost and actual aircraft radar tracks. Alternatively, with tie mode, ghosts are offset so that the controller's goal is to have actual aircraft radar tracks coincide with the ghost tracks in order to achieve separation.

When CRDA is available at an airport, the CRDA status list may be displayed on the STARS scope. Entering [MULTIFUNC]TN toggles whether it is shown, and [MULTIFUNC]TN[SLEW] repositions it on the screen. In the example below, we can see from the "S" in the line two below "CRDA STATUS" that CRDA is enabled in stagger mode for runways 27R/17 at KPHL for the current controller, who has ID 6F.

Ghost radar tracks are normally only generated for aircraft within a pre-defined volume of space around an approach course and only if their heading is within a specified range of the approach heading. However, a number of commands below allow forcing a ghost track even if these criteria are not met.

A variety of commands are available to configure CRDA. The following parameters are used with them:

And these are the CRDA-related commands:

Significant Points

There are a number of significant points associated with each TRACON; these include arrival fixes and exits, airports in the TRACON and other relevant fixes (e.g., those with predefined holds.) STARS offers two commands that print the distance and heading from a selected point (e.g. an aircraft) to a significant point.

Restriction Areas

Restriction areas are annotations on STARS maps that add additional information, usually related to temporary conditions (flight restrictions, events, etc.) They may be circular, polygonal, or have no shape associated with them, and may include text that provides additional information about them. They are drawn in yellow in the STARS window and their brightness is controlled via the "Map group B" brightness.

Here is a circular restriction area with 2nm radius centered at the KFRG airport:

Restriction areas may be defined by the controller using commands described below or may be defined in scenario definition files (see STARS). If a controller defines a restriction area, it is make available to all other controllers in the session. As a convenience, vice also downloads the current FAA TFRs and automatically generates restriction areas for them.

The currently-available restriction areas can be seen via the restriction area list, which can be displayed and positioned using these commands:

Here is an example of the restriction area list:

Restriction area numbers 1—100 are used for user-defined restriction areas and 101—200 for system-defined restriction areas.

The following commands can be used to create and delete restriction areas. (Note that system restriction areas cannot be deleted.) The syntax of the (RATEXT) and (RALOC) specifiers used for restriction areas is discussed below.

In the restriction area commands, (RATEXT) is used to indicate specification of the text associated with the restriction area. One or two lines of text may be specified; if a second line is given, it should be separated from the first by a space. Because space is used to separate lines, periods must be entered for spaces within a line of text. These periods are converted to spaces by vice.

Depending on the context, a third line with additional qualifiers can be entered: ∆ to indicate that the text should blink and + to indicate that its associated shape should be shaded, or * followed by a number from 1—8 to specify a color for the graphics. Here are the colors associated with each number:

(RALOC) corresponds to specifying a location. One way to do so is by clicking a point in the STARS window; alternatively, the names of a fix, a fix offset by a given distance in a given direction, or a latitude-longitude coordinate may be provided. If keyboard entry is used, [ENTER] must be pressed after each location. Here are a few examples of text input:

• CCC: specifies that the location of the CCC VOR should be used.
• CCC/320/2.5: specifies a point 2.5nm miles along the 320 bearing from the CCC VOR.
• 403758N/0734617W: specifies a latitude-longitude coordinate 40.37.58N, 73.46.17W. In other words, for latitude, the first two digits are degrees, the next two are minutes, and the next two are seconds, followed by a "N" or an "S". For longitude, three digits are used for degrees (and leading 0s must be used if necessary), then two digits for each of minutes and seconds, followed by "W" or "E". Latitude and longitude coordinates are separated by a slash /.

Putting all of the above together, the a restriction area above that is a 2nm circle around KFRG might be created by [F12]C2 REPUBLIC FRG[ENTER][ENTER]. We could instead make a shaded area with two lines of flashing by entering [F12]C2 REPUBLIC SHADED.AREA +∆ FRG[ENTER][ENTER]. Here is the result:

A number of commands are available to modify existing restriction areas and manage which ones are displayed:

Controller Airspace

Note: this feature is not present in real-world STARS.

vice is able to indicate when aircraft are outside of the departure or approach airspace, if it has information about the airspace boundaries. (This information is not available at all airports.) If an aircraft is outside of its assigned airspace, a red "AS" error will be printed at the top of its datablock, as shown below. The valid altitudes for the aircraft are shown as well, if there are any valid altitudes at its current location. For example, the aircraft below is at 5,000' but should be between 11,000' and 12,000' (or should be at a different location!)

The airspace volumes associated with controllers can be displayed by clicking on the button in the menu bar to display the information window and then opening the "Airspace" section.

STARS Configuration

Range and Center

The left side of the main DCB has a few buttons for controlling the range of the STARS scope and where it is centered:

Clicking on RANGE activates the range spinner, which allows setting the scope range to be between 6 and 256 nautical miles. The center of the scope can be changed by clicking PLACE CNTR; moving the mouse moves the scope accordingly. Click a second time when you're happy with the scope's position. Finally, OFF CNTR is shown as depressed when the scope's center is different than the default center specified in the scenario configuration. Clicking on it restores the center to the default.

Alternatively, center of the radar scope can be moved by clicking the right mouse button and dragging. Zoom in and out using the mouse wheel; each step increases or decreases the radius shown by one nautical mile. Holding down the control key while using the mouse wheel gives three mile steps in the radius. Zooming and panning the scope in this way can be disabled with vice's settings window, which is displayed when the in the menubar is clicked.

Character Size

Clicking the CHAR SIZE button in the main DCB brings up the character size DCB menu, shown here:

The sizes controlled by the buttons are:

• DATA BLOCKS: data block text.
• LISTS: STARS system lists.
• DCB: text in the DCB.
• TOOLS: the various STARS tools.
• POS: track position symbols

Clicking DONE returns to the main DCB.

All types of character sizes may range from 0 to 5, except for DCB, which goes from 0 to 2.

Brightness

Selecting the BRITE button in the main DCB brings up the brightness DCB menu, shown here:

The item brightness that the buttons control are:

• DCB: the DCB itself.
• MPA: maps in group "A" (generally, the primary video maps).
• FDB: full data blocks, the cursor, and preview area.
• POS: position symbols in radar tracks owned by the controller.
• OTH: datablocks and position symbols for tracks owned by other controllers and ghost tracks.
• RR: range rings.
• BCN: beacon targets (not currently used).
• HST: history circles behind track paths.
• WXC: weather contrast; i.e., the stippled patterns.
• BKC: background contrast.
• MPB: maps in group "B" (generally, the secondary maps).
• LST: system lists.
• LDB: limited and partial datablocks and their position symbols.
• TLS: STARS tools.
• CMP: the compass rose at the edges of the STARS display
• PRI: primary target symbols.
• WX: weather.

Some of these brightnesses can be set to 0, in which case "OFF" is shown in the BRITE menu and the corresponding item isn't drawn at all. Others have a minimum required brightness.

RADAR Sites

The STARS RADAR configuration can be managed by clicking the SITE button in the main DCB, which also shows the current RADAR mode. STARS supports three RADAR modes:

• SINGLE: RADAR data from a single RADAR site is used determine aircraft locations.
• MULTI: multiple RADAR sites are used to determine aircraft locations, where (more or less), the closest site to each aircraft is used.
• FUSED: RADAR data from multiple sites is combined with ADS-B data from aircraft to determine their locations.

SINGLE mode can be selected by clicking on a radar site in the SITE DCB sub-menu (here, NXX and PHL are available.) MULTI and FUSED are selected by clicking on the corresponding buttons.

Note that the choice of RADAR mode affects which symbols are used for tracks in STARS. Furthermore, in SINGLE and MULTI modes, radar tracks are only updated once every 5 seconds. In FUSION mode, they are updated once per second.

Keyboard commands can also be used to select the RADAR mode:

Audio

Audio alerts are played when there is a minimum safe altitude warning for an aircraft, if an aircraft is squawking a special purpose code (e.g., 7700 for an emergency), it a SPC has been manually assigned to an aircraft, or if there is a conflict alert between two aircraft. The "VOL" control in the main DCB can be used to control the volume of these alerts.

A few keyboard commands can be used to control audio:

vice also provides optional audio alerts for when there is an inbound handoff to the current controller and when an outbound handoff is accepted (though real-world STARS does not have these.) These alerts can be enabled and disabled under the "STARS" section of vice's settings menu.

Preferences

Various details of the current STARS configuration like brightness settings, font sizes, and the layout of the system lists can be saved in a STARS preference set. The current preference set stores the preference settings that are currently active, and up to 32 additional named preference sets can be stored. vice stores separate preferences for each TRACON, which makes it easy to customize STARS's settings in different ways for different facilities.

Functionality for loading and saving preference sets can be accessed by clicking PREF on the main DCB menu, which brings up the PREF menu:

Here we can see that there are two saved preference sets, PHLN and FINAL, and that FINAL is active. Clicking on a saved preference set selects it and loads its settings. Preferences can be restored to their defaults by clicking on DEFAULT. Clicking RESTORE restores the preferences to what they were when the PREF button was clicked to bring up the PREF DCB menu. If a preference set is selected, then SAVE is enabled; clicking on it saves the current preference settings to the selected preference set. DELETE deletes the selected preference set.

A new preference set is created when SAVE AS is clicked: the preview area will prompt PREF SET NAME and the name for the preference set can be entered, followed by the ENTER key. Preference set names may be up to 7 alphanumeric characters and may not be a number between 1 and 32.

These keyboard commands are available for preference sets:

FDAMs

Flight Data Auto-Modify (FDAM) regions automatically modify flight data when an associated track enters an adapted airspace volume. Entry actions may include changing scratchpads, setting leader line directions, initiating handoffs or ownership transfers, and issuing force quicklooks. Some of these changes can be automatically reverted when the track exits the region. FDAM regions are defined in scenario configuration files; see the Facility Engineering section for details on their configuration.

The lateral extent of FDAM regions can be shown on the scope via "SYS PROC" from the DCB "MAPS" menu.

The following supervisor commands control FDAM processing.

Display Elements

In addition to radar tracks and their datablocks, the STARS display contains various system lists that display useful text information, video maps of the local control area, and, optionally, a weather radar showing precipitation. These are all described in this section.

System Lists

The system lists show various types of useful information in the form of text. Their font size can be adjusted using the "LISTS" control in the "CHAR SIZE" DCB menu and their brightness is set with "LST" in the "BRITE" DCB menu. All of the system lists other than ones for CRDA and maps are documented in this section; see the CRDA documentation above for information about the CRDA system list and Video Maps for information about the maps system list.

Lists can be repositioned by clicking the middle mouse button inside a list; a white frame will appear around the list. Move the cursor to the desired location and click the middle mouse button again to complete the move, or press Escape to cancel. If two or more lists overlap, green frames are drawn around them to indicate the overlap. Clicking and holding the middle mouse button (when not over a list or aircraft track) will display green frames and labels around all visible lists.

System Status Area List

The System Status Area (SSA) list displays general information about the configuration of the STARS radar scope. Here is an example:

The red triangle indicates that STARS is functioning correctly; in vice it will always be there. The first line of text shows the current zulu time 03:07:27 and the altimeter at the primary airport for the current scenario, PHL. The following line shows the network status (always "OK/OK/NA" in vice) as well as the current radar mode, FUSED. Next is the current range shown from the scope's center, 17nm, and the length of predicted track lines (PTLs), 0.5 minutes. Next are the altitude filters, first for unassociated tracks and then for associated tracks (both in hundreds of feet.) The next few line again shows the altimeter at PHL and contains the altimeters at nearby airports in multi-airport scenarios.

A few lines are only shown when corresponding features are enabled. Here, "QL: 6S" indicates that TCP 6S has been quicklooked and "TW OFF: MSAW" indicates that MSAW has been disabled system-wide. Finally, we can see that CRDA has been enabled for the runway pair 27R/17, with the "S" indicating "stagger" mode.

The SSA list is always visible; a keyboard command is available to position it:

The SSA list also includes the ATIS letter and GI (General Information) text, which can be set with the following commands:

Which elements are displayed in the SSA list can be configured by selecting the "SSA FILTER" menu from the main DCB, which brings up the SSA DCB.

The buttons toggle display of the following elements:

• TIME: current time in zulu
• STATUS: system status; always "OK/OK/NA"
• RADAR: radar mode: FUSED, MULTI, or SINGLE
• SPC: whether to show an alert for any special purpose codes currently being squawked by aircraft (e.g., "RF" for an aircraft squawking 7600 due to a radio failure.)
• RANGE: radar range
• ALT FIL: altitude filters
• AIRPORT: altimeter at nearby airports
• QL: quick looked sectors
• CRDA: active CRDA pairs
• WX: available and displayed weather precipitation levels
• ALTSTG: show altimeter at primary airport
• CODES: show selected beacon codes
• PTL: length of predicted track lines
• WX HIST: weather history snapshot currently being displayed
• TW OFF: disabled system features (e.g., CA, MSAW)

Flight Plan List

The flight plan list shows flight plans that are not yet associated with aircraft and that you will be responsible for when they do. (This includes both future arrivals and departures.) Once they are associated with aircraft, flight plans are automatically removed from the list. Here is an example:

Each line includes the flight's tab list id, a two-digit number that can be used to refer to the flight plan with STARS commands, the aircraft's callsign, the assigned beacon code (right column), the aircraft's final altitude in hundreds of feet, and one letter indicating the arrival/departure fixes.

The flight plan list can be managed with these commands:

VFR List

The VFR list shows VFR flight plans that have NAS beacon codes assigned. It shows the tab list index, the callsign, and the assigned beacon code.

The VFR list is managed with these commands:

Tower List

The tower list shows arrivals at an airport. Up to three tower lists can be displayed; each show arriving aircraft sorted by their distance to the airport. The assignment of airports to tower lists is done by the facility engineer in the scenario specification and can't be changed while vice is running. Here is an example, showing a few arrivals to PHL:

The following commands can be used to configure the tower lists. For all of them the first number gives the tower list index and must be 1, 2, or 3.

Alert List

The Alert List shows the aircraft that currently have altitudes below the minimum vectoring altitude at their present position (LA) or have collision alerts (CA). Below we see that JZA868 is too low (and is currently at 600 feet altitude) and that separation has been lost between JIA1524 and NKS9096.

The maximum number of lines in the alert list is hard-coded to 50 and it is not possible to hide the alert list. However, its position in the STARS window can be set using the following command:

MCI Suppression List

If specific MCI alerts have been suppressed, the corresponding pairs of callsigns and beacon codes are listed in the MCI suppression list. Commands are available to control whether it is displayed and where it is placed on the screen.

Coast/Suspend List

The coast/suspend list lists coasting tracks (not yet implemented in vice) and suspended flight plans.

This list is always visible, but its position and length can be set:

Coordination Lists

Coordination lists are used for tower and departure controllers to coordinate aircraft releases. When there is a departure ready to be released from an airport the controller is responsible for, it is added to the coordination list by the tower controller. After the departure controller releases an aircraft, it will depart within the next few minutes. Here is an example coordination list:

Aircraft that are awaiting release flash, as DPJ7156 is here. Released aircraft are no longer flashing and have a plus sign after their tab list number (here, 0 and 2 for EJA5253 and LXJ13, respectively.) The coordination list also includes the aircraft type, the aircraft's assigned squawk code, its exit, and its requested final altitude.

These keyboard commands are used to manage coordination lists and releases:

Coordination list identifiers ((ID) in the above commands) are one to three alphanumeric characters. They can be found in the scenario information window, accessed by clicking the button in the menubar. Here we can see that the "REPUBLIC" coordination list has id "A".

Sign On List

The sign-on list shows the TCP covered by the current controller as well as the time they signed on (in Zulu time).

It can be configured using these commands:

Video Maps

One or more video maps may be displayed in the STARS window to show items like airports and runways, approaches, important fixes, and geographical features like bridges. There are default video maps specified for each control position and controllers may add an remove maps depending on circumstances.

The main DCB includes a MAPS button, which displays the DCB MAPS menu, and six buttons to toggle the display of six video maps; here are six from a KJFK scenario:

The button for map number 849, CLASS_B, is depressed, indicating that the corresponding map (which shows the class B airspace) is currently visible. The other maps are not currently displayed. Clicking on map's button toggles whether it is visible.

Here is the MAPS DCB menu for that same scenario:

The map labeled 4L_R which has number 201, is currently visible, though none of the others are. Each map is in one of two map groups—A or B; the brightness of the groups is controlled by MPA and MPB in the BRITE DCB menu. Unfortunately, STARS doesn't directly show which group a particular map is in.

The other buttons in the MAPS DCB do the following:

• DONE: returns to the main menu.
• CLR ALL: deselects all video maps.
• GEO MAPS: toggles display of the maps system list and shows the available video maps in it.
• SYS PROC: toggles display of the maps system list and shows maps related to STARS system operation (e.g., CRDA regions, ATPA volumes, RADAR site ranges, etc.) in it.
• CURRENT: toggles display of the maps system list and shows the currently displayed maps in it.

Depending on which maps have been included, there may be buttons for the following map categories; when pressed, they cause the corresponding type of available maps to be shown in the maps system list: AIRPORT, CONTROL, DANGER AREAS, GENERAL AV, GEO POINTS, MIL, RUNWAYS, and SID STAR.

Here is the maps system list for that same KJFK scenario. For each map, we have the map number, the map label (as shown in the DCB), and a longer name describing the map's contents. Maps that are currently displayed have > symbols next to them.

The following keyboard commands can be used to manage video maps.

Preview Area

The preview area is a display element that shows various types of information when using different commands, such as flight plan details, coordinates, or quicklook status.

The following command allows you to position the preview area:

Weather

The current weather radar that shows precipitation can be displayed on the STARS scope. Here is an example North of KORD during some summer thunderstorms. The blue-green areas indicate light precipitation, while the mustard-colored area is moderate to heavy precipitation. Stippling in the radar also indicates the strength, where a denser stipple is heavier precipitation.

AWI8111 would be well-advised to turn a few degrees to the right.

The brightness of the weather on the STARS scope can be controlled using the "WX" spinner in the BRITE menu of the DCB and the brightness of the stipple is controlled using the "WXC" BRITE control. It is also possible to control which levels of precipitation are shown using the "WX*" buttons in the main DCB. When precipitation of a given level is available to be displayed, "AVL" is shown in the button and the button has a blue-grey color. When there is no precipitation at a level, the corresponding button has the regular green color.

With the selection above, the three lowest levels, WX1 and WX2 are not shown, while all of the higher levels of precipitation are.

If the WX button in the SSA list is enabled, the currently available WX levels and whether they are displayed is shown in the SSA list. In the example below, there is precipitation at levels 1–5, though not 6. Levels 3, 4, and 5 are shown in the STARS window:

A few keyboard commands related to weather are available:

Vice-Specific Display Commands

vice provides a few additional display commands not found in the standard STARS system: