Filter Case Document dialog

How to fill in the dialog box fields...

Fill in the dialog box fields as indicated below. You may also accept presented default values and options. Disregard grayed fields and options. When done, press OK to continue. Or press Cancel to abort. If distances specified in this dialog are to be interpreted as real world distances, a valid setup file with appropriate scaling factors must have been loaded before.

Point deviation
This group of number fields controls the handling of single point artifacts. Parameters are deviations from predicted point positions:

• Inactivate if > [m] specifies the threshold deviation for inactivation of data points.
• Restore if < [m] specifies the maximal deviation to allow for restoration of previously inactivated data points.
• Failure if > [m] specifies the threshold for residual deviations to be counted as filter failures.

Segment shift
This group of number fields controls the handling of shifted path segments. Parameters are deviations from predicted point positions:

• Inactivate if > [m] specifies the threshold shift for inactivation of path segments.
• Ignore if > [s] specifies the maximal duration that path segments may have in order to be inactivated. This parameter also specifies how data are reconstructed during point resampling. If gaps are shorter than this value, weighed inter/extrapolation is used for smooth reconstruction, else data are linearly interpolated.

Trial rejection threshold - > failures
Use this number field to specify the number of filter failures which will trigger the rejection of the entire trial. Enter 0 if you want trials never to be rejected.

Point resampling
This group of fields controls point reconstruction and the removal of redundant points:

• add if > [s] is a number field to specify the time gap between data points which is to trigger insertion of reconstructed points. Gaps between data points may arise from point rejection or from missing data. Enter 0 to turn reconstruction off.
• del if < [s] is a number field to specify the time interval between data points. If points lie closer than this time interval, they are considered redundant and removed from the data. Enter 0 to turn redundancy checking off.
• del if < [m] is an array field to specify spatial redundancy thresholds. Two numbers are expected. The first number specifies a minimal point to point distance. If points lie closer than this, they are considered redundant and removed from the data. The second number specifies the minimal distance from a straight line. If a series of points deviate less than this distance from the connecting straight line, all but the first and last are deleted. Enter 0,0 to turn both checks off. Point reconstruction is run before the redundancy filter, in order to prevent reconstruction of points that were removed because of spatial redundancy.

Report
Use this radio button field to indicate how report the outcome of the filter operation:

• none = do not create a report.
• create new = create a new scrollsheet to hold the report.
• merge = merge the report into the topmost scrollsheet reusing existing columns as much as possible and overwriting any previous reports. If the topmost scrollsheet contains incompatible data, a new one is created.
• chain = append the report to the topmost scrollsheet without reusing or overwriting any existing columns or rows. If the topmost scrollsheet contains incompatible data, a new one is created.

supplemental xy data
Use this range field to specify a range of supplemental data channels that are to be reconstructed using balanced inter/extrapolation like xy data of the path. Supplemental data not included in this range are reconstructed using an algorithm that strongly emphasizes interpolation over extrapolation.

trial range
Use this range field to indicate the range of trials that should be filtered. If you selected a range of trials in the active case document before invoking the command, the field will display that range as default.

Additional information...

• See the topic Filter Case Document command for basic information on the command
  and for an explanation of the Wintrack filter engine.
• The related macro statement is explained in the topic Filter Case Document statement.
• There are toolbar shortcuts to filter case documents.
• Inside case documents provides advanced information on case documents.
• Inside scrollsheets provides advanced information on scrollsheets.
• See Creating and using macros to learn how to use and create macros.
• Keyboard Shortcuts gives an overview on keyboard shortcuts.
• Using the Wintrack toolbar gives an overview of toolbar shortcuts.