filters.divider

The divider filter breaks a point view into a set of smaller point views based on simple criteria. The number of subsets can be specified explicitly, or one can specify a maximum point count for each subset. Additionally, points can be placed into each subset sequentially (as they appear in the input) or in round-robin fashion.

Normally points are divided into subsets to facilitate output by writers that support creating multiple output files with a template (LAS and BPF are notable examples).

Default Embedded Stage

This stage is enabled by default

Example

This pipeline will create 10 output files from the input file readers.las.

{
  "pipeline":[
    "example.las",
    {
      "type":"filters.divider",
      "count":"10"
    },
    {
      "type":"writers.las",
      "filename":"out_#.las"
    }
  ]
}

Options

mode
A mode of ‘partition’ will write sequential points to an output view until the view meets its predetermined size. ‘round_robin’ mode will iterate through the output views as it writes sequential points. [Default: ‘partition’]
count
Number of output views. [Default: none]
capacity
Maximum number of points in each output view. Views will contain approximately equal numbers of points. [Default: none]

Warning

You must specify exactly one of either count or capacity.