1. Water Data Explorer (WDE)
In recent years, there has been a growing recognition of the need for standardized ways of sharing water data on the web. In response to this need, the Consortium of Universities for the Advancement of Hydrologic Science (CUAHSI) Hydrologic Information System (HIS) has been developed along with the standardized WaterOneFlow web services and WaterML data exchange format. To access data that are shared using the WaterOneFlow services and WaterML format, tools already exist such as the Microsoft Windows HydroDesktop software , WaterML R package, and the web-based CUAHSI HydroClient which serves as an access point to the CUAHSI HIS database.
Water Data Explorer (WDE) is a newly developed web-based tool allowing a broad range of users to discover, access, visualize, and download data from any Information System that makes available water data in WaterML format through WaterOneFlow services. WDE is designed in a way that allows users to customize it for local or regional web portals.
1.2. WDE Overview
WDE is an open-source web application providing users with the functionalities of data discovery, data access, data visualization, and data downloading from any Information System that makes available water data in WaterML format through WaterOneFlow web services. WDE can be installed by any organization and requires minimal server space.
1.2.1. User Interface
To organize and manage various WaterOneFlow web services, WDE uses Data Views that are organized in Catalogs.
Each Data View contains a set of data that is accessible through a specific WaterOneFlow web service.
The stations for which data are accessible through a specific Data View are displayed on the WDE map interface along with a legend of the respective Data Views.
For each Station/Platform, a set of metadata is available in the Graphs Panel of the WDE User Interface. Also, for each Station/Platform, a table of observed variables is available and includes variable names, units, and interpolation types.
Station/Platform time series data can be plotted as “Scatter” or “Whisker and Box” plots, and be downloaded in CSV, OGC NetCDF , OGC WaterML 2.0 , and CUAHSI WaterML 1.0 formats for any available time period of interest in the Time Series Plots section.
WDE can be installed in production services through a Docker image or directly on a server .
Docker Image: byuhydro/wde
The WDE docker image installation has support for different types of architectures:
Two Images: one PostgreSQL image and WDE image.
Using a docker-compose.yml to run both containers declaring environment variables:docker-compose up
Running two different containers with a file containing the environment variables:docker run --name postgres -e POSTGRES_PASSWORD=passpass -p 5432:5432 -d postgres docker run -it --env-file env.txt -p 80:80 byuhydro/wde
One Image: one WDE image connected to a local instance of PostgreSQL or an Amazon RSD postgreSQL database.
Using local instance of PostgreSQL with a file containing the environment variables:docker run -it --env-file env.txt -p 80:80 byuhydro/wde
Using an Amazon RSD postgreSQL database with a file containing the environment variables:docker run -it --env-file env.txt -p 80:80 byuhydro/wde
Currently there is only support for AWS if an cloud based database is used.
env.txt sample files can be found in here
18.104.22.168. Regular Production Installation
When installing WDE using the regular installation process in a production env, you will need to install the Tethys Platform first and then install WDE app. Follow this guide for an step by step process.
22.214.171.124. Regular Development Installation
WDE can also be installed in your local computer without the need to do a production installation in any server. You will need to install the Tethys Platform first and then WDE app.
WDE has been developed by Elkin Giovanni Romero Bustamante at Brigham Young University’s (BYU) Hydroinformatics laboratory with the support of the World Meteorological Organization. The BYU’s Hydroinformatics laboratory focuses on delivering different software products and services for water modelling. Some of the most important works include: Global Streamflow Forecast Services API , creation of the Tethys Platform , and Hydroserver Lite . The most recent publications and works can be found on the BYU Hydroinformatics website.
1.2.4. Source Code
The WDE source code is available on Github:
Please feel free to contribute.