1.. _filters.decimation:
2
3filters.decimation
4==================
5
6The **decimation filter** retains every Nth point from an input point view.
7
8.. embed::
9
10.. streamable::
11
12Example
13-------
14
15.. code-block:: json
16
17  [
18      {
19          "type": "readers.las",
20          "filename": "larger.las"
21      },
22      {
23          "type":"filters.decimation",
24          "step": 10
25      },
26      {
27          "type":"writers.las",
28          "filename":"smaller.las"
29      }
30  ]
31
32.. seealso::
33
34    :ref:`filters.voxelgrid` provides grid-style point decimation.
35
36Options
37-------
38
39step
40  Number of points to skip between each sample point.  A step of 1 will skip
41  no points.  A step of 2 will skip every other point.  A step of 100 will
42  reduce the input by ~99%. [Default: 1]
43
44offset
45  Point index to start sampling.  Point indexes start at 0.  [Default: 0]
46
47limit
48  Point index at which sampling should stop (exclusive).  [Default: No limit]
49
50.. include:: filter_opts.rst
51
52