From 8cc4c5041a14f9ced64a7871bcb57ec8bc77eea6 Mon Sep 17 00:00:00 2001 From: Alvaro Valdebenito Date: Thu, 8 Sep 2016 14:02:25 +0200 Subject: [PATCH] add README --- README.md | 106 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..355907f --- /dev/null +++ b/README.md @@ -0,0 +1,106 @@ +# Open Source EMEP/MSC-W model + +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][CLRTAP]. +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. + +[CLRTAP]: http://www.unece.org/env/lrtap/welcome.html +[GPLv3]: http://www.gnu.org/copyleft/gpl.html +[publ2016]: http://emep.int/publ/emep2016_publications.html +[rel410]: http://github.com/metno/emep-ctm/releases/tag/rv4_10 +[rel48]: http://github.com/metno/emep-ctm/releases/tag/rv4_8 +[rel45]: http://github.com/metno/emep-ctm/releases/tag/rv4_5 +[rel44]: http://github.com/metno/emep-ctm/releases/tag/rv4_4 +[rel43]: http://github.com/metno/emep-ctm/releases/tag/rv4_3 +[readme43]: http://github.com/metno/emep-ctm/releases/download/rv4_3/README_rv4_3special.txt +[rel40]: http://github.com/metno/emep-ctm/releases/tag/rv4_0 +[rel201106]:http://github.com/metno/emep-ctm/releases/tag/v201106 +[rel30]: http://github.com/metno/emep-ctm/releases/tag/rv3 + +## Releases +The latest Open Source EMEP/MSC-W model version ([rv4.10][rel410]), +corresponds to the [EMEP status reporting of the year 2016][publ2016]. +The source code, together with a set of input data, +an updated user guide and a full year model results for the year 2014, +under [GPL license v3][GPLv3]. + +#### Previous releases (YYYYMM - date of release) +* [OpenSource rv4.8 (201510)][rel48]. +* [OpenSource rv4.5 (201409)][rel45]. +* [OpenSource rv4.4 (201309)][rel44]. +* [OpenSource rv4.3 (201304)][rel43] *read the file [README_rv4_3special.txt][readme43]*. +* [OpenSource rv4.0 (201209)][rel40]. +* [OpenSource v.2011-06 (201108)][rel201106]. +* [OpenSource rv3 (200802)][rel30]. + +## 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 sigma 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][mscwmodels]. + +[mscwmodels]: http://www.emep.int/mscw/models.html#mscwmodels + +### Model Description + +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 + +### 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: +* [Status Reports][] +* [Country Reports][] + +[EMEP]: http://www.emep.int/ +[Status Reports]: http://www.emep.int/publ/common_publications.html +[Country Reports]:http://www.emep.int/mscw/mscw_datanotes.html