target_assignment.user: Target assignment (whole track method) - DO NOT DIRECTLY CALL...

In battleVerse/nautilus: Automated track-to-truth assignment for sensor performance analysis

Target assignment (whole track method) - DO NOT DIRECTLY CALL THIS FUNCTION

Description

This function IS NOT intended to be called by the user. The user is supposed to call target_assignment(method = 'user') to access this function.

This function assigns every sensor point to a single target using the whole track method, which assigns every point in an entire track to a single target. target.assignment.track() takes the output of target_track_distance() which had previously calculated the location error (difference between sensor point and target) for each sensor point compared to each target. This function takes the mean location error for each track by grouping by track number and target and calculating the mean location error. It then assigns a single track to the closest target (minimum of locationError) while the rest are discarded.

A sensor point is then determined to be a false track (isFalseTrack = TRUE) if one of several possible cutoffs is exceeded. See get_isFalseTrack() for details.

This function is not intended to be used as a stand-alone function, but rather as a part of the call to target_assignment().

Usage

target_assignment.user(assignmentData, userAssignedVector)

Arguments

assignmentData	the output of target_assignment()
userAssignedVector	a vector of values with the names of targets each point will be assigned to. Must be the same length as the number of observations in assignmentData

Value

A data frame with the same number of observations as the sensor data that was originally passed to target_track_distance(). Each sensor point in the original data set has been assigned to a target using the method specified by the user, and the output data provides the following summary statistics:

• lonError: difference in longitude between the sensor point and assigned target at the time of the sensor point

• latError: difference in latitude between the sensor point and assigned target at the time of the sensor point

• altError: difference in altitude between the sensor point and assigned target at the time of the sensor point

• bearingToTarget: bearing (azimuth) to target from ownship at the time of the sensor point

• trackNum: the track number associated with this sensor data point

• tgtAssigned: the ID of the target assigned to this sensor point

• locationError: distance between sensor point and target at the given time

• pointIndex: index referring to which of the original sensor data points this target-track pair refers. Necessary for comparisons in target_assignment()

• time: the time that this sensor point was recorded

• bearingError: difference in bearing between the sensor point and target at the time of the sensor point

• downrangeError: difference in range to ownship between the sensor point and target

• lon: longitude of the sensor point

• lat: latitude of the sensor point

• alt: altitude of the sensor point

• rangeToShip: range from target to ownship at the time of the sensor data point

• targetAspect: target aspect (as seen from ownship) at the time of the sensor data point

• meanLocationError: (only in square and gauss window methods) mean distance between sensor point and target for all of the points included in the window

• isFalseTrack: boolean indicating whether a point is outside the cutoff and therefore considered a false track

• tgtXtrack: factor expressing the truthID.trackNum interaction

• segmentNumber: an integer counting the number of times during which a single track is assigned to a particular target

Examples

numPoints=dim(scenarioMaker::example1_scenario$sensorData)[1]

battleVerse/nautilus documentation built on July 16, 2024, 4:20 a.m.