# writers.matlab

The Matlab Writer supports writing Matlab .mat files.

The produced files has a single variable, PDAL, an array struct.

Note

The Matlab writer requires the Mat-File API from MathWorks, and it must be explicitly enabled at compile time with the `BUILD_PLUGIN_MATLAB=ON` variable

Dynamic Plugin

This stage requires a dynamic plugin to operate

## Example

    [
        {
            "type":"readers.las",
            "filename":"inputfile.las"
        },
        {
            "type":"writers.matlab",
            "output_dims":"X,Y,Z,Intensity",
            "filename":"outputfile.mat"
        }
    ]

## Options

filename

  Output file name [Required]

output_dims

  A comma-separated list of dimensions to include in the output file. May also be specified as an array of strings. [Default: all available dimensions]

struct

  Array structure name to read [Default: “PDAL”]

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`]