# filters.info

The Info filter provides simple information on a point set as metadata. It is usually invoked by the info command, rather than by user code. The data provided includes bounds, a count of points, dimension names, spatial reference, and points meeting a query criteria.

Default Embedded Stage

This stage is enabled by default

Streamable Stage

This stage supports streaming operations

    [
        "input.las",
        {
            "type":"filters.info",
            "point":"1-5"
        }
    ]

## Options

point

  A comma-separated list of single point IDs or ranges of points. For example “2-6, 10, 25” selects eight points from the input set. The first point has an ID of 0. The point option can’t be used with the query option. [Default: no points are selected.]

query

  A specification to retrieve points near a location. Syntax of the the query is X,Y[,Z][/count] where ‘X’, ‘Y’ and ‘Z’ are coordinate locations mapping to the X, Y and Z point dimension and ‘count’ is the number of points to return. If ‘count’ isn’t specified, the 10 points nearest to the location are returned. The query option can’t be used with the point option. [Default: no points are selected.]

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