Skip to content

Add documentation on the land-use emulator#50

Merged
khaeru merged 18 commits intoiiasa:masterfrom
OFR-IIASA:add_details_land_use_emulator
Apr 30, 2021
Merged

Add documentation on the land-use emulator#50
khaeru merged 18 commits intoiiasa:masterfrom
OFR-IIASA:add_details_land_use_emulator

Conversation

@OFR-IIASA
Copy link
Copy Markdown
Contributor

@OFR-IIASA OFR-IIASA commented Sep 10, 2020

In order to review, please make a local build of the documentation and read /message_doc/_build/html/land_use/emulator.html

Comment thread land_use/emulator.rst Outdated
Equations and constraints
-------------------------

The land-use pathways are integrated into MESSAGE using a dedicated set of equations (add link to documentation). At the core, these state that the linear combination of land-use pathways must be equal to 1. Therefore, separately for each region, discrete land-use development pathways can either be used individually or combine linearly to obtain biomass quantities for example, which are not explicitly represented as part of the land-use matrix. This also applies to the mitigation dimension i.e. to the GHG categories.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence "At the core, these state that the linear combination of land-use pathways must be equal to 1. Therefore, separately" and the following discussion is not clear. Is this the sum of land shares from a total land available?

@khaeru khaeru changed the title WIP: Adding documentation on the land-use emulator. WIP: Add documentation on the land-use emulator Mar 12, 2021
@khaeru
Copy link
Copy Markdown
Member

khaeru commented Mar 18, 2021

Per discussion in Slack, the 2020 documentation will be released now that #51 is in. This PR should be (a) rebased, (b) updated with GLOBIOM documentation from the colleagues who will supply it, and (c) merged in advance of a 2021 release.

@OFR-IIASA
Copy link
Copy Markdown
Contributor Author

A few comments from a conversation on slack (from Behnam, Oct. 13, 2020) to improve the documentation of the emulator:

  • the legend and labels of some figures can be improved by a more suitable size, also for the figure captions adding more information on each sub-plot when there are multiple figures. (e.g., figure (above) shows..., while below shows...).
  • does it make sense to add numbers to equations (Eq. 1, ...)? Then, it's easier to refer to them in the text.
  • the costs and prices are in $2005. It may be worth to update this as we are in 2020 and it may be difficult to back-calculate the numbers.

@OFR-IIASA
Copy link
Copy Markdown
Contributor Author

@behnam-zakeri I have made changes to address the last set of comments:

  • Adjusting all figures and describing the panels in the text
  • Switching all units to $2010
  • Adding formula references

@OFR-IIASA OFR-IIASA changed the title WIP: Add documentation on the land-use emulator Add documentation on the land-use emulator Apr 23, 2021
@OFR-IIASA OFR-IIASA requested a review from behnam-zakeri April 23, 2021 10:02
@OFR-IIASA OFR-IIASA force-pushed the add_details_land_use_emulator branch from 276ae2d to a9acd17 Compare April 27, 2021 11:33
@khaeru khaeru self-requested a review April 30, 2021 14:31
@khaeru
Copy link
Copy Markdown
Member

khaeru commented Apr 30, 2021

Compiles with no warnings. Thanks @OFR-IIASA!

@khaeru khaeru merged commit e5202bd into iiasa:master Apr 30, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants