Worldfiles

Be warned that the grass2world parser program is not very flexible when it comes to file layout, so be careful when creating your template files. The template file is parsed based on the order in which variables occur, and all fields must be specified.

A world file consists of three parts. First, there are two dates giving the start and end time of the simulation. Second, is a list of support files, such as def files and met station information that grass2world must incorporate. The last and largest section, sets initial values for various parameters at various spacial levels. A generic template file would be layed out like so:

<start date: year month day hour>
<end date: year month day hour>
<number of basin defs>
..paths to basin defs
<number of hillslope defs>
..paths to hillslope defs
<number of zone defs>
..paths to zone defs
<number of soil defs>
..paths to soils defs
<number of landuse defs>
..paths to landuse defs
<number of vegetation defs>
..paths to vegeation defs
<number of met stations>
..paths to met stations
_world <map> <extent=1>
	_basin <map> <extent=1>
	<basin variable> <function> <parameters>
		_hillslope <map> <extent=1>
		<hillslope variable> <function> <parameters>
			_zone <map> <extent=1>
			<zone variable> <function> <parameters>
				_patch <map> <extent=1>
				<patch variable> <function> <parameters>
					_stratum <map> <extent={integer >0}>
					<stratum variable> <function> <parameters>

Variables

Basin Vars	Hillslope Vars	Zone Vars	Patch Vars	Statum Vars
x	x	x	x	default_ID
y	y	y	y	cover_fraction
z	z	z	z	gap_fraction
default_ID	default_ID	default_ID	soil_default_ID	root_depth
latitude	base_flow	a_area	landuse_default_ID	snow_stored
n_basestations	n_basestations	slope	a_area	rain_stored
		aspect	slope	cs_pool
		isohyet	wetness_index	cs_leafc
		east_horizon	Ksat_vertical	cs_dead_leafc
		n_basestations	m	cs_leafc_store
		base_station_ID	unsat_storage	cs_leafc_transfer
			sat_deficit	cs_live_stemc
			snowpack_water_equivalent_depth	cs_live_stemc_store
			snowpack_water_depth	cs_live_steamc_transfer
			snowpack_T	cs_dead_stem
			snowpack_energy_deficit	cs_dead_stemc_store
			rain_stored	cs_dead_stemc_transer
			litter_cs.litr1c	cs_live_crootc
			litter_ns.litr1n	cs_live_crootc_store
			litter_cs.litr2c	cs_live_crootc_transfer
			litter_cs.litr3c	cs_dead_crootc
			litter_cs.litr4c	cs_dead_crootc_store
			soil_cs.soils1c	cs_dead_crootc_transfer
			soil_ns.sminn	cs_frootc
			soil_ns.nitrate	cs_frootc_store
			soil_cs.soils2c	cs_frootc_transfer
			soils_cs.soil3c	cs_cwdc
			soil_cs.soil4c	epv.prev_leafcalloc
			n_basestations	ns_pool
				ns_leafn
				ns_dead_leafn
				ns_leafn_store
				ns_leafn_transfer
				ns_live_stemn
				ns_live_stemn_store
				ns_live_stemn_transfer
				ns_dead_stem
				ns_dead_stemn_store
				ns_dead_stemn_transfer
				ns_live_crootn
				ns_live_crootn_store
				ns_live_crootn_transfer
				ns_dead_crootn
				ns_dead_crootn_store
				ns_dead_crootn_transfer
				ns_frootn
				ns_frootn_store
				ns_frootn_transfer
				ns_cwdn
				epv_wstress
				epv_min_fparabs
				epv_min_vwc
				n_basestations

Functions

Name	Parameters	Description
daver	map	Outputs the average integer value in map
aver	map	Outputs the average float value in map
spavg	map	Output the spherical average (float) in map
mode	map	Outputs the average float value in map
area		Outputs the area
count	map	Outputs the number of categories in map
deqn	multiply, add, map	Outputs (average integer value in map ) * multiply + add
eqn	multiply add map	Outputs (average float value in map ) * multiply + add
dvalue	integer_value	Outputs integer_value
value	float_value	Outputs float_value