Python module for 3D tiles format
Project description
Py3dtiles
Py3dtiles is a CLI tool and a library writing with Python for creating and manipulating 3D Tiles.
Features
Tileset manipulation
Read tileset lazily (to avoid useless memory consumption)
Write tilesets with their tile contents
Browse the tile structure, access to the properties and tile content with the ability to modify them
Read and write pnts and b3dm with the batch table support
Tiling tools
All tiling tools are available with the API and the CLI
- Convert data into 3d tiles (tileset.json + pnts/b3dm files). The supported file formats are:
las/laz
xyz
ply
wkb
Merge 3D Tiles tilesets into one tileset
Read pnts and b3dm files and print a summary of their contents
Installation
With pip
To install Py3dtiles with pip (recommended method)
pip install py3dtilesFor installing specific format dependencies (las/laz, ply, postgis, install from source…), please read the installation section in the documentation.
With docker
At the moment we only publish on gitlab registry.
docker run -it --rm \
--mount type=bind,source="$(pwd)",target=/app/data/ \
--volume /etc/passwd:/etc/passwd:ro --volume /etc/group:/etc/group:ro --user $(id -u):$(id -g) \
registry.gitlab.com/py3dtiles/py3dtiles:<version> \
convert <file>NOTE:
the –mount option is necessary for docker to read your source data and to write the result. The way it is written in this example only allows you to read source files in the current folder or in a subfolder
This line –volume /etc/passwd:/etc/passwd:ro –volume /etc/group:/etc/group:ro –user $(id -u):$(id -g) is only necessary if your uid is different from 1000.
API basic example
>>> from pathlib import Path
>>>
>>> from py3dtiles.tileset.tileset import TileSet
>>>
>>> tileset = TileSet.from_file(Path("tests/fixtures/tiles/tileset.json"))
>>> all_tiles = (tileset.root_tile, *tileset.root_tile.get_all_children())
>>> for tile in all_tiles:
... if not tile.has_content():
... continue
... tile_content = tile.get_or_fetch_content(tileset.root_uri)
... print(f"The tile {tile.content_uri} has a content of {type(tile_content)} type")
... print(f"with this bounding volume: {tile.bounding_volume.to_dict()}")
The tile r.pnts has a content of <class 'py3dtiles.tileset.content.pnts.Pnts'> type
with this bounding volume: {'box': [0.390625, 0.3125, 0.0, 0.390625, 0.0, 0.0, 0.0, 0.3125, 0.0, 0.0, 0.0, 0.0]}
The tile r1.pnts has a...Result example
The data visualized on this website is generated with the convert and merge CLI command of Py3dtiles: https://giro3d.org/examples/lidar_hd.html
The library used on this site is giro3d but there are other 3dtiles viewers.
Documentation
The CLI and API documentation with examples are available here:
last stable: https://py3dtiles.org/
Roadmap
The objectives are:
to support the standard at version 1.1 (mainly gltf as content)
to convert more file formats
to have a better tiler for geometries
Contributing
We welcome new contributions. This may be fixing an issue or adding a feature, but also:
reporting an issue
reviewing a MR
improving the documentation or creating a tutorial
talking about this project to others
help others on the [chat room](https://matrix.to/#/#py3dtiles:matrix.org)
We have written a contributing guide to help you for your first contribution.
License
Py3dtiles is distributed under the Apache 2 Licence.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for py3dtiles-7.0.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 49eab586cd834f14e0085be4e97012c8c75a1e36c300d3ffbba23f4f80041c58 |
|
| MD5 | 0dd58a2b41d304669a629a3e39f06397 |
|
| BLAKE2b-256 | ce292c9a9f6cfda412b4dc9d22c5413ae1699694689f1f07ab60f5e81c72a94d |
