Building and running MIMICAv5 on Tetralith - Revision history

Hamish Struthers (NSC) at 13:54, 9 March 2020

2020-03-09T13:54:41Z

Hamish Struthers (NSC) at 13:28, 9 March 2020

2020-03-09T13:28:42Z

Hamish Struthers (NSC): Created page with "This page describes the building the [https://agupubs.onlinelibrary.wiley.com/doi/full/10.1002/2013MS000292 MIMICAv5] on NSC's [http://www.nsc.liu.se/systems/tetralith/ Tetralith..."

2020-03-09T09:54:33Z

Created page with "This page describes the building the [https://agupubs.onlinelibrary.wiley.com/doi/full/10.1002/2013MS000292 MIMICAv5] on NSC's [http://www.nsc.liu.se/systems/tetralith/ Tetralith..."

New page

This page describes the building the [https://agupubs.onlinelibrary.wiley.com/doi/full/10.1002/2013MS000292 MIMICAv5] on NSC's [http://www.nsc.liu.se/systems/tetralith/ Tetralith] system.

MIMICA is a 3D high-resolution model designed for atmospheric applications and written entirely in fortran. The code has been originally developed by Chien Wang at MIT, and later updated and transformed into a true LES model by Julien Savre at Stockholm University. Today, MIMICA is developed under the git version control system and is hosted on the [https://bitbucket.org/matthiasbrakebusch/mimicav5 Bitbucket] web-page

;Getting the source code

Once you have a Bitbucket account with the correct permissions to access the MIMICA repository, the MIMICAv5 distribution can be cloned by executing, e.g.:

:<code>git clone https://my-username@bitbucket.org/matthiasbrakebusch/mimicav5.git mimicav5</code>

If space permits, it is recommended that the source files be downloaded into the <tt>/home</tt> file system on Tetralith. This ensures that your code, and configuration files are backed up.

;MIMICA modules

A set of software modules have been installed on Tetralith specifically to try to mimic as closely as possible the environment used in the model development by Julien. It is recommended that these modules are used for building and running MIMICA on Tetralith to reduce porting problems.

:<code>$ module purge</code>
:<code>$ module load buildenv-intel/2017.u7-bare</code>
:<code>$ module use /proj/bolinc/shared/software/modules</code>
:<code>$ module load netCDF/4.4.1-intel-2017.u7-bare</code>
:<code>$ module load fftw/3.3.8-intel-2017.u7-bare</code>

;Environment variables, Makefile and start file

Loading the modules above sets a number of environment variables (incl. <tt>NETCDF_DIR, FFTW_LIB, FFTW_INC</tt>). The <tt>MIMICA</tt> environment variable must be set to the root path of the MIMICAv5 download (see 'Getting the source code' above), e.g.

:<code>$ export MIMICA=/home/my-tetralith-username/models/mimicav5</code>

← Older revision		Revision as of 13:28, 9 March 2020
Line 26:		Line 26:

	:<code>$ export MIMICA=/home/my-tetralith-username/models/mimicav5</code>		:<code>$ export MIMICA=/home/my-tetralith-username/models/mimicav5</code>
		+
		+	A Tetralith specific Makefile associated with the above modules can be downloaded here or the same file can be copied on Tetralith from (<tt>/proj/nsc/users/struthers/Public/MIMICA/makefile-v5</tt>).

@@ Line 13: / Line 13: @@
 ;MIMICA modules
-A set of software modules have been installed on Tetralith specifically to try to mimic as closely as possible the environment used in the model development by Julien. It is recommended that these modules are used for building and running MIMICA on Tetralith to reduce porting problems.
+A set of software modules have been installed on Tetralith specifically to try to match as closely as possible the environment used in the model development by Julien. It is recommended that these modules are used for building and running MIMICA on Tetralith to reduce porting problems.
 :<code>$ module purge</code>
@@ Line 21: / Line 21: @@
 :<code>$ module load fftw/3.3.8-intel-2017.u7-bare</code>
-;Environment variables, Makefile and start file
+;Environment variables and Makefile
 Loading the modules above sets a number of environment variables (incl. <tt>NETCDF_DIR, FFTW_LIB, FFTW_INC</tt>). The <tt>MIMICA</tt> environment variable must be set to the root path of the MIMICAv5 download (see 'Getting the source code' above), e.g.
@@ Line 27: / Line 27: @@
 :<code>$ export MIMICA=/home/my-tetralith-username/models/mimicav5</code>
-A Tetralith specific Makefile associated with the above modules can be downloaded here or the same file can be copied on Tetralith from (<tt>/proj/nsc/users/struthers/Public/MIMICA/makefile-v5</tt>).
+A Tetralith specific <tt>Makefile</tt> associated with the above modules can be copied on Tetralith from (<tt>/proj/nsc/users/struthers/Public/MIMICA/Makefile-v5</tt>) to your working folder.