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.sgThis 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.
Version 1.0.2 preserves empty comma-delimited cell positions, rejects invalid selected numeric cells and accepts empty fixed-width text. Quoted CSV and embedded separators/newlines are unsupported. See the matching Program manual for field widths and layout options.
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.
sgoutcsv preserves numeric precision and supports fixed-width text in fields mode. CSV exchange does not retain the full SOIG schema or sampling metadata; keep those definitions separately.
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