Main Content

physicalProperties

Retrieve or modify physical properties of satellite object

Since R2024a

collapse all in page

    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

    collapse all

    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'.

    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.

    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.

    Satellite drag area in m2, 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.

    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.

    Solar radiation pressure area in m2, 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

    collapse all

    Physical properties of satellite, returned as a physicalProperties object.

    Version History

    Introduced in R2024a

    See Also

    Objects

    Functions

    Topics