Orbit
Description
The Orbit
object adds an orbit visualization for the
satellite based on the current position of the satellite.
Creation
You can create Orbit
objects using the orbit
function of a satelliteScenario
object.
Properties
viewer
— Satellite Scenario Viewer
satelliteScenarioViewer
object
Satellite Scenario Viewer, specified as a scalar satelliteScenarioViewer
object.1
LeadTime
— Duration of future orbit to be visualized
nonnegative scalar
Duration of future orbit to be visualized in the satellite scenario viewer, specified as a nonnegative scalar, in seconds.
When
OrbitPropagator
is set to'ephemeris'
, the default value ofLeadTime
is the duration of the satellite scenarioStartTime
toStopTime
.When the orbit is parabolic or hyperbolic and
OrbitPropagator
is set to'numerical'
, the default value ofLeadTime
is the duration of the satellite scenarioStartTime
to the time when the satellite reaches145
times the equatorial radius of the Earth.In all other cases, the default value of
LeadTime
is one orbital period.
TrailTime
— Duration of orbit history to be visualized
nonnegative scalar
Duration of the orbit history to be visualized in Viewer
,
specified as 'TrailTime'
and a nonnegative scalar in
seconds.
When
OrbitPropagator
is set to'ephemeris'
, the default value ofTrailTime
is the duration of the satellite scenarioStartTime
toStopTime
.When the orbit is parabolic or hyperbolic and
OrbitPropagator
is set to'numerical'
, the default value ofTrailTime
is the duration of the satellite scenarioStartTime
to the time when the satellite reaches145
times the equatorial radius of the Earth.In all other cases, the default value of
LeadTime
is one orbital period.
LineWidth
— Visual width of orbit
1
(default) | scalar in the range (0 10]
Visual width of the orbit, in pixels, specified as a scalar in the range (0 10].
The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.
LineColor
— Color of orbit line
[0.5 0 1]
(default) | RGB triplet | hexadecimal color code | color name | short name
Color of orbit line, specified as an RGB triplet, hexadecimal color code, a color name, or a short 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 from0
toF
. 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 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"
|
|
Example: 'blue'
Example: [0 0 1]
Example: '#0000FF'
VisibilityMode
— Visibility mode of orbit
'inherit'
(default) | 'manual'
Visibility mode of the orbit, specified as one of these values:
'inherit'
— Visibility of the graphic matches that of the parent.'manual'
— Visibility of the graphic is not inherited and is independent of that of the parent.
Object Functions
Version History
Introduced in R2024a
See Also
Objects
Functions
1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)