al3dtiles

High-performance 3D Tiles v1.0/v1.1 reader, parser and converter (Cython + C++).

Features (v0.1)

Zero-copy GLB/B3DM container parsing (C++ mmap)
One-line GLB chunk0 JSON extraction
Meshopt + KTX2 decompression to Blender-readable GLB (via almeshopt + alktx2)
3D Tiles tileset traversal (v1.0/v1.1, 3DTILES_content_gltf)
C++ multi-threaded tileset JSON prefetch (std::thread pool + simdjson) with thin Python wrappers
Multi-threaded batch helpers

Quick start

import al3dtiles as t

t.extract_glb_json("content/1.glb", "out/1.json")
t.decompress_glb("content/1.glb", "out/1_blender.glb")

import al3dtiles as t

ds = t.TilesetDataset.open(r"Z:\...\tileset.json")

# 惰性解析：构造时不扫树，首次访问时才加载（C++ 线程池并行预取 JSON）
root = ds.tree(show_progress=True)          # 需要 transform / 树结构时
items = ds.contents()     # 扁平 content 列表（同一 C++ 并行引擎）

# 导出（默认：套用级联 transform，ECEF 真实位置，接近 Cesium）
ds.export_common_glb("4293.glb", r"E:\out\4293_world.glb")

# keep_enu=True：仅 decompress，保持 tile 局部坐标（原逻辑）
ds.export_common_glb("4293.glb", r"E:\out\4293_local.glb", keep_enu=True)

import al3dtiles as t

# 质检单体元数据（QC3DMETA v1）：遍历叶子节点 → 每单体 bbox + footprint + 网格桶
# 输出与 tileset.json 同级的 tileset.quality-meta.bin.zst（zstd level 3）
result = t.create_alcheck_metadata(r"D:\Data\...\tileset.json")
print(result.feature_count, result.elapsed_ms)

Build (Windows + Python 3.11)

# Vendor simdjson + meshoptimizer (first time only)
powershell -ExecutionPolicy Bypass -File scripts/vendor_simdjson.ps1
powershell -ExecutionPolicy Bypass -File scripts/vendor_meshoptimizer.ps1

chcp 65001
uv sync --extra dev
uv build --wheel --out-dir dist

Build options (`pyproject.toml`)

[tool.scikit-build.cmake.define]
USE_AVX2 = "ON"    # default
USE_AVX512 = "OFF" # reserved

Test

uv run pytest tests/ -v

Set AL3DTILES_TEST_DATA to override the default test tileset path.

Dependencies

Runtime: alktx2, almeshopt, numpy, orjson, zstandard
Build: scikit-build-core, Cython, ninja, CMake ≥ 3.20

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.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

al3dtiles-0.1.21-cp314-cp314-win_amd64.whl (483.9 kB view details)

Uploaded Aug 17, 2026 CPython 3.14Windows x86-64

al3dtiles-0.1.21-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (738.4 kB view details)

Uploaded Aug 17, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

al3dtiles-0.1.21-cp313-cp313-win_amd64.whl (473.5 kB view details)

Uploaded Aug 17, 2026 CPython 3.13Windows x86-64

al3dtiles-0.1.21-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (737.0 kB view details)

Uploaded Aug 17, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

al3dtiles-0.1.21-cp312-cp312-win_amd64.whl (474.0 kB view details)

Uploaded Aug 17, 2026 CPython 3.12Windows x86-64

al3dtiles-0.1.21-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (738.2 kB view details)

Uploaded Aug 17, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

al3dtiles-0.1.21-cp311-cp311-win_amd64.whl (478.9 kB view details)

Uploaded Aug 17, 2026 CPython 3.11Windows x86-64

al3dtiles-0.1.21-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (744.4 kB view details)

Uploaded Aug 17, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

File details

Details for the file al3dtiles-0.1.21-cp314-cp314-win_amd64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp314-cp314-win_amd64.whl
Upload date: Aug 17, 2026
Size: 483.9 kB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`100ac08d962d4d5a5981d0a2fad009203b302ae6ce6c3280aa080afdb612bc53`
MD5	`53d4658414698cd701a39614e74d10fc`
BLAKE2b-256	`e8e11a3648da2d65777d27014d214da39c3ff96c93c36b19bc9c0b6a011c456e`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Aug 17, 2026
Size: 738.4 kB
Tags: CPython 3.14, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`38168fc08cad8fcacdb8c5be0e1aab21806bd27837aebd8ab9c7abb4bccf7d81`
MD5	`2b998047b419701f754405d38ba5094c`
BLAKE2b-256	`d57ccedbe7bc3f298130a64fea228f98ace40acb671e35123f78d7e86ef2a277`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp313-cp313-win_amd64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp313-cp313-win_amd64.whl
Upload date: Aug 17, 2026
Size: 473.5 kB
Tags: CPython 3.13, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp313-cp313-win_amd64.whl
Algorithm	Hash digest
SHA256	`301142ed5cc9fa01ce598225ca08811b1f4649f1975b248ae5dafaa59da80951`
MD5	`5412f414be0f4de6286fa93abfc6bdf1`
BLAKE2b-256	`20109ba34a6646986d264dd636dd3a366c69140b9da49f9d9edaafc14dae0b9b`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Aug 17, 2026
Size: 737.0 kB
Tags: CPython 3.13, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`a466962fb0b0e29691cb0b7eaf522ef040b8beea53fddbe8f1f1b2afddd5a347`
MD5	`62d8f4f21a75eec654406c1359980897`
BLAKE2b-256	`d41235ac75410cc4d331a0a17cf2d8e9f8c2c9f11425a12aa37a8fa366cebfd3`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp312-cp312-win_amd64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp312-cp312-win_amd64.whl
Upload date: Aug 17, 2026
Size: 474.0 kB
Tags: CPython 3.12, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp312-cp312-win_amd64.whl
Algorithm	Hash digest
SHA256	`8f679592bf35397cba391149cf6a98cf1bbff5f6693ee47a37d3d0b2230d708c`
MD5	`f14181e54c8a887ee343612f56c2ea18`
BLAKE2b-256	`031d2217e74e89236fa93413d5a32f10265216676fd6ea6ed3dfb6eb7601413d`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Aug 17, 2026
Size: 738.2 kB
Tags: CPython 3.12, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`630a3bf634a4419f308e03efb349f2270595c151e40106fc0987033298ac0e32`
MD5	`6382f4af74dc2241df545f4dcbb49ba2`
BLAKE2b-256	`c084a22cfa1fbcdccd4960de84b667fbb1971c1a1eb217f87ac608dd26f4449b`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp311-cp311-win_amd64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp311-cp311-win_amd64.whl
Upload date: Aug 17, 2026
Size: 478.9 kB
Tags: CPython 3.11, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp311-cp311-win_amd64.whl
Algorithm	Hash digest
SHA256	`4d89373517f15bace2482f7796f47dd34f3e9c305c9b0e780e27c8be71783e08`
MD5	`3d7ef21fd1a598402fd5946b331c2490`
BLAKE2b-256	`534a1b358bcb3d9062f3b7e099ea3f770591ca79a969aa63fb6b11eaa9f5350a`

See more details on using hashes here.

File details

Details for the file al3dtiles-0.1.21-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: al3dtiles-0.1.21-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Aug 17, 2026
Size: 744.4 kB
Tags: CPython 3.11, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for al3dtiles-0.1.21-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`78d431deafc6338d929a6a32655bb636ac7770cddb7e8dc6f8df3c46bc5b8c7e`
MD5	`d1ca071ba6a04c375a63505d337bc1ef`
BLAKE2b-256	`f04ecd3e1ecc2d991bb5e43c619c4235b0278a1814338471b8de97de5104a03a`

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.23

Aug 17, 2026 1 file

0.1.22

Aug 17, 2026 1 file

This release

0.1.21 This release

Aug 17, 2026 8 files

0.1.20

Aug 17, 2026 1 file

al3dtiles 0.1.21

al3dtiles

Features (v0.1)

Quick start

Build (Windows + Python 3.11)

Build options (pyproject.toml)

Test

Dependencies

Key dates

1 maintainer

Credits

Requires

Provides Extra

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed

Build options (`pyproject.toml`)