---
id: alphashape
version: "1.3.1"
license: MIT license
license_treatment: permissive
maintenance: active
---

# alphashape — Toolbox for generating alpha shapes.

License: permissive · Maintenance: active · Downloads: 1.4M/mo

## What it is and what it does

Alphashape is a computational geometry library that wraps point clouds in tight, adaptive bounding shapes. Unlike a convex hull—which always produces the outermost perimeter—an alpha shape lets you control how tightly the boundary fits by adjusting an alpha parameter: lower values yield convex shapes, higher values produce concave hulls that hug the data more closely. The library works in 2, 3, 4, or higher dimensions and returns either a polygon (2D), a mesh (3D+), or a set of simplices depending on dimensionality.

You can specify the alpha parameter directly, define it as a function of local point density, or let the library solve for an optimal value automatically. A command-line tool is included for batch processing. The package depends on shapely for 2D geometry, trimesh for 3D visualization, and standard scientific Python stack (numpy, scipy, networkx, rtree) for computational backbone.

Use it for:

- Compute concave hulls around GPS traces or sensor readings to define coverage regions without over-fitting to outliers.
- Mesh 3D point clouds from LiDAR or photogrammetry by generating alpha shapes at varying scales.
- Automatically determine tight bounding polygons for geospatial features where convex hulls are too loose.
- Solve for optimal alpha values in exploratory analysis to find the best-fitting boundary without manual parameter tuning.
- Generate n-dimensional simplicial complexes for topological or statistical analysis of high-dimensional point sets.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates n-dimensional alpha shapes—concave or convex bounding polygons around point sets—with support for static, dynamic, or automatically-solved alpha parameters.

Yes. The package is stable (Production/Stable classifier), actively maintained, permissively licensed, has no known vulnerabilities, and installs with low friction. It fills a genuine gap between convex hulls and manual boundary fitting. Install it if you need adaptive bounding shapes; skip it only if you require only convex hulls or if your use case is strictly 2D and you prefer a lighter dependency tree.

## Install

pip install alphashape
uv add alphashape
poetry add alphashape

## Installing alphashape

Before you install: Low friction: pure-Python wheel with no compiled dependencies. Actively maintained as of 2026-07-23 with 313 repository stars and no known vulnerabilities.

License in practice: MIT license permits commercial and private use with minimal restrictions; attribution required but no copyleft obligations.

Quickstart:

pip install alphashape
import alphashape
import numpy as np
points = [(0., 0.), (0., 1.), (1., 1.), (1., 0.), (0.5, 0.25)]
alpha_shape = alphashape.alphashape(points, 2.0)

Verify before relying:

- Performance characteristics on large datasets (fact sheet notes solving for alpha can be slow but does not quantify thresholds)
- Numerical stability or precision guarantees for edge cases in high dimensions

## Package facts

- License: MIT license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

alpha shape generation, concave hull algorithm, n-dimensional point bounding, alpha complex computation, adaptive bounding polygon, convex hull generalization, point set boundary fitting, computational-geometry, point-cloud-processing

[View on SkillFed](https://skillfed.io/packages/alphashape) · [View on PyPI](https://pypi.org/project/alphashape/)