Simulation 3D General Aviation Pack

Generate translation and rotation information for general aviation aircraft

Since R2023b

• 

Libraries:
Aerospace Blockset / Animation / Simulation 3D

Description

The Simulation 3D General Aviation Pack block creates translation and rotation information for the Simulation 3D Aircraft block with Type set to General aviation. Use the Simulation 3D General Aviation Pack block to provide translation and rotation information to the Translation and Rotation input ports of the Simulation 3D Aircraft block.

Ports

Input

Body_T — Body translation

1-by-3 matrix

Body translation, specified as a 1-by-3 matrix.

Data Types: single | double

Engine1_T — Engine translation

1-by-3 matrix

Engine translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Engine translation parameter.

Data Types: single | double

Rudder_T — Rudder translation

1-by-3 matrix

Rudder translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Rudder translation parameter.

Data Types: single | double

Elevator_T — Elevator translation

1-by-3 matrix

Elevator translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Elevator translation parameter.

Data Types: single | double

Left_Aileron_T — Left aileron translation

1-by-3 matrix

Left aileron translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left aileron translation parameter.

Data Types: single | double

Right_Aileron_T — Right aileron translation

1-by-3 matrix

Right aileron translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right aileron translation parameter.

Data Types: single | double

Flaps_T — Flaps translation

1-by-3 matrix

Flaps translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Flaps translation parameter.

Data Types: single | double

Left_Spoiler_T — Left spoiler translation

1-by-3 matrix

Left spoiler translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left spoiler translation parameter.

Data Types: single | double

Right_Spoiler_T — Right spoiler translation

1-by-3 matrix

Right spoiler translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right spoiler translation parameter.

Data Types: single | double

Nose_Gear_T — Nose gear translation

1-by-3 matrix

Nose gear translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Nose gear translation parameter.

Data Types: single | double

Nose_Wheel_T — Nose wheel translation

1-by-3 matrix

Nose wheel translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Nose wheel translation parameter.

Data Types: single | double

Left_Gear_T — Left gear translation

1-by-3 matrix

Left gear translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left gear translation parameter.

Data Types: single | double

Left_Wheel_T — Left wheel translation

1-by-3 matrix

Left wheel translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left wheel translation parameter.

Data Types: single | double

Right_Gear_T — Right gear translation

1-by-3 matrix

Right gear translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right gear translation parameter.

Data Types: single | double

Right_Wheel_T — Right wheel translation

1-by-3 matrix

Right wheel translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right wheel translation parameter.

Data Types: single | double

Body_R — Body rotation

1-by-3 matrix

Body rotation, specified as a 1-by-3 matrix.

Data Types: single | double

Engine1_R — Engine rotation

1-by-3 matrix

Engine rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Engine rotation parameter.

Data Types: single | double

Rudder_R — Rudder rotation

1-by-3 matrix

Rudder rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Rudder rotation parameter.

Data Types: single | double

Elevator_R — Elevator rotation

1-by-3 matrix

Elevator rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Elevator rotation parameter.

Data Types: single | double

Left_Aileron_R — Left aileron rotation

1-by-3 matrix

Left aileron rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left aileron rotation parameter.

Data Types: single | double

Right_Aileron_R — Right aileron rotation

1-by-3 matrix

Right aileron rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right aileron rotation parameter.

Data Types: single | double

Flaps_R — Flaps rotation

1-by-3 matrix

Flaps rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Flaps rotation parameter.

Data Types: single | double

Left_Spoiler_R — Left spoiler rotation

1-by-3 matrix

Left spoiler rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left spoiler rotation parameter.

Data Types: single | double

Right_Spoiler_R — Right spoiler rotation

1-by-3 matrix

Right spoiler rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right spoiler rotation parameter.

Data Types: single | double

Nose_Gear_R — Nose gear rotation

1-by-3 matrix

Nose gear rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Nose gear rotation parameter.

Data Types: single | double

Nose_Wheel_R — Nose wheel rotation

1-by-3 matrix

Nose wheel rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Nose wheel rotation parameter.

Data Types: single | double

Left_Gear_R — Left gear rotation

1-by-3 matrix

Left gear rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left gear rotation parameter.

Data Types: single | double

Left_Wheel_R — Left wheel rotation

1-by-3 matrix

Left wheel rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Left wheel rotation parameter.

Data Types: single | double

Right_Gear_R — Right gear rotation

1-by-3 matrix

Right gear rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right gear rotation parameter.

Data Types: single | double

Right_Wheel_R — Right wheel rotation

1-by-3 matrix

Right wheel rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Right wheel rotation parameter.

Data Types: single | double

Output

Translation — Aircraft translation

15-by-3 array

Aircraft translation for General Aviation aircraft, returned as a 15-by-3 array. The signal contains translation [X, Y, Z], in meters, with one row of the array for each bone of the aircraft.

The translation applies to these bones of the General Aviation type.

Bone	Index
BODY	1
ENGINE1	2
RUDDER	3
ELEVATOR	4
LEFT_AILERON	5
RIGHT_AILERON	6
FLAPS	7
LEFT_SPOILER	8
RIGHT_SPOILER	9
NOSE_GEAR	10
NOSE_WHEEL	11
LEFT_GEAR	12
LEFT_WHEEL	13
RIGHT_GEAR	14
RIGHT_WHEEL	15

Rotation — Aircraft rotation

15-by-3 array

Aircraft rotation for General Aviation aircraft, returned as an 15-by-3 array:

The rotation applies to the same bones as listed for the Translation port.

The signal contains the rotation [roll, pitch, yaw], in radians, with one row of the array for each bone of the aircraft.

Parameters

Propulsion

Engine translation — Option to enable Engine1_T input port

off (default) | on

Select this parameter to enable the Engine1_T input port.

Programmatic Use

Block Parameter: Engine1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Engine rotation — Option to enable Engine1_R input port

off (default) | on

Select this parameter to enable the Engine1_R input port.

Programmatic Use

Block Parameter: Engine1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Controls

Rudder translation — Option to enable Rudder_T input port

off (default) | on

Select this parameter to enable the Rudder_T input port.

Programmatic Use

Block Parameter: Rudder_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Elevator translation — Option to enable Elevator_T input port

off (default) | on

Select this parameter to enable the Elevator_T input port.

Programmatic Use

Block Parameter: Elevator_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left aileron translation — Option to enable Left_Aileron_T input port

off (default) | on

Select this parameter to enable the Left_Aileron_T input port.

Programmatic Use

Block Parameter: Left_Aileron_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right aileron translation — Option to enable Right_Aileron_T input port

off (default) | on

Select this parameter to enable the Right_Aileron_T input port.

Programmatic Use

Block Parameter: Right_Aileron_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Flaps translation — Option to enable Flaps_T input port

off (default) | on

Select this parameter to enable the Flaps_T input port.

Programmatic Use

Block Parameter: Flaps_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left spoiler translation — Option to enable Left_Spoiler_T input port

off (default) | on

Select this parameter to enable the Left_Spoiler_T input port.

Programmatic Use

Block Parameter: Left_Spoiler_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right spoiler translation — Option to enable Right_Spoiler_T input port

off (default) | on

Select this parameter to enable the Right_Spoiler_T input port.

Programmatic Use

Block Parameter: Right_Spoiler_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Rudder rotation — Option to enable Rudder_R input port

off (default) | on

Select this parameter to enable the Rudder_R input port.

Programmatic Use

Block Parameter: Rudder_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Elevator rotation — Option to enable Elevator_R input port

off (default) | on

Select this parameter to enable the Elevator_R input port.

Programmatic Use

Block Parameter: Elevator_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left aileron rotation — Option to enable Left_Aileron_R input port

off (default) | on

Select this parameter to enable the Left_Aileron_R input port.

Programmatic Use

Block Parameter: Left_Aileron_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right aileron rotation — Option to enable Right_Aileron_R input port

off (default) | on

Select this parameter to enable the Right_Aileron_R input port.

Programmatic Use

Block Parameter: Right_Aileron_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Flaps rotation — Option to enable Flaps_R input port

off (default) | on

Select this parameter to enable the Flaps_R input port.

Programmatic Use

Block Parameter: Flaps_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left spoiler rotation — Option to enable Left_Spoiler_R input port

off (default) | on

Select this parameter to enable the Left_Spoiler_R input port.

Programmatic Use

Block Parameter: Left_Spoiler_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right spoiler rotation — Option to enable Right_Spoiler_R input port

off (default) | on

Select this parameter to enable the Right_Spoiler_R input port.

Programmatic Use

Block Parameter: Right_Spoiler_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Gear

Nose gear translation — Option to enable Nose_Gear_T input port

off (default) | on

Select this parameter to enable the Nose_Gear_T input port.

Programmatic Use

Block Parameter: Nose_Gear_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Nose wheel translation — Option to enable Nose_Wheel_T input port

off (default) | on

Select this parameter to enable the Nose_Wheel_T input port.

Programmatic Use

Block Parameter: Nose_Wheel_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left gear translation — Option to enable Left_Gear_T input port

off (default) | on

Select this parameter to enable the Left_Gear_T input port.

Programmatic Use

Block Parameter: Left_Gear_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left wheel translation — Option to enable Left_Wheel_T input port

off (default) | on

Select this parameter to enable the Left_Wheel_T input port.

Programmatic Use

Block Parameter: Left_Wheel_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right gear translation — Option to enable Right_Gear_T input port

off (default) | on

Select this parameter to enable the Right_Gear_T input port.

Programmatic Use

Block Parameter: Right_Gear_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right wheel translation — Option to enable Right_Wheel_T input port

off (default) | on

Select this parameter to enable the Right_Wheel_T input port.

Programmatic Use

Block Parameter: Right_Wheel_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Nose gear rotation — Option to enable Nose_Gear_R input port

off (default) | on

Select this parameter to enable the Nose_Gear_R input port.

Programmatic Use

Block Parameter: Nose_Gear_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Nose wheel rotation — Option to enable Nose_Wheel_R input port

off (default) | on

Select this parameter to enable the Nose_Wheel_R input port.

Programmatic Use

Block Parameter: Nose_Wheel_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left gear rotation — Option to enable Left_Gear_R input port

off (default) | on

Select this parameter to enable the Left_Gear_R input port.

Programmatic Use

Block Parameter: Left_Gear_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left wheel rotation — Option to enable Left_Wheel_R input port

off (default) | on

Select this parameter to enable the Left_Wheel_R input port.

Programmatic Use

Block Parameter: Left_Wheel_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right gear rotation — Option to enable Right_Gear_R input port

off (default) | on

Select this parameter to enable the Right_Gear_R input port.

Programmatic Use

Block Parameter: Right_Gear_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right wheel rotation — Option to enable Right_Wheel_R input port

off (default) | on

Select this parameter to enable the Right_Wheel_R input port.

Programmatic Use

Block Parameter: Right_Wheel_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Input

Select input coordinate frame — Input coordinate frame

NED (default) | Fixed-frame | ICRF

Select the input coordinate frame to position aerospace vehicles with respect to north-east-down (NED), fixed-frame (Fixed-frame), or International Celestial Reference Frame (ICRF).

If the model contains an associated Simulation 3D Scene Configuration block, Simulation 3D General Aviation Pack block uses the coordinate frame of the Simulation 3D Scene Configuration. In this case, the Select input coordinate frame might be disabled. For more information about the Simulation 3D General Aviation Pack block coordinate frame, see Algorithms.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	GeoRadioButton
Values:	'NED' (default) | 'Fixed-frame' | 'ICRF'

Algorithms

If a model contains a Simulation 3D General Aviation Pack block and an associated Simulation 3D Scene Configuration block, the Input tab options of Simulation 3D General Aviation Pack block might be disabled. In this case, the Simulation 3D General Aviation Pack block synchronizes its coordinate system with the scene specified for the Simulation 3D Scene Configuration block if the scene appears in this table.

Simulation 3D Scene Configuration Block Scene	Simulation 3D General Aviation Pack Coordinate System
Airport	NED
Earth, Moon, and Space	ICRF
Geospatial with LLA origin	NED
Geospatial with tileset center origin	Fixed-frame

For more information on ICRF and fixed-frame coordinate systems, see ECI and ECEF Coordinates.

The Simulation 3D General Aviation Pack block does not synchronize with any other scene selections in the Simulation 3D Scene Configuration block.

Version History

Introduced in R2023b

R2025a: Simulation 3D General Aviation Pack block now synchronizes coordinate frame with Simulation 3D Scene Configuration block

The Simulation 3D General Aviation Pack block has these changes:

• The Geospatial tab was renamed to Input tab.

• On the Input tab, the Select input coordinate frame pane now contains these coordinate frame buttons:

  • Fixed-frame — Fixed-frame coordinate frame. When you select this coordinate frame, the annotation Fixed-frame appears under the pack block icons.

  • ICRF — International Celestial Reference Frame coordinate frame. When you select this coordinate frame, the annotation ICRF appears under the pack block icons.

  • NED — North-east-down coordinate frame. When you select this coordinate frame, the annotation NED appears under the pack block icons.

  If a model contains a Simulation 3D pack block and an associated Simulation 3D Scene Configuration block, the Input tab options of Simulation 3D General Aviation Pack might be disabled. In this case, the Simulation 3D General Aviation Pack synchronizes coordinate systems with the Simulation 3D Scene Configuration block.

• The coordinate system displays as an annotation under the block.

• The Enable geospatial correction and Direction of x-axis (degrees clockwise from north) parameters have been removed.

R2024a: Simulation 3D General Aviation Pack Block Now Supports Earth-centered Earth-fixed (ECEF) Input Coordinate Frame

To enable ECEF coordinate systems for translation input, the Simulation 3D General Aviation Pack block has been updated. Use these parameters with the Use Earth center as origin (ECEF) parameter in the Simulation 3D Scene Configuration block.

• Select input coordinate frame

  • ECEF — ECEF input coordinate frame. When you select this coordinate frame, the annotation Origin: Earth center (ECEF) appears under the pack block icons.

  • NED — NED coordinate frame. Prior to R2024a, NED was the only supported coordinate frame.

• Direction of x-axis (degrees clockwise from north) — Direction of the x-axis. This parameter is enabled when you select the Enable geospatial correction check box.