{
    "command": "sgloadmat",
    "description": "Read named MATLAB variables, including nested structure or cell paths, and\nmap them to output fields. Choose field mappings to control which variables\nare imported and how their dimensions are represented in the dataset.",
    "examples": [
        {
            "command": "sgloadmat -dump=n field='cell[0][0].struct.structfield' <input.mat >output.sg",
            "expected": "The input MAT-file must contain the specified path; quote brackets for the shell.\nMatrix rows become vector samples and columns become SOIG columns.",
            "title": "Import a MATLAB variable nested in a cell and structure"
        },
        {
            "command": "sgloadmat -dump=n field=variable.T <input.mat >transposed.sg",
            "expected": "The input MAT-file must contain variable. The .T suffix transposes its layout\nbefore rows become vector samples and columns become SOIG columns.\nInspect output dimensions and values; these examples require suitable MAT-files.",
            "title": "Transpose a MATLAB matrix before importing it"
        }
    ],
    "input_description": "input MATLAB file; map a MATLAB variable to an output field as follows:\n\tfield=matlab.variable",
    "notes": [],
    "output_description": "output SIGCLEAR dataset:\n1. MATLAB matrix rows become vector samples\n2. MATLAB matrix columns become SIGCLEAR dataset columns",
    "package": "sigclear-io",
    "parameters": [
        {
            "choices": [],
            "default": "stdin",
            "default_known": false,
            "description": "input MATLAB file; map a MATLAB variable to an output field as follows:\n\tfield=matlab.variable",
            "name": "in",
            "required": false,
            "type": "ifile",
            "units": null
        },
        {
            "choices": [],
            "default": "STDOUT",
            "default_known": false,
            "description": "list the MATLAB variable hierarchy instead of creating a dataset; defaults to true on a terminal",
            "name": "-dump",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": "stdout",
            "default_known": false,
            "description": "output SIGCLEAR dataset:\n1. MATLAB matrix rows become vector samples\n2. MATLAB matrix columns become SIGCLEAR dataset columns",
            "name": "out",
            "required": false,
            "type": "ofile",
            "units": null
        }
    ],
    "related": [],
    "schema_version": 1,
    "summary": "import MATLAB data into a SIGCLEAR dataset",
    "synopsis": "sgloadmat <stdin -dump=STDOUT >stdout",
    "version": "1.0.2"
}