template_retreat

	A	B	C	D	E	F	G	H	I	J	K	L	M	N	O	P
1	turn		Template table for the ORCHIDEE Retreat, Nov 2015				Fabienne, Palmira, Albert				James, Fuxing, Matthieu G, Frederique
2							Susanna, Agnès, Catherine	Josefine Ghattas, Nicolas Vuichard, Claire Magand			Dan Zhu, Jonathan Barichivich, Bertrand Guenet, Nicolas Viovy
3							Jan Polcher, Ardalan Tootchi, Pascal Maugis				Daniel Goll (DSG), Wei Li, Juliette Lathière
4							Patricia Cadule, Chao Yue
5	Validated after retreat	Committed by Josefine	field id	Output name set in field_def	Var name (or formulation) in Fortran	Subroutine	Long name	Unit of the variable in the code	Unit in output	xml group	Comments	Action to perform in the code (to keep, to modify, to delete)	Proposed new field_id	Conversion formulation in fied_def file	Review from other groups: Name and comments	CMIP6 convention

6		3346	PAR	PAR	PAR	chemistry	PAR	μmol.m-2.s-1	μmol.m-2.s-1		JULIETTE
7		3346	PARsun	PARsun	PARsun	chemistry	Sunlit leaf PAR	μmol.m-2.s-1	μmol.m-2.s-1
8		3346	PARsh	PARsh	PARsh	chemistry	Shaded Leaf Area PAR	μmol.m-2.s-1	μmol.m-2.s-1
9		3346	laisun	laisun	laisun	chemistry	Sunlit Leaf Area Index	m2.m-2	m2.m-2
10		3346	laish	laish	laish	chemistry	Shaded Leaf Area Index	m2.m-2	m2.m-2
11		3346	Fdf	Fdf	Fdf	chemistry	Fdf	1	1		Long name same as in the chemistry.f90 variable declaration	To keep ?
12		3346	PARsuntab	PARsuntab	PARsuntab	chemistry	Sunlit Leaf PAR	μmol.m-2.s-1	μmol.m-2.s-1
13		3346	PARshtab	PARshtab	PARshtab	chemistry	Shaded Leaf Area PAR	μmol.m-2.s-1	μmol.m-2.s-1
14		3346	coszang	coszang	coszang	chemistry	Cosine of the solar zenith angle	1	1
15		3346	PARdf	PARdf	PARdf	chemistry	PARdf	μmol.m-2.s-1	1		error in xml file for unit; Long name same as in the chemistry.f90 variable declaration
16		3346	PARdr	PARdr	PARdr	chemistry	PARdr	μmol.m-2.s-1	1		error in xml file for unit; Long name same as in the chemistry.f90 variable declaration
17		3346	Trans	Trans	Trans	chemistry	Trans	1	1		Long name same as in the chemistry.f90 variable declaration	To keep ?
18		3346	flx_fertil_no	flx_fertil_no	flx_fertil_no	chemistry	flx_fertil_no	kg.m-2.s-1	kg.m-2.s-1		Make units "kgN/m2/s"; Long name same as in the chemistry.f90 variable declaration
19		3346	CRF	CRF	CRF	chemistry	CRF	1	1		Long name same as in the chemistry.f90 variable declaration
20		3346	flx_co2_bbg_year	flx_co2_bbg_year	flx_co2_bbg_year	chemistry	flx_co2_bbg_year	kg.m-2.yr-1	kg.m-2.yr-1		Make units "kgC/m2/s"	To delete ?
21		3346	N_qt_WRICE_year	N_qt_WRICE_year	N_qt_WRICE_year	chemistry	N_qt_WRICE_year	kgN/yr	kgN/yr	sechiba	dimensions are kjpindex*nvm - are we including /PFT/grid cell in any description anywhere - as has been the case for some unit descriptions in the past?
22		3346	N_qt_OTHER_year	N_qt_OTHER_year	N_qt_OTHER_year	chemistry	N_qt_OTHER_year	kgN/yr	kgN/yr	sechiba	same qu for rest of this section...
23		3346	ptnlev1	ptnlev1	ptnlev1	chemistry	ptnlev1	K	K	sechiba	Long name same as in the chemistry.f90 variable declaration	To keep ?
24		3346	flx_iso	flx_iso	flx_iso	chemistry	flx_iso	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
25		3346	flx_mono	flx_mono	flx_mono	chemistry	flx_mono	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
26		3346	flx_ORVOC	flx_ORVOC	flx_ORVOC	chemistry	flx_ORVOC	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
27		3346	flx_MBO	flx_MBO	flx_MBO	chemistry	flx_MBO	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
28		3346	flx_methanol	flx_methanol	flx_methanol	chemistry	flx_methanol	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
29		3346	flx_acetone	flx_acetone	flx_acetone	chemistry	flx_acetone	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
30		3346	flx_acetal	flx_acetal	flx_acetal	chemistry	flx_acetal	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
31		3346	flx_formal	flx_formal	flx_formal	chemistry	flx_formal	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
32		3346	flx_acetic	flx_acetic	flx_acetic	chemistry	flx_acetic	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
33		3346	flx_formic	flx_formic	flx_formic	chemistry	flx_formic	kgC/m^2/s	kgC/m^2/s	sechiba	Long name same as in the chemistry.f90 variable declaration
34		3346	flx_no_soil	flx_no_soil	flx_no_soil	chemistry	flx_no_soil	kgC/m^2/s	ngN/m^2/s	sechiba	error in either chemistry.f90 or xml field def; Long name same as in the chemistry.f90 variable declaration	The right unit is "ngN/m²/s"
35		3346	flx_no	flx_no	flx_no	chemistry	flx_no	kgC/m^2/s	ngN/m^2/s	sechiba	error in either chemistry.f90 or xml field def; Long name same as in the chemistry.f90 variable declaration	The right unit is "ngN/m²/s"
36	FM (26/03/2016)	-	soilalb_nir	soilalb_nir	alb_bare( :,2)	condveg_main	Soil Albedo near infrared	unitless	1	energy	Since the variable is unitless, unit in the output could be "-" instead of "1" as seen in "hydrolc.f90" It was decided to keep to '1' when unitless.	to keep
37	FM (26/03/2016)	-	vegalb_vis	vegalb_vis	alb_veget( :,1)	condveg_main	Vegetation Albedo near infrared	unitless	1	energy	Since the variable is unitless, unit in the output could be "-" instead of "1" as seen in "hydrolc.f90" It was decided to keep to '1' when unitless.	to keep
38	FM (26/03/2016)	-	vegalb_nir	vegalb_nir	alb_veget( :,2)	condveg_main	Vegetation Albedo visible	unitless	1	energy	Since the variable is unitless, unit in the output could be "-" instead of "1" as seen in "hydrolc.f90" It was decided to keep to '1' when unitless.	to keep
39	x	3404	albedo_alma	Albedo	albedo_glob	condveg_main	Albedo (grid averaged), for VIS and NIR (2D variable	unitless	1	energy		Remove the variable as it will be created in "field_def" file Pour Histwrite: remplacer albedo_glob par "(albedo(:,1) + albedo(:,2))/2."			Vérifié par Fabienne, Catherine, Philippe
40	x	3404	Salbedo	Salbedo	albedo_snow	condveg_main	Snow albedo	unitless	1	energy	Since the variable is unitless, it should be in the units; equal to "1" Later we should include the dependency of snow albedo to VIS vs NIR (following ORC-CAN)	Modifier le nom de field_id en/ "albedo_snow" (et dans fichier field_id)			Vérifié par Fabienne, Catherine, Philippe
41		-	ADAPTATION	ADAPTATION	adapted	constraints	Adaptation to climate (DGVM)	-	-	carbon	A scaling factor between zero and one, to be compared with a critical adaption value in order to determin whether the concerned PFT is able to survive
42		-	REGENERATION	REGENERATION	regenerate	constraints	Probability from regenerative (DGVM)	-	-	carbon	A scaling factor between zero and one to indicate the capacity of regeneration related with vernalization
43	FM (26/03/2016)	-	soilalb_vis	soilalb_vis	alb_bare( :,1)	convdeg_main	Soil Albedo Visible	unitless	1	energy	Since the variable is unitless, unit in the output could be "-" instead of "1" as seen in "hydrolc.f90" It was decided to keep to '1' when unitless.	to keep
44		3405	cdrag	cdrag	q_cdrag	diffuco	Drag coefficient for LE and SH	m/s	m/s	turbulence	change field id to q_cdrag	change field_id	q_cdrag
45		3405	raero	raero	raero	diffuco	Aerodynamic resistance	s/m	s/m	turbulence
46		3405	Wind	wind	wind	diffuco	Wind speed	m/s	m/s	forcing	majuscule for the first letter in field id ? + to put into intersurf because it is a forcing				CHECK HEIGHT AND PRECISE IT IN THE LONG NAME
47		3405	qsatt	qsatt	qsatt	diffuco	Surface saturated humidity	g/g	g/g	hydrology
48	done	done	Day	Day	julian_diff_2d	diffuco	Day		1	general	Should be output somewhere else	change field_id or var name			DELETE VARIABLE
49	done	done	Year_length	Year_length	year_length_2d	diffuco	Year_length		1	general	Should be output somewhere else	change field_id or var name			DELETE VARIABLE
50	done	-	netrad	netrad	netrad	enerbil	Net Radiation	W/m^2	W/m^2	energy		to keep
51	done	3406	evapot	evapot	evapot*one_day/dt_sechiba	enerbil	Potential evaporation	mm/tstep	mm/d	sechiba	in-code comment need to be corrected: should be mm/tstep	to delete	evapot_day	evapot*86400
52	done but...	3406 ? JG the name and long name has only been kept for alma output. Should it be used for all cases?	evapot_alma	PotEvapOld	evapot/dt_sechiba	enerbil	Potential evapotranspiration old method	mm/tstep	kg/m^2/s	sechiba	in-code comment need to be corrected: should be mm/tstep	to modify	evapot
53	done but...	3406 ? JG the name and long name has only been kept for alma output. Should it be used for all cases?	evapot_corr	evapot_corr	evapot_corr*one_day/dt_sechiba	enerbil	Potential evaporation	mm/tstep	mm/d	sechiba	in-code comment need to be corrected: should be mm/tstep	to delete	evapot_corr_day	evapot_corr*86400
54	done	3406	evapot_corr_alma	PotEvap	evapot_corr/dt_sechiba	enerbil	Potential evapotranspiration	mm/tstep	kg/m^2/s	sechiba	in-code comment need to be corrected: should be mm/tstep ; variable name could be "evapot_milly" instead of "evapot_corr"	to modify	evapot_corr
55	done	?	lwdown	lwdown	lwabs	enerbil	Absorbed downward longwave radiation	W/m^2	W/m^2	forcing	!! For the moment lwdown variable is not ouptut from ORCHIDEE;	to delete	lwabs	emis*lwdown
56	done	?	lwnet	lwnet	lwnet	enerbil	Net surface longwave radiation	W/m^2	W/m^2	sechiba	we propose to output lwup (this is not the case). In this case, lwnet could be not directly output, and define as 'lwdown-lwup' (check sign convention)	to keep
57	done	?	Qv	Qv	fluxsubli	enerbil	Flux of sublimation	mm/tstep	W/m^2	sechiba	in-code comment need to be corrected: ; There seems to a duplication with 'vevapsnow' (though the latter is in different units, and is further modified in hydrol.f90). It would be helpful to remove one of these two variables and introduce a better name, for clarity. + 2nd comment: unit in the code's comment should be "kg/m2" not "mm/tstep" + 3rd comment - maybe we should be thinking in the long term to not use a fixed latent heat of vaporization to convert from kg/m^2 per timestep to W/m^2	to modify	fluxsubli		check if sublimation latent heat is constant in LMDz (in case of coupled mode)	sbl ?
58	done	?	PotSurfT	PotSurfT	temp_sol_pot	enerbil	Potential (Unstressed) surface temperature	undefined	K	sechiba	we think temp_sol_pot is to delete completely. Seems to be equal to the initial value of temp_sol ??? One ticket 213 has been opened	to modify	temp_sol_pot
59		3407	IND_ESTAB	IND_ESTAB	d_ind	lpj_establish	Density of newly established saplings	ind/m^2/day (the unit is right but comment is wrong)	1/day	carbon					Dan: unit in xios is wrong, should be ind/m2/day
60		3407	ESTABTREE	ESTABTREE	estab_rate_max_tree	lpj_establish	Rate of tree establishement	unitless	1/day	carbon					unit should be unitless
61		3407	ESTABGRASS	ESTABGRASS	estab_rate_max_grass	lpj_establish	Rate of grass establishement	unitless	1/day	carbon					unit should be unitless
62	hydrolc reviewed by AD: column "Comments" also includes actions to perform; everytime we write below mm,it should be understood kg/m2
63	x	3687	runoff	runoff	run_off_tot*one_day/dt_sechiba	hydrolc_main	Surface runoff	kg/m²/dt_sechiba	mm/d	water	Convert to kg/m2/s in code + unit in field.xml	To suppress the multiplication by "one-day" in the code formulation	Do we add a daily output in the field_id?
64	x	3687	mrro	mrro	(run_off_tot+drainage)/dt_sechiba	hydrolc_main	Total Runoff	kg/m²/dt_sechiba	kg/m²/s	water	Operation: run_off_tot + drainage	To delete in the code	mrro	mrro=run_off_tot + drainage (based on field_id)		cmor
65	x	3687	drainage	drainage	drainage*one_day/dt_sechiba	hydrolc_main	Deep drainage	kg/m²/dt_sechiba	mm/d	water	Convert to kg/m2/s in code + unit in field.xml	To suppress the multiplication by "one-day" in the code formulation	Do we add a daily output in the field_id?
66	x	3687	rain	rain	precip_rain*one_day/dt_sechiba	hydrolc_main	Rainfall	kg/m²/dt_sechiba	mm/d	water	Convert to kg/m2/s in code + unit in field.xml	To suppress the multiplication by "one-day" in the code formulation + Long name = "Rainfall rate"	precip_rain + question about var_name in field_def	none
67	x	3687	snowf	snowf	precip_snow*one_day/dt_sechiba	hydrolc_main	Snowfall	kg/m²	mm/d	water	Convert to kg/m2/s in code + unit in field.xml	To suppress the multiplication by "one-day" in the code formulation + Long name = "Snowfall rate"	precip_snow + question about var_name in field_def as "Snowf" in ALMA?	none
68	x	3687	rain_alma	Rainf	precip_rain/dt_sechiba	hydrolc_main	Rainfall rate	kg/m²	mm/s	water		To delete in the code		none		ALMA
69	x	3687	snowf_alma	Snowf	precip_snow/dt_sechiba	hydrolc_main	Snowfall rate	kg/m²	mm/s	water		To delete in the code		none		ALMA
70	x	3687	dss	dss	dss	hydrolc_main	Up-reservoir Height	m	m	water	Long name should be "Depth of dry soil in top reservoir"	to keep		none
71	x	3687	bqsb	bqsb	mean_bqsb	hydrolc_main	Lower Soil Moisture	kg/m²	kg/m²	water		To modify	mean_bqsb	none
72	x	3687	gqsb	gqsb	mean_gqsb	hydrolc_main	Upper Soil Moisture	kg/m²	kg/m²	water		To modify	mean_gqsb	none
73	x	3687	qsintveg	qsintveg	qsintveg	hydrolc_main	Water on canopy	kg/m²	kg/m²	water	add per PFT in lon name ?	to keep		none
74	x	3687	precisol	precisol	precisol*one_day/dt_sechiba	hydrolc_main	Throughfall	kg/m²/dt_sechiba	mm/d	water	Convert to kg/m2/s in code + field.xml	To suppress the multiplication by "one-day" in the code formulation + Long name = "Throughfall rate"
75	x	3687	floodout	floodout	floodout*one_day/dt_sechiba	hydrolc_main	Flow out of floodplains	kg/m²/dt_sechiba	mm/s	water or routing	Convert to kg/m2/s in code + unit in field.xml	To suppress the multiplication by "one-day" in the code formulation		none
76	x	3687	humrel	humrel	humrel	hydrolc_main	Soil moisture stress	unitless	1	water	Long Name … "Soil moisture stress for transpiration (NOT relative humidity)"	to keep; set unit unit to "1"		none
77	x	3687	qsintmax	qsintmax	qsintmax	hydrolc_main	Maximum Interception capacity	kg/m²	kg/m²	water	add per PFT in lon name ?	to keep		none
78	x	3687	mrros	mrros	run_off_tot/dt_sechiba	hydrolc_main	Surface Runoff		kg/m²/s	water		To delete in the code	mrros	mrros=runoff(based on field_id)		cmor
79	x	3687	prveg	prveg	(precip_rain(:)-SUM(precisol(:,:))/dt_sechiba	hydrolc_main	Precipitation onto Canopy		kg/m²/s	water	Change long name to "Canopy interception".	To keep		none		cmor
80	x	3687	mrsos	mrsos	histvar	hydrolc_main	Moisture in Upper 0.1 m of Soil Column	kg/m²	kg m-2	water		To keep		none	mrsos	cmor
81	x	3687	mrso	mrso	mean_bqsb+mean_gqsb	hydrolc_main	Total Soil Moisture Content	kg/m²	kg/m²	water	to delete and redefine in file/field = humtot	To keep		mrso=humtot	mrso	cmor
82	x	3687	SubSnow	SubSnow	vevapsno/dt_sechiba	hydrolc_main	Snow sublimation	kg/m²/dt_sechiba	kg/m2/s	water	ALMA (redundant with field_id=subli)	delete. keep only output in sechiba, in mm/s		add an entry with filed_id=subli and name =SubSnow		ALMA; cmor name = sbl
83	x	3687	SnowDepth	SnowDepth	snowdepth	hydrolc_main	3D snow depth (total snow depth	m	m	water		to keep		none	snd	ALMA; cmor name = snd
84	x	3687	Qs	Qs	run_off_tot/dt_sechiba	hydrolc_main	Surface Runoff	kg/m²/dt_sechiba	kg/m²/s	water	ALMA output	To delete in the code	Link to runoff field_id	keep it, but linked to field_id=runoff		ALMA; cmor name = mrros
85	x	3687	Qsb	Qsb	drainage/dt_sechiba	hydrolc_main	Sub-surface runoff	kg/m²/dt_sechiba	kg/m²/s	water	ALMA output	To delete in the code	Link to drainage field_id	keep it, but linked to field_id=drainage		ALMA
86	x	3687	Qsm	Qsm	tot_melt/dt_sechiba	hydrolc_main	Snowmelt	kg/m²/dt_sechiba	kg/m²/s	water/snow	ALMA output ; change Long Name to "Snowmelt + Icemelt from nobio fractions"	To modify "field_id" to "tot_melt"	snowmelt + Qsm as "name" in "file_def"	no conversion		ALMA; cmor name = snm
87	x	3687	SoilWet	SoilWet	soilwet	hydrolc_main	Total soil wetness	unitless	-	water	[0,1] ?	To delete in the code
88	x	3687	DelSoilMoist	DelSoilMoist	delsoilmoist	hydrolc_main	Change in soil moisture (grid average	kg/m²	kg/m²	water	grid cell average	to keep	delsoilmoist	none		ALMA
89	x	3687	DelSWE	DelSWE	delswe	hydrolc_main	Change in Snow Water Equivalent	kg/m²	kg/m²	water		to keep	delswe	none		ALMA
90	x	3687	DelIntercept	DelIntercept	delintercept	hydrolc_main	Change in interception storage	kg/m²	kg/m²	water		^to keep	delintercept	none	average on the grid	ALMA
91		3687	RootMoist	RootMoist	tot_watsoil_end	hydrolc_main	Root zone soil water	Kg/m²	kg/m²	water	this gives the total soil moisture at the end of current dt_sechiba; normally equal to mrso	to delete, redefine in file = humtot		"=mrso"		ALMA
92		3642	LandPoints	LandPoints	1:kjpindex	intersurf_main_2d (intersurf_main_gathered)	LandPoints	-	-	?		keep	/	/
93		3642	Areas	Areas	area	intersurf_main_2d (intersurf_main_gathered)	Mesh areas	m^2	m^2	sechiba		to modify	area	/
94		3642	Contfrac	Contfrac	contfrac	intersurf_main_2d (intersurf_main_gathered)	Continental Fraction	-	1	sechiba	change units from 1 to (-)	to modify	contfrac	/
95		3642	evap	evap	zvevapp*one_day/dt_sechiba	intersurf_main_2d (intersurf_main_gathered)	Evaporation	kg/m^2/tstep	mm/d	sechiba	evap_alma and evap should be a unique variable	to delete in the code	vevapp_day	vevapp*86400
96		3642	evap_alma	evap_alma	zvevapp/dt_sechiba	intersurf_main_2d (intersurf_main_gathered)	Total Evapotranspiration	kg/m^2/tstep	kg/m^2/s	sechiba	correct longname: Total evaporation	to modify and move to sechiba	vevapp	/
97		3642	coastalflow	costalflow	zcoastal/dt_sechiba	intersurf_main_2d (intersurf_main_gathered)	Diffuse coastal flow	m^3/tstep	m^3/s	sechiba		to modify and move to sechiba	coastalflow	/
98		3642	riverflow	riverflow	zriver/dt_sechiba	intersurf_main_2d (intersurf_main_gathered)	River flow to the oceans	m^3/tstep	m^3/s	sechiba		to modify and move to sechiba	riverflow because name in sechiba	/
99		3642	temp_sol_C	temp_sol	ztemp_sol_new-ZeroCelsius	intersurf_main_2d (intersurf_main_gathered)	New Surface Temperature	K	C	sechiba	Rename longname as "Average Surface Temperature"	to delete	temp_sol_new_C	temp_sol_new-273.15
100		3642	temp_sol_K	AvgSurfT	ztemp_sol_new	intersurf_main_2d (intersurf_main_gathered)	Average Surface Temperature	K	K	sechiba		to modify and move to sechiba	temp_sol_new	/