Overview
Connect instruments and external software
sigclear-io provides general-purpose table, binary-record and MATLAB adapters. Decide whether each external row represents one record or whether sampled values belong in vector fields, then check the resulting SOIG schema before processing.
Quick example
Import selected CSV columns
sgloadcsv mode=fields in.select=pressure,altitude \
pressure.fmt=double altitude.fmt=double \
<measurements.csv >measurements.sg
This example assumes a header with pressure and altitude columns and ordinary numeric rows. Fields mode produces named scalar fields, one SOIG column per table row. Use sgattribute to inspect the output and man sgloadcsv to check the installed interface.
The importer uses comma/whitespace tokenization, not full quoted CSV parsing. Empty cells, embedded separators and multiword text require preprocessing or validation; conversion alone does not establish a missing-value policy.
Programs
Choose a Program
| Program | Function | Input/output and design distinction |
|---|---|---|
sgloadcsv | Import delimited tables | Table to SOIG scalar fields or vectors; limited comma/whitespace tokenization, not full quoted CSV. |
sgoutcsv | Export selected fields or vectors | SOIG to text; choose the row/vector layout and field names explicitly. |
sgloadbin | Import fixed-size binary records | Binary to SOIG; specify record size, field offsets, sample formats and byte order. |
sgloadmat | Import MATLAB variables | MAT-file to SOIG; variable paths and optional transposition determine field layout. |
sgoutmat | Export groups as MATLAB structures | SOIG to MAT-file; verify field shapes in the receiving application. |
Available converters depend on your installed package version. Select the matching version to consult its Program manuals.
Libraries and APIs
Build specialized converters
The Package installs libio and libiomat with their public interfaces in io.h and iomat.h. libio provides byte-order and IBM/IEEE conversion helpers.
Use the libraries for specialized converters, and verify dimensions, precision, byte order and sample spacing against the producer's format. Retain original files and test a small round trip before processing a complete dataset.
Examples