Name

Track Inspector — Visually review track data sets.

Synopsis

Synopsis

	ca.spatial.tracks.checker.TrackChecker {folder1} {folder2}
      

Arguments

NameTypeDefault
folder1The name of a folder containing a track data setNone
folder2The name of a folder containing a track data set to be compared (optional)None

Description

The Track Inspector provides a quick and easy way to explore track data sets produced by the Matrix Builder.

If invoked with a single track data set, the tool will start in explore mode. This shows the list of blocks in the top pane, the track options for the selected block in the second pane, the features and products for the selected track in the third pane, and a line graph of selected features and products in the bottom pane.

Begin the exploration process by clicking in the left-most column of the block table to select a block. This will load the initial track for this block in to the track pane.

In the track pane click to select a track of interest, either the initial track or a future track resulting from a treatment option. The tracks have icons indicating if they have future treatment options, have no future options, or if they are nodes which loop back to previously occuring tracks. The track icons are colored green for managed tracks and orange for unmanaged tracks.

After selecting a track, click on a feature or product record to display the curve in the bottom charting pane. Multiple features and products may be selected simultaneously. The charting pane will show the yield curve values over time, as well as vertical grey lines indicating when successional events have occured. Hover the mouse pointer over the yield curve inflection points or on the grey succession events for more information. Right-click on the charting pane for options to save or print the charts.

The block table has the usual tools for selecting and sorting the block records. These may be used to quickly search and locate records. The block records contain fields for the block label, management status, area and initial age, as well as the stratification values from the dominant fragment of the block.

Comparison mode

Comparison mode is invoked when the tool is launched with two track folders. In this mode the tool will show the contents of the track folders side-by-side, matching the block records from each folder by the block label and management type (managed or unmanaged). In cases where the records do not match up (i.e. the matching block label does not exist in the other folder) a blank line wll be shown in the corresponding position.

Matching block records will be examined for similarity based on the values in the block records and also by a deep search of stand dynamics. The stand dynamics tests consists of comparing stratification values, yield curves, treatments and responses. Records that do not match based on block record values (age, area, management status, initial fragment composition) will be marked with a 'B'. Records that do not match based on stand dynamics will be marked with a 'T'. These marks occur in the leftmost column of the block table. Marked records will have a yellow background in the leftmost column.

The total number of differing block records will be shown on the right side of the menu bar. If differences occur the navigation buttons will become activated. The navigation buttons may be used to sequentially step through the differences.

Block level differences will be highlighted in the cells of the block table. Track differences will be highlighted with a red line around the tracks that differ. Right-click on any track node to access options to expand the track folders to show the differences, or to provide an explanation for the differences between the selected tracks. A symbol will be displayed on the Features or Products tabs to indicate differences between the two selected tracks.

As differences are examined they may be marked as 'ignored'. The tool will add the ignored difference to a list, and recalculate the set of differing blocks, skipping over those ignored elements. This provides a systematic way to progress through a large set of issues by removing resolved and duplicate elements from the list.

There are two types of differences that can be ignored. The first method is for block level differences. This is invoked by right-clicking on the leftmost column. This will remove a single block record from the set of differences. These records will show an 'I' in the leftmost column.

Track differences can also be ignored by selecting the tracks that differ and right-clicking on the track icon. All instances of where those pairs of tracks occur will be ignored, possibly resulting in multiple differences being eliminated. Track differences that are being ignored will be highlighted with an orange line.

Scrolling, sorting and selection actions on the two sets of tracks are synchronized by default. Synchronization may be disabled and enabled by clicking on the lock icon.

Processing Notes

An easy short cut to launch the Track Inspector is to drag a track folder on to the Patchworks Application Chooser. If two track folders are dragged on to the Patchworks Application Chooser then the tool will be invoked in comparison mode.

When loading the data set and computing differences the tool will search forward through the set of treatments and responses, keeping track of the number of years in to the future based on applying each treatment at the earliest operable age. The forward search will stop when the tool encounters a track that it has already visited, or when the search goes beyond a maximum search depth. The default value for the maximum search depth is 300 years, but this may be changed in the user interface. Larger search depth values may may require more processing time.

Examples

      java -jar patchworks.jar ca.spatial.tracks.checker.TrackChecker c:/Projects/C5_Sample/tracks