This wiki documents  ticket:326

Here is the table for definitions of terms (parameter names) used in LandSurface_bdl.mm

This table has been generated thanks to Rupert's xml2excel.xsl parser.

• Last update: 01/12/2009
• Author: gerry

How to contribute to the process of building and governing definitions?

* comment * column: post a comment to the current definition, tell us the motivation for a change (f.e. def-1: "Type" is too vague)

* corrections * column: corrections requested (f.e. def-1: use "climate models families") . If comments suggest a rejection decision (cf (3)DR bellow), this column can be left empty and one can fill directly the "new definition" column

* new definition * column: the replacing definition in case of rejection decision (cf (3)DR bellow) or corrections accepted (cf (5)CA bellow)

* status * column: is for governance decision about definition. Status can be one of the following:

• (1) DS="definition submitted"; next step is (2), (3) or (4)
• (2) DA="definition accepted"
• (3) DR="definition rejected"; it is no worth to submit corrections, next step is (7)
• (4) CS="correction submitted" (definition not accepted as it stands); next step is (5) or (6)
• (5) CA= "correction accepted" next step is (7)
• (6) CR="correction rejected"; next step is back to (4) or go directly to (7)
• (7) NDS="new definition submitted"
• (8) NDA="new definition accepted"
• (9) NDR="new definition rejected"; next step is back to (7)

The roadmap for definition governance may apear somewhat "heavy", but the advantage of these multiple steps is that we do not expect the same person to fill-in all of the columns. One can only provide a comment on a submitted definition without changing its status (1); another person will submit a correction (4) and a third one (or the same one but in a second round) can propose a new definition (7) after having accepted (5) or rejected (6) the submitted correction.

Once harversted a set of accepted corrections (CA), a "new definion" is written and submitted (NDS).

The defintions are fixed when the status DA or NDA is reached.

component		parametergroup	parameter	definition	comment	corrections	new definition	status
1	LandSurface/LandSurfaceKeyProperties	General Attributes	BasicApproximations	Decription of the basic approximations made in the LandSurface model.	DS (gd)
2	LandSurface/LandSurfaceKeyProperties	General Attributes	Genealogy	History of parent models.	DS (gd)
3	LandSurface/LandSurfaceKeyProperties	General Attributes	CouplingWithAtmosphere	Specify the treatment of land surface coupling with the Atmosphere model component	DS (gd)
4	LandSurface/LandSurfaceKeyProperties	General Attributes	ListOfPrognosticVariables	Specify which prognostic variables are included in the land surface scheme	DS (gd)
5	LandSurface/LandSurfaceKeyProperties	ConservationOfProperties	WaterTreatment	Specify the treatment of water to ocean	DS (gd)
6	LandSurface/LandSurfaceKeyProperties	ConservationOfProperties	LagOfWaterDischarge	Value of the lag duration of the water discharge into ocean.	DS (gd)
7	LandSurface/LandSurfaceKeyProperties	ConservationOfProperties	WaterStorageMethod	Give further details of the water storage method	DS (gd)
8	LandSurface/LandSurfaceKeyProperties/LandSurfaceSpaceConfig	HorizontalDomain	Tiling	Is land surface tiling common to all land surface subcomponents?	DS (gd)
9	LandSurface/LandSurfaceKeyProperties/LandSurfaceSpaceConfig	HorizontalDomain	TilingMethod	Describe the method of tiling used	DS (gd)
10	LandSurface/LandSurfaceKeyProperties/LandSurfaceSpaceConfig	HorizontalDomain	GridConfig	Is the grid used the same as that of the atmosphere?	DS (gd)
11	LandSurface/LandSurfaceKeyProperties/LandSurfaceSpaceConfig	HorizontalDomain	MeanResolution	Mean horizontal resolution of the land surface model.	DS (gd)
12	LandSurface/LandSurfaceKeyProperties/LandSurfaceSpaceConfig	HorizontalDomain	GridCharacteristics	Description of the horizontal grid used for land surface.	DS (gd)
13	LandSurface/LandSurfaceKeyProperties	TimeSteppingFramework	Method	Is the time stepping framework used the same as that used in the atmosphere model component?	DS (gd)
14	LandSurface/LandSurfaceKeyProperties	TimeSteppingFramework	TimeStep	Enter the length of timestep in seconds	DS (gd)
15	LandSurface/LandSurfaceSoil	SoilMap	Texture	Description of the relative clay, sand and silt proportions of the soil	DS (gd)
16	LandSurface/LandSurfaceSoil	SoilMap	Structure	Description of the aggregate characteristics of the soil particles	DS (gd)
17	LandSurface/LandSurfaceSoil	SoilMap	Albedo	Ratio of reflected to incoming solar radiation on a land surface	DS (gd)
18	LandSurface/LandSurfaceSoil	SoilMap	WaterTable	Description of the level of water saturation within the soil layer	DS (gd)
19	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilHydrologyAttributes	SpecificTiling	Does the model use a tiling scheme within soil hydrology?	DS (gd)
20	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilHydrologyAttributes	NumberOfGroundWaterLayers	Enter the number of ground water levels used in the land surface scheme/model	DS (gd)
21	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilHydrologyAttributes	WaterStorageMethod	Describe the method by which water is stored in the land surface scheme/model	DS (gd)
22	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilMoistureFreezing	NumberOfGroundIceLayers	How many ground ice layers are included in the land surface scheme	DS (gd)
23	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilMoistureFreezing	IceStorageMethod	Describe the method of ice storage	DS (gd)
24	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	SoilMoistureFreezing	Permafrost	Describe the treatment of permafrost within the land surface scheme	DS (gd)
25	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	Runoff-Drainage	Method	Specify the treatment of runoff	DS (gd)
26	LandSurface/LandSurfaceSoil/LandSurfSoilHydrology	Runoff-Drainage	Processes	Specify processes treated within the runoff and drainage scheme	DS (gd)
27	LandSurface/LandSurfaceSoil/LandSurfSoilHeatTreatment	SoilHeatTreatmentAttributes	SpecificTiling	Is tiling used in the treatment of soil heat?	DS (gd)
28	LandSurface/LandSurfaceSoil/LandSurfSoilHeatTreatment	SoilHeatTreatmentAttributes	NumberOfGroundHeatLayers	How many layers are used in ground heat treatment?	DS (gd)
29	LandSurface/LandSurfaceSoil/LandSurfSoilHeatTreatment	Method	HeatStorage	Specify the method of heat storage	DS (gd)
30	LandSurface/LandSurfaceSoil/LandSurfSoilHeatTreatment	Method	Processes	Describe processes included in the treatment of soil heat	DS (gd)
31	LandSurface/LandSurfaceSnow	General Attributes	SpecificTiling	Is tiling used in the land surface snow scheme?	DS (gd)
32	LandSurface/LandSurfaceSnow	General Attributes	NumberOfSnowLayers	How many snow layers are included in the model?	DS (gd)
33	LandSurface/LandSurfaceSnow	SchemeMethod	SnowAlbedo	Description of the treatment of the ratio of reflected to incoming solar radiation on a snow surface	DS (gd)
34	LandSurface/LandSurfaceSnow	SchemeMethod	SnowDensity	Description of the treatment of snow density	DS (gd)
35	LandSurface/LandSurfaceSnow	SchemeMethod	SnowWaterEquivalent	Description of the treatment of the 'snow water equivalent'	DS (gd)
36	LandSurface/LandSurfaceSnow	SchemeMethod	SnowHeatContent	Description of the treatment of the heat content of snow	DS (gd)
37	LandSurface/LandSurfaceSnow	SchemeMethod	SnowTemperature	Description of the treatment of snow temperature	DS (gd)
38	LandSurface/LandSurfaceSnow	SchemeMethod	SnowLiquidWaterContent	Description of the treatment of the snow liquid water treatment	DS (gd)
39	LandSurface/LandSurfaceSnow	SchemeMethod	SnowCoverFractions	Specify cover fractions used in the surface snow scheme	DS (gd)
40	LandSurface/LandSurfaceSnow	SchemeMethod	Processes	Implemented snow-related processes	DS (gd)
41	LandSurface/LandSurfaceVegetation	General Attributes	SpecificTiling	Is tiling used in the surface vegetation scheme?	DS (gd)
42	LandSurface/LandSurfaceVegetation	General Attributes	VegetationType	Describe the treatment of vegetation type	DS (gd)
43	LandSurface/LandSurfaceVegetation	General Attributes	VegetationMap	Name and reference for the vegetation map used.	DS (gd)
44	LandSurface/LandSurfaceVegetation	General Attributes	Interception	Vegetation interception of rainwater represented?	DS (gd)
45	LandSurface/LandSurfaceVegetation	General Attributes	BiomeTypes	Names of biomes represented	DS (gd)
46	LandSurface/LandSurfaceVegetation	SchemeMethod	Phenology	Description of the treatment of vegetation phenology	DS (gd)
47	LandSurface/LandSurfaceVegetation	SchemeMethod	LAI	Describe the treatment of the leaf area index	DS (gd)
48	LandSurface/LandSurfaceVegetation	SchemeMethod	Biomass	Describe the treatment of vegetation biomass	DS (gd)
49	LandSurface/LandSurfaceVegetation	SchemeMethod	BioGeography	describe the treatment of vegetation biogeography	DS (gd)
50	LandSurface/LandSurfaceVegetation	SchemeMethod	StomatalResistanceFunctionOf	Specify the dependancies on vegetation stomatal resistance	DS (gd)
51	LandSurface/LandSurfaceEnergyBalance	General Attributes	SpecificTiling	Is tiling used in the surface energy balance scheme?	DS (gd)
52	LandSurface/LandSurfaceEnergyBalance	General Attributes	SubsurfaceTiling	Is sub-surface tiling employed?	DS (gd)
53	LandSurface/LandSurfaceEnergyBalance	General Attributes	NumberOfSurfaceTemperatures	Enter the number of surface temperatures used	DS (gd)
54	LandSurface/LandSurfaceEnergyBalance	SchemeMethod	TypeOfEvaporationFormulation	Specify the formulation method for land surface evaporation	DS (gd)
55	LandSurface/LandSurfaceEnergyBalance	SchemeMethod	Processes	Describe whih processes are included in the energy balance scheme	DS (gd)
56	LandSurface/LandSurfaceAlbedo	General Attributes	SpecificTiling	Is tiling used in the surface albedo calcualtions?	DS (gd)
57	LandSurface/LandSurfaceAlbedo	SnowFreeAlbedo	Type	Describe the treatment of snow-free land albedo	DS (gd)
58	LandSurface/LandSurfaceAlbedo	SnowFreeAlbedo	FunctionOf	Describe the dependancies on snow free albedo calculations	DS (gd)
59	LandSurface/LandSurfaceAlbedo	SnowFreeAlbedo	Direct-Diffuse	Is there a distinction between direct and diffuse albedo?	DS (gd)
60	LandSurface/LandSurfaceAlbedo	SnowFreeAlbedo	NumberOfWavelenghBands	Enter the number of wavelength bands used	DS (gd)
61	LandSurface/LandSurfaceAlbedo	SnowAlbedo	Type	Describe the treatment of snow-covered land albedo	DS (gd)
62	LandSurface/LandSurfaceAlbedo	SnowAlbedo	FunctionOf	Describe dependancies on snow albedo calculations	DS (gd)
63	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	General Attributes	NumberOfCarbonPools	Enter the number of carbon pools used	DS (gd)
64	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	General Attributes	ListOfCarbonPools	List the carbon pools used within the model carbon cycle	DS (gd)
65	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	Photosynthesis	Method	Describe the method used for photosynthesis	DS (gd)
66	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	AutotrophicRespiration	Method	Describe the treatment of autotrophic respiration	DS (gd)
67	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	AutotrophicRespiration	MaintenanceRespiration	[TBA]	DS (gd)
68	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	Allocation	AllocationBins	Specify the allocation of vegetation carbon bins	DS (gd)
69	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	Allocation	AllocationFractions	Describe how the fractions of allocation are calculated	DS (gd)
70	LandSurface/LandSurfaceCarbonCycle/VegetationCarbonCycle	Phenology	Method	Describe the treatment of vegetation carbon cycle phenology	DS (gd)
71	LandSurface/LandSurfaceCarbonCycle	Soil	Method	Describe the methods used within the soil carbon cycle scheme	DS (gd)
72	LandSurface/LandSurfaceCarbonCycle	Soil	NumberOfCarbonPools	How many soil carbon cycle pools are used?	DS (gd)
73	LandSurface/LandSurfaceCarbonCycle	Soil	ListOfCarbonPools	List the names of the soil carbon pools used	DS (gd)
74	LandSurface/LandSurfaceCarbonCycle	Permafrost	ListOfGases	Which gases are included in permafrost?	DS (gd)
75	LandSurface/RiverRouting	General Attributes	SpecificTiling	Tiling of basins.	DS (gd)
76	LandSurface/RiverRouting	General Attributes	Resolution	Is the resolution independant of the land surface resolution?	DS (gd)
77	LandSurface/RiverRouting	General Attributes	NumberOfReservoirs	Enter the number of reservoirs	DS (gd)
78	LandSurface/RiverRouting	General Attributes	ListOfPrognosticVariables	Specify the prognostic variables within the river routing scheme	DS (gd)
79	LandSurface/RiverRouting	General Attributes	WaterRe-evaporation	[TBA]	DS (gd)
80	LandSurface/RiverRouting	General Attributes	CouplingWithAtmosphere	Is river routing coupled to the atmosphere model component?	DS (gd)
81	LandSurface/RiverRouting	General Attributes	DrainageMap	What type of drainage map is being used?	DS (gd)
82	LandSurface/RiverRouting	General Attributes	QuantitiesExchangedWithAtmosphere	Which quantities are exchanged between river routing and the atmosphere model components?	DS (gd)
83	LandSurface/RiverRouting	OceanicDischarge	Type	Specify how rivers are discharged to the ocean	DS (gd)
84	LandSurface/RiverRouting	OceanicDischarge	QuantitiesTransported	Which quantities are exchanged from river-routing to the ocean model component?	DS (gd)
85	LandSurface/LandSurfaceLakes	General Attributes	CouplingWithRivers	Are lakes coupled to the river routing model component?	DS (gd)
86	LandSurface/LandSurfaceLakes	General Attributes	QuantitiesExchangedWithRivers	Which quantities are exchanged between the lakes and rivers	DS (gd)
87	LandSurface/LandSurfaceLakes	SchemeMethod	IceTreatment	Is lake ice included?	DS (gd)
88	LandSurface/LandSurfaceLakes	SchemeMethod	LakesAlbedo	Describe the treatment of lake albedo	DS (gd)
89	LandSurface/LandSurfaceLakes	SchemeMethod	LakesDynamics	Which dynamics of lakes are treated? horizontal, vertical, etc.	DS (gd)
90	LandSurface/LandSurfaceLakes	SchemeMethod	DynamicLakesExtent	|Is a dynamic lake extent scheme included?	DS (gd)
91	LandSurface/LandSurfaceLakes	SchemeMethod	EndorheicBasins	basins not flowing to ocean.	DS (gd)