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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

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

Uploaded CPython 3.11macOS 11.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

ringgrid-0.2.6-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.6-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.6-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: ringgrid-0.2.6-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.6-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 6e47dec587abecf12dc20ae63bafef9731ca28be804cf4a6f293298bb3fea402
MD5 06a406bfe05cf03e1e3de5a91d6b481c
BLAKE2b-256 5aca85e9a3375c429292b07a65af1f43428634155c83ad8cd5bdf415763f4eb0

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 42e5f2e2bc9bebc0772bdcba78aa986eb174a2d2a9405b5858308194fed6a1f5
MD5 28c3c27464ff097bf795b8e0c1e44112
BLAKE2b-256 ddad0752299e2cc372fe8433ec1acc2f5e35a1c60711e70703ace89e7f9b2bb5

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0b79b71bf23b5baf8c4d4f937177c51ca6ab9129076fea5a9d7c6e8bb62cc054
MD5 401daa797812e74432ff92fa0ab15e05
BLAKE2b-256 fc5de0fb4bb624fb15b38279a34ad15cdc53a56b34df97a5edf2786cb06e1cd6

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ringgrid-0.2.6-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.6-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 028ec0da6cdc78ff51948a9b075a53979df0947578ff7f89bbc8b6c8dfba6a2a
MD5 f83e9742549e3728b69b0717c2d186c0
BLAKE2b-256 4c7879bac2520c0bbf433724c9d1dc60f903efd3812aa6bd499aa0ce3d4c6ab4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 51c95c54600984ce72c9efae2526f6ff5523a865616cea18b8efa2555c2d6c8c
MD5 7337e9ef8115c4e30faaa1088d2fe204
BLAKE2b-256 2009f93718780e6a305a332197b3e3b352d2a9492aa43fb7887a31ccff691141

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f7b54fc3e4fe3d0349eb45f9e6a3ed54f4fe263418296fef6e6d1eda42db8dae
MD5 e31e3aca5a98fa4c8c3e8d41334eb040
BLAKE2b-256 7c135ad8e977bfe017d0af6246e743f07a0227b9a5384319803a083b91c1786d

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ringgrid-0.2.6-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.6-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 a767f7d9f18d13ea6d29ec3f7437f60ad05c2818728deed0a1b9d038cd079d00
MD5 9c14fed7e27fe940ed5ebb39ef4864b4
BLAKE2b-256 40ad547ff941d6e6155f010511c1bc03e57e1bf6a677045277c97a2aab6f5e77

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bab4f045d8b71e6c067144b2cf5db17a123f9e92a6c0bea2dc18022055ae20b7
MD5 d34c4244a1e9bf774157031e9abef1b0
BLAKE2b-256 71056b9ec5b703d50e01d2885a8d70e65a499e908b5ad552c09126b4f29614df

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 83c93066d93c4e16d4fca023bf7e01415e65bdd7030a33dde1198f0c1ff635af
MD5 c20a2b52d5ccb5b14f4f94e69dc686f5
BLAKE2b-256 6ccd2346cdce9a3b565e253d1107937043183ed2674b64c8860f21eff3bb072e

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ringgrid-0.2.6-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.6-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 2c25ab6ade5b605e990e87ef8ac19083a15ba09e78e094fa2e5278e3e5c21c56
MD5 921234cb2dadd57a52f35e4c28969b74
BLAKE2b-256 6d71bbaa68724f88863fbe2a4632e83621aee8a1ee4aacf08daeaf24b40a7e35

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 aabb02a4c6cb539ad32bf551f03015f81e23d55dd496ea53527750d99286dc05
MD5 9b773c02501d3cc0ae2147bfda1b8986
BLAKE2b-256 16dd2a26d1cb4bbff558c0d17b466297f9d2e0c3a63126c39ce621aa292ba6ef

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ringgrid-0.2.6-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d7ca011e4e182d0ebfc0325c0b37b54f274f437f51a97faf885d2d10a99e23ed
MD5 4277d17bcbda0df962c3c44d79d8afb7
BLAKE2b-256 1e27bf7079cf4013e3f98d8351d1e97f0d8921ebdde20250e6486dc69dacf68b

See more details on using hashes here.

Provenance

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