aviconv-aip

Template-driven extraction of airports, runways, radio frequencies, and navaids from a published PDF AIP into schema-valid AIXM 5.1.1.

Part of the aviconv converter family. This is the v1.0 headline feature: most States publish their AIP only as PDF, and nothing free turns those PDFs into structured AIXM.

What it is — and is not

aviconv-aip is a template-driven, human-in-the-loop extractor, not a magic button. PDF AIP extraction is heuristic — layouts vary between publishers and OCR mis-reads. So the honest deliverable is:

  • one declarative template per AIP publisher (adding a publisher means adding a YAML template, not changing extractor code);
  • a provenance record on every extracted value — AIP edition, AIRAC cycle, template version, and source page — so a reviewer can audit any value back to the PDF;
  • a coarse per-field confidence signal (high = matched table cell, low = OCR/heuristic fallback);
  • a human-review report listing every value beside its source page;
  • output routed through the released aviconv-aixm writer and the aviconv aixm validate --semantic gate, so an implausible extraction surfaces as a finding before it reaches a user.

Scope is locked to airports/runways/frequencies/navaids — not procedures, not airspace.

Offline / Pyodide boundary

The PDF and OCR dependencies (pdfplumber, optional pytesseract) are not Pyodide-safe. aviconv-aip is therefore a CLI-and-service feature only, never a browser-playground feature. This boundary is locked.

Install

pip install aviconv-aip           # base install (pdfplumber)
pip install "aviconv-aip[ocr]"    # + optional OCR fallback (needs tesseract)

Without the ocr extra, image-only pages are flagged in the extraction result rather than causing a crash.

Usage

aviconv aip list-templates                          # bundled publishers
aviconv aip extract --template pakistan AD-2.pdf     # PDF → records JSON
aviconv aip extract --template pakistan --review AD-2.pdf   # human-review report
aviconv aip to-aixm  --template pakistan AD-2.pdf    # PDF → AIXM 5.1.1

See the package docs and the template-authoring guide.

Source AIP licensing

No source AIP PDF is committed to this repository — only extraction templates and small synthetic, licence-clean fixtures ship. AIP content licensing varies by State; see LICENSES/README.md.

Project links

Data verified by PyPI on Aug 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ams-devs26 from gravatar.com ams-devs26

Credits

Author: aviconv contributors

GitHub Statistics

Data verified by PyPI on Aug 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

ocr

Tags

aip airac airport airspace aixm arinc424 aviation cifp eaip icao navaid pdf procedure scraper

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aviconv_aip-1.1.0.tar.gz (84.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aviconv_aip-1.1.0-py3-none-any.whl (61.4 kB view details)

Uploaded Python 3

File details

Details for the file aviconv_aip-1.1.0.tar.gz.

File metadata

  • Download URL: aviconv_aip-1.1.0.tar.gz
  • Upload date:
  • Size: 84.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aviconv_aip-1.1.0.tar.gz
Algorithm Hash digest
SHA256 2fb19f852e73a1a7e8aede768caf6c5a9620d758f253c656c8d7282d4ecef1fd
MD5 4c4246fcd4778c9e264884e46b0d2e2b
BLAKE2b-256 784a733aa9d80b73e9c08641197c6506f5c7ac8da4ab27e471de5341786faf4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for aviconv_aip-1.1.0.tar.gz:

Publisher: release.yml on ams-mmd/aviconv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aviconv_aip-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: aviconv_aip-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 61.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aviconv_aip-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 32da531c62a4c29a96db43db54eee4be3db5b629d4f7b6f2fd8f6b69f683f361
MD5 186b181b0c8922dfe55b58af497aa8e4
BLAKE2b-256 80ddc9d19ea3906e0d259a4b167b47fbd15d357604bd9bd7509639e9b2f8f5e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for aviconv_aip-1.1.0-py3-none-any.whl:

Publisher: release.yml on ams-mmd/aviconv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.1.1

2 files

This release

1.1.0 This release

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page