Skip to main content

Python module for 3D tiles format

Project description

chat link Build pipeline status Py3dtiles version on pypi Supported python versions Code coverage py3dtiles GitLab last commit Py3dtiles license

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 py3dtiles

For 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': [np.float64(0.390625), np.float64(0.3125), np.float64(0.0), np.float64(0.390625), np.float64(0.0), np.float64(0.0), np.float64(0.0), np.float64(0.3125), np.float64(0.0), np.float64(0.0), np.float64(0.0), np.float64(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.

Lidar HD data converted into 3d tiles visualized with giro3d

Documentation

The CLI and API documentation with examples are available here:

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.

Thanks

The following entities have funded py3dtiles:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py3dtiles-10.0.0.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

py3dtiles-10.0.0-py3-none-any.whl (99.2 kB view details)

Uploaded Python 3

File details

Details for the file py3dtiles-10.0.0.tar.gz.

File metadata

  • Download URL: py3dtiles-10.0.0.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for py3dtiles-10.0.0.tar.gz
Algorithm Hash digest
SHA256 f2b86052ab8ea9e5f130c910ddf3a50b6768754fa195801c9edd7524f521e607
MD5 cb743b5a4b23bd07ca83b82c526b1e07
BLAKE2b-256 22adab96389b1582863dbe494564ef4441b1ebefa3aee4f459ba01c37cbcff1a

See more details on using hashes here.

File details

Details for the file py3dtiles-10.0.0-py3-none-any.whl.

File metadata

  • Download URL: py3dtiles-10.0.0-py3-none-any.whl
  • Upload date:
  • Size: 99.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for py3dtiles-10.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 af351407171689b55b2be7e6c067c299c55c530f2210ed30d55739fe7824c4ce
MD5 f815ccf5d8af64ccdad11f91b9a5ab59
BLAKE2b-256 6f03422dfb924de62f3098fe1499116fefc556ede17070758b01414625c7a1fd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page