Main Content

insSensor

Inertial navigation and GPS simulation model

Description

The insSensor System object™ models data output from an inertial navigation and GPS.

To model output from an inertial navigation and GPS:

  1. Create the insSensor 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

Description

INS = insSensor returns a System object, INS, that models an inertial navigation and GPS reading based on an inertial input signal.

INS = insSensor(Name,Value) sets each property Name to the specified Value. Unspecified properties have default values.

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.

Accuracy of the roll measurement of the sensor body in degrees, specified as a nonnegative real scalar.

Roll is defined as rotation around the x-axis of the sensor body. Roll noise is modeled as a white noise process. RollAccuracy sets the standard deviation, in degrees, of the roll measurement noise.

Tunable: Yes

Data Types: single | double

Accuracy of the pitch measurement of the sensor body in degrees, specified as a nonnegative real scalar.

Pitch is defined as rotation around the y-axis of the sensor body. Pitch noise is modeled as a white noise process. PitchAccuracy defines the standard deviation, in degrees, of the pitch measurement noise.

Tunable: Yes

Data Types: single | double

Accuracy of the yaw measurement of the sensor body in degrees, specified as a nonnegative real scalar.

Yaw is defined as rotation around the z-axis of the sensor body. Yaw noise is modeled as a white noise process. YawAccuracy defines the standard deviation, in degrees, of the yaw measurement noise.

Tunable: Yes

Data Types: single | double

Accuracy of the position measurement of the sensor body in meters, specified as a nonnegative real scalar.

Position noise is modeled as a white noise process. PositionAccuracy defines the standard deviation, in meters, of the position measurement noise.

Tunable: Yes

Data Types: single | double

Accuracy of the velocity measurement of the sensor body in meters per second, specified as a nonnegative real scalar.

Velocity noise is modeled as a white noise process. VelocityAccuracy defines the standard deviation, in meters per second, of the velocity measurement noise.

Tunable: Yes

Data Types: single | double

Random number source, specified as a character vector:

  • '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 real, nonnegative integer scalar.

Dependencies

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

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Usage

Description

measurement = INS(motion) models the data received from an inertial navigation and GPS reading. The measurement is based on the input signal, motion.

Input Arguments

expand all

motion is a struct with the following fields:

  • 'Position' –– Position of the sensor body in the local NED coordinate system specified as a real finite N-by-3 array in meters. N is the number of samples in the current frame.

  • 'Velocity' –– Velocity of the sensor body in the local NED coordinate system specified as a real finite N-by-3 array in meters per second. N is the number of samples in the current frame.

  • 'Orientation' –– Orientation of the sensor body with respect to the local NED coordinate system specified as a quaternion N-element column vector or a single or double 3-by-3-by-N rotation matrix. Each quaternion or rotation matrix is a frame rotation from the local NED coordinate system to the current sensor body coordinate system. N is the number of samples in the current frame.

Example: motion = struct('Position',[0,0,0],'Velocity',[0,0,0],'Orientation',quaternion([1,0,0,0]))

Output Arguments

expand all

measurement is a struct with the following fields:

  • 'Position' –– Position measurement of the sensor body in the local NED coordinate system specified as a real finite N-by-3 array in meters. N is the number of samples in the current frame.

  • 'Velocity' –– Velocity measurement of the sensor body in the local NED coordinate system specified as a real finite N-by-3 array in meters per second. N is the number of samples in the current frame.

  • 'Orientation' –– Orientation measurement of the sensor body with respect to the local NED coordinate system specified as a quaternion N-element column vector or a single or double 3-by-3-by-N rotation matrix. Each quaternion or rotation matrix is a frame rotation from the local NED coordinate system to the current sensor body coordinate system. N is the number of samples in the current frame.

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

stepRun System object algorithm
releaseRelease resources and allow changes to System object property values and input characteristics
resetReset internal states of System object

Extended Capabilities