gnssSensor

Simulate GNSS to generate position and velocity readings

expand all in page

Description

The gnssSensor System object™ simulates a global navigation satellite system (GNSS) to generate position and velocity readings based on local position and velocity data.

To generate GNSS position and velocity readings:

  1. Create the gnssSensor object and set its properties.

  2. Call the object with arguments, as if it were a function.

To learn more about how System objects work, see What Are System Objects?.

Creation

Syntax

GNSS = gnssSensor
GNSS = gnssSensor('ReferenceFrame',frame)
GNSS = gnssSensor(___,Name,Value)

Description

GNSS = gnssSensor returns a gnssSensor System object GNSS that computes global navigation satellite system receiver readings based on local position and velocity input.

GNSS = gnssSensor('ReferenceFrame',frame) specifies the reference frame in which the GNSS readings are reported. Specify frame as 'NED' (north-east-down) or 'ENU' (east-north-up). The default value is 'NED'.

example

GNSS = gnssSensor(___,Name,Value) sets properties using one or more name-value pairs. For example, gnssSensor('SampleRate',2) creates a simulated GNSS with a sample rate of 2 Hz. Enclose each property name in quotes.

Properties

expand all

Unless otherwise indicated, properties are nontunable, which means you cannot change their values after calling the object. Objects lock when you call them, and the release function unlocks them.

If a property is tunable, you can change its value at any time.

For more information on changing property values, see System Design in MATLAB Using System Objects.

Sample rate of the GNSS receiver, specified as a positive scalar in Hz.

Data Types: single | double

Initial time of the GNSS receiver, specified as a datetime object. The object accounts for leap seconds in the conversion between the UTC and the GNSS time.

Origin of the local navigation reference frame, specified as a three-element row vector of scalars in geodetic coordinates (latitude in degrees, longitude in degrees, and altitude in meters). Altitude is the height above the reference ellipsoid model WGS84.

Data Types: single | double

Elevation mask angle, specified as a scalar in the range of [0, 90] in degrees. Satellites in view but below the mask angle are not used in estimating the position of the receiver.

Tunable: Yes

Data Types: single | double

Standard deviation of the measurement noise of pseudorange, specified as a nonnegative scalar in meters.

Tunable: Yes

Data Types: single | double

Standard deviation of the measurement noise of pseudorange rate, specified as a nonnegative scalar in meters per second.

Tunable: Yes

Data Types: single | double

Random number source, specified as one of these options::

  • 'Global stream' –– Random numbers are generated using the current global random number stream.

  • 'mt19937ar with seed' –– Random numbers are generated using the mt19937ar algorithm with the seed specified by the Seed property.

Data Types: char | string

Initial seed of an mt19937ar random number generator algorithm, specified as a nonnegative integer.

Dependencies

To enable this property, set RandomStream to 'mt19937ar with seed'.

Data Types: integer

Usage

Syntax

[positionReading,velocityReading,status] = GNSS(position,velocity)

Description

[positionReading,velocityReading,status] = GNSS(position,velocity) computes global navigation satellite system receiver readings from the position and velocity inputs.

Input Arguments

expand all

Cartesian position of the GNSS receiver in the local navigation coordinate system, specified as an N-by-3 matrix of scalars in meters. N is the number of samples.

Data Types: single | double

Velocity of the GNSS receiver in the local navigation coordinate system, specified as an N-by-3 matrix in meters per second. N is the number of samples.

Data Types: single | double

Output Arguments

expand all

Position readings of the GNSS receiver in the geodetic latitude, longitude, and altitude (LLA) coordinate system, returned as an N-by-3 matrix of scalars. N is the number of samples in the input argument. Latitude and longitude are in degrees. Altitude is in meters.

Data Types: single | double

Velocity reading of the GNSS receiver in the local navigation coordinate system in meters per second, returned as an N-by-3 matrix of scalars. N is the number of samples in the input arguments.

Data Types: single | double

Status information of visible satellites, returned as an N-element array of structures. N is the number of samples in the input arguments. Each structure contains these four fields:

Field NameDescription
SatelliteAzimuthAzimuth angles of visible satellites, returned as an M-element vector of scalars in degrees. M is the number of visible satellites.
SatelliteElevationElevation angles of visible satellites, returned as an M-element vector of scalars in degrees. M is the number of visible satellites.
HDOPHorizontal dilution of precision, returned as a scalar.
VDOPVertical dilution of precision, returned as a scalar.

Object Functions

To use an object function, specify the System object as the first input argument. For example, to release system resources of a System object named obj, use this syntax:

release(obj)

expand all

cloneCreate duplicate System object
stepRun System object algorithm
releaseRelease resources and allow changes to System object property values and input characteristics
resetReset internal states of System object
isDoneEnd-of-data status

Examples

collapse all

Open Live Script

Generate target positions and velocities based on a waypoint trajectory.

rng(2020) % For repeatable results
fs = 0.1;
tArrival = 50;
tspan = 0:1/fs:tArrival;
% Create a waypoint trajectory.
trajectory = waypointTrajectory([0,0,0;1,1,1]*500,[0,tArrival]);
[positions,~,velocities] = lookupPose(trajectory,tspan)
positions = 6×3

         0         0         0
  100.0000  100.0000  100.0000
  200.0000  200.0000  200.0000
  300.0000  300.0000  300.0000
  400.0000  400.0000  400.0000
  500.0000  500.0000  500.0000


velocities = 6×3

   10.0000   10.0000   10.0000
   10.0000   10.0000   10.0000
   10.0000   10.0000   10.0000
   10.0000   10.0000   10.0000
   10.0000   10.0000   10.0000
   10.0000   10.0000   10.0000

Create a GNSS System object. Use the LLA position for Natick, MA as the local reference frame origin of the trajectory.

refLocNatick = [42.2825 -71.343 53.0352];
gnss = gnssSensor('SampleRate',fs, ...
    'ReferenceLocation',refLocNatick);

Generate position and velocity readings based on the GNSS object.

[llaReadings,velocityReadings,status] = gnss(positions,velocities)
llaReadings = 6×3

   42.2825  -71.3430   52.3728
   42.2834  -71.3418  -48.6565
   42.2843  -71.3406 -146.9982
   42.2852  -71.3394 -246.3241
   42.2861  -71.3382 -348.5439
   42.2870  -71.3369 -449.8394


velocityReadings = 6×3

    9.9779    9.9998   10.0486
   10.0026   10.0144   10.0019
    9.9771   10.0047   10.0343
    9.9733   10.0232   10.0025
   10.0123    9.9849    9.9887
   10.0038    9.9904   10.0719


status=6×1 struct array with fields:
    SatelliteAzimuth
    SatelliteElevation
    HDOP
    VDOP

Extended Capabilities

See Also

|

Introduced in R2020b

Navigation Toolbox Documentation

Support