Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Starting the build process section on the OpenIFS - 48r1 Getting Started , page introduces the basic build and test command

...

In addition to the command line options defined above (-cbt) , openifs-test.sh invokes some default ecbuild options and allows a user to add ecbuild options from command line using the -- notation, e.g.,   $OIFS_TEST/openifs-test.sh -cbt --without-single-precision.

Default build options

There are 5 default build options that are defined directly in openifs-test.sh. Of the 5, 3 options cannot be negated by command line options, while 2 can be negated by selecting the opposite option from the command line.

The following build options can not cannot be negated

--openifs-only - ensures code for openifs OpenIFS is included in the build

--with-scmec - builds the SCM executable alongside the OpenIFS 3D executable

--arch=$OIFS_ARCH - defines the path to the arch directory defined in $OIFS_HOME/oifs-config.edit_me.sh

...

--init-snan - initialises uninitialised variables to nan

Command line build options

In addition to the default options, there is a range of command-line options defined in $OIFS_HOME/bundle.yml, which can be invoked when openifs-test.sh -b  is executed.

...

--arch=<add path of arch file> - Allows a user to over-ride $OIFS_ARCH loaded while sourcing oifs-config.edit_me.sh.sh. The expected path structure for <add path of arch file>  is ./arch/<site>/<platform>/<compiler>/<compiler_version>. For example --arch=./arch/ecmwf/hpc2020/gnu , where the site is ecmwf, the platform is hpc2020 and the compiler is gnu. The compiler version is not stated because the path contains a default link.

--without-single-precision or --without-double-precision - By default both single and double precision executables are built. These options negate the default option by excluding double or single precision build, which speeds up the build

...