CoastalApp

ESMF application for building a NUOPC / NEMS application coupling circulation models (ADCIRC, SCHISM) with forcing models (WW3, NWM) or even file forcings (ATMESH, WW3DATA).

ADC-WW3-NWM-NEMS is an ESMF application developed as part of the Coastal Act coupling project to determine wind versus water percentage loss caused by a Named Storm Event.

git clone --recursive https://github.com/noaa-ocs-modeling/CoastalApp
cd CoastalApp

Requirements

installing ParMETIS for WW3

Using unstructured WW3 requires an installation of ParMETIS for domain decomposition.

download the code here

build ParMETIS

module purge
module load intel impi
setenv CFLAGS -fPIC
make config cc=mpiicc cxx=mpiicc prefix=/path/to/your/parmetis/ | & tee config.out-rr
make install | & tee make-install.out-rr

This adds libparmetis.a under /path/to/your/parmetis/lib/libparmetis.a.

set the path to ParMETIS

setenv METIS_PATH /path/to/your/parmetis

Organization / Responsibility

`NEMS` application implementing ESMF / NUOPC coupling

Saeed Moghimi (lead) - saeed.moghimi@noaa.gov
Panagiotis Velissariou - panagiotis.velissariou@noaa.gov
Zachary Burnett - zachary.burnett@noaa.gov
Andre Van der Westhuysen - andre.vanderwesthuysen@noaa.gov
Beheen Trimble - beheenmt@gmail.com

ESMF / NUOPC cap for `ADCIRC` model

Saeed Moghimi (lead) saeed.moghimi@noaa.gov
Guoming Ling - gling@nd.edu
Damrongsak Wirasaet - dwirasae@nd.edu
Panagiotis Velissariou - panagiotis.velissariou@noaa.gov
Zachary Burnett - zachary.burnett@noaa.gov

ESMF / NUOPC cap for `FVCOM` model

Jianhua Qi (lead) - jqi@umassd.edu
Saeed Moghimi - saeed.moghimi@noaa.gov

ESMF / NUOPC cap for `SCHISM` model

Carsten Lemmen (lead) - carsten.lemmen@hzg.de
Y. Joseph Zhang - yjzhang@vims.edu

ESMF / NUOPC cap for `WW3` model

Andre Van der Westhuysen (lead) - andre.vanderwesthuysen@noaa.gov
Ali Abdolali - ali.abdolali@noaa.gov

`PaHM` model and ESMF / NUOPC cap for `PaHM` model

Panagiotis Velissariou (lead) - panagiotis.velissariou@noaa.gov

`ATMESH` data component and ESMF / NUOPC cap for `ATMESH` data component

Saeed Moghimi (lead) saeed.moghimi@noaa.gov
Guoming Ling - gling@nd.edu
Panagiotis Velissariou - panagiotis.velissariou@noaa.gov

ESMF / NUOPC cap for `NWM` model

Daniel Rosen (lead) - Daniel.Rosen@noaa.gov
Beheen Trimble - beheenmt@gmail.com
Jason Ducker - jason.ducker@noaa.gov
other colleagues from NWS / OWP

Compilation

This section contains some generic instructions of how to build the NEMS application. The contents of this section will change soon.

./build.sh --help

The following example builds NEMS.x with ADCIRC, ATMESH, and WW3DATA, using variables / modules from the Hera environment, compiling with the Intel compiler, and cleaning before building.

./build.sh --component "ADCIRC ATMESH WW3DATA" --plat hera --compiler intel --clean -2

Components

--component can be any combination of
- ADCIRC
- ATMESH
- WW3 / WW3DATA
- NWM

./build.sh --component "ADCIRC WW3" --plat hera --compiler intel --clean -2

./build.sh --component "SCHISM" --plat orion --compiler intel --clean -2

Platforms

--plat can be one of
- hera
- stampede
- wcoss
- orion
- jet
- gaea
- cheyenne
- linux
- macosx
- macports

For MacOS running MacPorts, use the macports option.

./build.sh --component "SCHISM" --plat hera --compiler intel --clean -2

./build.sh --component "SCHISM" --plat orion --compiler intel --clean -2

Compiler

--compiler can be one of
- intel
- gnu
- pgi

./build.sh --component "SCHISM" --compiler gnu --plat macports

./build.sh --component "SCHISM" --compiler intel --plat hera

Clean

--clean is optional, and can be one of
- (make clean and exit)
- 1 (make clean and exit)
- 2 (make clobber and exit)
- -1 (make clean and build)
- -2 (make clobber and build)

./build.sh --component "SCHISM" --compiler intel --plat hera --clean

./build.sh --component "SCHISM" --compiler intel --plat hera --clean -1

Contributing

Feel free to fork this repository and create a pull request with contributions.

adding a new platform / compiler to compilation script

Environment files are stored in modulefiles/ with the filename envmodules_<COMPILER>.<PLATFORM>

To compile in your own system you should create a similar file, then run build.sh to compile.

Collaboration

To collaborate and contribute to this repository follow below instructions:

go to https://github.com/noaa-ocs-modeling/CoastalApp
create a fork (click Fork on the upper right corner), and fork to your account.

clone your forked repository

git clone --recursive https://github.com/<ACCOUNT>/CoastalApp

edit the files locally
```
git status
```

commit changes

git commit -a -m "describe what you changed"

push your changes to GitHub
```
git push
```
enter your GitHub username/password if asked

create a pull request with descriptions of changes at

https://github.com/noaa-ocs-modeling/CoastalApp/compare/<BRANCH>...<ACCOUNT>:<BRANCH>

Citations

Moghimi, S., Van der Westhuysen, A., Abdolali, A., Myers, E., Vinogradov, S., 
   Ma, Z., Liu, F., Mehra, A., & Kurkowski, N. (2020). Development of an ESMF 
   Based Flexible Coupling Application of ADCIRC and WAVEWATCH III for High 
   Fidelity Coastal Inundation Studies. Journal of Marine Science and 
   Engineering, 8(5), 308. https://doi.org/10.3390/jmse8050308

Moghimi, S., Vinogradov, S., Myers, E. P., Funakoshi, Y., Van der Westhuysen, 
   A. J., Abdolali, A., Ma, Z., & Liu, F. (2019). Development of a Flexible 
   Coupling Interface for ADCIRC model for Coastal Inundation Studies. NOAA 
   Technical Memorandum, NOS CS(41). 
   https://repository.library.noaa.gov/view/noaa/20609/

Moghimi, S., Westhuysen, A., Abdolali, A., Myers, E., Vinogradov, S., Ma, Z., 
   Liu, F., Mehra, A., & Kurkowski, N. (2020). Development of a Flexible 
   Coupling Framework for Coastal Inundation Studies. 
   https://arxiv.org/abs/2003.12652

schism-dev/CoastalApp