Simulation 3D Helicopter Pack

Generate translation and rotation information for helicopter

Since R2023b

• 

Libraries:
Aerospace Blockset / Animation / Simulation 3D

Description

The Simulation 3D Helicopter Pack block creates translation and rotation information for the Simulation 3D Rotorcraft block with Type set to Helicopter. Use the Simulation 3D Helicopter Pack block to provide translation and rotation information to the Translation and Rotation input ports of the Simulation 3D Rotorcraft 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 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Engine 1 translation parameter.

Data Types: single | double

Engine2_T — Engine 2 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Engine 2 translation parameter.

Data Types: single | double

Rotor1_T — Rotor 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Rotor 1 translation parameter.

Data Types: single | double

Rotor2_T — Rotor 2 translation

1-by-3 matrix

Rotor 2 translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Rotor 2 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

Nose_Gear_Door1_T — Nose gear door 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Nose gear door 1 translation check box.

Data Types: single | double

Nose_Gear_Door2_T — Nose gear door 2 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Nose gear door 2 translation check box.

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

Left_Gear_Door1_T — Left gear door 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Left gear door 1 translation check box.

Data Types: single | double

Left_Gear_Door2_T — Left gear door 2 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Left gear door 2 translation check box.

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

Right_Gear_Door1_T — Right gear door 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Right gear door 1 translation check box.

Data Types: single | double

Right_Gear_Door2_T — Right gear door 2 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Right gear door 2 translation check box.

Data Types: single | double

Sensor1_T — Sensor 1 translation

1-by-3 matrix

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

Dependencies

To enable this port, select the Sensor 1 translation parameter.

Data Types: single | double

Sensor2_T — Sensor 2 translation

1-by-3 matrix

Sensor 2 translation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Sensor 2 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 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Engine 1 rotation parameter.

Data Types: single | double

Engine2_R — Engine 2 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Engine 2 rotation parameter.

Data Types: single | double

Rotor1_R — Rotor 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Rotor 1 rotation parameter.

Data Types: single | double

Rotor2_R — Rotor 2 rotation

1-by-3 matrix

Rotor 2 rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Rotor 2 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

Nose_Gear_Door1_R — Nose gear door 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Nose gear door 1 rotation check box.

Data Types: single | double

Nose_Gear_Door2_R — Nose gear door 2 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Nose gear door 2 rotation check box.

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

Left_Gear_Door1_R — Left gear door 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Left gear door 1 rotation check box.

Data Types: single | double

Left_Gear_Door2_R — Left gear door 2 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Left gear door 2 rotation check box.

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

Right_Gear_Door1_R — Right gear door 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Right gear door 1 rotation check box.

Data Types: single | double

Right_Gear_Door2_R — Right gear door 2 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Right gear door 2 rotation check box.

Data Types: single | double

Sensor1_R — Sensor 1 rotation

1-by-3 matrix

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

Dependencies

To enable this port, select the Sensor 1 rotation parameter.

Data Types: single | double

Sensor2_R — Sensor 2 rotation

1-by-3 matrix

Sensor 2 rotation, specified as a 1-by-3 matrix.

Dependencies

To enable this port, select the Sensor 2 rotation parameter.

Data Types: single | double

Output

Translation — Helicopter translation

19-by-3 array

Helicopter translation for helicopter rotorcraft, returned as an 19-by-3 array. The signal contains translation [X, Y, Z], in meters, with one row of the array for each bone of the rotorcraft.

The translation applies to these bones of the Helicopter type.

Bone	Index
BODY	1
ENGINE1	2
ENGINE2	3
ROTOR1	4
ROTOR2	5
NOSE_GEAR	6
NOSE_WHEEL	7
NOSE_GEAR_DOOR1	8
NOSE_GEAR_DOOR2	9
LEFT_GEAR	10
LEFT_WHEEL	11
LEFT_GEAR_DOOR1	12
LEFT_GEAR_DOOR2	13
RIGHT_GEAR	14
RIGHT_WHEEL	15
RIGHT_GEAR_DOOR1	16
RIGHT_GEAR_DOOR2	17
SENSOR1	18
SENSOR2	19

Rotation — Rotorcraft rotation

19-by-3 array

Rotorcraft rotation for helicopter rotorcraft, returned as an 19-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 rotorcraft.

Parameters

Propulsion

Engine 1 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 2 translation — Option to enable Engine2_T input port

off (default) | on

Select this parameter to enable the Engine2_T input port.

Programmatic Use

Block Parameter: Engine2_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Rotor 1 translation — Option to enable Rotor1_T input port

off (default) | on

Select this parameter to enable the Rotor1_T input port.

Programmatic Use

Block Parameter: Rotor1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Rotor 2 translation — Option to enable Rotor2_T input port

off (default) | on

Select this parameter to enable the Rotor2_T input port.

Programmatic Use

Block Parameter: Rotor2_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Engine 1 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'

Engine 2 rotation — Option to enable Engine2_R input port

off (default) | on

Select this parameter to enable the Engine2_R input port.

Programmatic Use

Block Parameter: Engine2_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Rotor 1 rotation — Option to enable Rotor1_R input port

off (default) | on

Select this parameter to enable the Rotor1_R input port.

Programmatic Use

Block Parameter: Rotor1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Rotor 2 rotation — Option to enable Rotor2_R input port

off (default) | on

Select this parameter to enable the Rotor2_R input port.

Programmatic Use

Block Parameter: Rotor2_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'

Nose gear door 1 translation — Option to enable Nose_Gear_Door1_T input port

off (default) | on

Select this check box to enable the Nose_Gear_Door1_T input port.

Programmatic Use

Block Parameter: Nose_Gear_Door1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Nose gear door 2 translation — Option to enable Nose_Gear_Door2_T input port

off (default) | on

Select this check box to enable the Nose_Gear_Door2_T input port.

Programmatic Use

Block Parameter: Nose_Gear_Door2_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'

Left gear door 1 translation — Option to enable Left_Gear_Door1_T input port

off (default) | on

Select this check box to enable the Left_Gear_Door1_T input port.

Programmatic Use

Block Parameter: Left_Gear_Door1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left gear door 2 translation — Option to enable Left_Gear_Door2_T input port

off (default) | on

Select this check box to enable the Left_Gear_Door2_T input port.

Programmatic Use

Block Parameter: Left_Gear_Door2_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'

Right gear door 1 translation — Option to enable Right_Gear_Door1_T input port

off (default) | on

Select this check box to enable the Right_Gear_Door1_T input port.

Programmatic Use

Block Parameter: Right_Gear_Door1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right gear door 2 translation — Option to enable Right_Gear_Door2_T input port

off (default) | on

Select this check box to enable the Right_Gear_Door2_T input port.

Programmatic Use

Block Parameter: Right_Gear_Door2_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'

Nose gear door 1 rotation — Option to enable Nose_Gear_Door1_R input port

off (default) | on

Select this check box to enable the Nose_Gear_Door1_R input port.

Programmatic Use

Block Parameter: Nose_Gear_Door1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Nose gear door 2 rotation — Option to enable Nose_Gear_Door2_R input port

off (default) | on

Select this check box to enable the Nose_Gear_Door2_R input port.

Programmatic Use

Block Parameter: Nose_Gear_Door2_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'

Left gear door 1 rotation — Option to enable Left_Gear_Door1_R input port

off (default) | on

Select this check box to enable the Left_Gear_Door1_R input port.

Programmatic Use

Block Parameter: Left_Gear_Door1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Left gear door 2 rotation — Option to enable Left_Gear_Door2_R input port

off (default) | on

Select this check box to enable the Left_Gear_Door2_R input port.

Programmatic Use

Block Parameter: Left_Gear_Door2_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'

Right gear door 1 rotation — Option to enable Right_Gear_Door1_R input port

off (default) | on

Select this check box to enable the Right_Gear_Door1_R input port.

Programmatic Use

Block Parameter: Right_Gear_Door1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Right gear door 2 rotation — Option to enable Right_Gear_Door2_R input port

off (default) | on

Select this check box to enable the Right_Gear_Door2_R input port.

Programmatic Use

Block Parameter: Right_Gear_Door2_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Sensors

Sensor 1 translation — Option to enable Sensor1_T input port

off (default) | on

Select this parameter to enable the Sensor1_T input port.

Programmatic Use

Block Parameter: Sensor1_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Sensor 2 translation — Option to enable Sensor2_T input port

off (default) | on

Select this parameter to enable the Sensor2_T input port.

Programmatic Use

Block Parameter: Sensor2_T

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Sensor 1 rotation — Option to enable Sensor1_R input port

off (default) | on

Select this parameter to enable the Sensor1_R input port.

Programmatic Use

Block Parameter: Sensor1_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Sensor 2 rotation — Option to enable Sensor2_R input port

off (default) | on

Select this parameter to enable the Sensor2_R input port.

Programmatic Use

Block Parameter: Sensor2_R

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Geospatial

Select input coordinate frame — Input coordinate frame

NED (default) | ECEF

Select the input coordinate frame to position aerospace vehicles with respect to north-east-down (NED) or the Earth center (ECEF). Use this parameter with the Use Earth center as origin (ECEF) parameter of the Simulation 3D Scene Configuration block.

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) | 'ECEF'

Enable geospatial correction — Option to enable geospatial correction

off (default) | on

Select this parameter to enable the geospatial correction to the input body translation and rotation.

Dependencies

To enable this parameter, set Select input coordinate frame to NED.

Programmatic Use

Block Parameter: AdjustForCesium

Type: character vector

Values: 'on' | 'off'

Default: 'off'

Direction of x-axis (degrees clockwise from north) — Compass direction of x-axis

90 (default) | real scalar

Specify the compass direction of the x-axis, specified as a real scalar, in degrees.

Dependencies

To enable this parameter:

• Set Select input coordinate frame to NED

• Select Enable geospatial correction

Programmatic Use

Block Parameter: Heading0

Type: character vector

Values: 90 | real scalar

Default: '90'

Version History

Introduced in R2023b

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

To enable ECEF coordinate systems for translation input, the Simulation 3D Helicopter 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.