Wolfgang Tichy

Obtaining Nmesh

To get the Nmesh source code type: 
git clone https://github.com/nmeshsource/nmesh.git
Read the newly cloned file nmesh/doc/nmesh.txt to better understand how nmesh works. You will learn that what modules are downloaded and compiled, is specified in a file called MyConfig.

For a minimal configuration, copy this MyConfig file into the newly created nmesh directory.

For a bigger configuration example, using some modules from the non-public git repos of the FAU NR group, type: 

cp nmesh/configs/Debian-DNSdata/MyConfig nmesh

Of course the bigger configuration will only work if you actually have access to the non-public FAU NR group repos.

After choosing your MyConfig, download the modules specified in it by entering: 

cd nmesh
make git_clone

Compiling Nmesh

To compile you may need to edit the MyConfig file (that you obtained above). In it you can set a few things like the compiler you use, or where certain libraries are located. The MyConfig files from above are examples that work on Debian. Among other things the MyConfig has the section: 
#SPECIALLIBS += -lgsl -lgslcblas  # for GSL

This line is currently commented out, but any SPECIALLIBS lines simply describe what libraries we want to compile in. Of course this only works if they are actually installed. See Compile Notes for more details about compiling and MyConfig variables such as SPECIALLIBS. Read the Library Notes to find out more about compiling on supercomputers such as FAU's Athene.

Parameter files for Nmesh

Several example parfiles are in nmesh/src/tests/scalarwave1/parfiles , with descriptions in nmesh/src/tests/scalarwave1/parfiles/Note.txt .

Running Nmesh

Nmesh can use MPI, so you can compile and run with mpicc and mpirun. On Athene, Nmesh and also BAM or Sgrid can also be started with the submitjob script found at https://github.com/wofti/WTscripts. For slurm you also need slurm_mpirun_script.

Developer access to main part of Nmesh

To be able to push to the Nmesh source code repo, access it via: 
git clone git@github.com:nmeshsource/nmesh.git

About the non-public git repos of the FAU NR group

Some Nmesh projects that are still under development reside in the non-public FAU NR git repos.