Create body object for use with animation object
h = Aero.Body
h = Aero.Body
constructs a body for an
animation object. The animation object is returned in h
.
To use the Aero.Body object, you typically:
Create the animation body.
Configure or customize the body object.
Load the body.
Generate patches for the body (requires an axes from a figure).
Set time series data source.
Move or update the body.
By default, an Aero.Body object natively uses aircraft x-y-z
coordinates
for the body geometry and the time series data. It expects the rotation
order z-y-x
(psi, theta, phi).
Convert time series data from other coordinate systems on the
fly by registering a different CoordTransformFcn
function.
Constructor | Description |
---|---|
Body | Construct body object for use with animation object. |
Method | Description |
---|---|
findstartstoptimes | Return start and stop times of time series data. |
generatePatches | Generate patches for body with loaded face, vertex, and color data. |
load | Get geometry data from source. |
move | Change Aero.Body position and orientation. |
update | Changes body position and orientation versus time data. |
Property | Description | Values |
---|---|---|
CoordTransformFcn | Specify a function that controls the coordinate transformation. | Character vector | string |
Name | Specify name of body. | |
Position | Specify position of body. | MATLAB array |
Rotation | Specify rotation of body. | MATLAB array |
Geometry | Specify geometry of body. | handle |
PatchGenerationFcn | Specify patch generation function. | MATLAB array |
PatchHandles | Specify patch handles. | MATLAB array |
ViewingTransform | Specify viewing transform. | MATLAB array |
TimeseriesSource | Specify time series source. | MATLAB array |
TimeseriesSourceType | Specify the type of time series data stored in 'TimeseriesSource' . Five
values are available. They are listed in TimeseriesSourceType Properties. The default value is
'Array6DoF' . | Character vector | string |
TimeseriesReadFcn | Specify time series read function. | MATLAB array |
The time series data, stored in the property 'TimeseriesSource'
,
is interpreted according to the 'TimeseriesSourceType'
property,
which can be one of:
TimeseriesSourceType Properties
Property | Description |
---|---|
'Timeseries' | MATLAB time series data with six values per time:
The values are resampled. |
'StructureWithTime' |
Simulink struct with time (for example, Simulink root outport logging
Signals are linearly interpolated vs. time using |
'Array6DoF' | A double-precision array in n rows and 7 columns for 6-DoF data:
time x y z phi theta psi . If a double-precision array of 8 or more
columns is in 'TimeseriesSource' , the first 7 columns are used as 6-DoF
data. |
'Array3DoF' | A double-precision array in n rows and 4 columns for 3-DoF data:
time x z theta . If a double-precision array of 5 or more columns is in
'TimeseriesSource' , the first 4 columns are used as 3-DoF data. |
'Custom' | Position and angle data is retrieved from 'TimeseriesSource' by the
currently registered 'TimeseriesReadFcn' . |