OpenSpeleoLib

OpenSpeleoLib reads, writes, validates, and converts cave-survey data.

GeoJSON conversion

Convert an Ariane TML survey with:

openspeleo convert -i survey.tml -o survey.geojson -f geojson

Coordinate safety guard

A connected shot can contain both survey measurements and an explicit geographic endpoint. During GeoJSON conversion, explicit coordinates remain authoritative, but OpenSpeleoLib calculates where the shot should end from its length, depth, azimuth, unit, and magnetic declination. If the supplied and calculated endpoints differ by more than 500 metres, conversion raises InconsistentShotCoordinatesError.

For example, synthetic Shot ID 4242 with supplied coordinates (-70, 40) and a calculated endpoint near (40, -70) produces an error containing:

[Shot ID=4242]: Explicit coordinates are inconsistent with shot measurements

The 500-metre threshold is a fixed catastrophic-data guardrail, not a survey-quality or GPS-accuracy guarantee. Coordinates within the threshold are accepted without certifying their accuracy. Root anchors and connected anchors whose parents cannot be resolved cannot be compared and retain their existing behavior.

The library never swaps coordinates, guesses a correction, or emits a partially converted GeoJSON document. The CLI calculates and validates the complete document before opening the output path: a failed conversion does not create a new output and does not replace an existing output passed with --overwrite. Correct the source survey and run the conversion again.

Download files

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

Source Distribution

openspeleo_lib-0.0.19.tar.gz (34.9 kB view details)

Uploaded Sep 7, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

openspeleo_lib-0.0.19-py3-none-any.whl (40.6 kB view details)

Uploaded Sep 7, 2026 Python 3

File details

Details for the file openspeleo_lib-0.0.19.tar.gz.

File metadata

Download URL: openspeleo_lib-0.0.19.tar.gz
Upload date: Sep 7, 2026
Size: 34.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openspeleo_lib-0.0.19.tar.gz
Algorithm	Hash digest
SHA256	`0afa1bdda86ce5d66dfe518066e906565cc33d5b32540cf52ec638d50b8d579f`
MD5	`6141b517efccb2ef4cd69d4140d70c59`
BLAKE2b-256	`17cfa8429bf98df938ba8a56ecc74c7bbb15edae9c084cb22b6402e404db0f0d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openspeleo_lib-0.0.19.tar.gz:

Publisher: release.yml on OpenSpeleo/pytool_openspeleo_lib

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openspeleo_lib-0.0.19.tar.gz
- Subject digest: 0afa1bdda86ce5d66dfe518066e906565cc33d5b32540cf52ec638d50b8d579f
- Sigstore transparency entry: 2753095508
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: OpenSpeleo/pytool_openspeleo_lib@6128187b30a5867e5496aa8844eac7f158343ca8
- Branch / Tag: refs/tags/v0.0.19
- Owner: https://github.com/OpenSpeleo
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@6128187b30a5867e5496aa8844eac7f158343ca8
- Trigger Event: workflow_dispatch