Skip to main content

Python bindings for ringgrid detector

Project description

ringgrid (Python)

Python bindings for the ringgrid detector, powered by PyO3 + maturin.

Install (from source)

pip install maturin
maturin develop -m crates/ringgrid-py/Cargo.toml --release

Features

  • Native Detector API with NumPy input support
  • Full DetectionResult model objects with JSON round-trips
  • Optional plotting helpers in ringgrid.viz (pip install ringgrid[viz])

Input Rules

  • Detector.detect(...) accepts:
    • np.ndarray with dtype=uint8 and shape (H, W) (grayscale)
    • np.ndarray with dtype=uint8 and shape (H, W, 3|4) (RGB/RGBA, auto-converted to grayscale)
    • image file path (str or pathlib.Path)
  • Other dtypes/shapes raise TypeError.

Examples

Run from repository root after maturin develop:

python crates/ringgrid-py/examples/basic_detect.py \
  --image testdata/target_3_split_00.png \
  --out testdata/target_3_split_00_det_py.json

python crates/ringgrid-py/examples/detect_with_camera.py \
  --image testdata/target_3_split_00.png \
  --out testdata/target_3_split_00_det_cam_py.json

Plotting example (requires matplotlib extra):

pip install -e crates/ringgrid-py[viz]
python crates/ringgrid-py/examples/plot_detection.py \
  --image testdata/target_3_split_00.png \
  --out testdata/target_3_split_00_overlay_py.png

Project details


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.

ringgrid-0.3.0-cp314-cp314-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.14Windows x86-64

ringgrid-0.3.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ x86-64

ringgrid-0.3.0-cp314-cp314-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

ringgrid-0.3.0-cp313-cp313-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.13Windows x86-64

ringgrid-0.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

ringgrid-0.3.0-cp313-cp313-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

ringgrid-0.3.0-cp312-cp312-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.12Windows x86-64

ringgrid-0.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

ringgrid-0.3.0-cp312-cp312-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

ringgrid-0.3.0-cp311-cp311-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.11Windows x86-64

ringgrid-0.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

ringgrid-0.3.0-cp311-cp311-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

ringgrid-0.3.0-cp310-cp310-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.10Windows x86-64

ringgrid-0.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

ringgrid-0.3.0-cp310-cp310-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

File details

Details for the file ringgrid-0.3.0-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.3.0-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.14, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ringgrid-0.3.0-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 c3990a0675b7fd394fa4d26e0e17d50cb63ecaa26384d78e06f4b3775b7d874e
MD5 3ac7e8b1e2f7677b8d479120070a2b95
BLAKE2b-256 21e3fcc115d8d771415555fb37d97a474321aa48af22d429a667797050f86f93

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp314-cp314-win_amd64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8c06dd37afe386abe17a8d3f36ed21440385e120f68f2fe3482e4f8e32f59b2f
MD5 4501d1f44d7a464a5b342eba4fbfe6ad
BLAKE2b-256 a184e8638e53dc187a53b50c31076a844d611adf5e04e4846666ac5856b85182

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d9fee4f5c62b99a63bb0d7ef5154cbf8c0b9f607be1b488574a39de608149581
MD5 920033f855ef22983816fa968941c875
BLAKE2b-256 03e33755c8e0cf3ca04088e2434264672af7937b015f09bc3e13b194e6bfcf12

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.3.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ringgrid-0.3.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 136cb2b0a2c8edee52ef3ebcd791143b9c57436287788210404217adf8e02daa
MD5 750c0b10c5e868c9a741d4aae7820da6
BLAKE2b-256 009e17ef5e3fea873c48c7800d42fb09dcc76e6b5cb9d5f15073b4380881b78c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp313-cp313-win_amd64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a2778e59d415066ccb7f357ebe7644a9d81508540901b56d3be11f8acb934e17
MD5 2347e612bbb84b34b640b7f931c48627
BLAKE2b-256 b81eacd1120ce84f791f9e12c0e302c760c7628a393660c354d391a6d44b11eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 acee5e2f4c56c8257fcbf184dfb2891ab2c5d1741ed066cb7a901e2fc29ec826
MD5 5f4a6db23e905d350232e765e1f47dbf
BLAKE2b-256 5e237baf4e9490ab208817a99500dc59e6a7271393139ef574597906ba32529e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.3.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ringgrid-0.3.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 749691dd8ef14cc6fb78a87ebc6e04a572af53fc03577b6b672b9843d83f16bb
MD5 7d3bd671748d17bf92532159aac27ab0
BLAKE2b-256 47d6f51d4de9ecd797a907cec911b6a6d33911bd7b4b2d82f8d39ecc638da423

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp312-cp312-win_amd64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f6e856e508b8d35e75e449b47898c537ddb6afac7c0f3c21597674e9737e93c7
MD5 c407e4c3b67af6e9ffc3e40cc5939d8f
BLAKE2b-256 24c23e785afbf67d41fff4ca92d0e374043cb3b4f04723ea3218830c548fd4c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 deba7d23a50034f04b5b633b8d879d92a0ff69878f11f56b0ad08e7d37cfa76b
MD5 4dad4a418de286b7ac8479deb5d48a72
BLAKE2b-256 cda50177e9e82f3ac5a82b4361f3fcb925e7eefe7a433032f67c332d532c350e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.3.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ringgrid-0.3.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 20af36bdc6929ad0674f2cba59fe2737e10f83572ea23c5d5ebc79bc5cda8a37
MD5 3c243a4ca7fea1e5a5d08fc295cb0670
BLAKE2b-256 88805f3bc2ccca5535187541ddcdfafa092a0dac48ca05894c265f8d432ff28b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp311-cp311-win_amd64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 91e5c95e0e8f6992d83571d2962e9c171d47c3510ccb2c4cdfe4bf3b57518ad3
MD5 d6219ba2dec230635e75e42d12e24ad7
BLAKE2b-256 39f173cbd13bc4054f30844088753d81c36bc6b88c1d7333ea07bd6b569049c7

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a9c023c310e7d3f1037f7e183e8826aef4ffea010d402d704924570e78a1d5ed
MD5 b3b9568a16ff9b68cab5433d1b039e7b
BLAKE2b-256 4c3517110ec21e606c67f69f7f090776136e977aeecef1dc74adcdae37a42d7a

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.3.0-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ringgrid-0.3.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 129fbab4d14b0c20fc80884c48882716cd779b0bb11102e670b034d00eb4450c
MD5 e72adda16486fcab88eaa558444add53
BLAKE2b-256 80b8127996532cf05b5e19abf35b6c6ec9f813463552a6806013ed81f6989eb8

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp310-cp310-win_amd64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d07d01234e8d3255ede26ec5c1f96af5c97cdbc5533db03d586bfdf03dcd487b
MD5 64ec7164a4a953a435c0a2f6dc31f06d
BLAKE2b-256 7939eaaef45772ac5bdd72c712a2e9fed151455110c4879b38b8e4f46313df23

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

File details

Details for the file ringgrid-0.3.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.3.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 08d150a6f383f3e41bf09e6bd04b8fdc9ba8d9f2e287dc57ebd53eb59834e30d
MD5 dfd47ecf6eaf1376dd1d07ec3542a506
BLAKE2b-256 32c96e0727661c5ea93ff950e9374fb22fabcb6bbaa0b0c72041102e37c21853

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.3.0-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: release-pypi.yml on VitalyVorobyev/ringgrid

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page