gyroparams

Gyroscope sensor parameters

Description

The gyroparams class creates a gyroscope sensor parameters object. You can use this object to model a gyroscope when simulating an IMU with imuSensor. See the Algorithms section of imuSensor for details of gyroparams modeling.

Creation

Syntax

params = gyroparams

params = gyroparams(Name,Value)

Description

params = gyroparams returns an ideal gyroscope sensor parameters object with default values.

params = gyroparams(Name,Value) configures gyroparams object properties using one or more Name,Value pair arguments. Name is a property name and Value is the corresponding value. Name must appear inside single quotes (''). You can specify several name-value pair arguments in any order as Name1,Value1,...,NameN,ValueN. Any unspecified properties take default values.

Properties

expand all

`MeasurementRange` — Maximum sensor reading (rad/s)
`Inf` (default) | real positive scalar

Maximum sensor reading in rad/s, specified as a real positive scalar.

Data Types: single | double

`Resolution` — Resolution of sensor measurements ((rad/s)/LSB)
`0` (default) | real nonnegative scalar

Resolution of sensor measurements in (rad/s)/LSB, specified as a real nonnegative scalar. Here, LSB is the acronym for least significant bit.

Data Types: single | double

`ConstantBias` — Constant sensor offset bias (rad/s)
`[0 0 0]` (default) | real scalar | real 3-element row vector

Constant sensor offset bias in rad/s, specified as a real scalar or 3-element row vector. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`AxesMisalignment` — Sensor axes skew (%)
`diag([100 100 100])` (default) | scalar | 3-element row vector | 3-by-3 matrix

Sensor axes skew in percentage, specified as a scalar, a 3-element row vector, or a 3-by-3 matrix. The diagonal elements of the matrix account for the misalignment effects for each axes. The off-diagonal elements account for the cross-axes misalignment effects. The measured state v_measure is obtained from the true state v_true via the misalignment matrix as:

$v_{m e a s u r e} = \frac{1}{100} M v_{t r u e} = \frac{1}{100} [\begin{matrix} m_{11} & m_{12} & m_{13} \\ m_{21} & m_{22} & m_{23} \\ m_{31} & m_{32} & m_{33} \end{matrix}] v_{t r u e}$

If you specify the property as a scalar, then all the off-diagonal elements of the matrix take the value of the specified scalar and all the diagonal elements are 100.
If you specify the property as a vector [a b c], then m₂₁ = m₃₁ = a, m₁₂ = m₃₂ = b, and m₁₃ = m₂₃ = c. All the diagonal elements are 100.

Data Types: single | double

`NoiseDensity` — Power spectral density of sensor noise ((rad/s)/√Hz)
`[0 0 0]` (default) | real scalar | real 3-element row vector

Power spectral density of sensor noise in (rad/s)/√Hz, specified as a real scalar or 3-element row vector. This property corresponds to the angle random walk (ARW). Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`BiasInstabilityCoefficients` — Filter coefficients for bias instability noise generation
`fractalcoef` (default) | structure

Filter coefficients for bias instability noise generation, specified as a structure. The structure has these fields:

Numerator — Numerator coefficients, specified as a real-valued vector.
Denominator — Denominator coefficients, specified as a real-valued vector.

To specify coefficients for fractal noise, use the fractalcoef function.

Example: struct(Numerator=1,Denominator=[1 -0.5])

Data Types: struct

`BiasInstability` — Instability of the bias offset (rad/s)
`[0 0 0]` (default) | real scalar | real 3-element row vector

Instability of the bias offset in rad/s, specified as a real scalar or 3-element row vector. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`RandomWalk` — Integrated white noise of sensor ((rad/s)(√Hz))
`[0 0 0]` (default) | real scalar | real 3-element row vector

Integrated white noise of sensor in (rad/s)(√Hz), specified as a real scalar or 3-element row vector. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`NoiseType` — Type of random noise
`"double-sided"` (default) | `"single-sided"`

Type of random noise, specified as:

"double-sided" — Random noise coefficients have a scale factor of 2.
"single-sided" — Random noise coefficients have a scale factor of 1.

Data Types: char | string

`TemperatureBias` — Sensor bias from temperature ((rad/s)/℃)
`[0 0 0]` (default) | real scalar | real 3-element row vector

Sensor bias from temperature in ((rad/s)/℃), specified as a real scalar or 3-element row vector. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`TemperatureScaleFactor` — Scale factor error from temperature (%/℃)
`[0 0 0]` (default) | real scalar in the range [0,100] | real 3-element row vector in the range [0,100]

Scale factor error from temperature in (%/℃), specified as a real scalar or 3-element row vector with values ranging from 0 to 100. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

`AccelerationBias` — Sensor bias from linear acceleration (rad/s)/(m/s²)
`[0 0 0]` (default) | real scalar | real 3-element row vector

Sensor bias from linear acceleration in (rad/s)/(m/s²), specified as a real scalar or 3-element row vector. Any scalar input is converted into a real 3-element row vector where each element has the input scalar value.

Data Types: single | double

Examples

collapse all

Generate Gyroscope Data from Stationary Inputs

Open Live Script

Generate gyroscope data for an imuSensor object from stationary inputs.

Generate a gyroscope parameter object with a maximum sensor reading of 4.363 $rad / s$ and a resolution of 1.332e-4 $(rad / s) / LSB$ . The constant offset bias is 0.349 $rad / s$ . The sensor has a power spectral density of 8.727e-4 $r a d / s / \sqrt{H z}$ . The bias from temperature is 0.349 $(rad / s^{2})$ $/^{0} C$ . The scale factor error from temperature is 0.02% $/^{0} C$ . The sensor axes are skewed by 2%. The sensor bias from linear acceleration is 0.178e-3 $(r a d / s) / (m / s^{2})$

params = gyroparams('MeasurementRange',4.363,'Resolution',1.332e-04,'ConstantBias',0.349,'NoiseDensity',8.727e-4,'TemperatureBias',0.349,'TemperatureScaleFactor',0.02,'AxesMisalignment',2,'AccelerationBias',0.178e-3);

Use a sample rate of 100 Hz spaced out over 1000 samples. Create the imuSensor object using the gyroscope parameter object.

Fs = 100;
numSamples = 1000;
t = 0:1/Fs:(numSamples-1)/Fs;

imu = imuSensor('accel-gyro','SampleRate', Fs, 'Gyroscope', params);

Generate gyroscope data from the imuSensor object.

orient = quaternion.ones(numSamples, 1);
acc = zeros(numSamples, 3);
angvel = zeros(numSamples, 3);
 
[~, gyroData] = imu(acc, angvel, orient);

Plot the resultant gyroscope data.

plot(t, gyroData)
title('Gyroscope')
xlabel('s')
ylabel('rad/s')

Figure contains an axes object. The axes object with title Gyroscope, xlabel s, ylabel rad/s contains 3 objects of type line.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2018b

expand all

R2023b: Specify bias instability noise coefficients and noise type

You can use the new BiasInstabilityCoefficients property of the gyroparams object to specify the coefficients of the transfer function used to generate the bias instability noise. Additionally, you can use the new NoiseType property of this object to set the scale factor of the noise coefficients as 1 or 2.

gyroparams

Description

Creation

Syntax

Description

Properties

MeasurementRange — Maximum sensor reading (rad/s) Inf (default) | real positive scalar

Resolution — Resolution of sensor measurements ((rad/s)/LSB) 0 (default) | real nonnegative scalar

ConstantBias — Constant sensor offset bias (rad/s) [0 0 0] (default) | real scalar | real 3-element row vector

AxesMisalignment — Sensor axes skew (%) diag([100 100 100]) (default) | scalar | 3-element row vector | 3-by-3 matrix

NoiseDensity — Power spectral density of sensor noise ((rad/s)/√Hz) [0 0 0] (default) | real scalar | real 3-element row vector

BiasInstabilityCoefficients — Filter coefficients for bias instability noise generation fractalcoef (default) | structure

BiasInstability — Instability of the bias offset (rad/s) [0 0 0] (default) | real scalar | real 3-element row vector

RandomWalk — Integrated white noise of sensor ((rad/s)(√Hz)) [0 0 0] (default) | real scalar | real 3-element row vector

NoiseType — Type of random noise "double-sided" (default) | "single-sided"

TemperatureBias — Sensor bias from temperature ((rad/s)/℃) [0 0 0] (default) | real scalar | real 3-element row vector

TemperatureScaleFactor — Scale factor error from temperature (%/℃) [0 0 0] (default) | real scalar in the range [0,100] | real 3-element row vector in the range [0,100]

AccelerationBias — Sensor bias from linear acceleration (rad/s)/(m/s2) [0 0 0] (default) | real scalar | real 3-element row vector

Examples

Generate Gyroscope Data from Stationary Inputs

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

Version History

R2023b: Specify bias instability noise coefficients and noise type

See Also

`MeasurementRange` — Maximum sensor reading (rad/s)
`Inf` (default) | real positive scalar

`Resolution` — Resolution of sensor measurements ((rad/s)/LSB)
`0` (default) | real nonnegative scalar

`ConstantBias` — Constant sensor offset bias (rad/s)
`[0 0 0]` (default) | real scalar | real 3-element row vector

`AxesMisalignment` — Sensor axes skew (%)
`diag([100 100 100])` (default) | scalar | 3-element row vector | 3-by-3 matrix

`NoiseDensity` — Power spectral density of sensor noise ((rad/s)/√Hz)
`[0 0 0]` (default) | real scalar | real 3-element row vector

`BiasInstabilityCoefficients` — Filter coefficients for bias instability noise generation
`fractalcoef` (default) | structure

`BiasInstability` — Instability of the bias offset (rad/s)
`[0 0 0]` (default) | real scalar | real 3-element row vector

`RandomWalk` — Integrated white noise of sensor ((rad/s)(√Hz))
`[0 0 0]` (default) | real scalar | real 3-element row vector

`NoiseType` — Type of random noise
`"double-sided"` (default) | `"single-sided"`

`TemperatureBias` — Sensor bias from temperature ((rad/s)/℃)
`[0 0 0]` (default) | real scalar | real 3-element row vector

`TemperatureScaleFactor` — Scale factor error from temperature (%/℃)
`[0 0 0]` (default) | real scalar in the range [0,100] | real 3-element row vector in the range [0,100]

`AccelerationBias` — Sensor bias from linear acceleration (rad/s)/(m/s²)
`[0 0 0]` (default) | real scalar | real 3-element row vector

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.