Add reference to MESSAGEix manuscript on overview pages

source/_static/message-globiom.bib

@@ -5,6 +5,7 @@ @techreport{message_globiom_2016
    url = {http://data.ene.iiasa.ac.at/message-globiom/},
    year = {2016}
 }
+
 @article{fricko_havlik_2017,
    author = {Fricko, O. and Havlik, P. and Rogelj, J. and Klimont, Z. and Gusti, M. and Johnson, N. and Kolp, P. and Strubegger, M. and Valin, H. and Amann, M. and Ermolieva, T. and Forsell, N. and Herrero, M. and Heyes, C. and Kindermann, G. and Krey, V. and McCollum, D. L. and Obersteiner, M. and Pachauri, S. and Rao, S. and Schmid, E. and Schoepp, W. and Riahi, K.},
    title = {The marker quantification of the Shared Socioeconomic Pathway 2: A middle-of-the-road scenario for the 21st century},
@@ -17,3 +18,12 @@ @article{fricko_havlik_2017
    doi = "http://dx.doi.org/10.1016/j.gloenvcha.2016.06.004",
 }
 
+@article{huppmann_2019_MESSAGEix,
+   author = {Huppmann, Daniel and Gidden, Matthew and Fricko, Oliver and Kolp, Peter and Orthofer, Clara and Pimmer, Michael and Kushin, Nikolay and Vinca, Adriano and Mastrucci, Alessio and Riahi, Keywan and Krey, Volker},
+   title = {{The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development}},
+   journal = {Environmental Modelling \& Software},
+   volume = {112},
+   pages = {143-156},
+   doi = {https://doi.org/10.1016/j.envsoft.2018.11.012},
+   year = {2019}
+}

source/_static/message-globiom.ris

@@ -66,3 +66,27 @@ ST  - The marker quantification of the Shared Socioeconomic Pathway 2: A middle-
 T2  - Global Environmental Change
 TI  - The marker quantification of the Shared Socioeconomic Pathway 2: A middle-of-the-road scenario for the 21st century
 ER  - 
+
+
+TY  - JOUR
+AU  - Huppmann, Daniel
+AU  - Gidden, Matthew
+AU  - Fricko, Oliver
+AU  - Kolp, Peter
+AU  - Orthofer, Clara
+AU  - Pimmer, Michael
+AU  - Kushin, Nikolay
+AU  - Vinca, Adriano
+AU  - Mastrucci, Alessio
+AU  - Riahi, Keywan
+AU  - Krey, Volker
+DO  - https://doi.org/10.1016/j.envsoft.2018.11.012
+LB  - huppmann_2019_MESSAGEix
+PY  - 2019
+SP  - 143-156
+ST  - The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development
+T2  - Environmental Modelling & Software
+TI  - The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development
+VL  - 112
+ID  - 817
+ER  - 

source/bibs/main.bib

@@ -1554,3 +1554,13 @@ @article{Raptis_2016_powerplant_data
 	keywords = {Power plants; Once-through cooling; Heat emissions; Thermal pollution; Global; Environmental impact},
 	year = {2016}
 }
+
+@article{huppmann_2019_MESSAGEix,
+   author = {Huppmann, Daniel and Gidden, Matthew and Fricko, Oliver and Kolp, Peter and Orthofer, Clara and Pimmer, Michael and Kushin, Nikolay and Vinca, Adriano and Mastrucci, Alessio and Riahi, Keywan and Krey, Volker},
+   title = {{The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development}},
+   journal = {Environmental Modelling \& Software},
+   volume = {112},
+   pages = {143-156},
+   doi = {https://doi.org/10.1016/j.envsoft.2018.11.012},
+   year = {2019}
+}

source/index.rst

@@ -11,6 +11,16 @@ When referring to MESSAGE-GLOBIOM 1.0 as described in this document, please use
 
 * Fricko O, Havlik P, Rogelj J, Klimont Z, Gusti M, Johnson N, Kolp P, Strubegger M, Valin H, Amann M, Ermolieva T, Forsell N, Herrero M, Heyes C, Kindermann G, Krey V, McCollum DL, Obersteiner M, Pachauri S, Rao S, Schmid E, Schoepp W, Riahi K (2017) The marker quantification of the Shared Socioeconomic Pathway 2: A middle-of-the-road scenario for the 21st century. Global Environmental Change, Volume 42, Pages 251-26, `DOI:10.1016/j.gloenvcha.2016.06.004 <https://doi.org/10.1016/j.gloenvcha.2016.06.004>`_.
 
+The MESSAGE-GLOBIOM Integrated Assessment Model is based on the |MESSAGEix|
+framework, an open-source energy systems optimization modelling environment
+including macro-economic feedback using a stylized computable general
+equilibrium model.
+When referring to the software underpinning MESSAGE-GLOBIOM rather than the data
+or specific assessments, please use the following citation:
+
+* Huppmann D, Gidden M, Fricko O, Kolp P, Orthofer C, Pimmer M, Kushin N, Vinca A, Mastrucci A, Riahi K, Krey V (2019) The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development. Environmental Modelling & Software, Volume 112, Pages 143-156, `DOI:0.1016/j.envsoft.2018.11.012 <https://doi.org/0.1016/j.envsoft.2018.11.012>`_.
+
+
 We thank Edward Byers, Jessica Jewell, Simon C. Parkinson, Narasimha D. Rao for their valuable comments that helped improving this manuscript.
 
 .. toctree::
@@ -26,3 +36,5 @@ We thank Edward Byers, Jessica Jewell, Simon C. Parkinson, Narasimha D. Rao for
    climate/index
    bibliography
    annex/index
+
+.. |MESSAGEix| replace:: MESSAGE\ :emphasis:`ix`

source/overview/index.rst

@@ -6,6 +6,8 @@ The IIASA IAM framework consists of a combination of five different models or mo
 
 MESSAGE represents the core of the IIASA IAM framework (:numref:`fig-iiasaiam`) and its main task is to optimize the energy system so that it can satisfy specified energy demands at the lowest costs. MESSAGE carries out this optimization in an iterative setup with MACRO, which provides estimates of the macro-economic demand response that results from energy system and services costs computed by MESSAGE. For the six commercial end-use demand categories depicted in MESSAGE (see :ref:`demand`), MACRO will adjust useful energy demands, until the two models have reached equilibrium (see :ref:`macro`). This iteration reflects price-induced energy efficiency improvements that can occur when energy prices change.
 
+The scientific software powering the global MESSAGE model is called the |MESSAGEix| framework, an open-source, versatile implementation of a linear optimization problem, with the option of coupling to a computable general equilibrium (CGE) model to incorporate the effect of price changes on economic activity and demand for commodities and resources. |MESSAGEix| is integrated with the *ix modeling platform* (ixmp), a powerful "data warehouse" for version control of reference timeseries, input data and model results. ixmp provides interfaces to the scientific programming languages Python and R for efficient, scripted workflows for data processing and visualisation of results (Huppmann et al., 2019 :cite:`huppmann_2019_MESSAGEix`).
+
 GLOBIOM provides MESSAGE with information on land use and its implications, including the availability and cost of bioenergy, and availability and cost of emission mitigation in the AFOLU (Agriculture, Forestry and Other Land Use) sector (see :ref:`globiom`). To reduce computational costs, MESSAGE iteratively queries a GLOBIOM emulator which provides an approximation of land-use outcomes during the optimization process instead of requiring the GLOBIOM model to be rerun iteratively. Only once the iteration between MESSAGE and MACRO has converged, the resulting bioenergy demands along with corresponding carbon prices are used for a concluding analysis with the full-fledged GLOBIOM model. This ensures full consistency of the results from MESSAGE and GLOBIOM, and also allows producing a more extensive set of land-use related indicators.
 
 Air pollution implications of the energy system are accounted for in MESSAGE by applying technology-specific air pollution coefficients from GAINS (see :ref:`gains`).
@@ -24,3 +26,5 @@ In general, cumulative global carbon emissions from all sectors are constrained
 
    spatial
    temporal
+
+.. |MESSAGEix| replace:: MESSAGE\ :emphasis:`ix`