satelliteScenarioViewer

Create viewer for satellite scenario

Syntax

satelliteScenarioViewer(scenario)

satelliteScenarioViewer(scenario,Name,Value)

v = satelliteScenarioViewer(scenario)

Description

satelliteScenarioViewer(scenario) creates a 3-D or 2-D satellite scenario viewer for the specified satellite scenario.

Note

• Satellite Scenario Viewer is a 3-D map display and requires hardware graphics support for WebGL™.

satelliteScenarioViewer(scenario,Name,Value) creates a new viewer using one or more name-value arguments. For example, 'Basemap', 'topographic' bases the scenario on Topographic imagery provided by Esri^®.

v = satelliteScenarioViewer(scenario) returns the handle to the satellite scenario viewer.

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 comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Basemap','topographic' bases the scenario on 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:

	'satellite' Full global basemap composed of high-resolution satellite imagery. Hosted by Esri.		'streets' General-purpose road map that emphasizes accurate, legible styling of roads and transit networks. Hosted by Esri.
	'topographic' General-purpose map with styling to depict topographic features. Hosted by Esri.		'streets-dark' Map designed to provide geographic context while highlighting user data on a dark background. Hosted by Esri.
	'landcover' 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.		'streets-light' Map designed to provide geographic context while highlighting user data on a light background. Hosted by Esri.
	'colorterrain' Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands are brown. Created using Natural Earth.		'grayterrain' Terrain map in shades of gray. Shaded relief emphasizes both high mountains and micro-terrain found in lowlands. Created using Natural Earth.
	'bluegreen' Two-tone, land-ocean map with light green land areas and light blue water areas. Created using Natural Earth.		'grayland' Two-tone, land-ocean map with gray land areas and white water areas. Created using Natural Earth.
	'darkwater' 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

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

Data Types: char | string

PlaybackSpeedMultiplier — Speed of animation

50 (default) | positive scalar

Speed of the animation for the input scenario used by the play function, specified as a comma-separated pair consisting of 'PlaybackSpeedMultiplier' and a positive scalar.

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.

Data Types: datetime

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.

Tips

• To pan the viewer window without rotation, use Shift + left click + drag.