Skip to content

swami-h2020-eu/mcm

Repository files navigation

SWAMI MCM Model

SWAMI (http://swami-h2020.eu/) was a H2020 project with the purpose of developing a model of the whole atmosphere by means of blending the Unified Model (UM) from the MetOffice in the UK for the atmosphere (0 to 120 km) and the Drag Temperature Model (DTM2020) from the Centre National d'Études Spatiales (CNES) in France covering the thermosphere, from 120 to 1500 km. The model, called MCM (MOWA Climatological Model), provides point-wise estimates of temperature, density and wind up to 120 km, and temperature, total and partial densities above 120 km. The drivers for the thermosphere model are the solar radio flux F10.7 and the planetary geomagnetic index Kp.

To be efficient and performant, the UM was averaged to a set of data tables that contain diurnal variability and cover three solar activity levels (in terms of F10.7). The DTM is included directly. Both models are combined by means of interpolation in the blending altitude range (between 100 and 120 km) to create MCM.

The thermosphere model DTM2020 is also available separately. Two versions exist: the operational version, which is used in MCM, and a more accurate research version. The drivers of the DTM2020 research model are the 30 cm solar radio flux F30 and the new hourly planetary geomagnetic index Hp60.

Documentation

The documentation is available at https://swami-h2020-eu.github.io/mcm/

It includes API reference, brief descriptions of the model, examples and compilation instructions

How to use

Clone the repository or download the code.

Tested in Ubuntu 18.04 LTS

Requirements:

  • gfortran
  • python >3.5
  • libnetcdff-dev

Fortran code

MCM model is under src/libswamif

Two versions of DTM2020 model are at src/dtm2020

Compilation instructions are at: https://swami-h2020-eu.github.io/mcm/fortran.html

Python wrapper

  • First, go to src/swami and compile the Fortran binary by running ./make_wrapper.sh
  • To create the package: python3 setup.py sdist
  • To install: pip3 install .. This will install a Python package called swami

More detailed instructions at: https://swami-h2020-eu.github.io/mcm/python.html

License

MCM INCLUDING DTM SOFTWARE, AND DTM SOFTWARE

The MCM software is property of the Centre National d’Etudes Spatiales (CNES, France), the Met Office (United Kingdom), and Elecnor Deimos (Spain). The DTM software is property of the Centre National d’Etudes Spatiales (CNES, France).

CNES, the Met Office and Elecnor Deimos grant to the Licensee a free non-exclusive and non-transferable license for the MCM software for academic, non-commercial, purposes only. CNES grants to the Licensee a free non-exclusive and non-transferable license for the DTM software for academic, non-commercial, purposes only. A user of MCM or DTM software shall not:

  • use it for any non-academic, commercial purposes,
  • make any modification or improvement to the Software,
  • disseminate it or partly disseminate it, or any of its supporting data
  • copy it except for archival or emergency repair

A license for commercial use of MCM or DTM can be requested. An example of such a license for the DTM software is provided in this directory (LICENSE DTM.doc).

WARRANTY

The Licensee will use the MCM or DTM software in its present state at his own risk, without any guarantee of any kind from CNES, the Met Office and Elecnor Deimos. CNES, the Met Office and Elecnor Deimos cannot be held liable for any damage for the Licensee that can result from the use of the MCM or DTM software.

THE USE OF THE MCM OR DTM SOFTWARE CONSTITUTES AN IMPLICIT ACCEPTATION BY THE USER OF THE TERMS OF THE PRESENT LICENSE.

Contact details

@daluar @ Deimos Space

@seanbruinsma @ CNES

David Jackson @ MetOffice