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"
},
{
"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"
},
{
"count":10
}
]
}