skillBoard

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #llm #golang #deep-learning #macos #java #awesome #kubernetes #pytorch #security #ios

(★ 18)

Skill Aviation flight schedule board.

skillBoard Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SkillBoard

SkillBoard is a Clojure-based real-time aviation display system designed for flight training
facilities. It runs as a continuous display, designed for a large wall screen, providing instructors and students with
situational awareness for flight operations.  It integrates data from multiple sources including FlightSchedulePro for
reservation management, Aviation Weather for meteorological information, and Radarcape for ADSB
aircraft tracking, and Open-Meteo for surface wind field data in order to display current flight
schedules, weather conditions, surface winds, flight categories, and nearby traffic on a cycling multi-screen
interface.

## Theory of Operation
The system polls FSP, Aviation Weather, and Radarcape once every 60 seconds or so
as specified in `config/seconds-between-internet-polls`.

If FSP communication fails for some reason (which it does) the system will remember
the last batch of data it got.

If Radarcape communications fail the respective fields on the screen will go blank until
communication is restored.

If Aviation Weather communications fail the screen will show "NO METAR" until communication
is restored.

Reservations for the past six hours and until tomorrow are displayed on the screen in
chronological order.  Reservations that have been checked in are removed.

ADSB data from Radarcape are collected for every tail number listed as "Active" in FSP.  
The ADSB data are associated, by tail number, with checked out reservations.
If no reservation for that tail number is checked out then the ADSB data will show as `NO-CO`
in the remarks.

GPS altitude is displayed in 100s of feet.  If the ADSB transmitter is in "ground" mode,
then Altitude will be displayed as `GND`.

The ADSB position of the aircraft is compared against the list of geofences in the 
`src/skillBoard/config.clj` file (see below).  If a match is found it is shown in the
remarks field.

### REMARKS
 * `NEAR` The aircraft is within 6NM of the airport.
 * `LOW` The aircraft is within 2NM of the airport and below 500' AGL.
 * `PATN` The aircraft is within 2NM of the airport and is within 500' of pattern altitude.
 * `TAXI` The aircraft is within 2NM of the airport, is in ground mode, or is below 30' AGL, 
and has a ground speed between 2 and 25kts.
 * `RAMP` The aircraft is within 2NM of the airport, is in ground mode, or is below 30' AGL,
and has a ground speed less than 2kts.

### Status Lights
The three status lights next to the clock on the upper right of the screen correspond to
the three internet data sources.  Top is FlightSchedulePro, middle is Radarcape, bottom is
Aviation Weather.  Green means data is being received.  Orange means one failed attempt.  
Red means two or more consecutive failures.

## Screens
The display cycles through eight configured slots in `config/screens`: Flights, TAF, Wind Map,
Traffic, Flights, TAF, Flight Category, and Traffic.  Those slots show five screen types:

### Flight Operations Screen
![screenshot](https://raw.githubusercontent.com/unclebob/skillBoard/master/images/Flight%20Operations%20Screen.jpg)
   * Presents all the reserved flights for today and the past six hours.
     * Crew includes Instructor and Student names.
     * `BRG/ALT/GS` are the bearing, altitude (in 100s of feet), and ground speed from the Radarcape ADSB data.
        The bearing is in the form `XXXBBBDDD` where `XXX` is the airport from which the bearing is taken,
        `BBB` is the bearing from that airport in degrees, and `DDD` is the distance in NM from that airport.
     * Flights in white (`config/scheduled-flight-color`) are scheduled flights.
     * Flights in green (`config/on-ground-color`) are flights that are on the ground.
     * Flights in yellow (`config/unscheduled-flight-color`) are flights that are in the air but not checked out.
### Weather Screen
![screenshot](https://raw.githubusercontent.com/unclebob/skillBoard/master/images/Weather%20Screen.jpg)     
   * Presents the TAF for `config/taf-airport` 
   * and the METAR history for `config/airport`.
### Wind Map Screen
   * Presents an animated 200 NM wind field centered on `config/airport`.
   * Uses a default `16 x 16` sample lattice over the radius bounds and keeps the in-radius points for polling.
   * Polls Open-Meteo once every 60 minutes with 10 second socket and connection timeouts.
   * Uses cached wind grid data when available and falls back to a synthetic field.
   * Fetches 10 meter surface wind speed and direction from Open-Meteo's GFS/HRRR JSON API and converts it to local vectors.
   * Fits the displayed map bounds to the screen aspect ratio so the wind field is not stretched on screen.
   * Plots all nearby METAR-reporting airports and labels only Class B, Class C, and Class D airports.
### Flight Category Screen
![screenshot](https://raw.githubusercontent.com/unclebob/skillBoard/master/images/Flight%20Category%20Screen.jpg)
   * Presents the flight category, clouds, visibility, wind, 
     and distance for the airports specified in `config/flight-category-airports`.
### Nearby Traffic Screen
![screenshot](https://raw.githubusercontent.com/unclebob/skillBoard/master/images/Nearby%20Traffic%20Screen.jpg)
   * Presents the traffic in the region specified by `config/nearby-altitude-range` and `config/nearby-distance`.
     * Traffic in white (`config/in-fleet-color`) are flights of aircraft in the fleet.
     * Traffic in yellow (`config/out-of-fleet-color`) are flights of aircraft not in the fleet.
     * Traffic in green (`config/on-ground-color`) are on the ground.

Screens can be manually changed by hitting the space bar.

## To run the Skill Board
    cd ~/skillBoard
    clojure -M:run

Be patient.

### To exit the program
Hit the escape key.

## To update to a new version
    git reset --hard
    git pull

## Configuration
There are two files that configure the system.

### `private/config`
This file holds information that should be kept secure.  The format is:

{
    :fsp-key "<the fsp key>"
    :fsp-operator-id "<the fsp operator id>"
    }

### `src/skillBoard/config.clj`
This file holds information that describes the local environment and the display behavior.

skillBoard

skillBoard Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

skillBoard

skillBoard Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README