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.2.7-cp314-cp314-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.14Windows x86-64

ringgrid-0.2.7-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.2.7-cp314-cp314-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

ringgrid-0.2.7-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.2.7-cp313-cp313-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

ringgrid-0.2.7-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.2.7-cp312-cp312-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

ringgrid-0.2.7-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.2.7-cp311-cp311-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

ringgrid-0.2.7-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.2.7-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.2.7-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.7-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.2.7-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 f6d69310fbb852ace9829db48f8dfc2252637e7cdac754a035b16242f7eee7f1
MD5 fe883389ca95a8e07444be457a59a1a8
BLAKE2b-256 28291b57e22937fc525b95061f9cfa25ace1f56804d5ebf0da7a4253aab2e425

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 210a298313d03c0987a3c91bbc0b8bcc32768a4c041082e1ca5908ed943696a5
MD5 4bfcf532327c703a8da4168fc0c42e88
BLAKE2b-256 9252f6a32d2d34e828951fc771d9f1606bb40dc59f696d39e31741a34c4106f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f1ba0239ee9563c58d9bf819f7863b052252b74cc5129c9968a474edcb8df8f8
MD5 e82b8dc498eebd43f38ad03d9214c327
BLAKE2b-256 c7c2a06bf217329ce01094290601de0a54a86c97b6c278bceb78d2e5eff30c74

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.7-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.2.7-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 1d86d85339524cc6571715fd9f751f1ee99b167496c29226fddeb9e91709adc6
MD5 d7341e2dad1eed3c79a5799f1f1b1bd4
BLAKE2b-256 88532050a5f0a74b05583cd018d39758cbe8defa7d2322b9dd41ca88da5b2355

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bbaddf9a529b63bf35b07d98dff7a18747b4860fd3e5ef459db4f8a72ab91d48
MD5 c7930639b536732aa050628083ee56e5
BLAKE2b-256 509c61b30c056108b5c9b93407c991e5730a36849c508c1bd01c8333489c704f

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 32d20bbe4bb133fa3af8b558433c9e9118745e1a6fc35f88dfcf29e85fcb579f
MD5 ad5bc3d73424e153fbb9685da35d2ebd
BLAKE2b-256 297c9d2f6334ca1cae8da897f1a249b11bfc02663af94983877a69514474bafb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.7-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.2.7-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 28ce97d6ce135e38e3c2c732cc4e0d98f6da980506ff661ccfc607641b36f990
MD5 ae07b8b1ad1acf13c9491a86a1888804
BLAKE2b-256 f8c0021823022104221f17d00bbceca425a5ec5d06d55f88c0e7d87913d9a7d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9a8b50fbfcf55c515c3a6560e857313d97b827fcf26d72826504ff28413f55b0
MD5 8312e71d5cab132fc25f9d08fec9eb3c
BLAKE2b-256 48b964688d59b04737021c53868164363fc64e5a9a9855b0fac9f08d970568e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 48d2f97dcddc4740f97454a7834ac1863f847b84879953698c8f5e73816a17bc
MD5 74cfa25366a76caa9d9e562571e7160e
BLAKE2b-256 e4928d6d353e656d47f23374acd850ccfb199107d06bf81800cef0a1c2a689b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.7-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.2.7-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 0cbf88077a89e468b6610d6a05dbccf13c9360813552786e02b1cecb1b8a6bfd
MD5 ee4e902b6c9b8c27ffbfb91507276325
BLAKE2b-256 cdb252e262d816620f4d286cd6f6447741ea23cfb857e81ee95285d594e5fed3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 2a27f7dbaa91bd8e10aa3413c8ed37dccaa3132d71c0b8489b4702738ce72fd9
MD5 5455ce16512a1aacfb5fb7c26a8a4413
BLAKE2b-256 449ca5e8d5e39dfd8d3145dc191e09099980423e5c39be53144fa4f89e5caa6e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6783f3ce537f28f7d5308703d9063c528abc1125bac372e3e1d2f184bb25db31
MD5 e3eec653392285d91e2a978bc413dde9
BLAKE2b-256 ae8da1d0496226cb6364242623de090c61bcd802f843af94cb040a5de0662098

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.7-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.2.7-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 b6a6bf0372e8c9361b6aa73cba0a88e6be1e7d04e9b1e0bd98b293390b6bcbfb
MD5 cf33a85bd41e7a688f1dd3ba0a4b2dbe
BLAKE2b-256 2f46b7e90cb652393ef50d8a64993f4db5d71b2e7fc6a89ef4a0fba0e60b01d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 10218b163425f5e1c25fd48def186b625a377b95b8bd6a51fa17d172dca59f56
MD5 1eb4224169535a18f57a6587e1e21ae1
BLAKE2b-256 d945b6010209f00a23971a90a4aee5b85a59171d71f80f975f692a44ffa62df3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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.2.7-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ringgrid-0.2.7-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2371cbbb95b7dd1dfc764eb63a8d120c052bc6b80b1e6750736a7f52a6c1ebea
MD5 72900d3996e1578fcbe48e6bad973645
BLAKE2b-256 859508e84e0602b2b3eb1f01d4419cfb55975fe4f5b2e6fdc41021d53778ca5f

See more details on using hashes here.

Provenance

The following attestation bundles were made for ringgrid-0.2.7-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