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:
Latest release

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.1.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.1-py3-none-any.whl (61.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aviconv_aip-1.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 65f5eec81d50f0676ad16e9fc48f969b94cc73db5a90c7f2ec7c62507cdf4a74
MD5 4f485c8d09c7ce0e1c0be08fc49f1c76
BLAKE2b-256 8f03f8bd1f704b8152064fb34580b6f668e2dac378118cd9d9a50c875bc085e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for aviconv_aip-1.1.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: aviconv_aip-1.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3a7a3bc7ad939a43c7699f1b3b7151cd1aa1f6884e18fc972e4aeed9281ca8f4
MD5 58bee25718765baf4bdde091ba9cb251
BLAKE2b-256 ec4f7791659e766028b7552f88b20c22d11722315bc3256cf9c402d5953aa03d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aviconv_aip-1.1.1-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

This release

1.1.1 This release

2 files

1.1.0

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