jakteristics

Point cloud geometric properties from python.

These details have not been verified by PyPI

Project links

Homepage

Development Status
- 2 - Pre-Alpha
Intended Audience
- Developers
License
- OSI Approved :: BSD License
Natural Language
- English
Programming Language

Project description

Documentation: https://jakteristics.readthedocs.io
Github: https://github.com/jakarto3d/jakteristics

Jakteristics is a python package to compute point cloud geometric features.

A geometric feature is a description of the geometric shape around a point based on its neighborhood. For example, a point located on a wall will have a high planarity.

The features used in this package are described in the paper Contour detection in unstructured 3D point clouds. They are computed based on the eigenvalues and eigenvectors:

Eigenvalue sum
Omnivariance
Eigenentropy
Anisotropy
Planarity
Linearity
PCA1
PCA2
Surface Variation
Sphericity
Verticality
Nx, Ny, Nz (The normal vector)

It’s inspired from a similar tool in CloudCompare.

It’s implemented in cython using the BLAS and LAPACK scipy wrappers. It can use multiple cpus, and the performance is quite good (at least twice as fast as CloudCompare).

Installation

python -m pip install jakteristics

Usage

Refer to the documentation for more details.

From python

from jakteristics import compute_features

features = compute_features(xyz, search_radius=0.15)

CLI

Once the package is installed, you can use the jakteristics command:

jakteristics input/las/file.las output/file.las --search-radius 0.15 --num-threads 4

Run tests

python -m pip install -r requirements-dev.txt
python setup.py pytest

History

0.4.0 (2020-04-16)

first pypi release
add github actions

0.3.0 (2020-04-14)

add feature-names parameter to compute specific features

0.2.0 (2020-04-10)

fix windows compilation with openmp
add example cloudcompare script
add num_threads cli parameter and help documentation
write extra dimensions in the correct order

0.1.2 (2020-04-10)

Fix tests

0.1.1 (2020-04-10)

Fix bug where single precision was used for intermediate variables

0.1.0 (2020-04-10)

First release

Project details

These details have not been verified by PyPI

Project links

Homepage

Development Status
- 2 - Pre-Alpha
Intended Audience
- Developers
License
- OSI Approved :: BSD License
Natural Language
- English
Programming Language

Release history Release notifications | RSS feed

0.6.2

Jul 22, 2024

0.6.0

Apr 20, 2023

0.5.1

Apr 11, 2023

0.5.0

Jan 26, 2022

0.4.3

Aug 24, 2020

0.4.2

Apr 20, 2020

0.4.1

Apr 17, 2020

This version

0.4.0

Apr 16, 2020

Download files

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

Source Distribution

jakteristics-0.4.0.tar.gz (504.0 kB view details)

Uploaded Apr 16, 2020 Source

Built Distributions

jakteristics-0.4.0-cp38-cp38-win_amd64.whl (664.1 kB view details)

Uploaded Apr 16, 2020 CPython 3.8 Windows x86-64

jakteristics-0.4.0-cp37-cp37m-win_amd64.whl (655.4 kB view details)

Uploaded Apr 16, 2020 CPython 3.7m Windows x86-64

jakteristics-0.4.0-cp36-cp36m-win_amd64.whl (655.3 kB view details)

Uploaded Apr 16, 2020 CPython 3.6m Windows x86-64

File details

Details for the file jakteristics-0.4.0.tar.gz.

File metadata

Download URL: jakteristics-0.4.0.tar.gz
Upload date: Apr 16, 2020
Size: 504.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.2

File hashes

Hashes for jakteristics-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`2ee7f4982632524d24f68ff6f04fc7530bc97cd8d50db0fee835f40fa16f2f4e`
MD5	`5fd7b9f78266b836e0a4f2bd482c57f4`
BLAKE2b-256	`feadcdb82d776ba3a750052a8bc5493def38704a6a4f7db3984f72e60022a619`

See more details on using hashes here.

File details

Details for the file jakteristics-0.4.0-cp38-cp38-win_amd64.whl.

File metadata

Download URL: jakteristics-0.4.0-cp38-cp38-win_amd64.whl
Upload date: Apr 16, 2020
Size: 664.1 kB
Tags: CPython 3.8, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.2

File hashes

Hashes for jakteristics-0.4.0-cp38-cp38-win_amd64.whl
Algorithm	Hash digest
SHA256	`9b8d31894a328dee6a4d25bbb0a63a627ce15ffe00aad71152213cae0ed9ef0b`
MD5	`86d698145491cbac71060d68fabd87d6`
BLAKE2b-256	`721cd995ff42942f48e10b597ea4e5ddca47ba1d55a7dce4e1fa87a09d3d693a`

See more details on using hashes here.

File details

Details for the file jakteristics-0.4.0-cp37-cp37m-win_amd64.whl.

File metadata

Download URL: jakteristics-0.4.0-cp37-cp37m-win_amd64.whl
Upload date: Apr 16, 2020
Size: 655.4 kB
Tags: CPython 3.7m, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6

File hashes

Hashes for jakteristics-0.4.0-cp37-cp37m-win_amd64.whl
Algorithm	Hash digest
SHA256	`cbda1b0d583ecfee2b8945cbf5d9d7d713e66cfec168454ac19f4e3cb8003801`
MD5	`7b1578af86dc2f6100c428c3489337f7`
BLAKE2b-256	`6f715aae9f563b58f682667f2fb15831a7396e70e803650e97133998b539b1e0`

See more details on using hashes here.

File details

Details for the file jakteristics-0.4.0-cp36-cp36m-win_amd64.whl.

File metadata

Download URL: jakteristics-0.4.0-cp36-cp36m-win_amd64.whl
Upload date: Apr 16, 2020
Size: 655.3 kB
Tags: CPython 3.6m, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.8

File hashes

Hashes for jakteristics-0.4.0-cp36-cp36m-win_amd64.whl
Algorithm	Hash digest
SHA256	`534981c5b3753231bd73dc87fc49bf9278bff4ff4df31876948528997645361a`
MD5	`e7670180f1cb0cb0c9bb1039af5fa973`
BLAKE2b-256	`3cac60cbf5a6f9a3196ff867d329827911cd3685de6e0a9b522d0252ef292c2a`