Skip to main content

Extract geometry features from 3D point clouds

Project description

Extract geometry features from 3D point clouds

Content

The project contains the following folders:

  • geo3dfeatures contains source code
  • docs contains some mardown files for documentation purpose and images
  • examples contains some Jupyter notebooks for describing data
  • tests; pytest is used to launch several tests from this folder

Additionally, running the code may generate extra subdirectories in a chosen data repository (./data, by default).

How to install

This projects runs with Python3, every dependencies are managed through poetry.

Installation from source

$ git clone ssh://git@git.oslandia.net:10022/Oslandia-data/geo3dfeatures.git
$ cd geo3dfeatures
$ virtualenv -p /usr/bin/python3 venv
$ source venv/bin/activate
(venv)$ poetry install

Contribution

See CONTRIBUTING.md.

Run commands

In order to get the available program commands, consider the program help (geo3d -h):

usage: geo3d [-h] {info,sample,index,featurize,cluster,train,predict} ...

Geo3dfeatures framework for 3D semantic analysis

positional arguments:
  {info,sample,index,featurize,cluster,train,predict}
    info                Describe an input .las file
    sample              Extract a sample of a .las file
    index               Index a point cloud file and serialize it
    featurize           Extract the geometric feature associated to 3D points
    cluster             Cluster a set of 3D points with a k-means algorithm
    train               Train a semantic segmentation model
    predict             Predict 3D point semantic class starting from a
                        trained model

optional arguments:
  -h, --help            show this help message and exit

Any further CLI documentation may be printed with geo3d <command> -h.

Documentation

Some documentation is available, that describes the set of considered geometric features, the fixtures (i.e. dummy datasets) used for test purpose and a practical pipeline use case:

Examples

The following example has been generated starting from a CANUPO dataset (file scene.xyz, with 500k points, 50 neighbors and all the features):

scene


Oslandia – 2019-2020

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

geo3dfeatures-0.4.0.post2.tar.gz (26.3 kB view details)

Uploaded Source

Built Distribution

geo3dfeatures-0.4.0.post2-py3-none-any.whl (88.7 kB view details)

Uploaded Python 3

File details

Details for the file geo3dfeatures-0.4.0.post2.tar.gz.

File metadata

  • Download URL: geo3dfeatures-0.4.0.post2.tar.gz
  • Upload date:
  • Size: 26.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.5 CPython/3.7.4 Linux/4.19.0-5-amd64

File hashes

Hashes for geo3dfeatures-0.4.0.post2.tar.gz
Algorithm Hash digest
SHA256 53dd4ce2f93d075611efb73b92f38f3b02453108048cf0af4b92cdb92dfc8c0c
MD5 3d0319577d66b996a4ed972843cc8c0f
BLAKE2b-256 c3a9bcd79dfa680019c28001784b0db1e820411865b20dda5d84b941cadb43d5

See more details on using hashes here.

File details

Details for the file geo3dfeatures-0.4.0.post2-py3-none-any.whl.

File metadata

File hashes

Hashes for geo3dfeatures-0.4.0.post2-py3-none-any.whl
Algorithm Hash digest
SHA256 cc849d30362955ad3fd164ce6b049c594db298093ff223603b9b5701dd68943f
MD5 3d2db0750ec5f1c8c6d40bc759f02104
BLAKE2b-256 327ace7d656b3f37ff707858e8b1df9fb76c57e0e0fc5309c43a0e70ee15232a

See more details on using hashes here.

Supported by

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