|
|
[[_TOC_]]
|
|
|
____
|
|
|
|
|
|
|
|
|
### 2.1 Operative system
|
|
|
WHIST can be used in **Windows/64** and **Linux/64**. It might work on Mac OS but we can not give support for this.
|
|
|
____
|
|
|
|
|
|
### 2.2 Screen resolution
|
|
|
If not all tools in your WHIST set up are visible as in the figures in this wiki you can try different screen resolutions on your computer to solve the problem. Their might be screens that can not support the WHIST interface sufficiently.
|
|
|
|
|
|
____
|
|
|
|
|
|
### 2.3 JAVA - OpenJdk
|
|
|
WHIST is a [**JAVA**](https://www.java.com) based tool. From 2019 WHIST uses the [**OpenJdk**](https://git.smhi.se/whist/whist/-/wikis/WHIST-Wiki/-3.-Download-software-and-get-started) (version 12.0.2).
|
|
|
____
|
|
|
|
|
|
### 2.4 Topographic data
|
|
|
Topographic data is needed for the creation of subbasins in WHIST and the following information is mandatory:
|
|
|
* digital elevation model (DEM)
|
|
|
* flow direction (DIR)
|
|
|
* flow accumulation (ACC) or upstream area (UPA) (when the unit is number of cells we call it ACC, when the unit is m2 or km2 we call it UPA (the accumulated upstream area)).
|
|
|
|
|
|
You are able to prepare DIR and ACC/UPA from a DEM with most GIS softwares. The grids should be hydrologically corrected to not give interrupted flow paths caused by undefined sinks etc and you should therefore use some "fill" and "burn streams" tools for known drainage lines (rivers/watersheds/lakes), ridges and depressions for correcting the DEM before preparing DIR and ACC. It is more important to get the flow direction correctly than having the the exact elevation. For elevation extraction an unconditioned DEM can be used.
|
|
|
|
|
|
There are also already hydrologically corrected databases of DEM, DIR and ACC available of different quality and resolution e.g. the global databases [**Hydrosheds**](https://www.hydrosheds.org//), [**Hydro1K**](https://www.usgs.gov/centers/eros/science/usgs-eros-archive-digital-elevation-hydro1k?qt-science_center_objects=0#qt-science_center_objects), [**GWD-LR**](http://hydro.iis.u-tokyo.ac.jp/~yamadai/GWD-LR/) and its revised version [**MERIT Hydro**](http://hydro.iis.u-tokyo.ac.jp/~yamadai/MERIT_Hydro/). Both GWD-LR and the further improved MERIT Hydro provides information about the river widths (WTH) which can be used as an option for better tailoring of subbasin delineation for very broad rivers. This is described under **Subbasin creation**.
|
|
|
|
|
|
##### 2.4.1 File format
|
|
|
The DEM-, ACC/UPA-, DIR- files must:
|
|
|
|
|
|
* be gridded
|
|
|
* have a ".bil" (band interleaved by line) format and a corresponding header file (.hdr) with a format suitable for WHIST. Please, see the grid header files in the WHISTexample and check that you use dots instead of commas, correct pixeltype and 32-bit data or lower, if you have problems and get error messages from WHIST.
|
|
|
* Single flow direction must be used since multiple flow direction are not possible to compute in WHIST.
|
|
|
* DIR and ACC/UPA must have perfectly aligned pixels and the same resolution
|
|
|
* use 32-bit data or lower
|
|
|
|
|
|
|
|
|
![DIRandACCpixels](uploads/0291b965bcfe4cf905fbda1d1ad7cc6d/DIRandACCpixels.png)
|
|
|
*The DIR and ACC/UPA grids must have perfectly overlapping pixels and the same resolution.*
|
|
|
|
|
|
##### 2.4.2 Flow direction code systems
|
|
|
|
|
|
The DIR file must be coded as one of the existing direction code systems already provided within WHIST, e.g. 1=N, 2=NE, 3=E etc. There are currently seven options and if your data has another system you will have to reclassify the data to one of these:
|
|
|
|
|
|
* GWD-LR
|
|
|
* HYDROSHEDS
|
|
|
* NATDEM
|
|
|
* LISFLOOD
|
|
|
* HYDRO1K
|
|
|
* SIV
|
|
|
* GRASS
|
|
|
|
|
|
and their code systems are as follows:
|
|
|
|
|
|
![FlowdirectiondetailsWHIST](uploads/e8050e017827cdd54cc66150dd5fbae7/FlowdirectiondetailsWHIST.png)
|
|
|
|
|
|
*Predefined flow direction code systems in WHIST. The flow direction from HYDRO1K is also predefined but not shown in this picture, it has the same coding of directions as HYDROSHEDS and missing values as -9999*. If for example Ocean has "none" this means that the ocean should have the number of "NODATA" in the header file.
|
|
|
|
|
|
|
|
|
##### 2.4.3 Projections suitable for WHIST
|
|
|
WHIST uses some predefined projections. The projections are described here beneath with the exact descriptions for the projection files:
|
|
|
|
|
|
1. **WGS84**(EPSG:4326)
|
|
|
GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]
|
|
|
2. **LAEA_EU (Europe)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",55.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",20.0],UNIT["meter",1.0]]
|
|
|
3. **ETRS_89_ LAEA (Europe)**
|
|
|
PROJCS["ETRS89_LAEA_Europe",GEOGCS["GCS_ETRS_1989",DATUM["D_ETRS_1989",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["false_easting",4321000.0],PARAMETER["false_northing",3210000.0],PARAMETER["central_meridian",10.0],PARAMETER["latitude_of_origin",52.0],UNIT["Meter",1.0]]
|
|
|
4. **LAEA_AS (Asia)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",45.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",100.0],UNIT["meter",1.0]]
|
|
|
5. **LAEA_NA (North America)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",45.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",-100.0],UNIT["meter",1.0]]
|
|
|
6. **LAEA_AF (Africa)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",5.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",20.0],UNIT["meter",1.0]]
|
|
|
7. **LAEA_AU (Australia)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",-15.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",135.0],UNIT["meter",1.0]]
|
|
|
8. **LAEA_SA (South America)**
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["Sphere_ARC_INFO",6370997.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",-15.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",-60.0],UNIT["meter",1.0]]
|
|
|
9. **LAEA_NP (North Pole)**(ESRI:102017)
|
|
|
PROJCS["Lambert_Azimuthal_Equal_Area",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.017453292519943295]],PROJECTION["Lambert_Azimuthal_Equal_Area"],PARAMETER["Latitude_Of_Origin",90.0],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",0.0],UNIT["meter",1.0]]
|
|
|
10. **RT90 (Sweden)**
|
|
|
PROJCS["RT_1990_Transverse_Mercator",GEOGCS["GCS_RT_1990",DATUM["D_RT_1990",SPHEROID["Bessel_1841",6377397.155,299.1528128]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Transverse_Mercator"],PARAMETER["Scale_Factor",1.0],PARAMETER["False_Easting",1500000.0],PARAMETER["Latitude_Of_Origin",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",15.80827777777778],UNIT["meter",1.0]]
|
|
|
11. **SWEREF 99 (Sweden)**(EPSG:3006)
|
|
|
PROJCS["SWEREF99_TM",GEOGCS["GCS_SWEREF99",DATUM["D_SWEREF99",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Transverse_Mercator"],PARAMETER["Scale_Factor",0.9996],PARAMETER["False_Easting",500000.0],PARAMETER["Latitude_Of_Origin",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",15.0],UNIT["meter",1.0]]
|
|
|
12. **UTM32N (Denmark)**
|
|
|
PROJCS["WGS 84 / UTM zone 32N",GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137.0,298.257223563]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.01745329251994328]],PROJECTION["Transverse_Mercator"],PARAMETER["Scale_Factor",0.9996],PARAMETER["False_Easting",500000.0],PARAMETER["Latitude_Of_Origin",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",9.0],UNIT["meter",1.0]]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### 2.4.4 Load new topography data into the WHIST database
|
|
|
|
|
|
When the topography files have been prepared according to the requirements above you can add them to the respecitvely folders under ../database/grids/
|
|
|
|
|
|
- Open WHIST
|
|
|
- Go to the main menu: basin/grid folders, see figure beneath.
|
|
|
|
|
|
![basin-2](uploads/f0513a14a5b8fea32c1d062ee6061e4a/basin-2.png)
|
|
|
|
|
|
- Click on the "Add" button and browse the first mandatory file of your new grids, e.g. the DEM grid.
|
|
|
- Click on "Add" again and browse the second mandatory file of your new grids, e.g the flow direction grid.
|
|
|
- Click on "Add" again and browse the third mandatory file of your new grid, e.g. the flow accumulation (or upstream area) grid.
|
|
|
- If you have a grid with river width, or other type of "masks", add these as well. This is just an option, not mandatory.
|
|
|
- The added files should turn up in the "Manage Grid Folders" window.
|
|
|
- The new files need to be edited before use, i.e. to set units and direction formats. Mark the new DEM grid and click on the Edit Button. Check that is looks like in the figure beneath.
|
|
|
|
|
|
![Edit_DEM](uploads/6413cf56389039848fb30337f64f37b1/Edit_DEM.png)
|
|
|
|
|
|
- Mark the new DIR in the same way and choose your flow direction type [(predefined)](https://git.smhi.se/whist/whist/-/wikis/WHIST-Wiki/-2.-WHIST-requirements#242-flow-direction-code-systems), see figure beneath.
|
|
|
|
|
|
![edit_DIR](uploads/241f3b66cde45df14d0951688d71d539/edit_DIR.png)
|
|
|
|
|
|
- Mark the new ACC/UPA and choose the unit of your grid, see figure beenath.
|
|
|
|
|
|
![edit_ACC](uploads/89a876d9f554ea52fc040355d2f8a64f/edit_ACC.png)
|
|
|
|
|
|
- Close the "Manage Grid Folders window".
|
|
|
- Check that the new grids are possible to view with the view tools, see description here: **[View tools](https://git.smhi.se/whist/whist/wikis/WHIST-Wiki/-6.-View-tools)**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
____
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|