NextGen in a Box Demo steps

[jameshalgren]

“NextGen In a Box” – Steps to run the NWM on local machine:

Obtain the data and execution files

Pull the latest ngen image:

$ docker pull awiciroh/ciroh-ngen-image:latest 

Download input data:

$ mkdir ngen-data 
$ cd ngen-data 

Download test data tar:

$ wget --no-parent https://awi-ciroh-ngen-data.s3.us-east-2.amazonaws.com/AWI_001/AWI_16_680661_001.tar.gz 

Validate cksum:

$ cksum AWI_16_680661_001.tar.gz  
3445409099 822285593 AWI_16_680661_001.tar.gz 

Untar the folder:

$ tar -xvf AWI_16_680661_001.tar.gz 

This will extract forcings and config files under AWI_16_680661_001 folder -- this is VPU 16 (Great Basin) from the Provo River outlet into Utah Lake to the headwaters.

Run the image with the serial option:

Make sure you are in ngen-data folder:

$ cd ngen-data 

Run docker:
For Mac:

$ docker run --rm -it -v "$(pwd)"/AWI_16_680661_001:/ngen/AWI_001 awiciroh/ciroh-ngen-image:latest 

For windows:

$ docker run --rm -it -v ${pwd}/AWI_16_680661_001:/ngen/AWI_001 awiciroh/ciroh-ngen-image:latest 

Select option “2) ngen-serial”.

Enter the hydrofabric catchment file path by copy/paste or type

“/ngen/AWI_001/config/catchments.geojson” 

Enter the hydrofabric nexus file path by copy/paste or type

“/ngen/AWI_001/config/nexus.geojson” 

Enter the Realization file path by copy/paste or type

 “/ngen/AWI_001/config/awi_simplified_realization.json” 

When prompted with Would you like to continue?, select interactive shell option
(Type 1 and hit enter.)

Starting a shell:

bash-5.1# $ cd ngen 

Run command:

$ /dmod/bin/ngen-serial /ngen/AWI_001/config/catchments.geojson "" /ngen/AWI_001/config/nexus.geojson "" /ngen/AWI_001/config/awi_simplified_realization.json 

NOTE: This will take approx. 3-5 mins to complete, once you see below output the run has completed successfully:

ut_get_converter(): Units not convertible 
Running timestep 100 
Running timestep 200 
Finished 240 timesteps. 
bash-5.1#

List output files : $ ls
*Note: We are actively working on the upstream and in-script changes to output to more flexible locations

Open output file:

$ cat cat-125075.csv
Time Step,Time,EVAPOTRANS,sloth_ice_fraction_schaake,sloth_ice_fraction_xinan,sloth_smp 
0,2022-08-24 13:00:00,0.000000,0.000000,0.000000,0.000000 
1,2022-08-24 14:00:00,0.000000,0.000000,0.000000,0.000000 
2,2022-08-24 15:00:00,0.000000,0.000000,0.000000,0.000000 
.
.
.

And for nexus outputs

$ cat nex-113748_output.csv 
0, 2022-08-24 13:00:00, 0.14034 
1, 2022-08-24 14:00:00, 0.127772 
2, 2022-08-24 15:00:00, 0.115978 
3, 2022-08-24 16:00:00, 0.103805 
4, 2022-08-24 17:00:00, 0.0940261 
5, 2022-08-24 18:00:00, 0.0853595 
6, 2022-08-24 19:00:00, 0.0777023 
7, 2022-08-24 20:00:00, 0.070596 
8, 2022-08-24 21:00:00, 0.0642252 
9, 2022-08-24 22:00:00, 0.0584292 
10, 2022-08-24 23:00:00, 0.0532293 
11, 2022-08-25 00:00:00, 0.0485171 
12, 2022-08-25 01:00:00, 0.0442426 
13, 2022-08-25 02:00:00, 0.0403615 
.
.
.

Thank you @arpita0911patel, @ZacharyWills, @hellkite500, and @benlee0423 for key contributions to getting this together.