Difference between revisions of "Worldfiles"

From Rhessys
Jump to navigationJump to search
(New page: {| {{table}} | align="center" style="background:#f0f0f0;"|'''Name''' | align="center" style="background:#f0f0f0;"|'''Parameters''' | align="center" style="background:#f0f0f0;"|''' ''' | al...)
 
 
(35 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
Be warned that the grass2world parser program is not 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.
 +
 +
<pre>
 +
WARNING!
 +
Worldfiles are currently incompatible between minor version releases of RHESSys. This means if your worldfile runs under
 +
5.13, then it will probably not run under 5.14.
 +
</pre>
 +
 +
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:   
 +
<pre>
 +
<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>
 +
&#09;_basin <map> <extent=1>
 +
&#09;<basin variable> <function> <parameters>
 +
&#09;&#09;_hillslope <map> <extent=1>
 +
&#09;&#09;<hillslope variable> <function> <parameters>
 +
&#09;&#09;&#09;_zone <map> <extent=1>
 +
&#09;&#09;&#09;<zone variable> <function> <parameters>
 +
&#09;&#09;&#09;&#09;_patch <map> <extent=1>
 +
&#09;&#09;&#09;&#09;<patch variable> <function> <parameters>
 +
&#09;&#09;&#09;&#09;&#09;_stratum <map> <extent={integer >0}>
 +
&#09;&#09;&#09;&#09;&#09;<stratum variable> <function> <parameters>
 +
</pre>
 +
 +
==Variables==
 +
{| {{table}}
 +
| align="center" style="background:#f0f0f0;"|'''Basin Vars'''
 +
| align="center" style="background:#f0f0f0;"|'''Hillslope Vars'''
 +
| align="center" style="background:#f0f0f0;"|'''Zone Vars'''
 +
| align="center" style="background:#f0f0f0;"|'''Patch Vars'''
 +
| align="center" style="background:#f0f0f0;"|'''Statum Vars'''
 +
|-
 +
| [[basin x|x]]||[[hillslope x|x]]||[[zone x|x]]||[[patch x|x]]||[[stratum default_ID|default_ID]]
 +
|-
 +
| [[basin y|y]]||[[hillslope y|y]]||[[zone y|y]]||[[patch y|y]]||[[cover_fraction]]
 +
|-
 +
| [[basin z|z]]||[[hillslope z|z]]||[[zone z|z]]||[[patch z|z]]||[[gap_fraction]]
 +
|-
 +
| [[basin default_ID|default_ID]]||[[hillslope default_ID|default_ID]]||[[zone default_ID|default_ID]]||[[patch soil_default_ID|soil_default_ID]]||[[root_depth]]
 +
|-
 +
| [[latitude]]||[[base_flow]]||[[a_area]]||[[landuse_default_ID]]||[[snow_stored]]
 +
|-
 +
| [[basin n_basestations|n_basestations]]||[[hillslope n_basestations|n_basestations]]||[[zone slope|slope]]||[[a_area]]||[[rain_stored]]
 +
|-
 +
| ||||[[aspect]]||[[patch slope|slope]]||[[cs_pool]]
 +
|-
 +
| ||||[[isohyet]]||[[wetness_index]]||[[cs_leafc]]
 +
|-
 +
| ||||[[East and west horizons|east_horizon]]||[[Ksat_vertical]]||[[cs_dead_leafc]]
 +
|-
 +
| ||||[[East and west horizons|west_horizon]]||[[m]]||[[cs_leafc_store]]
 +
|-
 +
| ||||[[zone n_basestations|n_basestations]]||[[unsat_storage]]||[[cs_leafc_transfer]]
 +
|-
 +
| |||||[[base_station_ID]]||[[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]]
 +
|-
 +
| ||||||[[patch n_basestations|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]]
 +
|-
 +
| ||||||||[[stratum n_basestations|n_basestations]]
 +
|}
 +
 +
==Functions==
 
{| {{table}}
 
{| {{table}}
 
| align="center" style="background:#f0f0f0;"|'''Name'''
 
| align="center" style="background:#f0f0f0;"|'''Name'''
 
| align="center" style="background:#f0f0f0;"|'''Parameters'''
 
| align="center" style="background:#f0f0f0;"|'''Parameters'''
−
| align="center" style="background:#f0f0f0;"|''' '''
 
−
| align="center" style="background:#f0f0f0;"|''' '''
 
 
| align="center" style="background:#f0f0f0;"|'''Description'''
 
| align="center" style="background:#f0f0f0;"|'''Description'''
−
| align="center" style="background:#f0f0f0;"|''''''
 
−
| align="center" style="background:#f0f0f0;"|''''''
 
−
|-
 
−
| daver||Map||||||Outputs the average integer value in map||||
 
 
|-
 
|-
−
| aver||Map||||||outputs the average float value in map||||
+
| daver||map||Outputs the average integer value in map
 
|-
 
|-
−
| Spavg||Map||||||output the spherical average (float) in map||||
+
| aver||map||Outputs the average float value in map
 
|-
 
|-
−
| mode||Map|| || ||outputs the average float value in map||||
+
| spavg||map||Output the spherical average (float) in map
 
|-
 
|-
−
| area||||||||outputs the area||||
+
| mode||map||Outputs the average float value in map
 
|-
 
|-
−
| count||Map||||||outputs the number of categories in map||||
+
| area||||Outputs the area
 
|-
 
|-
−
| deqn||Multiply||add||map||outputs (average integer value in map ) * multiply + add||||
+
| count||map||Outputs the number of categories in map
 
|-
 
|-
−
| eqn||Multiply||add||map||outputs (average float value in map ) * multiply + add||||
+
| deqn||multiply, add, map||Outputs (average integer value in map ) * multiply + add
 
|-
 
|-
−
| Dvalue||Integer_value||||||outputs integer_value||||
+
| eqn||multiply add map||Outputs (average float value in map ) * multiply + add
 
|-
 
|-
−
| value||Float_value||||||outputs float_value||||
+
| dvalue||integer_value||Outputs integer_value
 
|-
 
|-
−
|  
+
| value||float_value||Outputs float_value
 
|}
 
|}
−
_hillslope h10000 1 ("h10000" is the hillslope map)
 
−
x value 0.0
 
−
y value 0.0
 
−
z aver rainbow.dem
 
−
default_ID dvalue 1
 
−
base_flow value 0.0
 
−
n_basestations dvalue 0
 
−
_zone h10000 1 (if you have a zone map, use that. Here, we used the hillslope map as the zone map)
 
−
x value 0.0
 
−
y value 0.0
 
−
z aver rainbow.dem
 
−
default_ID dvalue 1
 
−
a_area area
 
−
slope aver slope2 ("slope2" is the slope map created in GRASS)
 
−
aspect spavg aspect2 slope2 ("aspect2" and "slope2" were created in GRASS)
 
−
isohyet value 1.0
 
−
east_horizon value 0.1745
 
−
west_horizon value 0.1745
 
−
n_basestations dvalue 1
 
−
base_station_ID dvalue 101
 
−
_patch patch1.cl 1 ("patch1.cl" is the patch map created in GRASS)
 
−
x value 0.0
 
−
y value 0.0
 
−
z aver rainbow.dem
 
−
soil_default_ID mode soils_new (this takes the modal values/ID's from the soils map called "soils_new")
 
−
landuse_default_ID mode lu90 (this takes the model values/ID's from the land use map called "lu90")
 
−
a_area area
 
−
slope aver slope2
 
−
wetness_index value 7
 
−
Ksat_vertical aver impervious ("impervious" is the impervious map created in GRASS)
 
−
m aver m3 (this takes the average values from the "m3" map)
 
−
unsat_storage value 0.01
 
−
sat_deficit value 0.02
 
−
snowpack_water_equivalent_depth value 0.00
 
−
snowpack_water_depth value 0.0
 
−
snowpack_T value -10.0
 
−
snowpack_surface_age value 0
 
−
snowpack_energy_deficit value -0.5
 
−
rain_stored value 0.00
 
−
litter_cs.litr1c value 0.0780
 
−
litter_ns.litr1n value 0.0011
 
−
litter_cs.litr2c value 0.0792
 
−
litter_cs.litr3c value 0.0000
 
−
litter_cs.litr4c value 0.0243
 
−
soil_cs.soil1c value 3.2
 
−
soil_ns.sminn value 0.005
 
−
soil_ns.nitrate value 0.001
 
−
soil_cs.soil2c value 3.0
 
−
soil_cs.soil3c value 3.5
 
−
soil_cs.soil4c value 8.0
 
−
n_basestations dvalue 0
 
−
_stratum patch1.cl 1 (if you have a stratum map, use that. Here, we used the patch map called "patch1.cl" in place of a stratum map)
 
−
default_ID mode vegtype5 (this takes the model values from the vegetation map called "vegtype5")
 

Latest revision as of 16:48, 24 November 2009

Be warned that the grass2world parser program is not 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. 

WARNING!
Worldfiles are currently incompatible between minor version releases of RHESSys. This means if your worldfile runs under
5.13, then it will probably not run under 5.14.

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
west_horizon m cs_leafc_store
n_basestations unsat_storage cs_leafc_transfer
base_station_ID 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
Retrieved from "http://wiki-rhessys.eri.ucsb.edu/index.php?title=Worldfiles&oldid=324"