filters.straighten

Contents

filters.straighten#

The straighten filter transforms the point cloud in a new parametric coordinate system, each point in world coordinate (X,Y,Z) is being projected along closest poyline segment, and rotated along the segment accordingly to the average m/roll value.

Streamable Stage

This stage supports streaming operations

Note

The new coordinate system (X’, Y’, Z’) could be understood as : * X’ : curvilinear abcissa (or meter point) * Y’ : orthogonal distance to segment (or orthogonal distance to line) * Z’ : orthogonal distance from (rolling) plane

Examples#

[
    "input.las",
    {
        "type": "filters.straighten",
        "polyline" : "LINSTRING ZM (...)"
    },
    "straighten.las"
]
[
    "input.las",
    {
        "type": "filters.straighten",
        "polyline" : "LINSTRING ZM (...)"
    },
    "straighten.las"
]

Options#

polyline

wkt` or json` definition of a 3D linestring with measurment (LINESTRING ZM in wkt) along which the cloud will be straighten. M is supposed to be roll expressed in radians. This is mandatory.

offset

if you want to add an X’ during straightening operation (or take an offset into account while unstraightening). This can be understood as a starting meter point. [Default: 0]

reverse

whether to straighten or unstraighten the point cloud [Default: false]

where

An expression that limits points passed to a filter. Points that don’t pass the expression skip the stage but are available to subsequent stages in a pipeline. [Default: no filtering]

where_merge

A strategy for merging points skipped by a where option when running in standard mode. If true, the skipped points are added to the first point view returned by the skipped filter. If false, skipped points are placed in their own point view. If auto, skipped points are merged into the returned point view provided that only one point view is returned and it has the same point count as it did when the filter was run. [Default: auto]