...
Table of Contents | ||
---|---|---|
|
Overview
Location sets may be used to define logical groups of locations. Often an action may need to be taken on a whole set of locations (e.g. validation). By creating a LocationSet the action need only be defined once on a location set and not on individual locations. Any location may appear in more than one location set. Internally a location set is simply evaluated as a list of locations.
The location set configuration file is included in the RegionConfigFiles\ folder: LocationSets.xml
...
Shape file, GeoJSON file and CSV file
It is possible to define locationSets with locations that are automatically generated (so NOT defined in the locations.xml) from an ESRI Shape (dbf) file, geoJSON file or from a CSV table. See all detailed information at the the next page
Database Table
It is also possible to define locationSets with locations that are read directly from a database. The contents of the database table are on the fly read and converted to a DBZ file. This DBZ file will be used by FEWS. This is for backup purpose in case the database is not available any more, like in stand-alone test environments. See all detailed information at the next page
LocationSet XML file elements
locationSet
Root element for the definition of a location set. Multiple entries may exist. The Id of the location set must be unique.
...
This element can be used to generate multiple locationsets from location attributes; these are normally invluded for locations in dbf or CSV files. In the example below a locationSet is created Warrington_Fluvial_Catchments_PDM from locationSet UK_Fluvial_Catchments_PDM where the location attribute Centre contains Warrington. By using the subLocationSetIdFunction, multiple locationSets are generated as well for all river_segments that can be found in the locationattribute @River_Segment@.
Code Block | ||||
---|---|---|---|---|
| ||||
<locationSet id="Warrington_Fluvial_Catchments_PDM"> <subLocationSetIdFunction>@River_Segment@_Warrington_Model_PDM</subLocationSetIdFunction> <locationSetId>UK_Fluvial_Catchments_PDM</locationSetId> <constraints> <attributeTextContains id="Centre" contains="Warrington"/> </constraints> </locationSet> |
...
LocationId | Name | River_Segment |
---|---|---|
713119 713120 67008 67015 67021 | Harrison Street PDM Ewood Blackburn PDM Pont Y Capel PDM Manley Hall PDM Lea Hall PDM | Darwen Darwen Dee_ISIS Dee_ISIS Dee_ISIS |
Note that sublocationsets can not be added to other locationsets. So it is adviced to create an overarching locationset (like UK_Fluvial_Catchments_PDM) from which sublocationsets are created by the function.
...
It is possible to define a label that is presented in the map. For more information, see Explorer.
LocationSets and Tabular Config File Display
For new functionality in the Tabular Config Files Display, the locationSets have been extended with functionality to display column headers and check meta data in CSV/DBF files. The configuration of these elements can be found in the Tabular Config Files Display WIKI page.
- 20 Tabular Config Files Display#20TabularConfigFilesDisplay-ConfigureMetaDataColumnHeaders
- 20 Tabular Config Files Display#20TabularConfigFilesDisplay-ConfigureMetaDataRules