geo3d.core.functional

Attributes

PDAL_MAX_POINTS

Functions

reader_las(→ altametris.geo3d.core.base.Reader)

Create a LAS reader object.

class_ranger(→ altametris.geo3d.core.base.Filter)

Create a filters range object based on Classification.

cluster(→ altametris.geo3d.core.base.Filter)

Create a filter cluster object.

groupby(→ altametris.geo3d.core.base.Filter)

Create a filter to groupby the point cloud thanks a specific dimension.

unclassifier(→ altametris.geo3d.core.base.Filter)

Create a filter assign with value of Classification = 0 if condition.

merger(→ altametris.geo3d.core.base.Filter)

Create a filter merge.

stats(→ altametris.geo3d.core.base.Filter)

Create a filter stats.

info(→ altametris.geo3d.core.base.Filter)

Create a filter info.

expression(→ altametris.geo3d.core.base.Filter)

Create an expression filter.

crop(→ altametris.geo3d.core.base.Filter)

Create a crip filter.

nndistance(→ altametris.geo3d.core.base.Filter)

Create an NNdistance filter object.

outlier(→ altametris.geo3d.core.base.Filter)

Create an Outlier filter object.

writer_las(→ altametris.geo3d.core.base.Writer)

Create a LAS writer object. Defaults to writing LAS 1.4 with point data record format 6.

Module Contents

geo3d.core.functional.PDAL_MAX_POINTS = 18446744073709551615
geo3d.core.functional.reader_las(filename: str, count: int = PDAL_MAX_POINTS, override_srs: str = 'EPSG:2154', nosrs: bool = True) → altametris.geo3d.core.base.Reader

Create a LAS reader object.

Parameters:

  • filename (str) – path to the las file.

  • count (int) – Maximum number of points to read. Defaults to ‘unlimited’ PDAL_MAX_POINTS.

  • override_srs (str) – Spatial reference to apply to the data. Defaults to ‘EPSG:2154’.

  • nosrs (bool) – Don’t read the SRS VLRs. Defaults to true

Returns:

pipeline.Reader object.

geo3d.core.functional.class_ranger(label1: int, label2: int, inv: bool = False) → altametris.geo3d.core.base.Filter

Create a filters range object based on Classification.

Parameters:

  • label1 (int) – Left range boundary.

  • label2 (int) – Right range boundary.

  • inv (bool) – inverse. Give the complementary space instead.

Returns:

pipeline.Filter object.

geo3d.core.functional.cluster(min_points: int = 100, tolerance: float = 1) → altametris.geo3d.core.base.Filter

Create a filter cluster object.

Parameters:

  • min_points (int) – minimum points per cluster. Defaults to 100.

  • tolerance (float) – maximum distance to a cluster. Defaults to 1.

Returns:

pipeline.Filter object.

geo3d.core.functional.groupby(dimension: str = 'ClusterID') → altametris.geo3d.core.base.Filter

Create a filter to groupby the point cloud thanks a specific dimension.

Parameters:

dimension (str) – Category which will be used to split the pc

Returns:

pipeline.Filter object.

geo3d.core.functional.unclassifier(condition: str) → altametris.geo3d.core.base.Filter

Create a filter assign with value of Classification = 0 if condition.

Parameters:

condition (str) – Expression of the condition. “ClusterID == 0” for example.

Returns:

pipeline.Filter object.

geo3d.core.functional.merger() → altametris.geo3d.core.base.Filter

Create a filter merge.

Returns:

pipeline.Filter object.

geo3d.core.functional.stats(dimensions: str = 'X,Y,Z', enumerate: str = 'Classification', count: str = 'Classification') → altametris.geo3d.core.base.Filter

Create a filter stats.

Parameters:

  • dimensions – The dimensions on whose to compute the stats. Defaults to 3D coordinates.

  • enumerate (str) – The dimensions whose values should be enumerated.

  • count (str) – Provide the count of the number of points of each enumerated category.

Returns:

pipeline.Filter object.

geo3d.core.functional.info() → altametris.geo3d.core.base.Filter

Create a filter info.

Returns:

pipeline.Filter object.

geo3d.core.functional.expression(condition: str) → altametris.geo3d.core.base.Filter

Create an expression filter.

Parameters:

condition – An expression that limits points passed to a filter. “Classification == 0”, for example.

Returns:

pipeline.Filter object.

geo3d.core.functional.crop(bounds: str) → altametris.geo3d.core.base.Filter

Create a crip filter.

Parameters:

bounds – The clipping rectangle in the format ‘([xmin, xmax], [ymin, ymax], [zmin, zmax])’.

Returns:

pipeline.Filter object

geo3d.core.functional.nndistance(mode: str = 'avg', k: int = 10) → altametris.geo3d.core.base.Filter

Create an NNdistance filter object.

Parameters:

  • mode (str) – The mode of operation. ‘kth’ to compute the distance from the kth remote point or ‘avg’ to compute the average Euclidean distance from the k nearest neighbors. Defaults to ‘avg’.

  • k (int) – The number of nearest neighbors. Defaults to 10.

Returns:

pipeline.Filter object.

geo3d.core.functional.outlier(classification: int = 7, method: str = 'statistical', min_k: int = 2, radius: float = 1.0, mean_k: int = 10, multiplier: float = 3) → altametris.geo3d.core.base.Filter

Create an Outlier filter object.

Parameters:

  • classification (int) – The class value to assign to outliers. Defaults to 7.

  • method (str) – The outlier removal method. ‘statistical’ or ‘radius’. Defaults to ‘statistical’.

  • min_k (int) – Minimum number of neighbors in radius. Applicable to radius method only. Defaults to 2.

  • radius (float) – The value of radius of the ball of neighbors. Defaults to 1.0.

  • mean_k (int) – The number of k nearest neighbors. Applicable to statistical method only. Defaults to 10.

  • multiplier (float) – The multiplier to use in computing the threshold. Defaults to 3.

Returns:

pipeline.Filter object.

geo3d.core.functional.writer_las(filename: str, minor_version: int = 4, dataformat_id: int = 6) → altametris.geo3d.core.base.Writer

Create a LAS writer object. Defaults to writing LAS 1.4 with point data record format 6.

Parameters:

  • filename (str) – path to the las file.

  • minor_version (int) – minor version of the LAS file (0 - 4). Defaults to 4.

  • dataformat_id (int) – Point data record format (0 - 11). Defaults to 6.

Returns:

pipeline.Writer object.