physicalProperties

Retrieve or modify physical properties of satellite object

Since R2024a

Syntax

prop = physicalProperties(sat)

physicalProperties(___,Name,Value)

Description

prop = physicalProperties(sat) returns a vector that contains the currently used physical properties for each satellite in sat.

prop = physicalProperties(___,Name,Value) updates the physical properties of each satellite in sat specified by optional name-value arguments and returns the updated PhysicalProperties in prop. When AutoSimulate of the satellite scenario is set to false, you can specify the optional name-value arguments only if SimulationStatus is set to NotStarted.

Input Arguments

sat — Satellite

row vector of Satellite objects

Satellite, specified as a row vector of Satellite objects.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Name='MySatellite' sets the satellite name to 'MySatellite'.

Mass — Satellite mass

positive scalar | positive vector

Satellite mass, in kg, specified as a positive scalar or vector. When specified as a scalar, the value is applied to all satellites in sat. When specified as a vector, the number of elements in 'Mass' should be equal to the number of elements in sat. Each value in 'Mass' is applied to the corresponding element in sat.

Default Value

The default value is the current value of Mass of PhysicalProperties property of sat.

DragCoefficient — Satellite drag coefficient

positive scalar | positive vector

Satellite drag coefficient, specified as a nonnegative scalar or vector. When specified as a scalar, the value is applied to all satellites in sat. When specified as a vector, the number of elements in 'DragCoeffiecient' should be equal to the number of elements in sat. Each value in 'DragCoefficient' is applied to the corresponding element in sat.

Default Value

The default value is the current value of DragCoeffiecient of PhysicalProperties property of sat.

DragArea — Satellite drag area

positive scalar | positive vector

Satellite drag area in m², specified as a nonnegative scalar or vector. When specified as a scalar, the value is applied to all satellites in sat. When specified as a vector, the number of elements in 'DragArea' should be equal to the number of elements in sat. Each value in 'DragArea' is applied to the corresponding element in sat.

Default Value

The default value is the current value of DragArea of PhysicalProperties property of sat.

ReflectivityCoefficient — Reflectivity coefficient of the satellite

positive scalar | positive vector

Reflectivity coefficient of the satellite, specified as a nonnegative scalar double. When specified as a scalar, the value is applied to all satellites in sat. When specified as a vector, the number of elements in 'ReflectivityCoefficient' should be equal to the number of elements in sat. Each value in 'ReflectivityCoefficient' is applied to the corresponding element in sat.

Default Value

The default value is the current value of DragCoeffiecient of PhysicalProperties property of sat.

SRPArea — Solar radiation pressure area

nonnegative scalar | nonnegative vector

Solar radiation pressure area in m², specified as a nonnegative scalar or vector. When specified as a scalar, the value is applied to all satellites in sat. When specified as a vector, the number of elements in 'SRPArea' should be equal to the number of elements in sat. Each value in 'SRPArea' is applied to the corresponding element in sat.

Default Value

The default value is the current value of SRPArea of PhysicalProperties property of sat.

Output Arguments

prop — Physical properties of satellite

physicalProperties object

Physical properties of satellite, returned as a physicalProperties object.

Version History

Introduced in R2024a