Aero.satellitescenario.CentralBodyOptions

R2026b

Central body options used by numerical orbit propagator

Since R2025a

Description

Central body options used by numerical orbit propagator in satellite scenario.

Creation

You can create Aero.satellitescenario.CentralBodyOptions objects using the centralBodyOptions function of a satelliteScenario object.

Properties

CentralBody — Name of central body

"Earth" (default) | "Moon" scalar

Name of the central body, specified as "Earth" or "Moon". This property is read-only.

Data Types: string

UseEarthOrientationParameters — Option to use Earth orientation parameters

false (default) | true

Option to use Earth orientation parameters for the transformation between the International Celestial Reference Frame (ICRF) and International Terrestrial Reference Frame (ITRF), specified as a logical scalar.

Dependencies

This property is applicable only when the CentralBody property equals "Earth", otherwise it is unused and ignored.

Data Types: logical

EarthOrientationParameterFile — Earth orientation data file

aeroiersdata.mat (default) | MAT file

Custom list of Earth orientation data, specified in a MAT file. To create the file, use the aeroReadIERSData function.

Dependencies

This property is applicable only when the CentralBody property equals "Earth", otherwise it is unused and ignored.

Data Types: string

Orbit — Orbit object

Orbit object

Orbit graphic object corresponding to the central body, returned by the orbit method.

GroundTrack — Ground track object

GroundTrack object

Ground track graphic object corresponding to the central body, returned by the groundTrack method.

MarkerSize — Size of marker

6 (default) | positive scalar less than or equal to 30

Size of the marker, specified as a real positive scalar less than or equal to 30. The unit is in pixels.

MarkerColor — Color of marker

[0.7843 0.7843 0.7843] (default) | RGB triplet | string scalar of color name | character vector of color name

Color of the marker, specified as either an RGB triplet or a string or character vector of a color name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB^® uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

ShowLabel — State of Aero.satellitescenario.CentralBodyOptions label visibility

true or 1 (default) | false or 0

State of Aero.satellitescenario.CentralBodyOptions label visibility, specified as a name-value argument consisting of 'ShowLabel' and numerical or logical value of 1 (true) or 0 (false).

Data Types: logical

LabelFontSize — Font size of Aero.satellitescenario.CentralBodyOptions label

15 (default) | scalar in the range [6, 30]

Font size of the Aero.satellitescenario.CentralBodyOptions label, specified as a scalar in the range [6, 30].

LabelFontColor — Font color of Aero.satellitescenario.CentralBodyOptions label

[1,1,1] (default) | RGB triplet | string scalar of color name | character vector of color name

Font color of the Aero.satellitescenario.CentralBodyOptions label, specified as a name-value argument consisting of 'LabelFontColor' and either an RGB triplet or a string or character vector of a color name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive, so the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Object Functions

orbit	Visualize orbit in satellite scenario
groundTrack	Add ground track object to satellite, platform or Moon in scenario

Version History

Introduced in R2025a