A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Open Source EMEP MSC-W model

Designed to calculate air concentrations and deposition fields for major acidifying and eutrophying pollutants, photo-oxidants and particulate matter.
https://github.com/metno/emep-ctm

Category: Natural Resources
Sub Category: Air Quality

Last synced: about 23 hours ago
JSON representation

Repository metadata

Open Source EMEP/MSC-W model

README.md

Open Source EMEP MSC-W model

Documentation Status
DOI

The EMEP models have been instrumental to the development of
air quality policies in Europe since the late 1970s,
mainly through their support to the strategy work under the
Convention on Long-range Transboundary Air Pollution.
In the 1990s the EMEP models became also the reference tools for
atmospheric dispersion calculations as input to the Integrated Assessment Modelling,
which supports the development of air quality polices in the European Union.

The EMEP MSC-W model is designed to calculate air concentrations
and deposition fields for major acidifying and eutrophying pollutants,
photo-oxidants and particulate matter.
The Open Source releases are intended to:

  • facilitate insight in the model assumptions, the parametrisation used,
    the requirements for input data and the actual model code
  • encourage dialogue and collaboration with the modelling community
  • allow individual model runs and insight on how to run different scenarios

Releases

The latest Open Source EMEP MSC-W model version (5.5)
is based on the version used on the EMEP status reporting of the year 2024.
The source code, together with a set of input data,
an updated user guide and a full year model results for the year 2018,
under GPL license v3.

You can download the source code and input data by following the instructions on the
OpenSource v5.5 (202412) release page.

Information on use of the model can be found in the EMEP MSC-W model User Guide

Previous releases (YYYYMM - date of release)

Model domain and resolution

The EMEP MSC-W model is very flexible with regard to the horizontal resolution
and vertical resolutions. In 2008 the EMEP domain was extended to include EECCA countries.
In 2017 the vertical resolution increased from 20 to 34 model levels.
Together wit the latest release gridded input and output data are provided on the EMEP0302 model domain
with a 0.3x0.2 degrees on long-lat projection and 34 vertical levels.

Input data

The standard input files for the EMEP model are provided in two different formats,
netCDF or ASCII.
We presently follow as much as possible the netCDF CF conventions
for both input and output data.
More details about the input files are described in Chapter 2 of the
EMEP MSC-W model User Guide.

IMPORTANT:
The input data that accompanies each release model should be appropriately acknowledged
when used for model runs.
If nothing else is specified according to references further in this chapter,
please acknowledge EMEP/MSC-W in any use of these data.

Model output

The main output files are in netCDF format
and some additional output files are in ASCII format.
Details about the output files are described in Chapter 3 of the User Guide.

Documentation

The EMEP MSC-W model is a chemical transport model developed at the
Meteorological Synthesizing Centre - West (MSC-W)
at the Norwegian Meteorological Institute (met.no).
The EMEP model is a limited-area, terrain following hybrid coordinate model
designed to calculate air concentration and deposition fields for

  • acidifying and eutrophying compounds (S, N)
  • ground level ozone (O3)
  • particulate matter (PM2.5, PM10).

as well as their long-range transport and fluxes across national boundaries
(Transboundary air pollution).
A history of the development of the EMEP model can be found at
http://www.emep.int/models.

Model Description

The main documentation is still the 2012 ACP paper:

The EMEP MSC-W chemical transport model -- technical description
D. Simpson, A. Benedictow, H. Berge, R. Bergstrõm, L. D. Emberson, H. Fagerli,
C. R. Flechard, G. D. Hayman, M. Gauss, J. E. Jonson, M. E. Jenkin, A. Nyíri,
C. Richter, V. S. Semeena, S. Tsyro, J.-P. Tuovinen, Á. Valdebenito, and P. Wind
Atmos. Chem. Phys., 12, 7825-7865, 2012
http://www.atmos-chem-phys.net/12/7825/2012/acp-12-7825-2012.html

... but many changes (some major) have been made since then. These changes are reported each year in the "updates" chapter of EMEP Status reports. The latest update concerns v5.0, and is:

Simpson, D., van Caspel, W., Benedictow, A., Fagerli, H., Jonson, J. E., Tsyro, S.,
Valdebento, A., and Wind, P.: Updates to the EMEP/MSC-W model, 2022–2023,
in: Transboundary particulate matter, photo-oxidants, acidifying and eutrophying components.
EMEP Status Report 1/2023, The Norwegian Meteorological Institute, Oslo, Norway, 159–179, 2023.
https://emep.int/publ/reports/2023/EMEP_Status_Report_1_2023.pdf

Please, when referring to the EMEP model, use the appropriate updates reference as well as the 2012 paper, e.g. Simpson et al., (2012, 2023, and references therein).

Running the model

How to submit a run is described in detail in Chapter 4
of the EMEP MSC-W model User Guide.

Questions on the EMEP model can be submitted to the issues tracker.
Support to the user community will be developed here with your contribution.
Please let us know what your needs for information are.

Computer requirements

To compile the EMEP model you need:

  • Fortran 95 compiler
  • NetCDF Library (>4.1.3)
  • MPI Library (>1.0)

It is necessary to compile with double precision reals (8 bytes reals).
The program has been used on computers ranging from a Linux laptop
to supercomputers (Itanium2 cluster, Intel Xeon cluster, Cray XT4, IBM power5+).
It is compatible with all compilers tested so far: Intel, PGI, gfortran, XL fortran.
A Makefile is included, the path to netcdf (INCL and LLIB) has to be adapted
to your machine, and to the fortran compiler (F90) and flags (F90FLAGS)
to the compiler you are using.

The code has been tested with 1 to 1024 CPUs, and scales well (for large grids).
If only one CPU is used 1-2 GB memory is required.
If more than one, for example 64 CPUs are used, 200 MB of memory per CPU is enough
(in the case of a 132 X 159 grid size).
For runs on more than 32 CPUs, a fast interconnect is recommended
(infiniband for example), for smaller runs, gigabit ethernet is sufficient.
It takes ~3.5 hrs on 64*Xeon X5355 (2.66GHz) for a 1-year simulation.

When downloading input data in order to do a "base run" please make sure that there
are 35 Gb disc space available, especially due to large meteorology input files.
The model can be run for shorter periods, users can download meteorology for
only the period they are interested in, plus one day.

Verification

The EMEP MSC-W model is validated and reported to the
Cooperative Programme for Monitoring and Evaluation of the
Long-range Transmission for Air Pollutants in Europe (EMEP) each year
by the EMEP/MSC-W group.
The reports can be found under the following links:

Citation

@article{emep-mscw_2012,
  author = {Simpson, D. and Benedictow, A. and Berge, H. and Bergstr\"om, R. and Emberson, L. D. and 
            Fagerli, H. and Flechard, C. R. and Hayman, G. D. and Gauss, M. and Jonson, J. E. and
            Jenkin, M. E. and Ny\'{\i}ri, A. and Richter, C. and Semeena, V. S. and Tsyro, S. and
            Tuovinen, J.-P. and Valdebenito, \'A. and Wind, P.},
  title = {The EMEP MSC-W chemical transport model – technical description},
  journal = {Atmospheric Chemistry and Physics},
  volume = {12},
  year = {2012},
  number = {16},
  pages = {7825--7865},
  doi = {10.5194/acp-12-7825-2012},
  url = {https://www.atmos-chem-phys.net/12/7825/2012/}
}

@misc{emep-ctm_v5.5,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model v5.5 (202412)},
  month        = dec,
  year         = 2024,
  doi          = {10.5281/zenodo.14507729},
  url          = {https://doi.org/10.5281/zenodo.14507729}
}

@misc{emep-ctm_v5.0,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model v5.0 (202310)},
  month        = oct,
  year         = 2023,
  doi          = {10.5281/zenodo.8431553},
  url          = {https://doi.org/10.5281/zenodo.8431553}
}

@misc{emep-ctm_rv4.45,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.45 (202203)},
  month        = mar,
  year         = 2022,
  doi          = {10.5281/zenodo.8337953},
  url          = {https://doi.org/10.5281/zenodo.8337953}
}

@misc{emep-ctm_rv4.36,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.36 (202011)},
  month        = nov,
  year         = 2020,
  doi          = {10.5281/zenodo.4230110},
  url          = {https://doi.org/10.5281/zenodo.4230110}
}

@misc{emep-ctm_rv4.34,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.34 (202001)},
  month        = jan,
  year         = 2020,
  doi          = {10.5281/zenodo.3647990},
  url          = {https://doi.org/10.5281/zenodo.3647990}
}

@misc{emep-ctm_rv4.33,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.33 (201906)},
  month        = jun,
  year         = 2019,
  doi          = {10.5281/zenodo.3265912},
  url          = {https://doi.org/10.5281/zenodo.3265912}
}

@misc{emep-ctm_rv4.17,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.17 (201802)},
  month        = feb,
  year         = 2018,
  doi          = {10.5281/zenodo.3355023},
  url          = {https://doi.org/10.5281/zenodo.3355023}
}

@misc{emep-ctm_rv4.15,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.15 (201709)},
  month        = sep,
  year         = 2017,
  doi          = {10.5281/zenodo.3355041},
  url          = {https://doi.org/10.5281/zenodo.3355041}
}

@misc{emep-ctm_rv4.10,
  author       = {EMEP MSC-W},
  title        = {Open Source EMEP/MSC-W model rv4.10 (201609)},
  month        = sep,
  year         = 2016,
  doi          = {10.5281/zenodo.3355083},
  url          = {https://doi.org/10.5281/zenodo.3355083}
}

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 6 days ago

Total Commits: 185
Total Committers: 4
Avg Commits per committer: 46.25
Development Distribution Score (DDS): 0.043

Commits in past year: 3
Committers in past year: 1
Avg Commits per committer in past year: 3.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Alvaro Valdebenito a****v@m****o 177
gitpeterwind p****d@m****o 4
Anna Benedictow a****w@m****o 3
mifads d****n@m****o 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 128
Total pull requests: 3
Average time to close issues: 7 months
Average time to close pull requests: 31 minutes
Total issue authors: 37
Total pull request authors: 2
Average comments per issue: 5.98
Average comments per pull request: 0.33
Merged pull request: 3
Bot issues: 0
Bot pull requests: 0

Past year issues: 9
Past year pull requests: 0
Past year average time to close issues: 1 day
Past year average time to close pull requests: N/A
Past year issue authors: 7
Past year pull request authors: 0
Past year average comments per issue: 4.89
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/metno/emep-ctm

Top Issue Authors

  • mvieno (22)
  • avaldebe (20)
  • PaulHamer (8)
  • gitpeterwind (6)
  • AlexanderdeMeij (5)
  • rubenww (5)
  • ln-x (5)
  • JessMBemep (5)
  • martinsaliba (5)
  • JohnJohanssonChalmers (4)
  • douglowe (3)
  • sarajutterstrom (3)
  • rosagierens (3)
  • yaoead96 (3)
  • enricopisoni (3)

Top Pull Request Authors

  • rubenww (2)
  • heikoklein (1)

Top Issue Labels

  • question (38)
  • enhancement (23)
  • documentation (15)
  • Solved (14)
  • bug (12)
  • help wanted (7)

Top Pull Request Labels

Score: 5.480638923341991