Skip to main content

3dsem

Classify point clouds with pretrained 3D semantic segmentation models, on your own machine, from one command.

pip install 3dsem

sem install dales-utonia
sem infer dales-utonia tile.las

That's the whole workflow. The classified .laz appears next to your input file, with per-point classification, confidence, and every original dimension carried over.

What you need

  • An NVIDIA GPU with a current driver (Windows 527.41+, Linux 525.60.13+), or a Modal account for cloud runs with --modal
  • Python 3.9 or newer
  • About 10 GB of disk per model

sem install downloads a model together with its exact, tested runtime in one step. After install, inference runs fully offline.

Models

Model Trained on License
dales-utonia DALES aerial LiDAR (8 classes: ground, vegetation, buildings, cars, trucks, poles, powerlines, fences) CC-BY-NC 4.0 (non-commercial) — shown before install

Commands

sem                  interactive picker (choose a model, run it)
sem models           list available and installed models
sem install <model>  one-time model download
sem infer <model> <input> [output]
sem output [<dir> | off]   default output directory (unset: results land
                           next to the input)
sem clean [<model> | --all]

infer accepts a .las/.laz/.ply/.pcd file or a whole folder, and converts it automatically using the model's own training recipe. By default it does a fast single pass with light smoothing; the effort presets trade time for accuracy:

sem infer dales-utonia tile.las --ultra            max accuracy: 9-view TTA,
                                                   full cleanup (~9x time;
                                                   also --med, --high, --low)
sem infer dales-utonia tile.las --unclass 0.6      low-confidence points
                                                   become unclassified
sem infer dales-utonia tile.las --panoptic vehicle:5x2.5
                                                   split a class into
                                                   individual objects
sem infer dales-utonia tile.las --modal            run on Modal instead of
                                                   a local GPU
sem infer dales-utonia tile.las --pick             browse every option with
                                                   arrow keys, then run

Every option is documented in sem infer --help.

What the extras are

  • TTA & overlapped voting — the model predicts the scene from several augmented views and overlapping tiles, then votes; slower, more robust.
  • Cleanup passes — KNN probability smoothing (in the spirit of RangeNet++), small-island removal, and height/planarity rules for ground/vegetation/building confusions.
  • Height Above Ground — when a model uses it, ground is detected with CSF or SMRF and the channel is computed from your cloud automatically.
  • --panoptic — training-free instance clustering with ALPINE (paper): give a typical object footprint per class and get an instance_id per point.

Where things live

All downloads go to ~/.trainer (set TRAINER_HOME to move them); sem clean --all removes everything. Your data and results never go there — each job is one folder next to your input (or under your sem output dir): the staged+classified .npz, a job.json record, and the exported .laz.

Licensing

The sem tool is MIT licensed. Each model ships a NOTICE.md stating its architecture credits and license terms; some models carry a non-commercial restriction inherited from their pretrained components, shown before you install.

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 Distribution

If you're not sure about the file name format, learn more about wheel file names.

3dsem-0.1.7-py3-none-any.whl (24.5 kB view details)

Uploaded Python 3

File details

Details for the file 3dsem-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: 3dsem-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 24.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.12

File hashes

Hashes for 3dsem-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 6d5a455f0e55e2e4106e809bb60bdbccd3cc8e1660921f30d7a15648af5d97da
MD5 83a4fa51051418870fb0a8aa2a031226
BLAKE2b-256 985fcaefe4f03624133efb38c88adbbee31a7994187caf49eb485bd30ebc7074

See more details on using hashes here.

Supported by

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