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

#inyear		§(used for stabilisation in year X at level  Y)

#peryear		§(not currently used)

#atlevel		§(used for stabilisation in year X at level  Y)

#baseline		§(not currently used)

#dy		§(replaced by %/yr)

#frac		§Combining the "stack" and "frac" options shows the relative proportion of the whole (scale is in %)

#stack		§Stack the curves as coloured bands. This only makes sense for summable quantities, e.g. it's OK for regional emissions, but not for emissions per capita. Also, beware of using stack for quantities which may go negative, such as radiative forcing.

#varq		§Choose emissions, @abate, or socioeconomic data from the @people

#perq		§Choose emissions, @abate, or socioeconomic data from the @people
<i>(°adju If you don't want any ratio, choose the blank item)</i>.

#popn		§from @people

#person		§(used for millions of people)

#capita		§(used for per capita)

#per&popn		§from @people

#co2emit		§from @regshares

#abate		§The difference between no-policy emissions (see @sresasbaseline) and mitigated emissions (see @mitigation, @regshares)

#energy		§from @people

#gdp		§from @people

#gnp		§from @people

#whatper		§°adju ²You can choose which quantity to plot from @varq, and  can also divide by a socioeconomic quantity from @perq (menus below). Current choice of curves is:²

#regscales		§² °adju The timescale is only from 1900-2100, since human society changes too fast to predict further into the future. However the global science plots go from 1750-2300, you can use @linkx to make the scales the same (see also @scale).²

#siunits		§Standard SI scalars are as follows:
  £~peta £`peta =1015
  £~tera £`tera =1012
  £~giga £`giga =109
  £~mega £`mega =106
  £~kilo £`kilo =103
  £~milli £`milli =10-3
  £~micro £`micro =10-6
  £~nano £`nano =10-9   <li>Note also: 1 ton = 106 grams.

See also @howmuchgtc

#howmuchgtc		§GtC is short for Gigatons of Carbon. Giga means a billion, so that's a billion tons. A ton is 1000kg, the weight of a cubic metre of water (or of about 16 typical adult people). Note that 1 gigaton is identical to 1 petagram (Pg), i.e. 1015grams.
  A ton of carbon is (roughly) the same as a ton of coal -which you can probably visualise. Oil and natural gas (methane) also contain hydrogen, but most of their total weight is still carbon.
  Burning 1 ton of carbon creates 3.67 tons of CO2 (3.67 is derived from 44/12 atomic mass units). As the global carbon cycle involves conversion between various forms of carbon (CO2, fossil fuel, plant biomass, bicarbonate ions in seawater, etc.), climate scientists find it more convenient to refer to tons of carbon than tons of CO2, but be careful which you are using when comparing figures.
  Incidentally, 3.67 tons of CO2 is the same amount as is currently found in the whole column of air above 646 square metres of the earth's surface. Or it's about the same amount as the carbon stored in a typical tree about 20m tall. The energy you get from burning one ton of carbon (as oil) could light 30 60Watt lightbulbs continuously for one year.
  Note, sometimes people refer instead to Gt CO2-equivalent (CO2-e) which includes other greenhouse gases scaled using "global warming potentials". Beware that the global warming potential for each gas depends on your time-horizon, since the gases have different lifetimes in the atmosphere!   <li>See also @co2eq

#unitbaseline		§The zero-point for reporting temperature rise is arbitrary ! Climate modellers usually start by assuming a steady-state in the preindustrial era (typically 1750), which thus defines the zero point. Those investigating historical data tend to use the 1960-1990 average as a baseline, to smooth out temporary fluctuations, while acknowledging that the best data comes from the recent past. Whereas people comparing future scenarios often want to to know the change from the present (typically 2000). So, be very careful to compare like with like! The same applies to sea-level rise.   <li>See also @baseyear

Most scientists report CO2 emissions in Gt Carbon, to allow for easy transformation to/from fossil fuel, bicarbonate ions in seawater, wood, soil, etc, whilst others report Gt CO2, including the weight of the oxygen atoms (Note 1 Gt= 1 billion tons = 1 Pg, and 1 Gt CO2 = (44/12)<li> Gt C). Also, sometimes people refer instead to Gt CO2-equivalent (CO2-e) which includes other greenhouse gases scaled using global warming potentials   <li>see also @howmuchgtc, @co2eq

#time		§Global climate / geochemical data runs from 1750 to 2300, whereas regional emissions / socioeconomic data runs from 1900 to 2100.

Currently JCM works in one-year timesteps (see also @loop).

²°adju You can link all the timescales using the @linkx option (in @layoutpanel).²

The simple 'time' class in jcm/mod contains the variables describing time, and methods to create standard arrays.

²°cogs This class may be replaced by an interface, with array methods moving to @module ²

²°cogs JCM has been run successfully to year 3000 or beyond, by changing time.gey, and recompiling (because java arrays have a fixed length). When 'parallel worlds' are implemented (see @modlist), it should be possible to change the timescale of the model dynamically, on creation of a new 'world'.²