...
so make sure this will not clash with an existing installation. See Compilation and installation on page 6 for details of flags which will allow you to change this.
Compilation, testing and installation
It is advisable to perform an 'out-of-source build', meaning that the build should take place in a directory separate from where the source code is. Here is an example set of commands to set up and build Metview using default settings:
| Code Block | ||
|---|---|---|
| ||
# unpack the source tarball into a temporary directory
mkdir -p /tmp/src
cd /tmp/src
tar xzvf Metview-4.5.0-Source.tar.gz
# configure and build in a separate directory
mkdir -p /tmp/build
cd /tmp/build
cmake /tmp/src/Metview-4.5.0-Source
make |
The Metview distribution includes a small set of tests which can help ensure that the build was successful. To start the tests, type:
| Code Block |
|---|
make test |
Although it is possible to run Metview directly from the build directory, it is best to install it. The installation directory is /usr/local by default, but can be changed by adding the -DCMAKE_INSTALL_PREFIX flag to the cmake command. In this case, the configure, build, test and install step would look like this:
| Code Block | ||
|---|---|---|
| ||
cmake /tmp/src/Metview-4.5.0-Source -DCMAKE_INSTALL_PREFIX=/path/to/metview_install_dir
make
make test
make install |
...
CMake options used in Metview
...
CMake option | Description | Default |
|---|---|---|
| CMAKE_INSTALL_PREFIX | where you want to install Metview | /usr/local |
| CMAKE_BUILD_TYPE | to select the type of compilation:
In most cases Release is preferable for an optimised version with no debug information | RelWithDebInfo |
| CMAKE_CXX_FLAGS | more additional flags for the C++ compiler, e.g. -DCMAKE_CXX_FLAGS="-O2 -march=native" | |
| CMAKE_C_FLAGS | additional flags for the C compiler | |
| CMAKE_Fortran_FLAGS | additional flags for the Fortran compiler | |
| ENABLE_UI | enables the Qt-based user interface | ON |
| ENABLE_MOTIF | enables the deprecated Motif-based user interface
| OFF |
| ENABLE_PLOTTING | enables plotting capabilities using Magics | ON |
| ENABLE_OPERA_RADAR | enables the Opera Radar Filter module (requires the proj4 library and headers) | OFF |
| ENABLE_MARS | enables MARS access (not required if using through the Web API) | OFF |
| MARS_LOCAL_HOME | sets the path to where local Mars MARS is installed | |
| ENABLE_ODB | enables processing and plotting of ODB data | OFF |
| ENABLE_MARS_ODB | enables ODB capabilities in MARS client | OFF |
| ENABLE_USAGE_LOG | enables logging of Metview startup calls | OFF |
| LOG_DIR | path to where to log the Metview startup calls | |
| EXTRA_TITLE | build-specific title to add to the log entries | |
| ENABLE_INPE | enables INPE modules | OFFON |
| Path options - only required when support libraries are not installed in default locations | ||
| CMake Option | Description | Notes |
| GRIB_API_PATH | path to where GRIB_API has been installed | |
| MAGICS_PATH | path to where Magics has been installed | Only required if plotting is enabled |
| NETCDF_PATH | path to where netCDF has been installed | |
| ODB_API_PATH | path to where ODB_API has been installed | Only required if ODB is enabled |
| ODB_PATH | path to where the original ODB has been installed | Optional if ODB is enabled |
| EMOS_PATH | path to where Emoslib has been installed | Also set EMOS_LIB_NAME |
| FDB_PATH | path to where fdb has been installed | Only required if MARS is enabled |
| PROJ4_PATH | path to where proj4 has been installed | Only required if OPERA Radar is enabled |