loadimupart

R2026b

Load parameterized IMU hardware part

Since R2026b

collapse all in page

Syntax

imu = loadimupart(collectionID,manufacturer,partNumber,operatingMode)
imu = loadimupart(___,DatasetVersion=version)

Description

The loadimupart function returns an imuSensor System object™ preconfigured with parameters from a real IMU hardware datasheet. Use this function to simulate the behavior of a specific commercial IMU part without manually setting sensor noise, bias, and measurement range properties.

The "MW.IMU" collection includes the following IMU hardware parts. Use tab completion to identify available operating modes for each part.

ManufacturerPart Number
"STMicroelectronics""ISM330IS"
"TDKInvenSense""ICM-20948"

imu = loadimupart(collectionID,manufacturer,partNumber,operatingMode) returns a parameterized imuSensor System object corresponding to the IMU hardware part matching the specified collection, manufacturer, part number, and operating mode.

Note

The available IMU hardware parts depend on the installed dataset version. Before loading IMU parts, ensure that the IMU hardware part datasets are installed using the installimuparts function.

example

imu = loadimupart(___,DatasetVersion=version) specifies the dataset version to load for the specified IMU part.

Examples

collapse all

Open Live Script

Before loading from the MathWorks IMU collection, run installimuparts if you have not already done so for your current MATLAB® installation. Rerun it only to update the collection.

installimuparts

Load the ISM330IS IMU from STMicroelectronics in the MathWorks® IMU collection using the "accel-range:16g|gyro-range:1000dps" operating mode. You can use tab complete to see all available operating modes for an IMU part.

imu = loadimupart("MW.IMU","STMicroelectronics","ISM330IS","accel-range:16g|gyro-range:1000dps")
imu = 
  imuSensor with properties:

          IMUType: 'accel-gyro-mag'
       SampleRate: 100
      Temperature: 25
    MagneticField: [27.5550 -2.4169 -16.0849]
    Accelerometer: [1×1 accelparams]
        Gyroscope: [1×1 gyroparams]
     Magnetometer: [1×1 magparams]
     RandomStream: 'Global stream'

Input Arguments

collapse all

IMU part collection, specified as a string scalar or character vector.

Use tab completion to identify collections available with the current MATLAB® version.

Example: "MW.IMU" specifies the MathWorks® IMU dataset collection provided by Navigation Toolbox™.

Data Types: char | string

IMU part manufacturer, specified as a string scalar or character vector.

Use tab completion to identify manufacturers available in the specified collection.

Example: "STMicroelectronics" specifies a manufacturer available in the "MW.IMU" collection.

Example: "TDKInvenSense" specifies a manufacturer available in the "MW.IMU" collection.

Data Types: char | string

IMU part number, specified as a string scalar or character vector.

Use tab completion to identify part numbers available for the specified manufacturer.

Example: "ISM330IS" specifies an IMU part available from the "STMicroelectronics" manufacturer.

Example: "ICM-20948" specifies an IMU part available from the "TDKInvenSense" manufacturer.

Data Types: char | string

IMU operating mode, specified as a string scalar or character vector.

The operating mode identifies a predefined hardware configuration for the specified IMU part number, corresponding to a datasheet‑defined combination of settings such as measurement range and performance characteristics. Use tab completion to identify operating modes available for the specified part number.

Example: "accel-range:16g|gyro-range:1000dps" specifies a predefined operating mode from the datasheet of the "ISM330IS" IMU part.

Data Types: char | string

Dataset version to load for the IMU part, specified as a string scalar, character vector, or "latest". Specifying "latest" loads the latest version available with the current MATLAB version.

Example: DatasetVersion="1.0.0"

Data Types: char | string

Output Arguments

collapse all

IMU part, returned as an imuSensor System object with properties set using IMU hardware specifications derived from the part datasheet. Properties not specified by the manufacturer are set to default values.

Version History

Introduced in R2026b

See Also

|

Topics