Difference between revisions of "CAMERA Meta-Data Visualization"

From Immersive Visualization Lab Wiki
Jump to: navigation, search
 
(15 intermediate revisions by one user not shown)
Line 6: Line 6:
 
= Getting Started =
 
= Getting Started =
 
1. Run OpenCOVER.
 
1. Run OpenCOVER.
 +
  
 
2. Select 'CAMERAVis' from the COVER menu (opens CAMERAVis menu)
 
2. Select 'CAMERAVis' from the COVER menu (opens CAMERAVis menu)
 +
 +
[[Image: CAMERAVisMenu.png]]
 +
  
 
3. Select 'Enable' from the CAMERAVis menu.
 
3. Select 'Enable' from the CAMERAVis menu.
 +
 +
[[Image: ResetPoints.png]]
  
 
Sample Sites (herein 'data points') are initially displayed as white, uniformly-sized spheres.
 
Sample Sites (herein 'data points') are initially displayed as white, uniformly-sized spheres.
 +
 +
 +
 +
= Quick Guide =
 +
1. Display Size, Color, and Shape to manipulate the data point. Representations explained in the legend.
 +
 +
2. Mouse-over/intersect a data point to get its location name and values for any parameters displayed.
 +
 +
3. Click on a data point to get all of the metadata available for the point.
 +
 +
4. Similar Values: select a parameter and a range, select a data point for comparison, distinguishes all relative points.
 +
 +
5. Statistics: select points for statistics, displays calculations/commonalities of all points selected.
  
  
Line 20: Line 39:
 
== Size ==
 
== Size ==
 
1. Select 'Display Size' from the CAMERAVis menu (opens Display Size menu).
 
1. Select 'Display Size' from the CAMERAVis menu (opens Display Size menu).
 +
 +
[[Image: DisplaySizeMenu.png]]
 +
  
 
2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, or Size Fraction, ).  
 
2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, or Size Fraction, ).  
 +
 +
[[Image: SizeScreenshot.png]]
  
 
The data points will change in size (radius of sphere, height of cone/cylinder/box) according to the value of the selected parameter. Lower values correspond to smaller-sized data points; higher values correspond to larger-sized data points. This is explained on screen in the legend.
 
The data points will change in size (radius of sphere, height of cone/cylinder/box) according to the value of the selected parameter. Lower values correspond to smaller-sized data points; higher values correspond to larger-sized data points. This is explained on screen in the legend.
 +
  
 
3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the size will vary.  
 
3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the size will vary.  
 +
 +
[[Image: MinMaxDial.png]]
  
 
Data points with metadata values lower than 'Min' are all displayed as the smallest-sized; data points with metadata vales higher than 'Max' are all displayed as the largest-sized. Those data points with metadata values within the selected range will vary across a size gradient according to their metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.
 
Data points with metadata values lower than 'Min' are all displayed as the smallest-sized; data points with metadata vales higher than 'Max' are all displayed as the largest-sized. Those data points with metadata values within the selected range will vary across a size gradient according to their metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.
  
−
4. At any time, select 'No Size' from the Display Size menu to return data points to the same size.
+
 
 +
4. At any time, select 'No Size' from the Display Size menu to return all data points to the uniform size.
 +
 
  
 
== Color ==
 
== Color ==
 
1. Select 'Display Color' from the CAMERAVis menu (opens Display Color menu).
 
1. Select 'Display Color' from the CAMERAVis menu (opens Display Color menu).
 +
 +
[[Image: DisplayColorMenu.png]]
 +
  
 
2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, Size Fraction, Habitat, Geographic Location, or Country).  
 
2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, Size Fraction, Habitat, Geographic Location, or Country).  
 +
 +
[[Image: ColorCategoryScreenshot.png]]  by Category
 +
 +
 +
[[Image: ColorValueScreenshot.png]] by Value
  
 
The data points will change in color differently according to the selected parameter and the value/category. Habitat, Country, Geographic Location, and Size Fraction have different colors for each possible category. Salinity (yellow), Chlorophyll (green), Sample Depth (blue), and Water Depth (blue) run on one color across a color gradient where low metadata values are whiter and high metadata values are fuller in color. The Temperature color gradient runs from blue (low) through white to red (high). This is explained on screen in the legend.
 
The data points will change in color differently according to the selected parameter and the value/category. Habitat, Country, Geographic Location, and Size Fraction have different colors for each possible category. Salinity (yellow), Chlorophyll (green), Sample Depth (blue), and Water Depth (blue) run on one color across a color gradient where low metadata values are whiter and high metadata values are fuller in color. The Temperature color gradient runs from blue (low) through white to red (high). This is explained on screen in the legend.
 +
  
 
3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the color will vary where a color gradient is in use.  
 
3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the color will vary where a color gradient is in use.  
 +
 +
[[Image: MinMaxDial.png]]
  
 
Data points with metadata values lower than 'Min' are all displayed as the whitest in color; data points with metadata vales higher than 'Max' are all displayed as the darkest in color. Those data points with metadata values within the selected range will vary across the parameter's color gradient according to the data points' metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.
 
Data points with metadata values lower than 'Min' are all displayed as the whitest in color; data points with metadata vales higher than 'Max' are all displayed as the darkest in color. Those data points with metadata values within the selected range will vary across the parameter's color gradient according to the data points' metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.
 +
  
 
4. At any time, select 'No Color' from the Display Size menu to return data points to white.
 
4. At any time, select 'No Color' from the Display Size menu to return data points to white.
 +
  
 
== Shape ==
 
== Shape ==
 
1. Select 'Display Shape' from the CAMERAVis menu (opens Display Shape menu).
 
1. Select 'Display Shape' from the CAMERAVis menu (opens Display Shape menu).
 +
 +
[[Image: DisplayShapeMenu.png]]
 +
  
 
2. Select the parameter to display (Size Fraction, Habitat, or Geographic Location).  
 
2. Select the parameter to display (Size Fraction, Habitat, or Geographic Location).  
 +
 +
[[Image: ShapeScreenshot.png]]
  
 
The data points will change their geometric shape according to the category of the parameter. Data points will be either a box, cone, or cylinder or a sphere if there is no metadata category for that data point. The shape representation is explained on screen in the legend.
 
The data points will change their geometric shape according to the category of the parameter. Data points will be either a box, cone, or cylinder or a sphere if there is no metadata category for that data point. The shape representation is explained on screen in the legend.
  
−
4. At any time, select 'No Shape' from the Display Size menu to return data points to spheres.
+
 
 +
3. At any time, select 'No Shape' from the Display Size menu to return data points to spheres.
 +
 
  
 
== Reset Display ==
 
== Reset Display ==
 
1. Select 'Reset Display'
 
1. Select 'Reset Display'
 +
 +
[[Image: ResetPoints.png]]
  
 
Resetting the display will return all data points to white, uniformly-sized spheres.
 
Resetting the display will return all data points to white, uniformly-sized spheres.
 +
  
  
Line 64: Line 116:
 
== Legend ==
 
== Legend ==
 
Select 'Show Legend' from the CAMERAVis menu to show/hide the legend. The legend explains what the data point manipulations represent, and updates itself when any changes to the display are made. The default for 'Show Legend' is 'on' (checked).
 
Select 'Show Legend' from the CAMERAVis menu to show/hide the legend. The legend explains what the data point manipulations represent, and updates itself when any changes to the display are made. The default for 'Show Legend' is 'on' (checked).
 +
 +
[[Image: Legend.png]]
 +
  
 
== Information Window ==
 
== Information Window ==
 
Select 'Show Info Window' from the CAMERAVis menu to show/hide the information window. The information window displays all metadata available for the last data point clicked on. The default for 'Show Info Window' is 'on' (checked).
 
Select 'Show Info Window' from the CAMERAVis menu to show/hide the information window. The information window displays all metadata available for the last data point clicked on. The default for 'Show Info Window' is 'on' (checked).
 +
 +
[[Image: InfoWindow.png]]
 +
  
 
== Location Tip ==
 
== Location Tip ==
−
Select 'Show Location' from the CAMERAVis menu to show/hide the Location tip. The tip displays the location name, as well as the values/categories for any displayed parameters, of the moused-over/intersected data point.
+
1. Select 'Location Tip' from the CAMERAVis menu to open the Location Tip menu.
 +
 
 +
[[Image: ToolTipMenu.png]]
 +
 
 +
2. Select 'Show Tip' to show/hide the Location tip. The tip displays the location name, as well as the values/categories for any displayed parameters, of the moused-over/intersected data point. Select any of the additional options from the Location Tip menu to display those values as well.
 +
 
 +
[[Image: LocationTip.png]]    [[Image: NewLocationTip.png]]
 +
 
  
  
Line 77: Line 142:
 
== Similar Values Display ==
 
== Similar Values Display ==
 
1. Select 'Similar Values' from the CAMERAVis menu (opens Similar Values menu). The default is 'off' (unchecked).
 
1. Select 'Similar Values' from the CAMERAVis menu (opens Similar Values menu). The default is 'off' (unchecked).
 +
 +
[[Image: SimilarValuesMenu.png]]
 +
  
 
2. Choose (click) a data point to compare against all others.
 
2. Choose (click) a data point to compare against all others.
 +
  
 
3. Use the 'Parameter' dial to choose a parameter to look for similarities with. The default is 'No Parameter'.
 
3. Use the 'Parameter' dial to choose a parameter to look for similarities with. The default is 'No Parameter'.
 +
  
 
4. If the selected parameter is salinity, temperature, chlorophyll, sample depth, or water depth, use the 'Range' dial to choose a range for which metadata values will be close enough to that of the selected data point to be highlighted.
 
4. If the selected parameter is salinity, temperature, chlorophyll, sample depth, or water depth, use the 'Range' dial to choose a range for which metadata values will be close enough to that of the selected data point to be highlighted.
  
−
5. Select 'Show' to highlight data points with metadata values that are within range or metadata categories matching that of the selected data point. The legend will explain specifics of the display.
+
 
 +
5. Select 'Show' from the Similar Values menu to highlight data points with metadata values that are within range or metadata categories matching that of the selected data point. The legend will explain specifics of the display.
 +
 
 +
[[Image: SimilarValues.png]]
  
 
== Statistics ==
 
== Statistics ==
 
1. Select 'Statistics' from the CAMERAVis menu (Statistics window opens). The default is 'off' (unchecked).
 
1. Select 'Statistics' from the CAMERAVis menu (Statistics window opens). The default is 'off' (unchecked).
 +
 +
[[Image: StatisticsWindow.png]]
 +
  
 
2. Choose data points to be included in the Statistics window. Selected points are indicated with a translucent sphere (surrounding it if it a sphere, or at the data point's base if it is another shape).
 
2. Choose data points to be included in the Statistics window. Selected points are indicated with a translucent sphere (surrounding it if it a sphere, or at the data point's base if it is another shape).
 +
 +
[[Image: Statistics.png]]
  
 
The window will update after each newly selected point, displaying average, maximum, and minimum metadata values of the selected data points and commonalities amongst all of the selected data points. If none of the selected data points have a value for a certain parameter, the statistics are displayed as '--'.
 
The window will update after each newly selected point, displaying average, maximum, and minimum metadata values of the selected data points and commonalities amongst all of the selected data points. If none of the selected data points have a value for a certain parameter, the statistics are displayed as '--'.
 +
  
  
 
= Miscellaneous =
 
= Miscellaneous =
 
The gray data points do not contain metadata (other than location name, geographic coordinates, time, and date) and thus will not change during data point display manipulations.
 
The gray data points do not contain metadata (other than location name, geographic coordinates, time, and date) and thus will not change during data point display manipulations.
 +
 +
[[Image: GrayPoints.png]]
 +
  
 
Flying into an indistinguishable clump of data points causes points to become relatively smaller, in effect separating them apart into separate, defined data points.
 
Flying into an indistinguishable clump of data points causes points to become relatively smaller, in effect separating them apart into separate, defined data points.
 +
 +
[[Image: GalapagosClump.png]]
 +
 +
 +
Select 'Show Planet' from the CAMERAVis menu to show/hide the planet. Data points remain. Default is 'on' (checked).
 +
 +
[[Image: NoGlobePoints.png]]
 +
 +
 +
Uncheck 'Enable' from the CAMERAVis menu to remove planet, data points, and all windows.
 +
 +
 +
 +
= Config Variables =
 +
<CAMERAVis>
 +
    <GOSFile value="/home/jschulze/svn/trunk/covise/src/renderer/OpenCOVER/plugins/CAMERAVis/GOS_Metadata.txt" />
 +
    <GOSFile2 value="/home/jschulze/svn/trunk/covise/src/renderer/OpenCOVER/plugins/CAMERAVis/GOS2.txt" />
 +
    <_scaleSize value="0.03" />
 +
    <MINSIZE value="25" />
 +
    <MAXSIZE value="125" />
 +
    <windowHeight value="1200"/>
 +
    <windowWidth value="1920"/>
 +
    <shapeScale value="5" />
 +
    <recenter value="true" />
 +
    <hudScale value="0.5" />
 +
    <screenHeight value="500" />
 +
    <screenWidth value="810" />
 +
</CAMERAVis>
 +
 +
GOSFile, GOSFile2 - (address of text file) Links to the text files containing the metadata.
 +
 +
_scaleSize - (float) Determines how big the font and sample sites are. Should correspond to cover->getScale() at the optimal zoom (varies 0.03 to 1.5).
 +
 +
MINSIZE, MAXSIZE - (float) cutoffs for the size function. Those values above MAXSIZE will revert to it, and vice versa with MINSIZE(~25, ~120).
 +
 +
windowWidth, windowHeight - (float) resolution of the display (i.e. 1920, 1080).
 +
 +
shapeScale - (float) Determines how tall the shapes (cone/box/cylinder) are in comparison to spheres (~5-10).
 +
 +
recenter - (bool) make 'true' if the world's center stays in one place. Moving rotates world, scale changes size.
 +
 +
hudScale - (float) Determines the size of the HUDs (info window, legend, statistics window) in relation to the screen (i. e. 0.4 on desktop, 0.9 on C-Wall).
 +
 +
screenHeight, screenWidth - (float) the screen h/w from the config file for the environment worked in (i.e. 500, 800 on desktop)

Latest revision as of 08:58, 31 August 2007

This Wiki Page is a user-guide for the CAMERAVis Application.

Questions? Sara Richardson (serichardson@ucsd.edu)


Contents

Getting Started

1. Run OpenCOVER.


2. Select 'CAMERAVis' from the COVER menu (opens CAMERAVis menu)

CAMERAVisMenu.png


3. Select 'Enable' from the CAMERAVis menu.

ResetPoints.png

Sample Sites (herein 'data points') are initially displayed as white, uniformly-sized spheres.


Quick Guide

1. Display Size, Color, and Shape to manipulate the data point. Representations explained in the legend.

2. Mouse-over/intersect a data point to get its location name and values for any parameters displayed.

3. Click on a data point to get all of the metadata available for the point.

4. Similar Values: select a parameter and a range, select a data point for comparison, distinguishes all relative points.

5. Statistics: select points for statistics, displays calculations/commonalities of all points selected.


Data Point Manipulations

Metadata values can be displayed by varying the size, color, or shape of the data points in a multitude of combinations.

Size

1. Select 'Display Size' from the CAMERAVis menu (opens Display Size menu).

DisplaySizeMenu.png


2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, or Size Fraction, ).

SizeScreenshot.png

The data points will change in size (radius of sphere, height of cone/cylinder/box) according to the value of the selected parameter. Lower values correspond to smaller-sized data points; higher values correspond to larger-sized data points. This is explained on screen in the legend.


3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the size will vary.

MinMaxDial.png

Data points with metadata values lower than 'Min' are all displayed as the smallest-sized; data points with metadata vales higher than 'Max' are all displayed as the largest-sized. Those data points with metadata values within the selected range will vary across a size gradient according to their metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.


4. At any time, select 'No Size' from the Display Size menu to return all data points to the uniform size.


Color

1. Select 'Display Color' from the CAMERAVis menu (opens Display Color menu).

DisplayColorMenu.png


2. Select the parameter to display (Salinity, Temperature, Chlorophyll, Sample Depth, Water Depth, Size Fraction, Habitat, Geographic Location, or Country).

ColorCategoryScreenshot.png by Category


ColorValueScreenshot.png by Value

The data points will change in color differently according to the selected parameter and the value/category. Habitat, Country, Geographic Location, and Size Fraction have different colors for each possible category. Salinity (yellow), Chlorophyll (green), Sample Depth (blue), and Water Depth (blue) run on one color across a color gradient where low metadata values are whiter and high metadata values are fuller in color. The Temperature color gradient runs from blue (low) through white to red (high). This is explained on screen in the legend.


3. Use the 'Min'/'Max' dials to adjust the range of metadata values over which the color will vary where a color gradient is in use.

MinMaxDial.png

Data points with metadata values lower than 'Min' are all displayed as the whitest in color; data points with metadata vales higher than 'Max' are all displayed as the darkest in color. Those data points with metadata values within the selected range will vary across the parameter's color gradient according to the data points' metadata values. By default, the 'Min'/'Max' are initially set at values that exclude outliers.


4. At any time, select 'No Color' from the Display Size menu to return data points to white.


Shape

1. Select 'Display Shape' from the CAMERAVis menu (opens Display Shape menu).

DisplayShapeMenu.png


2. Select the parameter to display (Size Fraction, Habitat, or Geographic Location).

ShapeScreenshot.png

The data points will change their geometric shape according to the category of the parameter. Data points will be either a box, cone, or cylinder or a sphere if there is no metadata category for that data point. The shape representation is explained on screen in the legend.


3. At any time, select 'No Shape' from the Display Size menu to return data points to spheres.


Reset Display

1. Select 'Reset Display'

ResetPoints.png

Resetting the display will return all data points to white, uniformly-sized spheres.


Information Display

There are three different ways to learn generally/specifically about the information represented on the globe.

Legend

Select 'Show Legend' from the CAMERAVis menu to show/hide the legend. The legend explains what the data point manipulations represent, and updates itself when any changes to the display are made. The default for 'Show Legend' is 'on' (checked).

Legend.png


Information Window

Select 'Show Info Window' from the CAMERAVis menu to show/hide the information window. The information window displays all metadata available for the last data point clicked on. The default for 'Show Info Window' is 'on' (checked).

InfoWindow.png


Location Tip

1. Select 'Location Tip' from the CAMERAVis menu to open the Location Tip menu.

ToolTipMenu.png

2. Select 'Show Tip' to show/hide the Location tip. The tip displays the location name, as well as the values/categories for any displayed parameters, of the moused-over/intersected data point. Select any of the additional options from the Location Tip menu to display those values as well.

LocationTip.png NewLocationTip.png


Interactive Features

There are different ways to interact with the data points to compare specific sets of multiple points.

Similar Values Display

1. Select 'Similar Values' from the CAMERAVis menu (opens Similar Values menu). The default is 'off' (unchecked).

SimilarValuesMenu.png


2. Choose (click) a data point to compare against all others.


3. Use the 'Parameter' dial to choose a parameter to look for similarities with. The default is 'No Parameter'.


4. If the selected parameter is salinity, temperature, chlorophyll, sample depth, or water depth, use the 'Range' dial to choose a range for which metadata values will be close enough to that of the selected data point to be highlighted.


5. Select 'Show' from the Similar Values menu to highlight data points with metadata values that are within range or metadata categories matching that of the selected data point. The legend will explain specifics of the display.

SimilarValues.png

Statistics

1. Select 'Statistics' from the CAMERAVis menu (Statistics window opens). The default is 'off' (unchecked).

StatisticsWindow.png


2. Choose data points to be included in the Statistics window. Selected points are indicated with a translucent sphere (surrounding it if it a sphere, or at the data point's base if it is another shape).

Statistics.png

The window will update after each newly selected point, displaying average, maximum, and minimum metadata values of the selected data points and commonalities amongst all of the selected data points. If none of the selected data points have a value for a certain parameter, the statistics are displayed as '--'.


Miscellaneous

The gray data points do not contain metadata (other than location name, geographic coordinates, time, and date) and thus will not change during data point display manipulations.

GrayPoints.png


Flying into an indistinguishable clump of data points causes points to become relatively smaller, in effect separating them apart into separate, defined data points.

GalapagosClump.png


Select 'Show Planet' from the CAMERAVis menu to show/hide the planet. Data points remain. Default is 'on' (checked).

NoGlobePoints.png


Uncheck 'Enable' from the CAMERAVis menu to remove planet, data points, and all windows.


Config Variables 

<CAMERAVis>
   <GOSFile value="/home/jschulze/svn/trunk/covise/src/renderer/OpenCOVER/plugins/CAMERAVis/GOS_Metadata.txt" />
   <GOSFile2 value="/home/jschulze/svn/trunk/covise/src/renderer/OpenCOVER/plugins/CAMERAVis/GOS2.txt" />
   <_scaleSize value="0.03" />
   <MINSIZE value="25" />
   <MAXSIZE value="125" />
   <windowHeight value="1200"/>
   <windowWidth value="1920"/>
   <shapeScale value="5" />
   <recenter value="true" />
   <hudScale value="0.5" />
   <screenHeight value="500" />
   <screenWidth value="810" />
</CAMERAVis>

GOSFile, GOSFile2 - (address of text file) Links to the text files containing the metadata.

_scaleSize - (float) Determines how big the font and sample sites are. Should correspond to cover->getScale() at the optimal zoom (varies 0.03 to 1.5).

MINSIZE, MAXSIZE - (float) cutoffs for the size function. Those values above MAXSIZE will revert to it, and vice versa with MINSIZE(~25, ~120).

windowWidth, windowHeight - (float) resolution of the display (i.e. 1920, 1080).

shapeScale - (float) Determines how tall the shapes (cone/box/cylinder) are in comparison to spheres (~5-10).

recenter - (bool) make 'true' if the world's center stays in one place. Moving rotates world, scale changes size.

hudScale - (float) Determines the size of the HUDs (info window, legend, statistics window) in relation to the screen (i. e. 0.4 on desktop, 0.9 on C-Wall).

screenHeight, screenWidth - (float) the screen h/w from the config file for the environment worked in (i.e. 500, 800 on desktop)

Retrieved from "http://ivl.calit2.net/wiki/index.php?title=CAMERA_Meta-Data_Visualization&oldid=2116"