Simulation 3D SmallSat Pack

Create translation and rotation input matrices for SmallSat

Since R2024a

• 

Libraries:
Aerospace Blockset / Animation / Simulation 3D

Description

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

Ports

Input

Body_T — Body translation

1-by-3 matrix

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

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

Output

Translation — Spacecraft translation

20-by-3 array

Spacecraft translation for SmallSat, returned as a 20-by-3 array. The signal contains translation [X, Y, Z], in meters, with one row of the array for each bone of the spacecraft.

The translation applies to these bones of the SmallSat type.

Bone	Index
BODY	1
ANTENNA1	2
ANTENNA2	3
ANTENNA3	4
ANTENNA4	5
SENSOR1	6
SENSOR2	7
SENSOR3	8
SENSOR4	9
SOLAR_ARRAY1	10
SOLAR_ARRAY1_1	11
SOLAR_ARRAY1_1_1	12
SOLAR_ARRAY1_1_1_1	13
SOLAR_ARRAY1_1_1_1_1	14
SOLAR_ARRAY2	15
SOLAR_ARRAY2_2	16
SOLAR_ARRAY2_2_2	17
SOLAR_ARRAY2_2_2_2	18
SOLAR_ARRAY2_2_2_2_2	19
THRUSTER	20

Rotation — Spacecraft rotation

20-by-3 array

Spacecraft rotation for SmallSat, returned as a 20-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 spacecraft.

Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink^® Toolstrip, on the Simulation tab, in the Prepare gallery, select Property Inspector.

Sensors

Antenna 1 translation — Option to enable Antenna1_T input port

off (default) | on

Select this parameter to enable the Antenna1_T input port.

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:	Antenna1_T
Values:	'off' (default) | 'on'

Antenna 1 rotation — Option to enable Antenna1_R input port

off (default) | on

Select this parameter to enable the Antenna1_R input port.

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:	Antenna1_R
Values:	'off' (default) | 'on'

Antenna 2 translation — Option to enable Antenna2_T input port

off (default) | on

Select this parameter to enable the Antenna2_T input port.

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:	Antenna2_T
Values:	'off' (default) | 'on'

Antenna 2 rotation — Option to enable Antenna2_R input port

off (default) | on

Select this parameter to enable the Antenna2_R input port.

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:	Antenna2_R
Values:	'off' (default) | 'on'

Antenna 3 translation — Option to enable Antenna3_T input port

off (default) | on

Select this parameter to enable the Antenna3_T input port.

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:	Antenna3_T
Values:	'off' (default) | 'on'

Antenna 3 rotation — Option to enable Antenna3_R input port

off (default) | on

Select this parameter to enable the Antenna3_R input port.

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:	Antenna3_R
Values:	'off' (default) | 'on'

Antenna 4 translation — Option to enable Antenna4_T input port

off (default) | on

Select this parameter to enable the Antenna4_T input port.

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:	Antenna4_T
Values:	'off' (default) | 'on'

Antenna 4 rotation — Option to enable Antenna4_R input port

off (default) | on

Select this parameter to enable the Antenna4_R input port.

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:	Antenna4_R
Values:	'off' (default) | 'on'

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

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:	Sensor1_T
Values:	'off' (default) | 'on'

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

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:	Sensor1_R
Values:	'off' (default) | 'on'

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

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:	Sensor2_T
Values:	'off' (default) | 'on'

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

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:	Sensor2_R
Values:	'off' (default) | 'on'

Sensor 3 translation — Option to enable Sensor3_T input port

off (default) | on

Select this parameter to enable the Sensor3_T input port.

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:	Sensor3_T
Values:	'off' (default) | 'on'

Sensor 3 rotation — Option to enable Sensor3_R input port

off (default) | on

Select this parameter to enable the Sensor3_R input port.

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:	Sensor3_R
Values:	'off' (default) | 'on'

Sensor 4 translation — Option to enable Sensor4_T input port

off (default) | on

Select this parameter to enable the Sensor4_T input port.

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:	Sensor4_T
Values:	'off' (default) | 'on'

Sensor 4 rotation — Option to enable Sensor4_R input port

off (default) | on

Select this parameter to enable the Sensor4_R input port.

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:	Sensor4_R
Values:	'off' (default) | 'on'

Solar Arrays

Solar array 1 translation — Option to enable SolarArray1_T input port

off (default) | on

Select this parameter to enable the SolarArray1_T input port.

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:	SolarArray1_T
Values:	'off' (default) | 'on'

Solar array 1 rotation — Option to enable SolarArray1_R input port

off (default) | on

Select this parameter to enable the SolarArray1_R input port.

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:	SolarArray1_R
Values:	'off' (default) | 'on'

Solar array 1.1 translation — Option to enable SolarArray1_1_T input port

off (default) | on

Select this parameter to enable the SolarArray1_1_T input port.

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:	SolarArray1_1_T
Values:	'off' (default) | 'on'

Solar array 1.1 rotation — Option to enable SolarArray1_1_R input port

off (default) | on

Select this parameter to enable the SolarArray1_1_R input port.

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:	SolarArray1_1_R
Values:	'off' (default) | 'on'

Solar array 1.1.1 translation — Option to enable SolarArray1_1_1_T input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_T input port.

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:	SolarArray1_1_1_T
Values:	'off' (default) | 'on'

Solar array 1.1.1 rotation — Option to enable SolarArray1_1_1_R input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_R input port.

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:	SolarArray1_1_1_R
Values:	'off' (default) | 'on'

Solar array 1.1.1.1 translation — Option to enable SolarArray1_1_1_1_T input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_1_T input port.

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:	SolarArray1_1_1_1_T
Values:	'off' (default) | 'on'

Solar array 1.1.1.1 rotation — Option to enable SolarArray1_1_1_1_R input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_1_R input port.

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:	SolarArray1_1_1_1_R
Values:	'off' (default) | 'on'

Solar array 1.1.1.1.1 translation — Option to enable SolarArray1_1_1_1_1_T input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_1_1_T input port.

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:	SolarArray1_1_1_1_1_T
Values:	'off' (default) | 'on'

Solar array 1.1.1.1.1 rotation — Option to enable SolarArray1_1_1_1_1_R input port

off (default) | on

Select this parameter to enable the SolarArray1_1_1_1_1_R input port.

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:	SolarArray1_1_1_1_1_R
Values:	'off' (default) | 'on'

Solar array 2 translation — Option to enable SolarArray2_T input port

off (default) | on

Select this parameter to enable the SolarArray2_T input port.

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:	SolarArray2_T
Values:	'off' (default) | 'on'

Solar array 2 rotation — Option to enable SolarArray2_R input port

off (default) | on

Select this parameter to enable the SolarArray2_R input port.

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:	SolarArray2_R
Values:	'off' (default) | 'on'

Solar array 2.2 translation — Option to enable SolarArray2_2_T input port

off (default) | on

Select this parameter to enable the SolarArray2_2_T input port.

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:	SolarArray2_2_T
Values:	'off' (default) | 'on'

Solar array 2.2 rotation — Option to enable SolarArray2_2_R input port

off (default) | on

Select this parameter to enable the SolarArray2_2_R input port.

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:	SolarArray2_2_R
Values:	'off' (default) | 'on'

Solar array 2.2.2 translation — Option to enable SolarArray2_2_2_T input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_T input port.

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:	SolarArray2_2_2_T
Values:	'off' (default) | 'on'

Solar array 2.2.2 rotation — Option to enable SolarArray2_2_2_R input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_R input port.

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:	SolarArray2_2_2_R
Values:	'off' (default) | 'on'

Solar array 2.2.2.2 translation — Option to enable SolarArray2_2_2_2_T input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_2_T input port.

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:	SolarArray2_2_2_2_T
Values:	'off' (default) | 'on'

Solar array 2.2.2.2 rotation — Option to enable SolarArray2_2_2_2_R input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_2_R input port.

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:	SolarArray2_2_2_2_R
Values:	'off' (default) | 'on'

Solar array 2.2.2.2.2 translation — Option to enable SolarArray2_2_2_2_2_T input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_2_2_T input port.

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:	SolarArray2_2_2_2_2_T
Values:	'off' (default) | 'on'

Solar array 2.2.2.2.2 rotation — Option to enable SolarArray2_2_2_2_2_R input port

off (default) | on

Select this parameter to enable the SolarArray2_2_2_2_2_R input port.

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:	SolarArray2_2_2_2_2_R
Values:	'off' (default) | 'on'

Thrusters

Thruster translation — Option to enable Thruster_T input port

off (default) | on

Select this parameter to enable the Thruster_T input port.

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:	Thruster_T
Values:	'off' (default) | 'on'

Thruster rotation — Option to enable Thruster_R input port

off (default) | on

Select this parameter to enable the Thruster_R input port.

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:	Thruster_R
Values:	'off' (default) | 'on'

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 SmallSat 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 SmallSat 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 SmallSat Pack block and an associated Simulation 3D Scene Configuration block, the Input tab options of Simulation 3D SmallSat Pack block might be disabled. In this case, the Simulation 3D SmallSat 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 SmallSat 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 SmallSat Pack block does not synchronize with any other scene selections in the Simulation 3D Scene Configuration block.

Version History

Introduced in R2024a

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

The Simulation 3D SmallSat 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 SmallSat Pack might be disabled. In this case, the Simulation 3D SmallSat 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.