Skip to content

Latest commit

 

History

History
81 lines (76 loc) · 4.64 KB

vpview_gui_introduction.md

File metadata and controls

81 lines (76 loc) · 4.64 KB
Raw

General GUI Notes

There are a number of GUIs in the system. As part of the VIVIA package, the vpView and vsPlay GUIs are useful for displaying detections, their respective probabilities, and for making new annotations in video. There are additionally simpler GUIs which can be enabled in .pipe files that are a part of KWIVER. For examples on how to run both of these GUIs see the "visualizing_detections_in_gui" example folder.

vpView GUI Notes

vpView does not open videos directory, but instead open prj files containing a pointer to any imagery and detections we want to load. Listed below are the parameters available in the vpView prj file:

Note: The list is not complete, but currently focusing on the most used (and new) parameters

  • DataSetSpecifier = filename(or glob)
    Filename with list of images for each frame or glob for sequence of images
  • TracksFile = filename
    Filename containing the tracks data.
  • TrackPVOsFile = filename
    Specifies (PVO or TOT) file containing track classification data in the ASCII format
    where each line contains 'track-id fish-probability scallop-probability other-probability'.
  • TrackColorOverride = r g b
    rgb color, specified from 0 to 1, overrides the default vpView track color for this project only
  • ColorMultiplier = x
    Event and track colors are scaled by the indicated value. Can be used in conjunction with the TrackColorOverride
  • EventsFile = filename
    Filename containing the events data.
  • ActivitiesFile = filename
    Filename containing the activity data.
  • SceneElementsFile= filename
    Filename containing the scene elements (in json file).
  • AnalysisDimensions = W H
    Dimension (in pixel/image coordinates) of AOI. Ignored when using a mode that leverages image corner points for imagetransformation.
  • OverviewOrigin = U V
    Offset of image data such that "0, 0" occurs at the AOI origin. Should always be negative #'s. Like AnalysisDimensions, unused when image corner points are used.
  • AOIUpperLeftLatLon = lat lon
    Required for "Translate image" mode of corner point usage (Tools->Configure->Display); also required for displaying an AOI when the source imagery isn't ortho-stabilized
  • AOIUpperRightLatLon = lat lon
  • AOILowerLeftLatLon = lat lon
  • AOILowerRightLatLon = lat lon
    If the UpperLeft and LowerRight are specified, an AOI "box" can be displayed. Depending on the nature of the homography controlling image display / transformation, additional corner point may improve the designation of the region.
  • FrameNumberOffset = N
    Positive value to offset imagery relative to the track/event data. A value of 3 would mean that the 1st image would correspond to track frame 2 (0-based numbering)
  • ImageTimeMapFile = filename
    Specifies file containing map of "filename timestamp (in seconds)" one line per frame. The file can be created via File->Export Image Time Stamps
  • HomographyIndexFile = filename
    Specifies file containing frame number/timestamp/homography sequence for all frames specified by the DataSetSpecifier. If the tag is set and the number of homographies match the image source count, the "Image-loc"'s of the tracks (not the "Img-bbox") are stored in coordinate frame mapped to by the homographies. This enables track trails during playback (for source imagery that isn't stored in stabilized form)
  • HomographyReferenceFrame = frame index
    Specifies the frame to use as the reference homography frame for stabilizing the video (if homographies are present). If, instead of stabilizing the video, the homographies should be used to stabilize the tracks, set the HomographyReferenceFrame to -1 (defaults to 0).
  • FiltersFile = filename (note, support not yet in master)
    Specifies file containing definitions of spatial filters for the project. The coordinate system (lat/lon or image/pixels) must be consistent between states when the filters are saved versus when the project / filter file is loaded.
  • IgnoreImageCoords = true/false (note, support not yet in master)
    In the world mode, ignores the image bounding box data and shows a head (point/dot) at the end of the track tail. This parameter only affects the track head and not the tail.
  • ColorWindow = W (defaults to 255)
    Window / range of input color values that will be mapped. The value gives the total range, not the distance from the median.
  • ColorLevel = L (defaults to 127)
    Input color value that will be mapped to the median output value, and also serves as the median value of the input color range.