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