satelliteScenarioViewer
Create viewer for satellite scenario
Syntax
Description
satelliteScenarioViewer(
creates a
3-D or 2-D satellite scenario viewer for the specified satellite scenario. Satellite
Scenario Viewer is a 3-D map display and requires hardware graphics support for WebGL™.scenario
)
satelliteScenarioViewer(
creates a new viewer using one or more name-value arguments. For example,
scenario
,Name,Value
)'Basemap'
, 'topographic'
uses topographic imagery
provided by Esri®.
Examples
Create and Visualize Satellite Scenario
Create a satellite scenario object.
sc = satelliteScenario;
Add a satellite and ground station to the scenario. Additionally, add an access between the satellite and the ground station.
sat = satellite(sc,"eccentricOrbitSatellite.tle");
gs = groundStation(sc);
access(sat,gs);
Visualize the scenario at the start time defined in the TLE file by using the Satellite Scenario Viewer.
satelliteScenarioViewer(sc);
Input Arguments
scenario
— Satellite scenario
satelliteScenario
object
Satellite scenario, specified as a satelliteScenario
object.
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.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: 'Basemap','topographic'
uses topographic imagery provided by
Esri.
Name
— Name of viewer window
'Satellite Scenario Viewer'
(default) | string scalar | character vector
Name of the viewer window, specified as a comma-separated pair consisting of
'Name'
and either a string scalar or a character vector.
Data Types: char
| string
Position
— Viewer window position
center of the screen (default) | row vector of four elements
Size and location of the satellite scenario window in pixels, specified as a row
vector of four elements. The elements of the vector are [left bottom width
height]
. In the default case, width and height are 800 and 600 pixels,
respectively.
Basemap
— Map on which scenario is visualized
'satellite'
(default) | 'topographic'
| 'streets'
| 'streets-light'
| 'streets-dark'
| 'darkwater'
| 'grayland'
| 'bluegreen'
| 'colorterrain'
| 'grayterrain'
| 'landcover'
Map on which scenario is visualized, specified as a comma-separated pair
consisting of 'Basemap'
and one of the values specified in this
table:
|
Full global basemap composed of high-resolution satellite imagery. Hosted by Esri. |
|
General-purpose road map that emphasizes accurate, legible styling of roads and transit networks. Hosted by Esri. |
|
General-purpose map with styling to depict topographic features. Hosted by Esri. |
|
Map designed to provide geographic context while highlighting user data on a dark background. Hosted by Esri. |
|
Map that combines satellite-derived land cover data, shaded relief, and ocean-bottom relief. The light, natural palette is suitable for thematic and reference maps. Created using Natural Earth. |
|
Map designed to provide geographic context while highlighting user data on a light background. Hosted by Esri. |
|
Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands are brown. Created using Natural Earth. |
|
Terrain map in shades of gray. Shaded relief emphasizes both high mountains and micro-terrain found in lowlands. Created using Natural Earth. |
|
Two-tone, land-ocean map with light green land areas and light blue water areas. Created using Natural Earth. |
|
Two-tone, land-ocean map with gray land areas and white water areas. Created using Natural Earth. |
|
Two-tone, land-ocean map with light gray land areas and dark gray water areas. This basemap is installed with MATLAB®. Created using Natural Earth. |
All basemaps except 'darkwater'
require
Internet access. The 'darkwater'
basemap is included with
MATLAB and Aerospace Toolbox.
If you do not have consistent access to the Internet, you can download the basemaps created using Natural Earth onto your local system by using the Add-On Explorer. The basemaps hosted by Esri are not available for download.
Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by The MathWorks®.
Data Types: char
| string
CameraReferenceFrame
— Reference frame of camera
'ECEF'
(default) | 'Inertial'
Reference frame of the camera, specified as a comma-separated pair consisting of
'CameraReferenceFrame'
and one of these values:
'ECEF'
— Earth-Centered Earth-Fixed camera.'Inertial'
— Inertially fixed camera.
When you specify 'Inertial'
, the globe rotates with respect to
the camera. When you specify 'ECEF'
, the camera rotates with the
globe.
Dependencies
To enable this name-value argument, set to Dimension
to
'3-D'
.
CurrentTime
— Current simulation time
StartTime
of
satelliteScenario
(default) | datetime
array
Current simulation time of the viewer, specified as a datetime
array. This value changes over time when the animation is
playing.
Dependencies
To enable this name-value argument, set AutoSimulate
to true
.
Data Types: datetime
Dimension
— Dimension of viewer
'3-D'
(default) | '2-D'
Dimension of the viewer, specified as a comma-separated pair consisting of
'Dimension'
and either '3-D'
or
'2-D'
.
ShowDetails
— Flag to show graphical details
true
or 1
(default) | false
or 0
Flag to show the graphical details for Satellite Scenario Viewer, specified as one of these numeric or logical values.
1
(true
) — Show all graphical details of satellites and ground stations except those explicitly hidden.0
(false
) — Hide all graphical details of satellites and the ground stations, including orbits, fields of view, labels, and the ground track. Even whenShowDetails
isfalse
, clicking or pausing on satellites and ground stations reveals hidden graphical details or labels, respectively.
Data Types: logical
Output Arguments
v
— Satellite scenario viewer
satelliteScenarioViewer
object
Satellite scenario viewer, returned as a satelliteScenarioViewer
object.
To specify, query, or visualize satellite scenario viewer details, use these functions:
campos | Set or query camera position. |
camheight | Set or query camera height. |
camheading | Set or query camera heading angle. |
camroll | Set or query camera roll angle. |
campitch | Set or query camera pitch angle. |
camtarget | Target an object with the camera. |
hideAll | Hide all visualizations and animations in the Satellite Viewer. |
showAll | Show all visualizations and animations in the Satellite Viewer. |
Note
When AutoSimulate
property of the satellite scenario is true
,
the timeline and the playback widgets are available. You can use the play
function to access
the widgets during simulation.
Tips
To pan the viewer window without rotation, use Shift + left click + drag.
Version History
See Also
Functions
Beispiel öffnen
Sie haben eine geänderte Version dieses Beispiels. Möchten Sie dieses Beispiel mit Ihren Änderungen öffnen?
MATLAB-Befehl
Sie haben auf einen Link geklickt, der diesem MATLAB-Befehl entspricht:
Führen Sie den Befehl durch Eingabe in das MATLAB-Befehlsfenster aus. Webbrowser unterstützen keine MATLAB-Befehle.
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)