filters.locate

Contents

filters.locate#

The Locate filter searches the specified [dimension] for the minimum or maximum value and returns a single point at this location. If multiple points share the min/max value, the first will be returned. All dimensions of the input PointView will be output, subject to any overriding writer options.

Default Embedded Stage

This stage is enabled by default

Example#

This example returns the point at the highest elevation.

[
    "input.las",
    {
        "type":"filters.locate",
        "dimension":"Z",
        "minmax":"max"
    },
    "output.las"
]

Options#

dimension

Name of the dimension in which to search for min/max value.

minmax

Whether to return the minimum or maximum value in the dimension.

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]

Contents