GROUP

From ICE Enterprises
Jump to navigation Jump to search

Combines two or more inputs into a type-3000 file

<out>   Type 3000/5000 output file
<P1-PN> Input files, type 1000, 2000, 3000 or 5000

This primitive interleaves data from two or more input files and creates a type
3000/5000 file output.  The entries are interleaved as single numbers or ASCII
values for type 1000 inputs, frames for type 2000, and records from type
3000/5000.

Type 3000/5000 subrecord names are preserved as long as they don't conflict.
Names for type 1000 and 2000 are SRxx where xx is the output subrecord number.
They can be changed with HEADERMOD, if desired.

See the SPLIT command to break type-3000/5000 files back apart.

Examples:
  1. Create a Type 3000 file from two Type 1000 files
    nM> wave ram:file1 form="SF" elem=1000 shape=sin amp=1000
    nM> wave ram:file2 form="SF" elem=1000 shape=ramp amp=1000
    nM> group ram:file3 ram:file1 ram:file2   

Switches:
  /TL - The number of elements to be read each process loop.
        Default is computed as 16384/bytes-per-element
  /WARN - Warn of record name conflicts [DEFAULT=TRUE]

See Also: SPLIT, MERGEFILE, MUX, DEMUX