> For the complete documentation index, see [llms.txt](https://wingbits.gitbook.io/wingbits-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wingbits.gitbook.io/wingbits-ai/reference/data-dictionary.md).

# Data dictionary

Field definitions for Wingbits datasets. Real-time ADS-B uses short field codes (optimized for streaming); fleet and historical datasets use descriptive names.

## Real-time ADS-B (52 fields)

### Position

| Field | Meaning                  | Units   |
| ----- | ------------------------ | ------- |
| `la`  | Latitude                 | degrees |
| `lo`  | Longitude                | degrees |
| `ab`  | Barometric altitude      | ft      |
| `ag`  | Geometric / GPS altitude | ft      |

### Velocity

| Field | Meaning          | Units   |
| ----- | ---------------- | ------- |
| `gs`  | Ground speed     | kts     |
| `gr`  | Vertical rate    | ft/min  |
| `br`  | Baro rate        | ft/min  |
| `mh`  | Magnetic heading | degrees |
| `tr`  | True track       | degrees |

### Identity

| Field | Meaning                                  |
| ----- | ---------------------------------------- |
| `h`   | ICAO hex address                         |
| `f`   | Flight callsign                          |
| `sq`  | Squawk code                              |
| `c`   | Aircraft category                        |
| `t`   | Message type (`adsb_icao`, Mode-S, MLAT) |

### Signal quality

| Field | Meaning                 |
| ----- | ----------------------- |
| `rs`  | Signal RSSI (dBFS)      |
| `n`   | Total messages          |
| `nb`  | Valid position messages |
| `np`  | Position rate           |
| `nv`  | Velocity rate           |

### Navigation

| Field | Meaning                       |
| ----- | ----------------------------- |
| `nq`  | Navigation accuracy (NACp)    |
| `nam` | Navigation altitude (MCP/FCU) |
| `nh`  | Selected heading              |
| `sp`  | Selected altitude             |

### Environmental

| Field | Meaning                 |
| ----- | ----------------------- |
| `wd`  | Wind direction          |
| `ws`  | Wind speed              |
| `oat` | Outside air temperature |
| `tat` | Total air temperature   |

### Status

| Field | Meaning          |
| ----- | ---------------- |
| `em`  | Emergency status |
| `a`   | Alert flag       |
| `spi` | SPI (ident)      |
| `og`  | On-ground flag   |

### Metadata

| Field       | Meaning                       |
| ----------- | ----------------------------- |
| `timestamp` | UTC timestamp                 |
| `rc`        | Receiver count                |
| `d`         | Device ID                     |
| `sda`       | System design assurance level |

## Fleet metadata (174 fields)

Descriptive fields across operator identity, aircraft specification, registration, engines, cabin configuration, ownership/leasing, lifecycle/status, and utilization. See [Fleet metadata](https://wingbits.gitbook.io/wingbits-ai/data-products/fleet-metadata.md) for the category breakdown.

## Historical records (31 fields)

Time periods, operator chain, aircraft identity, lifecycle events, and engine history. See [Historical records](https://wingbits.gitbook.io/wingbits-ai/data-products/historical-records.md) for the category breakdown.
