Create an imat_result object.
r=imat_result
r=imat_result(m,n,p,...)
r=imat_result(m,n,p,...,'Attr',value,...)
r=imat_result('Attr',value,...)
r=imat_result(m,n,p,...,v)
r=imat_result(v)
r=imat_result(imat_shp)
r=imat_result(imat_fn)
You call IMAT_RESULT to construct an imat_result object. A result object contains result data and attributes that define the data source and contents such as data location, result type, and data components.
Calling IMAT_RESULT with no arguments creates a scalar imat_result object.
If the first one or more arguments to IMAT_RESULT are integers, then an mxnxpx... result is created. Each element of this object is a single result. (Alternatively, the dimension of the result can be specified by a row vector of dimensions, as in imat_result([2 2]).) The output result will have the default attributes.
To override default attributes at time of object creation, you can specify one or more attribute names and values in the call to imat_result. This is equivalent to creating the object with default attributes, and then setting the specified attributes in sequential order.
Instead of a list of attribute names and values, you may supply a structure variable v with field names equal to attribute names, and field values set to the desired attribute values. (Such a structure can be obtained from the get function with multiple attribute requests.)
If the input is an imat_shp object, IMAT_RESULT creates an imat_result from the supplied imat_shp. It creates one result for each shape. Squared attribute types will be converted as linear, which may produce incorrect results if the units are changed.
If the input is an imat_fn object, IMAT_RESULT creates a result from the supplied imat_fn. It only converts functions with an abscissa data type of Time or Frequency that are not empty. It builds results based on function type, abscissa data type, ordinate numerator, then ordinate denominator data types. The abscissa values go into the Time or Frequency attributes of the result. If there are multiple groups of functions, F will be a cell array, each containing an imat_result object based on the function group.
>> r=imat_result(3,imat_result_dan,'resulttype','acceleration')
r =
3x1 IMAT_RESULT
Row Name DataLocation ModelType ResultType
--- ---- ------------- --------- ------------
1 Data At Nodes Unknown Acceleration
2 Data At Nodes Unknown Acceleration
3 Data At Nodes Unknown Acceleration
>>