Auspex Cursus

End-to-end polyline detection: for every detected instance the network outputs an ordered, open sequence of vertices — a path (a pipe, a drip line, a road centre line, a horizon), not a box and not a closed polygon. Each class declares its own vertex count (n_points: 2 for straight things, 8–12 for curves), so a 2-point "horizon" and a 12-point "drip line" live in the same model.

  • CursusDETR: a DETR-style network with hierarchical instance×point queries, deformable attention (pure PyTorch, no CUDA extensions), iterative refinement, denoising training and direction-invariant Hungarian matching.
  • Any annotation source: CVAT XML, LabelMe JSON, GeoJSON/Shapefile + GeoTIFF with a full georeferencing pipeline — all converted to one on-disk format (CursusJSON).
  • Two training modes behind one config switch: whole-image, or tiled with sliding-window inference and cross-tile stitching for large rasters.
  • Chamfer-mAP evaluation, ONNX export, CVAT/LabelMe/GeoJSON prediction writers (predictions can be uploaded back to CVAT as pre-labels).
  • Single & multi-GPU training (DDP), Windows / Linux, CPU-capable inference.

Install

pip install auspex-cursus

Install a CUDA build of PyTorch first (from pytorch.org) if you want GPU training.

Quickstart

auspex-cursus synth --out datasets/synth --labelspace labelspace.yaml --n-images 64
auspex-cursus convert --format cvat --src annotations.xml --images ./images \
                      --labelspace labelspace.yaml --out data.cursus.json
auspex-cursus train --cfg my_run.yaml
auspex-cursus predict --weights runs/my_run/best.pt --source ./photos --out preds \
                      --formats cursus,cvat,overlay

Every subcommand has --help.

Licensing

Prediction, validation, conversion and export are free to use. Training runs on a 30-day evaluation trial, after which it needs a licence credential — either a CURSUS- licence key or a Helion account token covering auspex-cursus:

export AUSPEX_CURSUS_LICENCE=<key>       # or a path to a file holding it

Licensing: https://heliontechltd.com/license

Distributed as compiled binaries; verification is fully offline — training machines never need network access.

Project links

Key dates

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

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for sohanurislamshuvo from gravatar.com sohanurislamshuvo

Credits

Author: Md. Sohanur Islam Shuvo

License

Other/Proprietary License (Proprietary)

Requires

Python <3.14, >=3.10

Provides Extra

geo export viz dev

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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

auspex_cursus-0.8.0-cp313-cp313-win_amd64.whl (3.6 MB view details)

Uploaded CPython 3.13Windows x86-64

auspex_cursus-0.8.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (28.8 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

auspex_cursus-0.8.0-cp313-cp313-macosx_11_0_arm64.whl (3.9 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

auspex_cursus-0.8.0-cp312-cp312-win_amd64.whl (3.6 MB view details)

Uploaded CPython 3.12Windows x86-64

auspex_cursus-0.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (29.3 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

auspex_cursus-0.8.0-cp312-cp312-macosx_11_0_arm64.whl (4.0 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

auspex_cursus-0.8.0-cp311-cp311-win_amd64.whl (3.8 MB view details)

Uploaded CPython 3.11Windows x86-64

auspex_cursus-0.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (28.9 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

auspex_cursus-0.8.0-cp311-cp311-macosx_11_0_arm64.whl (4.0 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

auspex_cursus-0.8.0-cp310-cp310-win_amd64.whl (3.8 MB view details)

Uploaded CPython 3.10Windows x86-64

auspex_cursus-0.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (27.5 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

auspex_cursus-0.8.0-cp310-cp310-macosx_11_0_arm64.whl (4.1 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

File details

Details for the file auspex_cursus-0.8.0-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 ba80e336352a6eda86215be4c7ef1d2ac8b545d302fa8989e725f3e57901087e
MD5 e692b5b3eea47e93a84865b8fb46a9bf
BLAKE2b-256 89b5d8a60d0f593e9714f007f68cd3b336b7c227623a19f50e6459bbac92d91d

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp313-cp313-win_amd64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 55bd8ca835afbd28b658ec46e793083dc91c214591c03162537de3888c89b9fb
MD5 1eb4898c2a7c4c681a275591fedac762
BLAKE2b-256 c6a34f33e69f1acfd6f3b705efe5f402a0c5fa394f26ef6abddc091042294b8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2c0688988a5b2280ad6087ffe84398c0163313e412a93ee4b93388fce2dcf7c9
MD5 69b770010da329410ee5f7f3597922f0
BLAKE2b-256 6ea50a4c4a54009cda240785d208891cf8f81175f34b102e008e19d3e2895ce4

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 7190957443ffa0f50ae9b6477a852005d44719160bb5cd39cd2e17043938390b
MD5 df4417211e278dea6a651e809799f512
BLAKE2b-256 2b7e198fb45b9960540195aa1f4077404600cb98ef8cbb8b5468266c33d48349

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp312-cp312-win_amd64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8b827c619f0ea7d0d6ef618a1afc5cc62b2cb101a461efbfc85469c01aa9eda0
MD5 e21dafb2bd741d5a2f1bb5396e3e67d9
BLAKE2b-256 15afc23ca995ab8c12337652b4b0b34772f98983f6ee4db333ce84fd892ee96c

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a088eae760b5416d104b776013e3fd00901f61873a3015b8240d7ca027e3e7e2
MD5 f9bbd750e5d746326125c1530698104c
BLAKE2b-256 5f8eb228978151415b49ebccfde05e1e38555c83d586904f0420cab5a517081f

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 170acd1928090def7b90e6215aad67ff29f3364aedacf893f7d3c44741b53e00
MD5 35b9cfcb450dfa10fb65560e0448b4cd
BLAKE2b-256 103be6d1848c53aec4148d1edbfb28e7ac7fdff6d21ef4a6149d332c1c70f1c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp311-cp311-win_amd64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 5bb7b73d1c3e40517481f733655ea2f9daa44ff0c89f7b950063a2d85e00e854
MD5 2746045337b61de1e3891aa228956196
BLAKE2b-256 652c775e3398f3c1e95d2734e104ce7528cbb48e158ba177cf130598bd8a1e7e

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 953888894688bcdd97a25da7c94f00a171a6b9445d8197fa3cf63768cf2c1efc
MD5 a297f7013b93fc1f8c3a878a1c33ac7d
BLAKE2b-256 521a40fcd9c6496ee781acd90c5656feeb6db933d0bd79ca311327a70f5b093c

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 6ec235de7fadd720cb0d8237c1ab27a66485cc69d4e8bc95ae4cab8ecfce4613
MD5 86115ee739e0cb343ff0f2f4817298dc
BLAKE2b-256 4dc2ae793c73d332b356364b764ad4baf859da6de950d9da147dc4c461958250

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp310-cp310-win_amd64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a293cfa83d71073f1f04810cb8eb906ef650d53bb4a5e1070e1b310203d9647a
MD5 ed0aa525342ef70b954ab948af4d5481
BLAKE2b-256 ed71e7e63f1e2c5d33124bc65014949db80e887116695bab2a77027e33e87acf

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

File details

Details for the file auspex_cursus-0.8.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_cursus-0.8.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6046b6678f5a3eb21f4a2200f09fd7ec91d197dde1df1e255aac085c20d56533
MD5 2b4e6d17cd61867f7d283800af1449ae
BLAKE2b-256 5a454a3b7cb58b2c0a15d8dcbf36823a71ba6f487c2c692b17a2716d38927d02

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_cursus-0.8.0-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: release.yml on sohanurislamshuvo/auspex-cursus

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

Release history Release notifications | RSS feed

0.8.2

12 files

0.8.1

12 files

This release

0.8.0 This release

12 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