copy

Copy lidar SLAM object

Syntax

newSlamObj = copy(slamObj)

Description

newSlamObj = copy(slamObj) creates a deep copy of slamObj with the same properties. Any changes made to newSlamObj are not reflected in slamObj.

Examples

Create Copy of Lidar SLAM

Create a lidarSLAM object.

slamObj = lidarSLAM

slamObj = 
  lidarSLAM with properties:

                  PoseGraph: [1×1 poseGraph]
              MapResolution: 20
              MaxLidarRange: 8
            OptimizationFcn: @optimizePoseGraph
       LoopClosureThreshold: 100
    LoopClosureSearchRadius: 8
     LoopClosureMaxAttempts: 1
    LoopClosureAutoRollback: 1
       OptimizationInterval: 1
          MovementThreshold: [0 0]
     ScanRegistrationMethod: 'BranchAndBound'
     TranslationSearchRange: [4 4]
        RotationSearchRange: 1.5708

Create a copy of the lidar SLAM object.

slamObjNew = copy(slamObj)

slamObjNew = 
  lidarSLAM with properties:

                  PoseGraph: [1×1 poseGraph]
              MapResolution: 20
              MaxLidarRange: 8
            OptimizationFcn: @optimizePoseGraph
       LoopClosureThreshold: 100
    LoopClosureSearchRadius: 8
     LoopClosureMaxAttempts: 1
    LoopClosureAutoRollback: 1
       OptimizationInterval: 1
          MovementThreshold: [0 0]
     ScanRegistrationMethod: 'BranchAndBound'
     TranslationSearchRange: [4 4]
        RotationSearchRange: 1.5708

Remove Loop Closures from Pose Graph in Lidar SLAM Object

Load laser scan data from a file.

load("offlineSlamData.mat");

To set up the SLAM algorithm:

1. Specify the lidar range, map resolution, loop closure threshold, and search radius.

2. Tune these parameters for your specific robot and environment.

3. Create the lidarSLAM object with these parameters.

maxLidarRange = 8;
mapResolution = 20;
slamObj = lidarSLAM(mapResolution,maxLidarRange);
slamObj.LoopClosureThreshold = 210;  
slamObj.LoopClosureSearchRadius = 8;

Add scans iteratively to the SLAM object.

for i = 1:numel(scans)
    addScan(slamObj,scans{i});
end

Create a copy of the SLAM object. Display the underlying pose graph of the SLAM object.

slamObj2 = copy(slamObj);
slamObj2.PoseGraph

ans = 
  poseGraph with properties:

               NumNodes: 71
               NumEdges: 83
    NumLoopClosureEdges: 13
     LoopClosureEdgeIDs: [31 36 63 65 67 69 71 73 75 77 79 81 83]
        LandmarkNodeIDs: [1×0 double]

Remove the first two loop closures by specifying their edge IDs.

lcEdgeIDs = slamObj2.PoseGraph.LoopClosureEdgeIDs(1:2);
removeLoopClosures(slamObj2,lcEdgeIDs)

Plot the pose graphs of the SLAM object before and after removing the loop closures.

subplot(2,1,1)
show(slamObj.PoseGraph);
subplot(2,1,2)
show(slamObj2.PoseGraph);

Input Arguments

slamObj — Lidar SLAM object

lidarSLAM object

Lidar SLAM object, specified as a lidarSLAM object. The object contains the SLAM algorithm parameters, sensor data, and underlying pose graph used to build the map.

Output Arguments

newSlamObj — Lidar SLAM object

lidarSLAM object

Lidar SLAM object, returned as a lidarSLAM object.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Use this syntax when constructing lidarSLAM objects for code generation:

slamObj= lidarSLAM(mapResolution,maxLidarRange,maxNumScans) specifies the upper bound on the number of accepted scans allowed when generating code. maxNumScans is a positive integer. This scan limit is only required when generating code.

Version History

Introduced in R2019b