Aero.Node Class

Namespace: Aero

Create node object for use with virtual reality animation

Description

Aero.Node creates a node object for use with virtual reality animation Aerospace Toolbox license.

The Aero.Node class is a handle class.

Creation

Description

h = Aero.Node creates a node object for use with virtual reality animation.

Properties

Name — Name of node object

character vector | string

Name of node object, specified as a character vector or string.

Attributes:

GetAccess	public
SetAccess	public

Data Types: char | string

VRNode — Handle of node object

MATLAB^® array

Handle of the vrnode (Simulink 3D Animation) object.

Attributes:

GetAccess	public
SetAccess	public

CoordtransformFcn — Function controlling coordinate transformation

MATLAB array

Handle of the vrnode (Simulink 3D Animation) object.

Attributes:

GetAccess	public
SetAccess	public

TimeSeriesSource — Variable that contains the time series data

array

Variable that contains the time series data, specified as a MATLAB array.

Attributes:

GetAccess	public
SetAccess	public

TimeSeriesSourceType — Type of time series data stored in 'TimeSeriesSource'

'Timeseries' (default) | 'Array6DoF' | 'Array3DoF' | 'StructureWithTime' | 'Timetable' | 'Custom'

Type of time series data stored in 'TimeSeriesSource', specified as one of 'Timeseries', 'Array6DoF', 'Array3DoF', 'StructureWithTime', 'Timetable', or 'Custom'.

• 'Timeseries' – MATLAB timeseries data with six values per time: lat lon alt phi theta psi

  The values are resampled.

• 'Timetable' – MATLAB timetable data with six values per time: lat lon alt phi theta psi

  The values are resampled.

• 'StructureWithTime' – Simulink^® struct with time:

  • signals(1).values: lat lon alt

  • signals(2).values: phi theta psi

• 'Timetable' – MATLAB timetable data with six values per time: lat lon alt phi theta psi

  The values are resampled.

• 'Array6DoF' – A double-precision array in n rows and 7 columns for 6-DoF data: time lat lon alt 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 lat alt theta. If a double-precision array of 5 or more columns is in 'TimeSeriesSource', the first 4 columns are used as 3-DoF data.

• 'Array3DoF' – A double-precision array in n rows and 4 columns for 3-DoF data: time lat alt 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'.

Attributes:

GetAccess	public
SetAccess	public

Data Types: string

TimeseriesReadFcn — Function to read time series data

function handle

Function to read time series data when 'TimeSeriesSourceType' value is 'Custom'.

Attributes:

GetAccess	public
SetAccess	public

Data Types: function_handle

Methods

Public Methods

findstartstoptimes	Return start and stop times of time series data
move	Change node position and orientation versus time data
update	Change node position and orientation versus time data

Algorithms

Typically, you do not need to create a node object with this method. This is because the .wrl file stores the information for a virtual reality scene. During the initialization of the virtual reality animation object, any node with a DEF statement in the specified .wrl file has a node object created.

When working with nodes, consider the translation and rotation. Translation is a 1-by-3 matrix in the aerospace body coordinate system defined for the Aero.VirtualRealityAnimation object or another coordinate system. In the latter case, you can use the CoordtransformFcn function to move it into the defined aerospace body coordinate system. The defined aerospace body coordinate system is defined relative to the screen as x-left, y-in, z-down.

Rotation is a 1-by-3 matrix, in radians, that specifies the rotations about the right-hand x-y-z coordinate axes. The order of application of the rotation is z-y-x (yaw, pitch, and roll (Y-P-R)). This function uses the CoordtransformFcn to apply the translation and rotation from the input coordinate system to the defined aerospace body coordinate system. The function then moves the translation and rotation from the defined aerospace body coordinate system to the defined VRML x-y-z coordinates for the Aero.VirtualRealityAnimation object. The defined VRML coordinate system is defined relative to the screen as x-right, y-up, z-out.

Version History

Introduced in R2007b