Citation Rules

MESSy Citation Rules

For publication of results based on MESSy in a scientific journal, the Creative Commons Attribution-NonCommerical-ShareAlike Licence also applies.

  • You are requested to consult the CSG on proper acknowledgement, and in particular on potential co-authorships, during the early drafting phase of your manuscript (publication or proposal). Please recall that the maintainers of involved submodels should be contacted about recent bug-fixes and other changes, and about proper acknowledgement or co-authorship (following the MESSy submodel licences). We will only request co-authorship for model developers where it is really appropriate.
  • We request that end-users using MESSy or stand-alone components of MESSy in planned publications or proposals upload a pre-print of their draft manuscript at least two weeks prior to submission to the MESSy Wiki, to provide some time to check and prevent misinterpretation of model results and conflicts of interest. If you object to this procedure, please send it to the CSG, who will instead distribute the draft only to submodel maintainers involved.

How to cite the application of ECHAM/MESSy

We ask you to cite the application of ECHAM/MESSy as EMAC without any additional pre- or suffixes indicating your institution, specific submodel or any other additional information misleadingly suggesting different model systems. Please highlight such information (e.g., the outstanding role of a specific submodel, etc.) in the abstract or in the main body of your manuscripts where describing the model configuration and setup (see MESSy Glossary). The following citation suggestions should be adapted with respect to the applied version of MESSy and the appropriate resolution.

EMAC

“The ECHAM/MESSy Atmospheric Chemistry (EMAC) model is a numerical chemistry and climate simulation system that includes sub-models describing tropospheric and middle atmosphere processes and their interaction with oceans, land and human influences (Jöckel et al., 2010). It uses the second version of the Modular Earth Submodel System (MESSy2) to link multi-institutional computer codes. The core atmospheric model is the 5th generation European Centre Hamburg general circulation model (ECHAM5, Roeckner et al., 2006). The physics subroutines of the original ECHAM code have been modularized and reimplemented as MESSy submodels and have continuously been further developed. Only the spectral transform core, the flux-form semi-Lagrangian large scale advection scheme, and the nudging routines for Newtonian relaxation are remaining from ECHAM. For the present study we applied EMAC (MESSy version 2.55.0) in the T42L90MA-resolution, i.e. with a spherical truncation of T42 (corresponding to a quadratic Gaussian grid of approx. 2.8 by 2.8 degrees in latitude and longitude) with 90 vertical hybrid pressure levels up to 0.01 hPa. The applied model setup comprised the submodels …”

References

All applied submodels and the respective references have to be listed as stated in the list of MESSy Submodels. The following publications should be referenced, more appropriate references can also be found in the the MESSy Publications.

Jöckel, P., Kerkweg, A., Pozzer, A., Sander, R., Tost, H., Riede, H., Baumgaertner, A., Gromov, S., Kern, B., Development cycle 2 of the Modular Earth Submodel System (MESSy2), Geoscientific Model Development, 3, 717-752, https://doi.org/10.5194/gmd-3-717-2010, 2010.

Roeckner, E., Brokopf, R., Esch, M., Giorgetta, M., Hagemann, S., Kornblueh, L., Manzini, E., Schlese, U., and Schulzweida, U.: Sensitivity of simulated climate to horizontal and vertical resolution in the ECHAM5 atmosphere model, J. Climate, 19, 3771-3791, 2006.

How to cite the application of COSMO/MESSy

We ask you to cite the application of COSMO/MESSy as COSMO/MESSy or COSMO-CLM/MESSy without any additional pre- or suffixes indicating your institution, specific submodel or any other additional information misleadingly suggesting different model systems. Please highlight such information (e.g., the outstanding role of a specific submodel, etc.) in the abstract or in the main body of your manuscripts where describing the model configuration and setup (see MESSy Glossary).

COSMO/MESSy

“COSMO-CLM/MESSy is a numerical chemistry and climate simulation system that includes sub-models describing tropospheric (partly stratospheric) processes and their interaction with oceans, land and human influences (Kerkweg and Jöckel, 2012a). It uses the second version of the Modular Earth Submodel System (MESSy2) to link multi-institutional computer codes. The core atmospheric model is COSMO-CLM. COSMO-CLM (COSMO model in Climate Mode) is the community model of the German regional climate research community jointly further developed by the CLM-Community (COSMO-CLM, Rockel et al., 2008). For the present study we applied COSMO-CLM/MESSy (COSMO version 5.0_clm10, MESSy version 2.55.0). The applied model setup comprised the submodels … [list of submodels with references, see MESSy Submodels].”

References

Kerkweg, A. and Jöckel, P.: The 1-way on-line coupled atmospheric chemistry model system MECO(n) – Part 1: Description of the limited-area atmospheric chemistry model COSMO/MESSy, Geosci. Model Dev., 5, 87-110, https://doi.org/10.5194/gmd-5-87-2012, 2012a.

Rockel, B., Will, A., and Hense, A.: The Regional Climate Model COSMO-CLM (CCLM), Meteorol. Z., 17, 347-348, 2008

How to cite the application of MECO(n)

We ask you to cite the application of MECO(n) as MECO(n) without any additional pre- or suffixes indicating your institution, specific submodel or any other additional information misleadingly suggesting different model systems. Please highlight such information (e.g., the outstanding role of a specific submodel, etc.) in the abstract or in the main body of your manuscripts where describing the model configuration and setup (see MESSy Glossary). The (n) of MECO(n) referes to the number of nested instances, e.g., MECO(2) comprises a master model with two nested instances of COSMO/MESSy.

MECO(n)

“MECO(n) is short for MESSy-fied ECHAM and COSMO models nested n times. It features an online coupling of the COSMO-CLM model, equipped with the Modular Earth Submodel System (MESSy) interface (called COSMO-CLM/MESSy), with the global atmospheric chemistry model ECHAM5/MESSy for Atmospheric Chemistry (EMAC), see Kerkweg and Jöckel, 2012b. For the present study we applied a MECO(n) setup with EMAC (ECHAM version 5.3.02) in … resolution and n nested COSMO-CLM/MESSy (COSMO version 5.0_clm10, MESSy version 2.55.0) instances. The applied model setup comprised the submodels … [list of submodels per model instance with references, see MESSy Submodels)].”

References

Kerkweg, A. and Jöckel, P.: The 1-way on-line coupled atmospheric chemistry model system MECO(n) – Part 2: On-line coupling with the Multi-Model-Driver (MMD), Geosci. Model Dev., 5, 111-128, https://doi.org/10.5194/gmd-5-111-2012, 2012b.

How to cite the application of MESSy

Please cite the following publication for applications of MESSy:

Jöckel, P., Sander, R., Kerkweg, A., Tost, H., and Lelieveld, J., Technical Note: The Modular Earth Submodel System (MESSy) – a new approach towards Earth System Modeling, Atmos. Chem. Phys., 5, 433-444, http://www.atmos-chem-phys.net/5/433/2005/, 2005.

Special Section for GMD(D)

The EGU Journal Geoscientific Model Development has special rules regarding the accessibility of the code used and described in a publication, in particular:
” All papers must include a section, at the end of the paper, entitled ‘Code availability’. Here, either instructions for obtaining the code, or the reasons why the code is not available should be clearly stated. It is preferred for the code to be uploaded as a supplement or to be made available at a data repository with an associated DOI (digital object identifier) for the exact model version described in the paper. Alternatively, for established models, there may be an existing means of accessing the code through a particular system. In this case, there must exist a means of permanently accessing the precise model version described in the paper. In some cases, authors may prefer to put models on their own website, or to act as a point of contact for obtaining the code. Given the impermanence of websites and email addresses, this is not encouraged, and authors should consider improving the availability with a more permanent arrangement. After the paper is accepted the model archive should be updated to include a link to the GMD paper.” (see http://www.geoscientific-model-development.net/gmd_journal_white_paper.pdf) This also applies to publication of MESSy submodels. As consortium we agreed on NOT providing individual submodels as part of the electronic supplement, unless they are embedded in a stand-alone program. Furthermore, licence conditions of our legacy codes prohibit the provision of the entire source code as publicly available electronic supplement. We therefore recommend to use the following text for the “Code availability” section.

Code availability

“The Modular Earth Submodel System (MESSy) is being continuously further developed and applied by a consortium of institutions. The usage of MESSy and access to the source code is licenced to all affiliates of institutions who are members of the MESSy Consortium. Institutions can become a member of the MESSy Consortium by signing the MESSy Memorandum of Understanding. More information can be found on the MESSy Consortium website (http://www.messy-interface.org). The code presented here was developed based on MESSy version X and will be available in the next official release (version Y).”

As the exact code described and used in the paper needs to published, it needs to be ensured, that exactly the code published is part of the next official relase (version Y). This requires, that the code is checked in by the developer and approved by the source code administrators before publication, or, to be more precise, before starting the simulations analysed in the publication. In case of doubt, please contact the Consortium Steering Group for advice.