crop

Crop data from sensor data object

Since R2024b

Syntax

crop(sensorDataObj,startTime,endTime)

sensorDataCropped = crop(sensorDataObj,startTime,endTime)

Description

crop(sensorDataObj,startTime,endTime) crops data from the sensor data object to the time interval from the specified start time startTime to the specified end time endTime, and updates the sensor data object sensorDataObj.

sensorDataCropped = crop(sensorDataObj,startTime,endTime) crops data from the input sensor data object sensorDataObj to the time interval from the specified start time startTime to the specified end time endTime, and returns a new cropped sensor data object sensorDataCropped. This syntax does not update the input sensor data object sensorDataObj.

Note

This function requires the Scenario Builder for Automated Driving Toolbox™ support package. You can install the Scenario Builder for Automated Driving Toolbox support package from the Add-On Explorer. For more information about installing add-ons, see Get and Manage Add-Ons.

Examples

Crop Data from GPS Data Object

Load recorded GPS data into the workspace.

load("recordedGPSData.mat")

Initialize a GPSData object using information from the loaded GPS data.

gpsData = scenariobuilder.GPSData(timestamps,latitudes,longitudes,altitudes)

gpsData = 
  GPSData with properties:

          Name: ''

    NumSamples: 392
      Duration: 19.5498
    SampleRate: 20.0513
    SampleTime: 0.0500
    Timestamps: [392×1 double]

      Latitude: [392×1 single]
     Longitude: [392×1 single]
      Altitude: [392×1 single]

    Attributes: []

Specify a start time and end time to which to crop data.

startTime = gpsData.Timestamps(100);
endTime = gpsData.Timestamps(200);

Crop the data of the GPS data object.

crop(gpsData,startTime,endTime)

Display the cropped GPS data.

disp(gpsData)

  GPSData with properties:

          Name: ''

    NumSamples: 101
      Duration: 5.0006
    SampleRate: 20.1975
    SampleTime: 0.0500
    Timestamps: [101×1 double]

      Latitude: [101×1 single]
     Longitude: [101×1 single]
      Altitude: [101×1 single]

    Attributes: []

Crop Data from Trajectory Object

Load recorded GPS data into the workspace.

load("recordedGPSData.mat","X","Y","Z","timestamps")

Create a Trajectory object by using the loaded timestamps and xyz-coordinates.

traj = scenariobuilder.Trajectory(timestamps,X,Y,Z)

traj = 
  Trajectory with properties:

               Name: ''

         NumSamples: 392
           Duration: 19.5498
         SampleRate: 20.0513
         SampleTime: 0.0500
         Timestamps: [392×1 double]

           Position: [392×3 double]
        Orientation: [392×3 double]
           Velocity: [392×3 double]
             Course: [392×1 double]
        GroundSpeed: [392×1 double]
       Acceleration: [392×3 double]
    AngularVelocity: [392×3 double]

        LocalOrigin: [0 0 0]
         TimeOrigin: 0

         Attributes: []

Plot the trajectory.

plot(traj)

Specify a start time and end time to which to crop data.

startTime = traj.Timestamps(100);
endTime = traj.Timestamps(200);

Crop the data of the trajectory object.

trajCropped = crop(traj,startTime,endTime)

trajCropped = 
  Trajectory with properties:

               Name: ''

         NumSamples: 101
           Duration: 5.0006
         SampleRate: 20.1975
         SampleTime: 0.0500
         Timestamps: [101×1 double]

           Position: [101×3 double]
        Orientation: [101×3 double]
           Velocity: [101×3 double]
             Course: [101×1 double]
        GroundSpeed: [101×1 double]
       Acceleration: [101×3 double]
    AngularVelocity: [101×3 double]

        LocalOrigin: [0 0 0]
         TimeOrigin: 0

         Attributes: []

Plot the cropped trajectory.

plot(trajCropped)

Input Arguments

sensorDataObj — Sensor data

GPSData object | Trajectory object | CameraData object | LidarData object | ActorTrackData object

Sensor data, specified as a GPSData object, Trajectory object, CameraData object, LidarData object, or an ActorTrackData object.

startTime — Start time to which to crop sensor data

nonnegative scalar | datetime scalar | duration scalar

Start time to which to crop sensor data, specified as a nonnegative scalar, a datetime scalar, or a duration scalar. The data type of the startTime value and the data type of the Timestamps property of the input sensor data object sensorDataObj must be the same. If you specify a nonnegative scalar, units must be in seconds.

The function crops the sensor data to the time interval from the specified start time startTime to the specified end time endTime.

Data Types: single | double | uint8 | uint16 | uint32 | uint64

endTime — End time to which to crop sensor data

positive scalar | datetime scalar | duration scalar

End time to which to crop sensor data, specified as a positive scalar, a datetime scalar, or a duration scalar. The data type of the endTime value and the data type of the Timestamps property of the input sensor data object sensorDataObj must be the same. If you specify a positive scalar, units must be in seconds.

The function crops the sensor data to the time interval from the specified start time startTime to the specified end time endTime.

Data Types: single | double | uint8 | uint16 | uint32 | uint64

Output Arguments

sensorDataCropped — Cropped sensor data

GPSData object | Trajectory object | CameraData object | LidarData object | ActorTrackData object

Cropped sensor data, returned as a GPSData object, Trajectory object, CameraData object, LidarData object, or an ActorTrackData object.

Version History

Introduced in R2024b