Google Earth Water Levels (XYZ Plot)

Report Name: Google Earth: Water Levels (XYZ Plot) (example:dot plot) (example:surface plot) (example:color grid)

File Name: EarthSoft.Interfaces.Google.dll

Dependencies: Saved Water Levels user report

Software: EQuIS Professional

Source: EQuIS Professional install

Language: English

Output Type: Keyhole Markup Language (*.kmz)1, 2, 3

Description: This report uses the results of a saved Water Levels user report and generates a *.kmz which displays water levels represented in a color grid, contour, dot plot, or surface plot. Prior to using this report, please review the Submission of Content Warning for Google Earth reports as well as the commercial license requirements.

Installation Instructions: This report assembly is part of the EQuIS Professional installation. No additional installation steps are necessary.

Overview:

The Places tree contains folders for each of the days on which water level measurements exist. Values from each day are interpolated using a Nearest Neighbor algorithm. The interpolated values are then displayed using a color palette ranging from blue (low) to red (high). Each color in the palette is shown as a folder, so the user can check/uncheck that folder to show/hide values in that range.

In addition to the color palette, the elevation of each point (distance from the ground) represents the relative value to other points. For example, the lower valued points are close to the ground; whereas the higher valued points are farther above the ground. This relative distance from the ground makes it possible to view a 2D contour (by reducing the tilt in Google Earth to look straight down from above) or to view a 3D surface (by increasing the tilt in Google Earth to look from the side).

This report includes data over the selected date range. Drag the time slider or press the Play button to watch the values change over time. The report provides the option to create Contours, Color grids, Dot Plots or Surface Plots.

This report is computationally intensive, and interpolates a unique grid for each date. For example, a site may have only 100 different records, but 25 different dates. In this case the report would interpolate 25 different grids, and potentially consume vast system resources.

In order for locations to appear in this report:

•DT_COORDINATE.COORD_TYPE_CODE must be like "*LAT*LONG*"

•DT_COORDINATE.IDENTIFIER MUST be "Primary".

•DT_LOCATION.LOC_TYPE must be populated.

•DT_LOCATION.SYS_LOC_CODE must be populated.

•DT_LOCATION.LOC_DESC must be populated before locations are clickable.

•The Water Levels report must have STATUS_FLAG=A in ST_REPORT.

Report Parameters

Saved Water Levels Report	Select a saved Water Levels user report
Output	Select the ouput type: Contour, Color Grid, Dot Plot, Surface Plot
Grid Size/Resolution	Select the output resolution: 50 (Standard), 100 (Fine), 150 (Super fine)
Number of Palette Steps	Enter the number of palette steps

* Selecting a higher resolution will take longer to process.

Report Output
The report output for this report is a *.kmz file that that is viewed in Google Earth.

Please also note that there are limitations to the size and complexity of KML/KMZ files supported in Google Earth. Selecting too many parameters and/or too large a date range may result the following information message:

"Report did not generate output. Please try again.Please reduce the number of parameters and/or dates to be contoured (params=P,dates=D)" where P = the number of input parameters, and D = the number of input dates.

1Using Google Earth for commercial purposes requires a commercial license from Google which must be obtained separately by the end user.

2EQuIS Google Earth reports do not require Google Earth or Google Services to generate KML files. Charts may be generated by Google Charts.

3KML is an open standard that may be read or viewed in other applications. These reports have only been tested in Google Earth.