The grid display is used in DELFT-FEWS for viewing grid time series. These grid time series can be dynamically animated against a map background (comparable to the main map display).
The Id of the grid display is identified in the DisplayInstanceDescriptors. When available on the file system, the name of the XML file for configuring the GridDisplay with an Id of FloodMapDisplay is for example:
FloodMapDisplay 1.00 default.xml
FloodMapDisplay |
File name for the Flood Map display configuration |
1.00 |
Version number |
default |
Flag to indicate the version is the default configuration (otherwise omitted). |
Figure 143 Example of a configuration of the Grid Display
Besides plotting a grid in the grid display, it is also possible to plot scalar data (Figure 10) and longitudinal profiles (figure 9).
Figure 010 Example of a configuration of the scalar data in Grid Display
Figure 009 Example of a configuration of the longprofile in Grid Display
Figure 144 Root elements of the gridDisplay configuration
Name of the Grid Display. When opened this will appear in the title bar of the window.
Definition of a group in the grid display. Each group may have its own set of maps and time series to display. Defining groups creates a tree view in the left of the display (see example above). Multiple instances may exist.
Attributes;
Optional description of the display group/grid plot. Used for reference purposes only
Optional property to highlight the Group name in bold in the selection filter.
Definition of a grid plot within the display group. Each grid plot forms a node in the tree view. When a gridPlot is selected, the appropriate maps will be displayed and the time series data retrieved from the database.
Attributes;
Definition of the time series set to be displayed in the selected grid plot. This can refer to one location with valuetype grid or longitudinal profile, or it can refer to a locationSet of scalars. Contourlines can only be displayed in combination with a regular grid.
Definition of colours to use in displaying the dynamic grid. These are also shown in the legend on the left of the grid display (see example above).
Definition of the maps used as a background to the dynamic grid displayed. The layout and zoom extent are also defined in this element.
Figure 145 Elements of the configuration of class breaks
Optional description of the configuration. Used for reference purposes only.
Not implemented yet.
Not implemented yet.
When this is true the display unit for the class break values will be displayed in the legend. Default is false. The display unit can be configured in parameter group.
Definition of the optional ordinal value that will always keep the same colour when the class break colours are rescaled in the grid display. After rescaling, the highest lowerValue will be changed to the maximum grid value visible in the current zoom extent and the lowest lowerValue will be changed to the minimum grid value visible in the current zoom extent. The lowerValues and the colours in between will be rearranged to fit between the minimum and maximum. Thus the colours for given values change.
If no ordinal value is specified, then the colours are just rearranged. However, if e.g. ordinal value = 0 is specified and 0 values have a white colour, then the rescaling will take this into account so that 0 values always stay coloured white. This can be used for instance when displaying temperatures, where red colours are used for positive values and blue colours are used for negative values and zero values are coloured white.
Colour definition for the colour in the legend associated with the lowest value in the range.
Colour definition for the colour in the legend associated with the highest value in the range.
Optional definition of the opaqueness of the colour in the legend associated with the lowest value in the range.
Optional definition of the opaqueness of the colour in the legend associated with the highest value in the range.
Optional definition of the size of symbols associated with the lowest value in the range.
Optional definition of the size of symbols associated with the highest value in the range.
Definition of the value at which the colour in the grid displayed changes. The legend will be a gradual change in colours from the lowest colour to the highest colour, with the number of increments determined by the number of lowerValue items entered. Multiple entries may exist.
Deprecated, use break.
The options described above can be used for definitions of lowerValues that have colors that change gradually between a lowerColor and upperColor. The break option can be used instead for specifying a discrete lowerValue with an absolute color, symbolSize and opaquenessPercentage. Multiple entries may exist.
The background maps to be displayed are defined in the geoMap element. This is an XML implementation of the OpenMap configuration described also in Appendix C for configuring the main map display (in time this will also be done using the geoMap element).
Figure 146 Elements of the geoMap configuration
The more advanced options are described below. Rather straightforward options like northArrowVisible are self explaining.
Optional description of the configuration. Used for reference purposes only.
Root element for the definition of a zoom extent. The extents defined will appear in a drop down list in the grid display.
Coordinate system the extents are defined in. Enumeration of available coordinate systems is available in Appendix B.
Definition of the default zoom extent.
Attributes;
Definition of the additional zoom extents. Multiple entries may exist.
Attributes;
Coordinates of the zoom extent. Note that in displaying the maps for the extent defined, the map display will be scaled to fit the extent in the current display window.
Notice that you need to specify a mapLayersCacheDir in the global.properties, like mapLayersCacheDir=%REGION_HOME%/MapCache
Notice that you need to specify a mapLayersCacheDir in the global.properties, like mapLayersCacheDir=%REGION_HOME%/MapCache
To make use of a Wfs or ArSDE connection you have to use the option for serverShapeLayer.
In this section the location of the background shape file can be defined.
An example of the various options, that can be completely mixed is shown in the below picture.
Definition of a GIS layer to be displayed.
Attributes;
Optional description of the map layer. Used for reference purposes only.
Name of the class used in displaying the map layer. A different class is required for different types of GIS data.
NOTE: Defining a class name allows advanced users to add additional display functionality to the OpenMap utility, and this being used in map displays in DELFT-FEWS. See the OpenMap documentation for details on how to add additional display classes.
Boolean flag indicating if layer is visible by default.
Definition of properties associated with the map layer to be displayed. Properties that need to be defined depend on the class used. At least one property must be defined. This may be a dummy property. Multiple entries may exist.
Definition of a string property. An example is the definition of the geoDatum for displaying shape files using the geoDatumDisplay class.
Key to identify the property
Value of the property defined.
Note: when displaying a shape file layer that does not use WGS 1984 as the coordinate system, a property must be defined that defines the geo datum. To do this set the key value as "geoDatum" and define the coordinate system using the enumeration in Appendix B.
The following example shows how to configure a Meteosat image as grayScaleImage in the Grid display.
<gridPlotGroup id="Meteosat Images"> <gridPlot id="MeteoSat"> <timeSeriesSet> <moduleInstanceId>ImportMeteosat</moduleInstanceId> <valueType>grid</valueType> <parameterId>image</parameterId> <locationId>meteosat</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="minute" multiplier="15"/> <relativeViewPeriod unit="hour" start="-12" end="36"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> <classBreaks> <lowerColor>black</lowerColor> <upperColor>white</upperColor> <lowerValue>0</lowerValue> <lowerValue>8</lowerValue> <lowerValue>16</lowerValue> <lowerValue>24</lowerValue> <lowerValue>32</lowerValue> <lowerValue>40</lowerValue> <lowerValue>48</lowerValue> <lowerValue>56</lowerValue> <lowerValue>64</lowerValue> <lowerValue>72</lowerValue> <lowerValue>80</lowerValue> <lowerValue>88</lowerValue> <lowerValue>96</lowerValue> <lowerValue>104</lowerValue> <lowerValue>112</lowerValue> <lowerValue>120</lowerValue> <lowerValue>128</lowerValue> <lowerValue>136</lowerValue> <lowerValue>144</lowerValue> <lowerValue>152</lowerValue> <lowerValue>160</lowerValue> <lowerValue>168</lowerValue> <lowerValue>176</lowerValue> <lowerValue>184</lowerValue> <lowerValue>192</lowerValue> <lowerValue>200</lowerValue> <lowerValue>208</lowerValue> <lowerValue>216</lowerValue> <lowerValue>224</lowerValue> <lowerValue>232</lowerValue> <lowerColor>orange</lowerColor> <upperColor>red</upperColor> <lowerValue>240</lowerValue> <lowerValue>248</lowerValue> <lowerValue>255</lowerValue> </classBreaks> </gridPlot> </gridPlotGroup> |