Skip to main content

ahull3Dpy

Fast 3D Alpha Hull with Label Propagation

Python port of the ahull3D R package. Computes 3D alpha shapes with label propagation from input points to hull vertices and faces. Optimized for tree segmentation and LiDAR point cloud processing.

Features

  • 🚀 Fast C++ core using CGAL
  • 🏷️ Label propagation: Input point IDs → hull vertices → faces
  • 📦 Easy installation with pre-compiled wheels
  • 🔄 Drop-in replacement for ahull3D R package functionality

Installation

pip install ahull3Dpy

Usage

Basic Usage

import numpy as np
from ahull3Dpy import ahull3D

# Generate random 3D points
pts = np.random.randn(100, 3)
pts = pts / np.linalg.norm(pts, axis=1)[:, np.newaxis]

# Compute alpha hull
mesh = ahull3D(pts, alpha=0.5)

print(f"Vertices: {mesh['vertices'].shape}")  # (M, 3)
print(f"Faces: {mesh['faces'].shape}")        # (F, 3)

With Labels (point IDs)

The input_truth parameter propagates labels (e.g., tree IDs from LAS files) from input points to the hull vertices and faces:

import numpy as np
from ahull3Dpy import ahull3D

# Generate points with labels (e.g., tree IDs from LiDAR data)
pts = np.random.randn(100, 3)
pts = pts / np.linalg.norm(pts, axis=1)[:, np.newaxis]

# Point IDs (e.g., tree IDs from LAS file)
# In real LiDAR data, this would be the 'pid' or 'treeID' field
labels = np.array([1, 2, 3])  # Tree IDs
labels = np.repeat(labels, [33, 33, 34])  # Assign to points

# Compute alpha hull with label propagation
mesh = ahull3D(pts, alpha=0.5, input_truth=labels)

# Access propagated labels
print(f"Vertex labels: {mesh['input_truth']}")     # Labels for each hull vertex
print(f"Face labels: {mesh['face_truth']}")        # Labels for each face (3 labels per face)
print(f"Unique labels: {np.unique(mesh['input_truth'])}")  # Should be [1, 2, 3]

Visualize

from ahull3Dpy import plot_ahull3D

plot_ahull3D(mesh, color='lightblue', opacity=0.7)

Metadata

Release files for ahull3Dpy 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for ahull3Dpy 1.0.0
File Actions
ahull3dpy-1.0.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for ahull3dpy-1.0.0-cp312-cp312-win_amd64.whl
ahull3dpy-1.0.0-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details for ahull3dpy-1.0.0-cp312-cp312-manylinux_2_28_x86_64.whl
ahull3dpy-1.0.0-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for ahull3dpy-1.0.0-cp312-cp312-macosx_11_0_arm64.whl
ahull3dpy-1.0.0-cp312-cp312-macosx_10_13_x86_64.whl CPython 3.12 CPython 3.12 macOS 10.13+ x86-64 Details for ahull3dpy-1.0.0-cp312-cp312-macosx_10_13_x86_64.whl
ahull3dpy-1.0.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for ahull3dpy-1.0.0-cp311-cp311-win_amd64.whl
ahull3dpy-1.0.0-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details for ahull3dpy-1.0.0-cp311-cp311-manylinux_2_28_x86_64.whl
ahull3dpy-1.0.0-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for ahull3dpy-1.0.0-cp311-cp311-macosx_11_0_arm64.whl
ahull3dpy-1.0.0-cp311-cp311-macosx_10_9_x86_64.whl CPython 3.11 CPython 3.11 macOS 10.9+ x86-64 Details for ahull3dpy-1.0.0-cp311-cp311-macosx_10_9_x86_64.whl
ahull3dpy-1.0.0-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for ahull3dpy-1.0.0-cp310-cp310-win_amd64.whl
ahull3dpy-1.0.0-cp310-cp310-manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64 Details for ahull3dpy-1.0.0-cp310-cp310-manylinux_2_28_x86_64.whl
ahull3dpy-1.0.0-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details for ahull3dpy-1.0.0-cp310-cp310-macosx_11_0_arm64.whl
ahull3dpy-1.0.0-cp310-cp310-macosx_10_9_x86_64.whl CPython 3.10 CPython 3.10 macOS 10.9+ x86-64 Details for ahull3dpy-1.0.0-cp310-cp310-macosx_10_9_x86_64.whl
ahull3dpy-1.0.0-cp39-cp39-win_amd64.whl CPython 3.9 CPython 3.9 Windows x86-64 Details for ahull3dpy-1.0.0-cp39-cp39-win_amd64.whl
ahull3dpy-1.0.0-cp39-cp39-manylinux_2_28_x86_64.whl CPython 3.9 CPython 3.9 Linux glibc 2.28+ x86-64 Details for ahull3dpy-1.0.0-cp39-cp39-manylinux_2_28_x86_64.whl
ahull3dpy-1.0.0-cp39-cp39-macosx_11_0_arm64.whl CPython 3.9 CPython 3.9 macOS 11.0+ ARM64 Details for ahull3dpy-1.0.0-cp39-cp39-macosx_11_0_arm64.whl
ahull3dpy-1.0.0-cp39-cp39-macosx_10_9_x86_64.whl CPython 3.9 CPython 3.9 macOS 10.9+ x86-64 Details for ahull3dpy-1.0.0-cp39-cp39-macosx_10_9_x86_64.whl

Total release size: 15.1 MB

Release files / ahull3dpy-1.0.0-cp312-cp312-win_amd64.whl

Download URL ahull3dpy-1.0.0-cp312-cp312-win_amd64.whl
Size 183.2 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
dc96db8b9270a6720abe520493ceb13b598948c402ca9d698a3502294e6bb68a
BLAKE2b-256 checksum
How to use checksums
cc78483ae40ce8e4a4c6bcce029a7a6420636b3173b82a7d1fbed8799797c45a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL ahull3dpy-1.0.0-cp312-cp312-manylinux_2_28_x86_64.whl
Size 3.2 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
46c681d073c05ba75e5e744ba731cbbabc18ff68d97f0dbd37944ea4f4cf8959
BLAKE2b-256 checksum
How to use checksums
42c8cf99789926397b3b9680acaabfa1cc25db001a92508c88e52890ddaab3de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp312-cp312-macosx_11_0_arm64.whl

Download URL ahull3dpy-1.0.0-cp312-cp312-macosx_11_0_arm64.whl
Size 186.0 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
d2fded079fde97cf225b578df4075687e06307a21eac9157dd697d042e90234e
BLAKE2b-256 checksum
How to use checksums
f980548d6d765834642c7bc1aa08e29dc727316050111887c17f7c54ae529f5b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp312-cp312-macosx_10_13_x86_64.whl

Download URL ahull3dpy-1.0.0-cp312-cp312-macosx_10_13_x86_64.whl
Size 198.9 kB
Tags CPython 3.12 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
0528ae9bcaff68e08c1d134358c650a57dbffd94d10b84c22297c7cbcd5e3231
BLAKE2b-256 checksum
How to use checksums
5718ed3ea1f367bf5b838d020d25d2c1be6fc661ec5db1a4722265b6185b096f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp311-cp311-win_amd64.whl

Download URL ahull3dpy-1.0.0-cp311-cp311-win_amd64.whl
Size 179.4 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
4a59a81fb65dd5cff0b171acc21e74ea8271d21f6c24b468be5169a62fb92f98
BLAKE2b-256 checksum
How to use checksums
9969b73f5d94588157438a48eaaf4fb6f8403c3bfd6a50a8b3b7f0279287dbc2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL ahull3dpy-1.0.0-cp311-cp311-manylinux_2_28_x86_64.whl
Size 3.2 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
ad6b2fbb68cba25c5198e27fb9d48fde70dc901b909acc2c8594e5cf9f82a6b5
BLAKE2b-256 checksum
How to use checksums
f0163e49a65bed8f0e359d370ded7110f4b994c7ab5039ee18cc4b4dbc8823a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp311-cp311-macosx_11_0_arm64.whl

Download URL ahull3dpy-1.0.0-cp311-cp311-macosx_11_0_arm64.whl
Size 183.6 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1a62274d35f04145252d169d24df14639ae9bbd265cf618f10f9d985386f83b6
BLAKE2b-256 checksum
How to use checksums
12feda004063b1b95e772160a2aebfc56437013da3499bad0d68fda23544440a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp311-cp311-macosx_10_9_x86_64.whl

Download URL ahull3dpy-1.0.0-cp311-cp311-macosx_10_9_x86_64.whl
Size 199.4 kB
Tags CPython 3.11 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
22f1b1f3ebee595f90d0dc89bf84fb0c63445925032fde3b0f792b9b14970153
BLAKE2b-256 checksum
How to use checksums
0194d0fe8a82f7826a4ea0c4f5cdfd430bea07b0ef962ba2cb50c0c3f0b09c99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp310-cp310-win_amd64.whl

Download URL ahull3dpy-1.0.0-cp310-cp310-win_amd64.whl
Size 178.6 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
7ac09351fac93ac56173f920a03122f3f432da31f5644ac52586a39530f87459
BLAKE2b-256 checksum
How to use checksums
c58a08d6a537778f93a1ef39ad03a2c6ec6d0ae6f6d9b8e6e6c4570ebf70eb9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL ahull3dpy-1.0.0-cp310-cp310-manylinux_2_28_x86_64.whl
Size 3.2 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
3dd671dca07c15f4f6bffdae2215e1f03c648460e9a3aa03f9a7405bc575bfd5
BLAKE2b-256 checksum
How to use checksums
466524a55e9f935d9fb5c0e3bb93664802296cf5402eff6a2c7592e279316cdc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp310-cp310-macosx_11_0_arm64.whl

Download URL ahull3dpy-1.0.0-cp310-cp310-macosx_11_0_arm64.whl
Size 182.3 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
28a3f5371e7095c24a1a8a11404e9da3f9e674a482fb29cabc1a832d7eea2812
BLAKE2b-256 checksum
How to use checksums
df1b251c2fa045aa26e3e6dbc82cb86c2515539ebb1ca7dc1482ede922eb22be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp310-cp310-macosx_10_9_x86_64.whl

Download URL ahull3dpy-1.0.0-cp310-cp310-macosx_10_9_x86_64.whl
Size 198.2 kB
Tags CPython 3.10 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
75a8514f7258d1f99b5bdab728ddd250692aaf256c59deeea22ab7b0e7e69c47
BLAKE2b-256 checksum
How to use checksums
163d6cd130d25e157b30b79d9a807e4f931e00ed8de953c63db114ecf316ec25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp39-cp39-win_amd64.whl

Download URL ahull3dpy-1.0.0-cp39-cp39-win_amd64.whl
Size 178.7 kB
Tags CPython 3.9 Windows x86-64
SHA-256 checksum
How to use checksums
1f3ef25148cd3d4e026a5f33985b7f7addf92cf3240065ba734cff8734e8b352
BLAKE2b-256 checksum
How to use checksums
64555b4896b2a0d0ff35a9cdd815566fe72a3166e51057c291d4b93c01da7aab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp39-cp39-manylinux_2_28_x86_64.whl

Download URL ahull3dpy-1.0.0-cp39-cp39-manylinux_2_28_x86_64.whl
Size 3.2 MB
Tags CPython 3.9 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
5e99bf3138638a21f7d37a9ede41046e60ff8009d5912fe468187a330a5608bf
BLAKE2b-256 checksum
How to use checksums
9310652e70e08bf90afb6e0af1643c2af53204a9418a203463aa067f898eea3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp39-cp39-macosx_11_0_arm64.whl

Download URL ahull3dpy-1.0.0-cp39-cp39-macosx_11_0_arm64.whl
Size 182.5 kB
Tags CPython 3.9 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
5195a7c86f40e012556e0552cd1bf8e036370e9a509e29c4ed6b287606e8aaf3
BLAKE2b-256 checksum
How to use checksums
8839ce911fa1f78c4e66ac6df260f963f67f130cd1996d4342e5d57d5511893b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / ahull3dpy-1.0.0-cp39-cp39-macosx_10_9_x86_64.whl

Download URL ahull3dpy-1.0.0-cp39-cp39-macosx_10_9_x86_64.whl
Size 198.3 kB
Tags CPython 3.9 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
8c2ea76911bfb8094f3424171051899c4b2bbdbfe7c618164e08ac0018ee9810
BLAKE2b-256 checksum
How to use checksums
9ad799844aee38444950dcddeaf7bfb763a47236b3814f7ad7525aee25c49fb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Security for ahull3Dpy 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

16 release files No provenance

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