This is part of the labels / documentation for <a href='http://jcm.chooseclimate.org'>Java Climate Model</a><hr/>

#jcm.mod		¨addJCM5		§see also 
<ul>
<li>Old label: @mod
<li>@package, @module
</ul>

#jcm.mod.obj		¨addJCM5		§This package contains modules which set the objective and calculate the scenario driving the rest of JCM. 
 The fundamental choice is made by the parameter @objective in  @controller , which switches primary control to one of these modules. However several modules may be active due to feedbacks between them.

See also 
old link: @emitcc

#jcm.mod.soc		¨addJCM5		§This package gathers modules for regionally distributed socioeconomic factors and emissions. All curves in this package share the same adjustable @regions. 

Curves in @socreg combine @history with future projections. Deepnding on the chosen @objective these depend on either @futbasescen or @stabilisation scenarios distributed according to parameters in @shares. 
Regional @costs and @responsibility may also be explored.

#controller		¨addJCM5		§This module directs the flow of the JCM calculation loop, determining which other modules are called in which sequence, depending on the fundamental question / paradigm set by the parameter @objective

See also: 
@philosophy 
 old label: @mitigation
----

#futbasescen		¨addJCM5		§This module calculates  bottom-up scenarios based on the evolution of driving forces, following storylines such as @aboutsres

See also old modules: @sres @people
See also @interpolator

#shares		¨addJCM5		§Documentation to be updated.
see old modules: @regshares, @kyoto
see old plot @distribplot
see old label: @distribution

#socreg		¨addJCM5		§This module acts as a container for all regional socioeconomic and emissions curve sets. You can change the set of regions with the parameter @regions 

Note also @regiondatasource, @history, @futbasescen

Old doc to be updated:
Future regional emissions may be mitigated according to various formulae -see @stabilisation, @distribution,
See old modules:  @regshares,  @people
See old plot: @distribplot
----

#CalcLucEmit		¨addJCM5		§see also @biome 

<img src="../data/lu_A_1700.png">
----

#berncarbon		¨addJCM5		§Below is old JCM4 documentation to be updated
Some of it relates to @atco2flux and @atco2conc plots

JCM carbon cycle is based on the Bern model, as used by IPCC. This was originally calibrated using chemical tracer and isotope data, and its predictions fall in the mid-range of model intercomparisons.



See also @carboncycle @carbonatechemistry @carbonstorage

See also old labels:
@carbonemissions,
@carbonfuture

 ¤adju Note: It is easier to understand the effect of the parameters, when the model is working in forwards rather than @inverse mode: -see old label @sinksdynamic

  ---- 
¤adju ££sinksocean 
¤cogs  ==Ocean sink: HILDA model ==
  (HILDA = High-Latitude Diffusion Advection)   <li>low-latitude (84% surface) divided into 36 layers   <li>depth-dependent vertical diffusion between layers   <li>high-latitude box, well-mixed   <li>horizontal advection between HL & LL   <li>slow upwelling loop (down in HL, up in LL)   <li>surface layer (HL and LL) exchanging with atmosphere   <li>non-linear carbonate chemistry with feedback from temperature
  
---- 
 ¤adju ££sinksbiosphere 
¤cogs ==Terrestrial Biosphere sink==
  4-box biosphere :   <li>green, wood, soil, humus boxes,   <li>linear fluxes between boxes and to atmosphere   <li>non-linear "CO2 fertilisation" factor 'beta'   
<li>temperature-soil respiration feedback (new in JCM5)

  ---- ===Calculation method===
  The entire system is solved using an efficient eigenvector calculation method with a ramp function for non-linear fluxes.
  <hr> See also<li> Joos et al 2001 (@references),<li>@eigenvec,<li>@compareipcc, IPCC-TAR WG1 Chapter 3


----

#carbonatechemistry		¨addJCM5		§CO2 reacts with alkaline seawater to form bicarbonate ions
  CO2 + H2O <=> HCO3- + H+
  This conversion reduces the partial pressure of CO2 in seawater, giving the ocean has a vast capacity to store CO2. Currently the ocean holds about 50 times more inorganic carbon than the atmosphere, 99% of it in the form of HCO3-.
  However adding CO2 to seawater makes it more acidic, which reduces this "buffer capacity". Increasing the temperature also affects the chemical equilibria and reduces the solubility of CO2 in seawater. Both these feedbacks (acidification and temperature) act to decrease the future ocean sink.
  If you select "linear" from the @carbchemmenu (expert level) you will switch off the acidification effect.
  If you disable the @chemfbopt you will switch off the feedback from temperature. You may observe that this removes the spikes in the historical ocean sink, which are caused by equivalent spikes in radiative forcing, especially volcanos.
  (see also @flowchart )

#carbonstorage		¨addJCM5		§This module saves data for the  @carbonstoragecurves plot 
(this process is separated from @berncarbon simply for computationally efficiency, as it is only needed when the plot is visible) 


----

#aerosolrf		¨addJCM5		§see also @radfor
see old label: @radforintro @radforaerosol, @radforsolvol, @radfordistrib

#othgasemitoptions		¨addJCM5		§Follow links below for the formula for each variant
  These formulae scale the emissions of all gases other than CO2, including CH4, N2O, HFCs, PFCs,   SF6,  tropospheric ozone precursors (CO,VOC,NOx) and aerosols (SOx, Soot). Only the gases already controlled by the Montreal protocol (ClFCs, HClFCs) are excluded.

  %% ¤cogs Note: BC/OC aerosols are either scaled to CO, or to land-use change.  -see @radforaerosol %%
  <hr>
The chosen formula apply to <b>all</b> stabilisation scenarios in JCM
  %%(see @stabemitdoc, @stabconcdoc, @stabrfdoc, @stabtempdoc, @stabseadoc)%%

@sresscale is the default option for all JCM stabilisation scenarios.
  @sresfix (with scenario @A1B) was used in IPCC-SYR (see @ipccothgas)
  <hr>See also @othgasplot, @fgasplot, @radforplot

#co2eq&allghg		¨addJCM5		§This adds Tropospheric and Stratospheric Ozone, and CFCs to  @co2eq&6gas . Beware that the distribution of ozone forcing is different to that of well-mixed greenhouse gases  
<li>see also @oghga, @fgases, @co2eq

££co2eq

#co2eq&6gas		¨addJCM5		§The 'six' gases controlled by the Kyoto protocol are CO2, N2O, CH4, SF6, PFCs, HFCs  <li>See also @kyoto, @co2eq

££co2eq

#co2eq&allghgaero		¨addJCM5		§This adds Sulphate and Carbon Aerosols to @allghg (so it includes all forcing from anthropogenic emissions). Beware that the distribution of aerosol forcings is very different to that of greenhouse gases, so one cannot say that positive forcing (from GHGs) in one region is cancelled by negative forcing (from aerosols) in another: the result is still climate change!  <li>see also @radforaerosol, @co2eq

££co2eq

#co2equivconc		¨addJCM5		§See @co2eq for more explanation

#carbonstoragecurves		¨addJCM5		§This shows  the contents of all the boxes in the carbon cycle model (ocean layers and biosphere). The curves are simply the contents of the cq array in the @berncarbon . 
These contain only "extra" anthropogenic carbon, excluding the contents in the preindustrial steady state. See also @atco2plot.


See @carbonstorage for more explanation

#JCM25		¨addJCM5		§A set of 25 regions used for @socreg .
£§jcmregcol

#attmeth		¨addJCM5		§There are several methods of attributing cumulative effects when the cause-effect relationship is non-linear. For more information see the documentation under @attribution
%%¤cogs note only the tracer method is currently working, although others have been tried in earlier versions of JCM.%%

#history		¨addJCM5		§This module assembles historical data from various sources, interpolating over time and space to fit the chosen  @regions.
It's main output is found in curve-sets in @socreg, combined with future scenario data.  Some additional curves (for experts to check)  are below.
Note also old link: @regiondatasource
Note also the separate module @CalcLucEmit
See aso @interpolator

#fosCO2		¨addJCM5		§Original data from CDIAC
See old link: @regiondatasource

#pop		¨addJCM5		§Population data from Kees Goldvijk,RIVM-HYDE
More info to be added later

#aviaship		¨addJCM5		§Exprrimental, Under construction

#jcm		¨addJCM5		§See also old link: @comp

#Worlds		¨addJCM5		§JCM5 has a "parallel worlds" structure, allowing simultaneous comparison of several projections using different parameters (scenarios, scientific uncertainties, policy options). 
¤adju You can make an additional world (or remove it) using the Worlds menu at the top. Each world provides it's own @treeMaker. 
¤adju To compare data in different worlds on one plot, use the @compareworlds option in the popup menu corresponding to each @qtset (from the @treeMaker or from @plots).  

¤cogs Each world's modules, parameters and curves are entirely independent (excepting "static" historical datasets). There is no limit set to the number of parallel worlds, however beware that using several  parallel worlds takes a lot of computer memory (especially if you use large region sets). 
¤cogs Later it is envisaged to implement partially-parallel worlds in which some modules are shared and some are different (e.g. same emissions scenarios but different climate response), which could offer large efficiency savings for complex calculations.
¤cogs The parallel worlds system takes advantage of java's object-oriented structure (see @aboutjava)

The contents of the current set of worlds are below:

#world		¨addJCM5		§One of several parallel worlds, see @Worlds
¤cogs code in World also unpacks the packages  during model startup.

#complexity		¨addJCM5		§see @complexitymenu

#jcm.core		¨addJCM5		§Package containing core building blocks of JCM

#infob		¨addJCM5		§An object with basic information (name, colour, complexity), that can feature in @menuMaker and @treeMaker, linking to a set of more infobs or actions

#interacob		¨addJCM5		§An extension of infob which stores information about model interactions (calculation dependencies). 
See also @interactions, @interacmap, @register, @loop
----
Below is old JCM4 documentation to be updated

£§iob

#qt		¨addJCM5		§One curve in a @qtset, that may be shown in @plots

#register		¨addJCM5		§Contains lists of all @interacob and @plotlink, and various methods to organise them

#setup		¨addJCM5		§A small text file storing enough information about parameters, layout and plots to recreate the current setup of JCM is saved automatically when the model is closed, and reloaded on opening.

Some alternative default setups are also provided within the main JCM package.

¤adju You can save your own custom setups  (e.g. for pre-prepared demonstrations)  and reload them later  from the Setup menu at the top

¤adju The Setup menu also contains an option to reset all parameters to default values

¤cogs These files are stored in a folder called "setup" in your JCM home directory.
¤cogs Persistence should be reliable for model parameters but not yet for layout. 
¤adju If you find the stored layout is causing problems starting the model, try deleting setup/current.txt

see also @StartJCM

#units		¨addJCM5		§Units of @qt and @param.
Units may be combined (for ratios of @qt), in which case common factors should be cancelled. When dividing two quantities, JCM also tries to cancel powers of ten, converting to standard SI multiples (see below).

 %%¤adju If this gives you a strange quantity (e.g. "micro-person per joule per year"), it probably makes more sense to choose instead the opposite  ratio (e.g. megajoule per person per year). %%

  ££siunits ££unitbaseline  ££time

<hr>See also @howmuchgtc

#jcm.gui		¨addJCM5		§Package containing Graphical User Interface components of JCM

#labman		¨addJCM5		§Stores, Loads and Saves all @label, both from the original package, and changes due to editing (see @docview)

#sourceview		¨addJCM5		§A simple viewer for checking JCM java source code.
It can also display several types of input data stored in the JCM packages
¤adju Access this from the source menu at the top 
¤cogs Note, this decorates java using html (for colors fonts and layout), if you want the original code please unpack the JCM5.jar package (note a jar file is just like a zip archive). 
¤adju If you want to explore the code in more depth, it is recommended to use an IDE such as netbeans (@www.netbeans.org)

#contextMenu		¨addJCM5		§shows popup context menus

#imagesaver		¨addJCM5		§A tool to save or copy an image (png or jpg) from @plots or other @panels (accessed from popup menus)

#plots		¨addJCM5		§From each @qtset several types of plot can be created
@lineplot
@datable
@histoplot
@scatterplot
----
see also @jcm.gui.plot

#processdialog		¨addJCM5		§A box showing information about any slow process,
e.g. loading large GCM datasets or documentation files, or iterative calculations used in @optimisation or @scripting

#datable		¨addJCM5		§A table showing all @qt in a @qtset
Get this from popup menus in @treeMaker or from the menu at the top.

¤cogs The table is dynamically linked to the model: changing parameters may change the table contents. On the other hand, you cannot edit the contents directly. 
%%¤cogs Note, for a few data columns a scaling factor (e.g. x1000) has been applied on the visible graph. %%
¤adju You can save the data, using the option in the popup menu (right-click). You can also choose the separator, in case you want it in a particular format for pasting into another application. 
¤adju You can move the columns about

#jcm.tls		¨addJCM5		§Package containing code for file input/output, reflection and text manipulation

#histoplot		¨addJCM5		§A histogram made from data from two @qtset, for a specific year. 
If we call the curve sets A and B, then the height of each bar shows A/B, the width of each bar shows A, and the area shows B. 
 
For example, if the bar height shows emissions per capita for each region (see @socreg), the width shows population, and the area shows emissions. This illustrates both which regions are the largest emitters, and which are the largest per-capita emitters.

Another variant adds an extra dataset, e.g. to show both fossil and landuse change  emissions per capita

¤adju The slider chooses the year - it is interesting to drag this to see changes over time

#scatterplot		¨addJCM5		§This is experimental, still under construction

#lineplot		¨addJCM5		§A plot showing how a @qtset changes over time
Get the plot by dragging an icon from a @treeMaker into another @panel.

¤cogs It make take some time for the model to recalculate, depending on @interactions, especially if much has changed since this @qtset was last used.

¤cogs The plot is dynamically linked to the model and will respond to changing @param - try dragging sliders in the @treeMaker 


¤adju Some extra options are accessible from the popup menu (right-click). 
<ul>
<li> You can stack the curves.  
Some curves (e.g. ratios, totals) cannot be stacked
<li> You can copy or save an image (see @imagesaver)
<li> You can create subsidiary plots combining two @qtset
</ul>
¤adju You can also change the scales by dragging them.
Double click to set the origin (fixed point) for dragging
¤adju More information about each @qt and @scaleview  is provided as you move the mouse over them.

#scaleview		¨addJCM5		§An adjustable scale
¤adju You can change scales by dragging them, which stretches or squeezes rhe scale ith respect to a fixed point (usually 0 for vertical axis,2000 for time axis) . To choose a different fixed point, double click on the scale

¤adju Move your mouse over the axis to see pop-up info about units and range

When a plot is opened an appropriate scale range is calculated automatically. 
See also @units

#package		¨addJCM5		§JCM, like all java code, is organised into  packages of related classes of objects.
See also @jcm.mod
@aboutjava

#showpan		¨addJCM5		§Manages the arrangement of @panels

#normal		¨addJCM5		§This is for general use. All curves and controls will be shown at normal level and above, unless their code specifies otherwise.

#simplest		¨addJCM5		§This is to help beginners learning how to use JCM, showing just one curve and one or two key controls per plot. It is only implemented for a few panels, to show interactions between CO2 emissions, concentration, forcing, temperature and sealevel. Beware that any simplification hides important assumptions -you should not present results derived from consideration of this level alone!

#EditDoc		¨addJCM5		§JCM documentation can be edited using a convenient "wiki" system.

Changes to the source text are shown immediately in the documentation.
Changes to labels are also used elsewhere in the model, when refreshed (e.g. when you click on the @treeMaker). 

Start by choosing "Edit Doc Source" from the "Edit Doc" menu at the top of any @docview panel. A split-panel for editing will appear to the right. 

---- ==Labels / Keys==

Each label/page has a unique identifying key (shown at the top of docview, you can also see keys in the @treeMaker and in hyperlinks by choosing  "label codes" from the Language menu (within View menu)

At the top of the editing panel are short text-fields for the "category" (used for dividing the files and organising the @labdoctable) and any extra information about this label (whatever you like, e.g.  "fix-me!").  

Below are two text-fields for the short label (used for hyperlinks and by @menuMaker, @treeMaker and @legend)  and medium label (used  for titles of pages and subsections). 

---- ==Wiki syntax==

Below this are two larger panes. The text in the upper one (black text, editable), will be converted into HTML for the documentation. 

Some convenient "wiki"-style shortcuts are provided for text-formatting:
%%(to understand these examples, look at the source in edit-doc panel)%%
 **bold**  //italic// --strikeout--  __underline__ %%small%% ,,subscript,, ^^superscript^^ 
It is also easy to add icons e.g.  ¤cogs ¤clou ¤tool ¤bern using names in png/iconnames.txt (inside JCM package)

Normal HTML  tags can also be used, but note that the java5 html parser does not recognise as many tags as some browsers.

----==HyperLinks and Inserts==

HyperLinks are made using the at-sign plus the label key, like this @docexample.
 If this key does not yet exist,  the link will appear red as in @anotherexample, you can click on it to open a new blank label for editing.

Source text may also contain code (starting with a pound-sign) to insert subcomponents from other keys, in several ways, as shown by examples 1-5 below
<ul>
<li>1. £`docexample
<li>2. £~docexample
<li>3. £§docexample
<li>4. £%docexample
<li>5. ££docexample
</ul>
Example 4 makes a summary of limited length excluding any %%small text%%, further inserts, or extra dynamic  documentation (see below).
Example 5 creates as subsection and also adds a bookmark at the top of the page.

Right-click on the editing panel to jump directly to edit the label/documentation of any of these subcomponents.

----==Extra Dynamic Documentation==

After this extra documentation may be added, as shown in the lower panel (brown colour, not editable). This is automatically generated by the model to provide dynamic information about this model component (e.g. @infob, @module,  @param, @qtset, @qt, @region) . This also uses inserts (as described above), which you can edit using keys from the popup menu (right-click).

¤cogs The system is still evolving, to understand exactly how it works look in @autodoc and getExtraDoc() methods in code of @infob and its descendants.

----==Saving and Loading==

When you close JCM, all changes to labels/documentation will be saved automatically in text files in a folder "labdocchanges", and reloaded next time you start JCM. Thus, you can accumulate edits without worrying about saving them. However it is wise to make a backup of 'labdocchanges"  from time to time (especially while the system is still evolving).

To blend with the existing documentation, you can use "Save All" option from the "Edit Doc" menu, this saves many files which can be reloaded together using the "Load" option. 
Eventually, changes should be incorporated permanently into the JCM package for distribution, regarding this please consult Ben Matthews.

----
see also old label: @labdoc

#docexample		¨addJCM5		§Text of key docexample

#howuse		¨addJCM5		§Here are some hints to get started using JCM5
<ul>
<li>Start by exploring the model using @treeMaker. 
Click on items to expand/collapse branches. 
<li>From this tree,  drag @qtset into @panels to open @plots. 
¤cogs There may be a delay to show new plots, as the model calculates only as needed (see @interactions)
<li>From a tree, you can also drag a @package or a @module into another panel to make sub-trees, this is useful for keeping a set of parameters visible.
<li>Try adjusting some @param (e.g. drag a slider with the mouse), you should see an instance response on related plots.
<li>You can change the layout by resizing or splitting @panels - right click to see a popup menu with options. You can also drag tabs from one panel to another.
<li> Each item has @docview which can be accessed from the menu or by clicking on an item in the tree if  @helpmode is enabled
</ul>
Note also the following:
<ul>
<li> The @treeMaker uses same package structure as the java code, see @jcm. 
<li> @menuMaker at the top  (@Tree @Doc @Params @Plot @Table @Map) also use this structure, filtered to include only  specific types of items 
<li> Some items  in the the @treeMaker and @menuMaker may be hidden -  see @filterenabled and @complexitymenu
<li>You get more options by right-clicking on plots / tables etc. 
<li> In case of problems, check messages in @sysout
<li> To see the relationships between modules check the @interacmap
<li>You can also change the @languagemenu of labels and documentation. Translations need updating, but there is a convenient system for @EditDoc 
<li> You can @imagesaver Saving or copying images/tables won't work in the Java-Web-Start "safe-mode" (without disk access).
<li> Parameters and Layout will be saved and reloaded next time you start JCM -see @setup

</ul>
----
See also old label: @intro
(note this refers to JCM4 which has a quite different user interface)

#menuMaker		¨addJCM5		§At the top of JCM window are some menus 
@Tree @Doc @Params @Plot @Table @Map @Source
which are formed by filtering the heirachical  tree of @infob (used for @package) and its descendants @module @param and @qtset, to show only one specific type of objects. 
Note: Menus, like @treeMaker are affected by @complexitymenu and @filterenabled in the View menu

#moulist		¨addJCM5		§Handles drag and drop between @panels

#circmenu		¨addJCM5		§A circular menu for quickly finding JCM components, providing an alternative navigation system to @treeMaker . 
This is experimental.

#translation		¨addJCM5		§Documentation coming soon

See @docview, @EditDoc
See old labels: @labdoc, @acknowtranslate

#jcm.mod.data		¨addJCM5		§A package containing java code for loading external data

#jcm.mod.math		¨addJCM5		§A package containing some mathematical tools

Note also @jama

#jcm.mod.carbon		¨addJCM5		§This package contains modules concerned with the cycle of carbon between the atmosphere, ocean and terrestrial biosphere.

#jcm.mod.ogas		¨addJCM5		§This package contains  modules relating to the emissions, atmospheric chemistry, concentration and radiative forcing of all gases except CO2, i.e. CH4, N2O, Ozone (from NOx, CO and VOCs), CFCs, HFCs, SF6, and sulphate and carbon aerosols. Effects of solar variability and volcanos are also included.
See also @radfor

#jcm.mod.cli		¨addJCM5		§This package contains modules calculating the steps from @radfor, via @glotemp, through to global @sealevel,  in other words all modules concerning heat fluxes. 
The main calculations are made by a @udebclimod based on the model of Wigley & Raper.

#jcm.mod.reg		¨addJCM5		§This package concerns regional climate change, scaling the results from the simple global model using datasets from GCMs.

It is anticipated to develop this package further by adding a regional sectoral impacts module

As well as @regcli, @regseacli, 
note below some other java classes in this package
%% (not in the tree as they contain no public output  )%%

@grid 
@mapdata
@mapprojection
@regman 
@region
@regpoly

#regseacli		¨addJCM5		§This module (new in JCM5) plots the @seasonalcycle  of a chosen climate variable (the same as in @regcli) for each of the regions in the @regions

Note that this is derived from a lot of GCM data so it takes some time to calculate, a @processdialog should appear if when the  @seasonalcycle @qtset is first opened

This module should be considered as @experimental as it is still under development

#mapprojection		¨addJCM5		§Change the projection for viewing the map. (this does not affect the calculations.)

#regman		¨addJCM5		§Loads the region data and provides functions for searching for sets of @region, such as @ALL, @NATIONS, @JCM25, @JCM12
See also @regions parameter

#region		¨addJCM5		§A region of the world
This is defined either by polygon data, or by a set of subregions
See also @regions, @regman

#seasonalcycle		¨addJCM5		§see @regseacli

#atco2flux		¨addJCM5		§See @berncarbon for explanation about the sinks

#accccarbon		¨addJCM5		§If this is selected (not by default), a very simple model used by ACCC
(see @attribution) is used instead of the normal @berncarbon. The ACCC model, as any simple linear model, is not accurate for future projections.

#fgas		¨addJCM5		§Below is old JCM4 documentation to be updated
Emissions are set by @othgasemit
Note also effect of parameters in @atchem
See also old module @oghga

££fgases

#othgasemitcurves		¨addJCM5		§see old label: @othgasplot

#fgas&conc		¨addJCM5		§See old labels: @fgasplot, @fgases

#fgas&emit		¨addJCM5		§See old labels: @fgasplot, @fgases

#fgas&rf		¨addJCM5		§See old labels: @fgasplot, @fgases, @radforothgas

#fgas&rf&totals		¨addJCM5		§See old labels: @fgasplot, @fgases, @radforothgas

#allrf		¨addJCM5		§See old label: @radforplot
Note also @co2equivconc
For more detail note also other plots:
@allrf-detail
@regrf
@atchem&rf
@fgas&rf
@fgas&rf&totals

%%Note: to fix - if you want to stack the curves, use instead @allrf-detail %%

#allrf_detail		¨addJCM5		§See old label: @radforplot

Note also other plots:
@regrf
@atchem&rf
@fgas&rf
@fgas&rf&totals

#regrf		¨addJCM5		§(new in JCM5) This shows the uneven distribution of the radiative forcing between the four surface boxes of the @udebclimod
Note the formulae for distributing aerosol and solar effects are only simple guesses. 
The @unif option makes the four forcings the same (while preserving the total)- as you see from @glotempcurves this doesn't make much difference to the global average temperature, although it strongly affects the regional ones. 

See also old label @radfordistrib

#glotemp		¨addJCM5		§This is a linker module, managing the @glotempcurves produced by the main climate module @udebclimod

See also old labels: @rftemp and @gcmfit

#oceantemp		¨addJCM5		§This is a part of @udebclimod that has been separated in this module as it is   a computationally intensive routine which is only needed when the @oceantempcurves are visible. 

(In this respect similar to  @carbonstorage, although the layer structure and diffusivities are different for heat and carbon)

#udebclimod		¨addJCM5		§Below is JCM4 Documentation to be updated

This module calculates the global surface temperature change, considering the energy balance due to radiative forcing in four surface boxes (north, south, land, ocean), and the slow uptake of heat by a multilayer upwelling-diffusion ocean.

<hr>See also @glotemp, @glotempcurves, @oceantempcurves, @rftemp, @gcmfit

££udebmodel  
</ul>
££climodfuture
</ul>

#sealevelrise		¨addJCM5		§See old label @sealevelplot

£§icemeltupdate

#oceantempcurves		¨addJCM5		§see @udebclimod
see also @sealevelrise
see old plot doc: @oceantempplot

#glotempcurves		¨addJCM5		§See old plot label @glotempplot
Note also old labels: @rftemp, @gcmfit 
Note also @oceantempcurves

#tempavfrom1750		¨addJCM5		§Global Annual Average Temperature, calculated by the model, compared to to 1750

#aerosol&rf		¨discard		§See old label: @radforaerosol

#jcmregcol		¨addJCM5		§The  warm reds, yellows, browns correspond to Annex B countries which agreed an emissions reduction target under the Kyoto protocol. The cool greens and blues are the developing countries. 
These regions are composed of countries sharing similar percapita emission histories and/or geographical proximity, and have no political significance.

#JCM12IMAGE		¨addJCM5		§A hybrid between JCM12 and IMAGE

#KYOTO		¨addJCM5		§Divided the world into Annex B (with emissions limitation quotas) and Non-Annex B (without), as in the Kyoto protocol

#CSW15		¨addJCM5		§A region set used by an climate-economics model

#HOUGHTON		¨addJCM5		§region set used for Houghton's Land-Use CO2 emissions data

#NATIONS		¨addJCM5		§All Nations (2002), except that small islands are grouped by ocean basin

#ALLLAND		¨addJCM5		§All Land regions, including subregions of large countries

#OCEANS		¨addJCM5		§Ocean regions

#ALL		¨addJCM5		§All regions, land and ocean

#GRID		¨addJCM5		§system under construction - please ignore

#GRIDLO		¨addJCM5		§system under construction, please ignore

#paraminterac		¨addJCM5		§%%note changing parameters in the documentation does not yet affect the model, to adjust parameters use  the @treeMaker%%

#nocurvesyet		¨addJCM5		§¤adju This Curve Set has not yet been displayed and so does not yet contain any curve data. When you show a plot (e.g. by dragging the icon from the @treeMaker into another panel), or a plot-variant or table from the popup menu, then the model will calculate as necessary and this documentation may contain moe information about curves. 
See also @interactions

#StartJCM		¨addJCM5		§JCM main startup sequence -  constructs the top menus, calls  @setup and sets up @Worlds

#oldmodule		¨addJCM5		§Old info:
Modules may use @tls and @root but do not refer to @gui or @pan (¤cogs see @struccode)
For each stage, for each timestep, all modules are called in the order specified by  the @modlist interface, which also enables modules to refer to each other easily.

#jcm.gui.doc		¨addJCM5		§Package handling labels and documentation
see also old link: @labdoc

#label		¨addJCM5		§Contains short and medium labels and documentation about one model item, for all languages

#About&Source		¨addJCM5		§see @sourceview
see @jcm

#iconFinder		¨addJCM5		§finds an appropriate icon for  model components

#lookandfeel		¨addJCM5		§see @lookandfeelmenu

#jcm.gui.gen		¨addJCM5		§Package of miscellaneous GUI components

#jcm.gui.nav		¨addJCM5		§Package of Components used for Navigation and Layout

#jcm.gui.plot		¨addJCM5		§Package for plot and table components

#jcmTM		¨addJCM5		§data structure underlying @datable

#baseplot		¨addJCM5		§Contains common components of @lineplot, @histoplot, @scatterplot

#colorscale		¨addJCM5		§Color-scale used for showing @regcli in @mapplot

#paramValueChooser		¨addJCM5		§A component for showing the value of a numerical @param, and adjusting it using a slider. Note that the  model responds immediately to recalculate any visible plots - the response time will depend on the complexity of this calculation.

#About&Setup		¨addJCM5		§£§setup

#About&Script		¨addJCM5		§(Documentation to be developed)
see @script
see @scripting

#JCM5		¨addJCM5		§£§mainmenu

#noteprogress		¨addJCM5		§Note: JCM5 documentation is currently being updated, both new and old pages are included below

#Tools		¨addJCM5		§£§About&Tools

#paramMenu		¨addJCM5		§A component for adjusting a menu @param

#paramOption		¨addJCM5		§A component for adjusting a true/false @param

#menuFiller		¨addJCM5		§Provides info to @contextMenu

#jcmTabbedPane		¨addJCM5		§Extends java-swing JTabbedPane by adding a close facility, and interacting with @moulist

#capwin		¨addJCM5		§Screen capture - not currently used

#labelTM		¨addJCM5		§model underlying @labdoctable

#hasinfo		¨addJCM5		§an interface, currently all hasinfo are @infob

#modloop		¨addJCM5		§an interface for @module loop methods

#plotlink		¨addJCM5		§An interface for @register to store a list of @plots and other @jcm.gui that depend on @interacob and may need @loop to recalculate

#optimiser		¨addJCM5		§See @optimisation

#aboutsearch		¨addJCM5		§¤adju Use the  text box at the top right to specify which words to search for. Results will only include pages containing all of the search words, in the currently selected @languagemenu

#population		¨addJCM5		§see old label: @people

#regpoly		¨addJCM5		§A polygon defining a region

See also old label @bord and data file regions.txt (view from Source menu)

#ratio		¨addJCM5		§This option specifies that, for the chosen climate variable, the ratio compared to the global average change is shown instead of the absolute value.

#atchem&conc		¨addJCM5		§see old plot: @othgasplot
see also @atchem

#atchem&rf		¨addJCM5		§see old plot: @othgasplot
old label: @radforothgas
see also @atchem, @radfor
see old label: @radforintro

#icemeltupdate		¨addJCM5		§-{red // Note: the ice-melt curves here are consistent with IPCC-TAR 2001, but more recent studies suggest that both Greenland and Antarctica are already melting much faster than projected than these models! }-

#greenland-sensitivity		¨addJCM5		§£§icemeltupdate

#antarctica-sensitivity		¨addJCM5		§£§icemeltupdate

#intropara		¨addJCM5		§Climate change is influenced by complex interlinked processes. This interactive model lets you explore the system and how we can change it, simply by moving controls with your mouse and observing the effect instantly on plots ranging from emissions to impacts. The core calculation methods are similar to those used in the  Intergovernmental Panel on Climate Change Third Assessment Report, implemented efficiently in the java language to make this tool accessible to everybody via the internet.

#updatedoc		¨addJCM5		§-{red// Last updated 2nd March 2006
This is a pre-release of JCM5 for testing, it is not finished. 
The documentation is not yet complete. Some documentation pages refer to the older version JCM4 which had a similar core model but quite different structure.//}-