3D Scenarios

R2026b

Author 3D scenes, run simulations, perform analyses, and create visualizations

The 3D Scenarios add-on enables you to model, visualize, and simulate scenarios in a 3D geographic environment. Create a scenario with terrain from DTED files and buildings from OpenStreetMap^® files. Visualize the scenario using interactive 3D globe viewers. Add car, aircraft, and generic actors with waypoint trajectories, then run simulations that analyze line-of-sight visibility or find geometric ray paths between the actors. Query actor poses in specified reference frames as the simulation progresses.

Note

Install the 3D Scenarios add-on by using the install3DScenarios function.

Functions

expand all

Scenarios

`scenario`	Create 3D scenario (Since R2026b)
`advance`	Advance 3D scenario by one time step (Since R2026b)
`restart`	Restart 3D scenario from beginning (Since R2026b)

Viewers

Create and Manage Viewers

`viewer`	Create viewer for 3D scenario (Since R2026b)
`gcv`	Get current 3D scenario viewer (Since R2026b)
`viewers`	Get viewers for 3D scenario (Since R2026b)
`close`	Close 3D scenario viewer (Since R2026b)

Get Visuals and Plot Data

`getvisual`	Get visual for actor, behavior, or analysis (Since R2026b)
`plotpoints`	Plot points in 3D scenario viewer (Since R2026b)
`plotline`	Plot line in 3D scenario viewer (Since R2026b)
`plot`	Plot ray paths in 3D scenario viewer (Since R2026b)
`pickpoints`	Interactively pick points in viewer (Since R2026b)

Control Camera

`zoomto`	Focus camera on actor, behavior, or analysis (Since R2026b)
`follow`	Move camera to follow actor (Since R2026b)
`campos`	Set or get camera position (Since R2026b)
`camheading`	Set or get camera heading angle (Since R2026b)
`campitch`	Set or get camera pitch angle (Since R2026b)
`camroll`	Set or get camera roll angle (Since R2026b)

Actors and Trajectories

Create Actors

`car`	Create car actor in 3D scenario (Since R2026b)
`aircraft`	Create aircraft actor in 3D scenario (Since R2026b)
`actor`	Create point actor in 3D scenario (Since R2026b)

Specify Actor Trajectories

`groundTrajectory`	Create ground trajectory (Since R2026b)
`airTrajectory`	Create air trajectory (Since R2026b)

Query and Manage Actors

`pose`	Set or get actor pose (Since R2026b)
`position`	Set or get actor position (Since R2026b)
`translate`	Translate actor (Since R2026b)
`rotate`	Rotate actor (Since R2026b)
`remove`	Remove actor or analysis from 3D scenario (Since R2026b)

Geometric Analyses

Create Analyses

`losAnalysis`	Add line-of-sight analysis to 3D scenario (Since R2026b)
`rayTraceAnalysis`	Add ray trace analysis to 3D scenario (Since R2026b)

Query and Manage Analyses

`analyses`	Get analyses in 3D scenario (Since R2026b)
`hasLOS`	Line-of-sight visibility status (Since R2026b)
`findpaths`	Find ray paths (Since R2026b)
`remove`	Remove actor or analysis from 3D scenario (Since R2026b)

Query and Manage Ray Paths

`aoa`	Angle of arrival (Since R2026b)
`aod`	Angle of departure (Since R2026b)
`propdist`	Propagation distance (Since R2026b)
`reverse`	Reverse direction of ray path (Since R2026b)

Poses and Reference Frames

Query and Manage Poses

`pose`	Position, orientation, and motion relative to reference frame (Since R2026b)
`transform`	Transform `pose` object between reference frames (Since R2026b)
`euler`	Orientation of `pose` object as Euler angles (Since R2026b)
`dcm`	Orientation of `pose` object as direction cosine matrix (Since R2026b)
`quaternion`	Orientation of `pose` object as quaternion (Since R2026b)

Create Reference Frames

`geoframe`	Create geographic reference frame (Since R2026b)
`ecefframe`	Create Earth-centered, Earth-fixed (ECEF) reference frame (Since R2026b)
`localframe`	Create local Cartesian reference frame (Since R2026b)
`bodyframe`	Create body reference frame for actor (Since R2026b)

Topics

Structure of a 3D Scenario
A scenario consists of a scene, actors, analyses, and viewers that represent and simulate a geographic environment. (Since R2026b)
Simulate 3D Scenarios
Simulate a scenario by advancing through time steps that move actors, recalculate analyses, and update visuals. (Since R2026b)
Specify Coordinate Conventions for 3D Scenarios
Control how the scenario represents position, orientation, and motion data by specifying the reference frame, axes convention, orientation basis, and height reference. (Since R2026b)