The Lund University Modular Inversion Algorithm (LUMIA) is a python package for performing atmospheric transport inversions.
The release 2020.8 is described in https://www.geosci-model-dev-discuss.net/gmd-2019-227/ and can be downloaded at url
lumia is constructed as a standard python package, and can be installed using the standard
There are two main ways of installing it:
The difference is that the installation as a project also downloads the documentation/example files, and installs everything in a folder of your choice. The installation as a package is faster and simpler but it only downloads and installs the lumia python package itself (i.e. it makes it possible to use
import lumia in your python scripts), in the
site-packages of your python environment.
pip install git+https://github.com/lumia-dev/lumia.git
git clone https://github.com/lumia-dev/lumia.git myproj pip install -e myproj
myproj by the name of your project)
Regardless the installation method, the installer handles some dependencies (some python packages will be installed automatically if they are missing on the system), but two dependencies cannot be installed via pip, and need to be installed manually:
cartopypython package is required (it is used to compute land/sea masks). See https://scitools.org.uk/cartopy/docs/latest/installing.html for installation instructions.
After following either of the installation procedure, the
lumia package and its sub-modules should be available for other python scripts on the machine. By default, the installer also creates a copy of the
transport/lagrange_mp.py script inside the user
$PATH. The script is used as a transport model in the example inversions presented in the tutorial.
For more specific usage instruction, please refer to the tutorial, and to the example jupyter notebooks in the GMDD folder.
LUMIA is a scientific tool. The code is made available under the EUPL v1.2 open source license, and it is not provided with any warranty. In particular:
You are free to download it and use it, but you are strongly encouraged to contact us before, to discuss the level of support that we can provide, and give you a developer access to our git repository.