filters.head

The HeadFilter returns a specified number of points from the beginning of the PointView.

Note

If the requested number of points exceeds the size of the point cloud, all points are passed with a warning.

Default Embedded Stage

This stage is enabled by default

Example #1

Thin a point cloud by first shuffling the point order with filters.randomize and then picking the first 10000 using the HeadFilter.

{
  "pipeline":[
    {
      "type":"filters.randomize"
    },
    {
      "type":"filters.head",
      "count":10000
    }
  ]
}

Example #2

Compute height above ground and extract the ten highest points.

{
  "pipeline":[
    {
      "type":"filters.smrf"
    },
    {
      "type":"filters.hag"
    },
    {
      "type":"filters.sort",
      "dimension":"HeightAboveGround",
      "order":"DESC"
    },
    {
      "type":"filters.head",
      "count":10
    }
  ]
}

See also

filters.tail is the dual to filters.head.

Options

count
Number of points to return. [Default: 10]