PositionVelocityModel

Position and velocity measurement model

Since R2025a

expand all in page

    Description

    An PositionVelocityModel object contains a measurement model that measures the position and velocity of the target in the defined reference frame. The measurement convention is: measurement = [position;velocity]. You can use this model to define the measurement model for a CustomSensor object.

    Creation

    To create an PositionVelocityModel object, use the sensorMeasurementModel function with the "position-velocity" input argument. For example:

    measurementModel = sensorMeasurementModel("position-velocity")

    Properties

    expand all

    Measurement dimensions, specified as a 1, 2, or 3. This property specifies if the measurement is in 1-D, 2-D or 3-D.

    Example: 2

    Position of the sensor with respect to the target state reference frame, specified as a M-by-1 real column vector or a M-by-N real matrix. M must be the same as the value specified in the NumMeasurementDimensions property. Units are in meters.

    • When specified as a M-by-1 real column vector, the OriginPosition takes the form [x;y;z].

    • When specified as a M-by-N real matrix, the OriginPosition represents sequential frames. For example, if the sensor is mounted on a tower, and you know both the sensor's mounting position relative to the tower and the tower's position relative to the target frame, you can specify OriginPosition as [sensorMounting towerPosition], where sensorMounting is the sensor's mounting position relative to the tower and towerPosition is the tower's position relative to the target state's reference frame. The number of the frame, N, must be consistent across the OriginPosition and Orientation properties.

    Example: [15 20 40]

    Velocity of the sensor reference frame with respect to the target state reference frame, specified as a M-by-1 real column vector or a M-by-N real matrix. M must be the same as the value specified in the NumMeasurementDimensions property. Units are in meters.

    • When specified as a M-by-1 real column vector, the OriginVelocity takes the form [vx;vy;vz].

    • When specified as a M-by-N real matrix, the OriginVelocity represents sequential frames. For example, if the sensor is mounted on a plane but can move independently of the plane, and you know both the sensor's velocity relative to the plane and the plane's velocity relative to the target frame, you can specify OriginVelocity as [sensorMountingVelocity planeVelocity], where sensorMountingVelocity is the sensor's velocity relative to the plane and planeVelocity is the plane's velocity relative to the target state's reference frame. The number of the frame, N, must be consistent across the OriginPosition, Orientation and OriginVelocity properties.

    Example: [0 1 0]

    Orientation of the sensor with respect to the target state reference frame, specified as a M-by-M real matrix or a M-by-M-by-N real matrix. M must be the same as the value specified in the NumMeasurementDimensions property. Units are in degrees.

    • When specified as a M-by-M real matrix, the Orientation represents the sensor's orientation relative to the target state reference frame.

    • When specified as a M-by-M-by-N real matrix, the Orientation represents sequential frames. For example, if the sensor is mounted on a tower, and you know both the sensor's mounting orientation relative to the tower and the tower's orientation relative to the target frame, you can specify Orientation as cat(3,sensorMountingOrientation,towerOrientation), where sensorMountingOrientation is the sensor's orientation relative to the tower and towerOrientation is the tower's orientation relative to the target state's reference frame. The number of the frame, N, must be consistent across the OriginPosition and Orientation properties.

    Variance of error in position measurement, specified as a real-valued M-by-M matrix. M must be the same as the value specified in the NumMeasurementDimensions property.

    Example: 5*eye(3)

    Variance of error in the velocity measurement, specified as a real-valued M-by-M matrix. M must be the same as the value specified in the NumMeasurementDimensions property.

    Example: 3*eye(3)

    Version History

    Introduced in R2025a

    See Also

    Functions

    Objects