# 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`.