# 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`]