Model:GrainHill: Difference between revisions

From CSDMS
(Created page with "{{Model identity |Model type=Single }} {{Start models incorporated}} {{End a table}} {{Model identity2 |ModelDomain=Terrestrial |Spatial dimensions=2D |One-line model descript...")
 
No edit summary
Line 1: Line 1:
{{Model identity
{{Model identity
|Model also known as=Grain Hill
|ModelFramework=LandLab
|Model type=Single
|Model type=Single
}}
}}
Line 7: Line 9:
|ModelDomain=Terrestrial
|ModelDomain=Terrestrial
|Spatial dimensions=2D
|Spatial dimensions=2D
|Spatialscale=Reach-Scale
|One-line model description=Cellular automaton model of hillslope evolution
|One-line model description=Cellular automaton model of hillslope evolution
|Extended model description=(descrip to be edited)
|Extended model description=The Grain Hill model provides a computational framework with which to study slope forms that arise from stochastic disturbance and rock weathering events. The model operates on a hexagonal lattice, with cell states representing fluid, rock, and grain aggregates that are either stationary or in a state of motion in one of the six cardinal lattice directions. Cells representing near-surface soil material undergo stochastic disturbance events, in which initially stationary material is put into motion. Net downslope transport emerges from the greater likelihood for disturbed material to move downhill than to move uphill. Cells representing rock undergo stochastic weathering events in which the rock is converted into regolith. The model can reproduce a range of common slope forms, from fully soil mantled to rocky or partially mantled, and from convex-upward to planar shapes. An optional additional state represents large blocks that cannot be displaced upward by disturbance events. With the addition of this state, the model captures the morphology of hogbacks, scarps, and similar features. In its simplest form, the model has only three process parameters, which represent disturbance frequency, characteristic disturbance depth, and baselevel lowering rate, respectively. Incorporating physical weathering of rock adds one additional parameter, representing the characteristic rock weathering rate. These parameters are not arbitrary but rather have a direct link with corresponding parameters in continuum theory.
}}
}}
{{Start model keyword table}}
{{Start model keyword table}}
Line 15: Line 18:
|First name=Gregory
|First name=Gregory
|Last name=Tucker
|Last name=Tucker
|Type of contact=Model developer
|Institute / Organization=University of Colorado
|Town / City=Boulder
|Town / City=Boulder
|Postal code=80309
|Postal code=80309
Line 22: Line 27:
}}
}}
{{Model technical information
{{Model technical information
|Supported platforms=Unix, Linux, Mac OS, Windows
|Programming language=Python
|Code optimized=Single Processor
|Start year development=2014
|Does model development still take place?=Yes
|Does model development still take place?=Yes
|Model availability=As code
|Source code availability=Through web repository
|Source web address=https://github.com/gregtucker/grain_hills
|Program license type=BSD or MIT X11
|Program license type=BSD or MIT X11
|Memory requirements=varies with grid size
|Typical run time=varies with grid size
}}
}}
{{Input - Output description
{{Input - Output description
|Describe input parameters=number_of_node_rows: # rows
number_of_node_columns: # columns
cell_size: width of grid cells,
grav_accel: gravitational acceleration, m/s2
friction_coef: dimensionless friction factor, 0 to 1
run_duration: duration of run, years
output_name: base name for output files
uplift_interval: time interval between uplift events, years
disturbance_rate: frequency parameter for soil disturbance, 1/years
weathering_rate: frequency parameter for rock weathering, 1/years
rock_state_for_uplift: type of material added at base during uplift (7=soil, 8=rock)
opt_rock_collapse: option to have rock cells collapse when undermined
opt_track_grains: (currently under development)
show_plots: whether to display plots on screen (True or False)
plot_to_file: whether to write plots to png file (True or False)
plot_interval: interval between plots, years
output_interval: interval between file output, years
report_interval: real-time interval for reporting on screen, seconds
include_blocks: whether to include a layer of rock that weathers to blocks (True or False)
block_layer_dip_angle: (optional) if block option selected, dip angle for rock layer
block_layer_thickness: (optional) if block option selected, thickness of layer in cells
y0_top: (optional) if block option selected, y coordinate of top of layer at x=0
|Input format=ASCII
|Describe output parameters=node state grid written to netCDF file (each node gets a code from 0 to 8; see paper)
|Other output format=netCDF
|Pre-processing software needed?=No
|Pre-processing software needed?=No
|Post-processing software needed?=No
|Post-processing software needed?=No
|Visualization software needed?=No
|Visualization software needed?=No
}}
}}
{{Process description model}}
{{Process description model
|Describe processes represented by the model=Regolith disturbance; rock weathering; baselevel lowering
|Describe key physical parameters and equations=(see paper)
|Describe length scale and resolution constraints=(see paper)
|Describe time scale and resolution constraints=(see paper)
|Describe any numerical limitations and issues=(see paper)
}}
{{Model testing}}
{{Model testing}}
{{Users groups model}}
{{Users groups model}}
{{Documentation model
{{Documentation model
|Manual model available=No
|Manual model available=No
|Model website if any=https://github.com/gregtucker/grain_hills
}}
}}
{{Additional comments model}}
{{Additional comments model}}

Revision as of 13:48, 3 July 2018



GrainHill


Metadata

Also known as Grain Hill
Model type Single
Model part of larger framework LandLab
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 2D
Spatial extent Reach-Scale
Model domain Terrestrial
One-line model description Cellular automaton model of hillslope evolution
Extended model description The Grain Hill model provides a computational framework with which to study slope forms that arise from stochastic disturbance and rock weathering events. The model operates on a hexagonal lattice, with cell states representing fluid, rock, and grain aggregates that are either stationary or in a state of motion in one of the six cardinal lattice directions. Cells representing near-surface soil material undergo stochastic disturbance events, in which initially stationary material is put into motion. Net downslope transport emerges from the greater likelihood for disturbed material to move downhill than to move uphill. Cells representing rock undergo stochastic weathering events in which the rock is converted into regolith. The model can reproduce a range of common slope forms, from fully soil mantled to rocky or partially mantled, and from convex-upward to planar shapes. An optional additional state represents large blocks that cannot be displaced upward by disturbance events. With the addition of this state, the model captures the morphology of hogbacks, scarps, and similar features. In its simplest form, the model has only three process parameters, which represent disturbance frequency, characteristic disturbance depth, and baselevel lowering rate, respectively. Incorporating physical weathering of rock adds one additional parameter, representing the characteristic rock weathering rate. These parameters are not arbitrary but rather have a direct link with corresponding parameters in continuum theory.
Keywords:
Name Gregory Tucker
Type of contact Model developer
Institute / Organization University of Colorado
Postal address 1
Postal address 2
Town / City Boulder
Postal code 80309
State Colorado
Country United States
Email address gtucker@colorado.edu
Phone
Fax


Supported platforms
Unix, Linux, Mac OS, Windows
Other platform
Programming language

Python

Other program language
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 2014
Does model development still take place? Yes
If above answer is no, provide end year model development
Code development status
When did you indicate the 'code development status'?
Model availability As code
Source code availability
(Or provide future intension)
Through web repository
Source web address https://github.com/gregtucker/grain_hills
Source csdms web address
Program license type BSD or MIT X11
Program license type other
Memory requirements varies with grid size
Typical run time varies with grid size


Describe input parameters number_of_node_rows: # rows

number_of_node_columns: # columns cell_size: width of grid cells, grav_accel: gravitational acceleration, m/s2 friction_coef: dimensionless friction factor, 0 to 1 run_duration: duration of run, years output_name: base name for output files uplift_interval: time interval between uplift events, years disturbance_rate: frequency parameter for soil disturbance, 1/years weathering_rate: frequency parameter for rock weathering, 1/years rock_state_for_uplift: type of material added at base during uplift (7=soil, 8=rock) opt_rock_collapse: option to have rock cells collapse when undermined opt_track_grains: (currently under development) show_plots: whether to display plots on screen (True or False) plot_to_file: whether to write plots to png file (True or False) plot_interval: interval between plots, years output_interval: interval between file output, years report_interval: real-time interval for reporting on screen, seconds include_blocks: whether to include a layer of rock that weathers to blocks (True or False) block_layer_dip_angle: (optional) if block option selected, dip angle for rock layer block_layer_thickness: (optional) if block option selected, thickness of layer in cells y0_top: (optional) if block option selected, y coordinate of top of layer at x=0

Input format ASCII
Other input format
Describe output parameters node state grid written to netCDF file (each node gets a code from 0 to 8; see paper)
Output format
Other output format netCDF
Pre-processing software needed? No
Describe pre-processing software
Post-processing software needed? No
Describe post-processing software
Visualization software needed? No
If above answer is yes
Other visualization software


Describe processes represented by the model Regolith disturbance; rock weathering; baselevel lowering
Describe key physical parameters and equations (see paper)
Describe length scale and resolution constraints (see paper)
Describe time scale and resolution constraints (see paper)
Describe any numerical limitations and issues (see paper)


Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing


Do you have current or future plans for collaborating with other researchers?
Is there a manual available? No
Upload manual if available:
Model website if any https://github.com/gregtucker/grain_hills
Model forum / discussion board
Comments


This part will be filled out by CSDMS staff

OpenMI compliant Not yet"Not yet" is not in the list (Yes, No but planned, No but possible, No not possible) of allowed values for the "Code openmi compliant or not" property.
BMI compliant Not yet"Not yet" is not in the list (Yes, No but planned, No but possible, No not possible) of allowed values for the "Code IRF or not" property.
WMT component Not yet"Not yet" is not in the list (Yes, In progress, No but possible, No not possible) of allowed values for the "Code CMT compliant or not" property.
PyMT component
Is this a data component
Can be coupled with:
Model info
Gregory Tucker

Nr. of publications: 1
Total citations: 7
h-index: 1
m-quotient: 0.17
Qrcode GrainHill.png
Link to this page


Introduction

History

References




Nr. of publications: 1
Total citations: 7
h-index: 1
m-quotient: 0.17


Publication(s)YearTypeCited
Error: Table AuthorsMan not found.
. . , , .
[[| (View/edit entry)]]
GrainHill
Landlab

Model overview

Template:SEM 2787833328
Error: Table AuthorsMan not found.
. . , , .
[[| (View/edit entry)]]
GrainHill
Landlab

Related theory

Template:SEM 2289594762

Issues

Help

Input Files

Output Files