add README

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