aviconv-asterix
Bidirectional EUROCONTROL ASTERIX codec — part of the aviconv converter family.
Supported categories (pinned editions):
| Category | Content | Edition |
|---|---|---|
| CAT021 | ADS-B Target Reports | 2.6 |
| CAT034 | Transmission of Monoradar Service Messages | 1.29 |
| CAT048 | Monoradar Target Reports | 1.32 |
| CAT062 | SDPS System Track Data | 1.20 |
Scope
Bidirectional. ASTERIX is a binary sensor/tracker wire format;
aviconv both decodes it into typed, JSON-serialisable records and
encodes records back to binary. As of 0.2.0, encode(decode(b)) == b
holds byte-exact for every record carried through iter_records (see
docs/packages/asterix.md for the raw vs.
typed encode paths and the decode-subset LSB-quantisation table).
A decode subset of each category is mapped to typed fields (data
source, times, WGS-84 positions, flight levels, velocities, identity);
every other present data item is still measured via its UAP layout and
preserved hex-encoded in raw_items, so nothing on the wire is
silently dropped. If a record sets an FSPEC bit with no UAP entry
(edition mismatch), that data block is undecodable — the block LEN is
used to resynchronise at the next block (--skip-errors).
CAT048 position is polar, not WGS-84. I048/040 carries slant range
- azimuth relative to the reporting radar, not a lat/lon — ASTERIX does
not carry the radar site's own position, so no georeferencing is
possible from a CAT048 record alone.
Cat048Recordexposesrho_nmandtheta_degand deliberately has nolat/lonfield.
Usage
from aviconv_asterix import encode_records, iter_records
records = list(iter_records(open("radar.ast", "rb").read()))
print(records[0].callsign, records[0].lat, records[0].lon)
encode_records(records) == open("radar.ast", "rb").read() # True
Every record decoded via iter_records carries its original octets in
raw_items; re-encoding it (unmodified or not) re-emits those octets
verbatim, byte-exact, regardless of any typed-field edits made via
model_copy. Records built from scratch (no raw_items) encode from
their typed fields instead, via each item's build callable — see
docs/packages/asterix.md for which items
have one wired.
CLI (NDJSON, one record per line):
aviconv asterix decode radar.ast
aviconv asterix decode - < radar.ast # binary stdin
aviconv asterix decode radar.ast --skip-errors -o out.ndjson
aviconv asterix encode records.ndjson -o radar.ast
aviconv asterix decode radar.ast | aviconv asterix encode - # round-trip
Licence
MIT. The ASTERIX category specifications are published by EUROCONTROL; this package is not endorsed by or affiliated with EUROCONTROL.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aviconv_asterix-0.2.0.tar.gz.
File metadata
- Download URL: aviconv_asterix-0.2.0.tar.gz
- Upload date:
- Size: 32.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1940e53872b27f36467d018633760143674c7371f8a12bfafef6c0185f680be1
|
|
| MD5 |
554d25bb0a3a89fbf61f8f42f783b8cf
|
|
| BLAKE2b-256 |
e5f3b2db1667dcc1ec0d8c914d615a3dcb1e0a9e0ac60ca9bba3aa0cef1faa6f
|
Provenance
The following attestation bundles were made for aviconv_asterix-0.2.0.tar.gz:
Publisher:
release.yml on ams-mmd/aviconv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aviconv_asterix-0.2.0.tar.gz -
Subject digest:
1940e53872b27f36467d018633760143674c7371f8a12bfafef6c0185f680be1 - Sigstore transparency entry: 2386000354
- Sigstore integration time:
-
Permalink:
ams-mmd/aviconv@5fa95be603db06336a2eac136fa51656869f127a -
Branch / Tag:
refs/tags/aviconv-asterix-v0.2.0 - Owner: https://github.com/ams-mmd
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5fa95be603db06336a2eac136fa51656869f127a -
Trigger Event:
push
-
Statement type:
File details
Details for the file aviconv_asterix-0.2.0-py3-none-any.whl.
File metadata
- Download URL: aviconv_asterix-0.2.0-py3-none-any.whl
- Upload date:
- Size: 30.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ecb4ee8a2cb9d08f5df9fe4f06c0a0df8c8412d8633e657238408c6cca24ae4c
|
|
| MD5 |
bd69bc3ff4b2f94c27f422654bbf487a
|
|
| BLAKE2b-256 |
bc9a679af20906dc477dd2eb8609d5ff801f90705450c3019db689a164460104
|
Provenance
The following attestation bundles were made for aviconv_asterix-0.2.0-py3-none-any.whl:
Publisher:
release.yml on ams-mmd/aviconv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aviconv_asterix-0.2.0-py3-none-any.whl -
Subject digest:
ecb4ee8a2cb9d08f5df9fe4f06c0a0df8c8412d8633e657238408c6cca24ae4c - Sigstore transparency entry: 2386000357
- Sigstore integration time:
-
Permalink:
ams-mmd/aviconv@5fa95be603db06336a2eac136fa51656869f127a -
Branch / Tag:
refs/tags/aviconv-asterix-v0.2.0 - Owner: https://github.com/ams-mmd
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5fa95be603db06336a2eac136fa51656869f127a -
Trigger Event:
push
-
Statement type:
