writers.text¶

The text writer writes out to a text file. This is useful for debugging or getting smaller files into an easily parseable format. The text writer supports both GeoJSON and CSV output.

Default Embedded Stage

This stage is enabled by default

Streamable Stage

This stage supports streaming operations

Example¶

[
    {
        "type":"readers.las",
        "filename":"inputfile.las"
    },
    {
        "type":"writers.text",
        "format":"geojson",
        "order":"X,Y,Z",
        "keep_unspecified":"false",
        "filename":"outputfile.txt"
    }
]

Options¶

filename: File to write to, or “STDOUT” to write to standard out [Required]
format: Output format to use. One of geojson or csv. [Default: “csv”]
precision: Decimal Precision for output of values. This can be overridden for individual dimensions using the order option. [Default: 3]
order: Comma-separated list of dimension names in the desired output order. For example “X,Y,Z,Red,Green,Blue”. Dimension names can optionally be followed with a colon (‘:’) and an integer to indicate the precision to use for output. Ex: “X:3, Y:5,Z:0” If no precision is specified the value provided with the precision option is used. [Default: none]
keep_unspecified: If true, writes all dimensions. Dimensions specified with the order option precede those not specified. [Default: true]
jscallback: When producing GeoJSON, the callback allows you to wrap the data in a function, so the output can be evaluated in a <script> tag.
quote_header: When producing CSV, should the column header named by quoted? [Default: true]
write_header: Whether a header should be written. [Default: true]
newline: When producing CSV, what newline character should be used? (For Windows, \\r\\n is common.) [Default: “\n”]
delimiter: When producing CSV, what character to use as a delimiter? [Default: “,”]

where: An expression that limits points passed to a writer. Points that don’t pass the expression skip the stage but are available to subsequent stages in a pipeline. [Default: no filtering]
where_merge: A strategy for merging points skipped by a ‘where’ option when running in standard mode. If true, the skipped points are added to the first point view returned by the skipped filter. If false, skipped points are placed in their own point view. If auto, skipped points are merged into the returned point view provided that only one point view is returned and it has the same point count as it did when the writer was run. [Default: auto]