HELP
An object that creates a record from separate
components

USE
Use Build Record to create a record from
scalar or array components.  The input data
components become fields in the output
record.  The output record can be either a
scalar or a one-dimensional array.

LOCATION
Data ==> Build Data ==> Record

OPEN VIEW PARAMETERS
* Output Shape -- You can set the shape of
the output record to either Scalar or Array
1D.

NOTES
The fields in the record are named from the
names of the corresponding input terminals.
The field names are not case sensitive
(lowercase and uppercase letters are
equivalent).  Field names may not be
duplicated within a single record.
Additional data inputs may be added to create
a record with any number of fields.  Records
of records are allowed (where a field in a
record is itself a record).  There is no
limit on recursion (except for the available
memory).

If all inputs are scalar quantities, the
record on the Record output pin will be a
scalar record consisting of one field for
each input, regardless of the specified
Output Shape.

If one or more of the inputs are array,
the shape of the resulting record depends on
the specified Output Shape:
* If Scalar is specified as the Output Shape,
the output record will be a scalar that
consists of one field for each input.  Each
field will be either a scalar or an array,
the same shape as the corresponding input.
* If Array 1D is specified as the Output
Shape, the output record will be a
one-dimensional array of records with fields
for each input.  If an input is a scalar or
one-dimensional array, the corresponding
field in the record will be a scalar.  If an
input is an n-dimensional array, the
corresponding field will be an array of n-1
dimensions.  If more than one of the inputs
are arrays, they must all have the same size
and shape.  Let's look at some examples:
* If input A is a one-dimensional array 10
elements long and input B is a scalar, the
output will be a one-dimensional record array
of 10 elements with two fields, A and B.  The
individual elements of the A input array will
appear in the individual array elements of
field A in the output record.  Input B will
be duplicated 10 times in the B field of the
output record.
* If an input is an array of two or more
dimensions, the output record will still be
an Array 1D.  For example, if an input field
is a two-dimensional array, 10-by-3 in size,
the output record is a one-dimensional array
with a length of 10, but with a field which
is a one-dimensional array of 3 elements.

SEE ALSO
From DataSet, Get Field, Merge Record, Record
Constant, Set Field, SubRecord, To DataSet,
and UnBuild Record.
