Graphical Tools for creating Next Gen Water model input data.
Project description
This repository contains tools for preparing data to run a next gen simulation using NGIAB. The tools allow you to select a catchment of interest on an interactive map, choose a date range, and prepare the data with just a few clicks!
What does this tool do?
This tool prepares data to run a next gen simulation by creating a run package that can be used with NGIAB. It picks default data sources, including the v20.1 hydrofabric and nwm retrospective v3 forcing data.
Requirements
- This tool is officially supported on macOS or Ubuntu. To use it on Windows, please install WSL.
- GDAL needs to be installed.
- The 'ogr2ogr' command needs to work in your terminal.
sudo apt install gdal-bin
will install gdal and ogr2ogr on ubuntu / wsl
Installation and running
#optional but encouraged: create a virtual environment
python3 -m venv env
source env/bin/activate
# installing and running the tool
pip install ngiab_data_preprocess
python -m map_app
The first time you run this command, it will download the hydrofabric and model parameter files from Lynker Spatial. If you already have them, place conus.gpkg
and model_attributes.parquet
into modules/data_sources/
.
Development Installation
Installation steps
To install and run the tool, follow these steps:1. Clone the repository:
```bash
git clone https://github.com/CIROH-UA/NGIAB_data_preprocess
cd NGIAB_data_preprocess
```
2. Create a virtual environment and activate it:
```bash
python3 -m venv env
source env/bin/activate
```
3. Install the tool:
```bash
pip install -e .
```
4. Run the map app:
```bash
python -m map_app
```
Usage
Running the command python -m map_app
will open the app in a new browser tab. Alternatively, you can manually open it by going to http://localhost:5000 with the app running.
To use the tool:
- Select the catchment you're interested in on the map.
- Pick the time period you want to simulate.
- Click the following buttons in order:
- Create subset gpkg
- Create Forcing from Zarrs
- Create Realization
Once all the steps are finished, you can run NGIAB on the folder shown underneath the subset button.
Note: When using the tool, the output will be stored in the ./output/<your-first-catchment>/
folder. There is no overwrite protection on the folders.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ngiab_data_preprocess-1.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b91bdd9e61e8e241247ef02eae9f9671784d7e61008e97a0a72a269d9b8176aa |
|
MD5 | cdb98396e3fb03a6600296b76251f887 |
|
BLAKE2b-256 | 1474a397a35e894d4234ea09f22a65e497313c79acf3656f4b944b2ce815342d |
Hashes for ngiab_data_preprocess-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8604ddcbf2a28ae548e5d0150e06789fa9e19580b7edfd166935e844bb677b4e |
|
MD5 | 9d82ff767f7f83d1621a543b6acb5758 |
|
BLAKE2b-256 | f50e0305000e9599bd24407a64591b85b0f7d869f041f4fd535bd7058d51a5e8 |