SLAM Configuration

The following parameters can be used to change the configuration of the SLAM algorithm.

Parameters

Default Value

Type

Base.ProfileName

"default"

String

Position.PositioningMode

"SLAM"

String

Position.Estimator.NumKeyFrames

5

Integer

Position.Estimator.NumIMUFrames

3

Integer

Position.Estimator.TimeBudget

"18ms"

String

Position.Frontend.NumKeypoints

100

Integer

Position.Frontend.MaxDepthUncertaintyRatio

?

Float

Position.Frontend.RadiusANMS

17

Integer

Position.Frontend.TrackingOnPlane.DoTrackingOnPlane

false

Boolean

Position.MultiSession.GBAUseInertialFactors

false

Boolean

Display Name

The ProfileName field changes the Preset Name displayed on the SLAMcore Visualiser information panel.

_images/visualiser_preset.png

Fig. 17 SLAMcore Visualiser - Display name of the preset

Positioning Mode

Changes the positioning mode of the SLAMcore software between "SLAM" or "ODOMETRY_ONLY".

  • PositioningMode
    • Type: String

    • Default: “SLAM”

    • Description: Changes the positioning mode of the SLAMcore software.

    • Options:
      • "SLAM" (Default)

        Run in visual-inertial SLAM mode. The algorithm will be able to relocalise or close loops when visiting an area it has visited before. In this mode of operation the algorithm will be able to correct any drift accumulated over time and will be more accurate overall.

      • "ODOMETRY_ONLY"

        Run in visual-inertial odometry mode. During this mode of operation, the algorithm will not relocalise or close any loops, thus there will be no jumps in the pose estimation. However, the global pose estimation may drift more over time.

Estimator Parameters

  • NumKeyFrames
    • Type: Integer

    • Default: 5

    • Description: Specifies the number of keyframes in the local sliding window optimiser.

  • NumIMUFrames
    • Type: Integer

    • Default: 3

    • Description: Specifies the number of frames linked by the most recent non-linear IMU error terms in the local sliding window optimiser.

  • TimeBudget
    • Type: String

    • Default: “18ms”

    • Description: Specifies maximum allowed time of optimisation [ms]

Frontend Parameters

  • NumKeypoints
    • Type: Integer

    • Default: 100

    • Description: Specifies the maximum number of keypoints that the SLAM algorithm is instructed to detect in each frame. The more features the algorithm detects, the more it will be able to track, and the more accurate the overall pose estimation will be. Note that by increasing the number of keypoints the processing time required for each frame also goes up.

  • MaxDepthUncertaintyRatio
    • Type: Float

    • Default: 0.3

    • Description: Specifies the coefficient of variation of the depth measurement, or the ratio of the standard deviation of the depth measurement to the mean of the measurement. Increasing the maximum allowed ratio allows detection of more features far away from the camera.

  • RadiusANMS
    • Type: Integer

    • Default: 17

    • Description: Specifies the suppression radius (in pixels) of interest points extracted from each image of the adaptive non-maximal suppression (ANMS) interest point selection strategy.

  • DoTrackingOnPlane
    • Type: Boolean

    • Default: false

    • Description: Set to true to enable detection of a single dominant ground plane.

Multisession Parameters

  • GBAUseInertialFactors
    • Type: Boolean

    • Default: false

    • Description: Set to true to enable the use of inertial factors during GBA for multisession, to constrain the orientation relative to the gravity direction.