CSN Assumption Names: Difference between revisions

From CSDMS
Line 1: Line 1:
=   '''[[CSDMS_Standard_Names | CSDMS Standard Names]]  — Assumption Names''' =
=   '''[[CSDMS_Standard_Names | CSDMS Standard Names]]  — Assumption Names''' =
:
:
* This document provides standardized assumption names for use in Model Metadata Files (MMF).  They are organized into groups.
* This document provides standardized assumption names for use in Model Metadata Files (MMF).  They are organized into groups and are not meant to be exhaustive but more illustrative. The ones collected here already illustrate various language patterns that are commonly used to describe assumptions. <br/> <br/>
 
* Note that '''assumption''' is meant to be taken as a broad term that can include things like ''conditions'', ''simplifications'', ''limitations'', ''provisos'' and other forms of clarification.  <br/> <br/>
 
* CSDMS encourages model developers to include as many <assumption> tags in there Model Metadata File as they feel apply to their model or to a particular input or output variable name.  XML tag nesting determines the scope of an <assumption> tag's scope. For someone familiar with a particular modeling domain, the terms that have been collected here should be easily recognized and understood.  <br/> <br/>


<br/>
<br/>

Revision as of 10:36, 17 August 2012

  CSDMS Standard Names — Assumption Names

  • This document provides standardized assumption names for use in Model Metadata Files (MMF). They are organized into groups and are not meant to be exhaustive but more illustrative. The ones collected here already illustrate various language patterns that are commonly used to describe assumptions.

  • Note that assumption is meant to be taken as a broad term that can include things like conditions, simplifications, limitations, provisos and other forms of clarification.

  • CSDMS encourages model developers to include as many <assumption> tags in there Model Metadata File as they feel apply to their model or to a particular input or output variable name. XML tag nesting determines the scope of an <assumption> tag's scope. For someone familiar with a particular modeling domain, the terms that have been collected here should be easily recognized and understood.


Conserved Quantity Assumptions

angular_momentum_conserved
electric_charge_conserved
energy_conserved
linear_momentum_conserved
mass_conserved
momentum_conserved
potential_vorticity_conserved
  
########
sediment_mass_conserved
water_mass_conserved
########
conserves_energy
conserves_mass
conserves_momentum
conserves_potential_vorticity


Equations, Laws and Principles

  • These all end in "_equation", "_law" or "_principle", except for the "law of the wall".

ampere_law
archimedes_principle
avogadro_law
beer_lambert_law
bernoulli_principle
biharmonic_equation
biot_savart_law
boltzman_equation
boyle_law
burgers_equation
cauchy_riemann_equations
combined_gas_law
conservation_of_energy_law         ###
conservation_of_mass_law            ###  (same as continuity_equation)
conservation_of_momentum_law  ###
coulomb_law
dalton_law
darcy_law   (See: Darcy's law).
darcy_weisbach_equation   (See: Darcy-Weisbach).
diffusion_equation
ehrenfest_equations   (See: | Ehrenfest equations).
eikonal_equation
einstein_field_equations
euler_equation   (inviscid flow)
euler_lagrange_equation
exner_equation
faraday_law
faxen_law
fick_law
fourier_law
gauss_law_for_electricity
gauss_law_for_magnetism
gay_lussac_law
geodesic_equation
geometric_optics_equation
gibbs_helmholtz_equation
glen_stress_strain_law     (Glen's Law for glacier flows, Glen (1955); nonnewtonian fluid)
hack_law
### heat_equation  (use "diffusion_equation" instead)
helmholtz_equation
henry_law
horton_law
ideal_gas_law
joule_first_law
joule_second_law
kepler_first_law_of_planetary_motion
kepler_second_law_of_planetary_motion
kepler_third_law_of_planetary_motion
laplace_equation
law_of_the_wall          (flow resistance)
lorentz_force_law
manning_equation     (flow resistance)
mass_energy_equivalence
maxwell_equations
minimal_surface_equation
navier_stokes_equation
newton_first_law_of_motion
newton_law_of_cooling
newton_law_of_universal_gravitation
newton_second_law_of_motion
newton_third_law_of_motion
nonlinear_diffusion_equation   ###
ohm_law
p_laplace_equation
planck_law
poiseuille_law
poisson_equation
reynolds_averaged_navier_stokes_equation
richards_equation   (infiltration theory)
schroedinger_equation
snell_law
stefan_boltzmann_law
stiff_equation   #### (a type, vs. a named equation)
stokes_law
thermodynamics_zeroth_law
thermodynamics_first_law
thermodynamics_second_law
thermodynamics_third_law
wien_displacement_law
young_laplace_equation


Named Model-Type Assumptions

  • These may be used for the <how_modeled> tag.
  • These names all end in "_model".
Infiltration Process Models
beven_exponential_K_infiltration_model
curve_number_model    ##### (HydroModeler)
green_ampt_infiltration_model
horton_infiltration_model
richards_1d_infiltration_model
richards_3d_infiltration_model
smith_parlange_infiltration_model
Evaporation (and sometimes Transpiration) Process Models
asce_standardized_evaporation_model    #### (HydroModeler)
energy_balance_evaporation_model
hargreaves_evaporation_model                 #### (HydroModeler)
penman_monteith_evaporation_model
priestley_taylor_evaporation_model
Water Wave Models
airy_wave_model
capillary_wave_model    #### ????
cnoidal_wave_model
stokes_wave_model
Soil Models
brooks_corey_soil_model
darcy_soil_model  ?###### See Equations, Laws, Etc.
transitional_brooks_corey_soil_model
van_genuchten_soil_model
Snowmelt Models
degree_day_snowmelt_model
energy_balance_snowmelt_model
Atmosphere Models   #######
brutsaert_saturated_vapor_pressure_model
satterlund_saturated_vapor_pressure_model
Channelized Flow Models
d8_surface_flow_model
diffusive_wave_model    ####
d_infinity_surface_flow_model    ####
dynamic_wave_model 
hydraulic_geometry_model   ####  (Leopold et al.)
kinematic_wave_model
law_of_the_wall_flow_resistance_model  ##### ???
manning_flow_resistance_model   ##### ???
mass_flux_flow_model
muskingum_flow_routing_method      (routing flow through a channel network)
Sediment Transport Models
bagnold_sediment_transport_model   (distinguish total load and bedload ####)
detachment_limited_sediment_transport
einstein_sediment_transport_model
komar_longshore_sediment_transport_model    ####
meier_peter_mueller_sediment_transport_model
supply_limited_sediment_transport
Turbulence and Turbulence Closure Models
See: Turbulence modeling.
detached_eddy_simulation_model (DES)
direct_numerical_simulation_model  (DNS)  (Navier-Stokes solved without a turbulence model)
eddy_viscosity_model    (due to Boussinesq, 1887)
k_epsilon_model    (due to Jones and Launder) 
k_omega_model    (due to Kolmogorov ??)
kolmogorov_statistical_turbulence_model
large_eddy_simulation_model  (LES)   ?? #####
menter_shear_stress_transport_model
prandtl_mixing_length_model  (due to Prandtl)
reynolds_averaged_navier_stokes_model   (or reynolds_shear_stress_model)
smagorinsky_model   (due to Smagorinsky, 1964;  for sub-grid scale eddy viscosity)
spalart_allmaras_model
 
boussinesq_buoyancy_approximation
dispersion_relation   (could be linear)
kramers_kronig_relations
General Physics Models
harmonic_oscillator_model
lambda_cdm_model   (standard model of Big Bang cosmology)
simple_pendulum_model    (harmonic oscillator ?)
standard_particle_physics_model
vibrating_string_model
Thermodynamics Models
carnot_heat_engine_model  (See: Carnot heat engine).
Earthquake Models
rough_fault_model
slider_block_model
spring_block_seismic_model
travelling_wave_model      (include the word "earthquake"?  ####)
Nonlinear Science Models
bond_percolation_model  (what type of lattice ??)
cellular_automata_model
diffusion_limited_aggregation_model
fisher_droplet_model
ising_model
lattice_gas_model    (or lattice_gas_automata_model ??)
logistic_map_model
sandpile_model   (Per Bak, self-organized criticality)
self_similar_tree_model
site_percolation_model   (what type of lattice ??)
Illumination and Shading Models
See: List of common shading algorithms.
blinn_phong_illumination_model
cook_torrance_illumination_model
flat_shading_model
gouraud_shading_model
lambert_illumination_model           (lambert vs. lambertian)
minnaert_illumination_model
oren_nayer_illumination_model
phong_illumination_model
phong_shading_model
ward_anisotropic_illumination_model
Models Not Yet Grouped
frictionless
general_relativity_model
hagen_poiseuille      (pressure drop in a pipe; laminar, viscous, incompressible)
harmonic_function   (solution to Laplace equation)
hydraulic_jump
inclined_plane
power_law              ####
special_relativity_model
unnamed_empirical_law         ####
VSEPR                 (to compute molecular geometry)


Flow-Type Assumptions

  • These names all end in "_flow".
accelerating_flow
boundary_layer_flow
couette_flow    (See: Couette flow).
depth_integrated_flow        (for 3D flow to 2D flow;  vs. vertically_integrated_flow)
electro_osmotic_flow
fully_developed_turbulent_flow
geostrophic_flow           ###### CHECK
hele_shaw_flow  (See: Hele-Shaw flow).
hydraulically_rough_flow
hydraulically_smooth_flow
hydrostatic_flow
inviscid_flow  (of an ideal fluid with no viscosity)
laminar_flow
nonaccelerating_flow
nonhydrostatic_flow
plug_flow  (See: Plug flow).
potential_flow   (inviscid, as around airfoils;  See Potential flow).
statistically_isotropic_turbulent_flow
steady_flow
stokes_flow  (same as "creeping flow"; See: Stokes flow).
turbulent_flow
unsteady_flow
viscous_flow
  
### boussinesq_assumption
### reynolds_averaged_flow
### taylor_hypothesis


Fluid-Type Assumptions

  • The word "material" is sometimes used in place of "fluid", but here we consistently use the word "fluid".
  • Is Glen's Law (a nonlinear stress-strain relation for glaciers) a special case of one of the nonnewtonian fluid types listed here?
bingham_plastic_fluid   (See: | Bingham plastic).
carreau_fluid
compressible_fluid
cross_fluid
dilatant_fluid     (shear thickening fluid or STF)
first_order_fluid
herschel_bulkley_fluid
incompressible_fluid
#### inviscid_fluid   (non-viscous;  see inviscid_flow instead)
kelvin_voigt_fluid       (a linear viscoelastic model; same as "kelvin_material"  ?? ######)
maxwell_fluid   (a linear viscoelastic model)
newtonian_fluid  (sometimes just called "viscous_fluid"  ??)
nonnewtonian_fluid
oldroyd_fluid   (a linear viscoeleastic model; see Oldroyd-B model.
power_law_fluid    (generalized Newtonian, Ostward-de Waele)
pseudoplastic_fluid (shear thinning)
rheopectic_fluid
second_order_fluid
super_fluid  (See: Superfluid).
thixotropic_fluid  (See: [1].)
viscoelastic_fluid  (See: Viscoelastic.)
viscoplastic_fluid  (See: Viscoplastic.)
#### viscous_fluid   (see viscous_flow instead)


General Process Assumptions

1D    (Q: If richards_equation is used for infiltration, keep 1D and 3D out of how_modeled name?)
2D
3D
constant_coefficients
continuous
continuum  (continuum_hypothesis ?)
differentiable
differentiable_twice
differentiable_three_times
discontinuous
dynamic_equilibrium
equal_mixed_partials
equilibrium
ergodic
flat_spacetime
linear
multiple_valued_function  ###
nonlinear
orthogonal
single_valued_function  ### ???
spatially_uniform
static_equilibrium
steady_state
symmetric
uniform
  
### degenerate


Named Approximations

  • These all end in "_approximation" and some can be found in other sections.
boussinesq_approximation  (ocean modeling)
fourier_series_approximation
infiltrated_depth_approximation  (infiltration modeling)
power_law_approximation
taylor_series_approximation
wavelet_series_approximation  ####


Thermodynamic Process Assumptions

adiabatic_process (See: Adiabatic).
cyclic_process
diabatic_process
endoreversible_process
endothermic_process    (better as adjective? absorbs energy)
exothermic_process     (better as adjective? releases energy)
irreversible_process
isentropic_process  (also called "reversible" ?; See: Isentropic).
isenthalpic_process  (also called "isoenthalpic"; See: Isenthalpic).
isobaric_process
isocaloric_process
isochoric_process
isothermal_process
polytropic_process
quasistatic_process  (reversible implies quasistatic, but not conversely)
reversible_process


Atmosphere Modeling Assumptions

  • See additional assumptions in "CF Standard Name Assumptions" below.
boussinesq_approximation   (not in CF, but see for_*)
clear_sky                  (23 in CF)
deep_snow                  (1 in CF)
horizontal_plane_topography        (for clear-sky radiation calculation, not in CF)
no_aerosol_or_cloud     (1 in CF)
no_snow                 (1 in CF)
rigid_lid               (in CF; always related to boussinesq approximation ??)
sea_level_for_geoid     (4 in CF)
standard_temperature_and_pressure  (not in CF)


Ocean Modeling Assumptions

  • See additional assumptions in "CF Standard Name Assumptions" below.
airy_wave
capillary_wave
cnoidal_wave
deep_water_wave
fully_developed_sea
no_tide                   (2 in CF)
passive_scalar    (e.g. temperature and salinity, perhaps suspended sediment)
### per_unit_length_of_wave_crest
shallow_water_wave
shore_parallel_contours   (not in CF)
stokes_wave


Groundwater and Infiltration Modeling Assumptions

  • See dupuit_forschheimer in Modeling Methods.
brooks_corey_soil_model ? ####
confined_aquifer ####
dupuit_assumption
homogeneous_medium  (separate from isotropic ??)
horizontal_flowlines  (and vertical equipotential lines)
hydraulic_gradient_equals_free_surface_gradient
hydraulic_gradient_equals_land_surface_gradient
hydraulic_gradient_invariant_with_depth
hydrostatic_pressure_head
infiltrated_depth_approximation  (not in CF)  (Used by Green-Ampt and Smith-Parlange)
     (or infiltrability_depth_approximation)
impermeable_horizontal_base  (or impermeable_boundary_at_base)
impermeable_lower_boundary   (or impermeable_base)
isotropic_medium
steady_state_recharge ???
transitional_brooks_corey_soil_model ? ####
unconfined_aquifer  ####
van_genuchten_soil_model ? ####


Surface Water Modeling Assumptions

bankfull_flow
channel_width_less_than_model_cell_width
convergent_topography
convergent_or_divergent_topography  ###### ?
d8_flow_between_cells
d_infinity_flow_between_cells
diffusive_wave
dynamic_wave
impermeable_surface ???
inbank_flow   (or no_overbank_flow ? or within_bank_flow ? ##############)
kinematic_wave   (hydraulic_slope_equals_channel_slope)
mass_flux_method_flow_between_cells
no_distributaries
no_overbank_flow
no_vegetation ????
prismatic_channels
spatially_uniform_rainfall
#### instantaneous_unit_hydrograph idea ???



Stochastic Model Assumptions

autoregressive
bernoulli_process
beta_distributed
binomial_distributed
brownian_bridge_process
brownian_motion_process
compound_poisson_process
continuous
continuous_time
discrete
discrete_time
fractional_brownian_motion_process
gaussian_distributed
geometric_brownian_motion_process
homogeneous
identically_distributed
independent
independent_increments
#### independent_and_identically_distributed  (use both)
linear_least_squares_regression
markov_process
martingale_process
moving_average
negative
nonlinear_least_squares_regression
nonnegative
ornstein_uhlenbeck_process
pareto_distributed
point_process
poisson_distributed
poisson_process
positive
random_walk_process  (symmetric or unsymmetric)
rayleigh_distributed
schramm_loewner_evolution_process  (See: SLE process).
second_order_stationary_process
semi_markov_process
stationary_process
uniform_distributed
uncorrelated
weak_stationarity_of_order_k
weibull_distributed
weiner_process


Object Shape Assumptions

  • Most of these names end in "_shaped".
circle_shaped
concave
concave_upward    (long profiles)
convex
ellipse_shaped
ellipsoid_shaped      (e.g. for earth)
hexagon_shaped
hyperbola_shaped
octogon_shaped
parabola_shaped
pentagon_shaped
prismatic   (see Channel Flow)
rectangle_shaped
semicircle_shaped     (e.g. for a channel_cross_section)
sphere_shaped
square_shaped
trapezoid_shaped      (e.g. for a channel_cross_section)
  
What about these?  (See General Process Assumptions.)
continuous_curve
continuous_surface
differentiable_curve
differentiable_surface
differentiable_twice_curve
differentiable_twice_surface

"What about assumptions on functional form?"

exponential
logarithmic


Averaging Assumptions

  • These names all start with "averaged_over_".
averaged_over_basin
averaged_over_depth
averaged_over_interval
averaged_over_one_day
averaged_over_one_month
averaged_over_one_year
averaged_over_population
averaged_over_space
averaged_over_time


Numerical Method Assumptions

  • Most of these names end with "_method", "_scheme" or "_grid".
analytic_element_method  (See: Analytic element method).
arakawa_a_grid  (unstaggered)
arakawa_b_grid  (staggered)
arakawa_c_grid   (staggered)
arakawa_d_grid  (staggered, rotated 90 degrees)
arakawa_e_grid   (staggered, rotated 45 degrees)
backward_difference_scheme
boundary_element_method  (See: Boundary element method).
central_difference_scheme
characteristics_method          (known as "method of characteristics")
conditionally_stable  ####
conjugate_gradient_method
direct_numerical_solution
discrete_event_simulation
euler_method    (distinguish between "forward" and "backward" with a prefix?)
explicit_time_stepping_method
fast_marching_method    (a type of level_set_method)
finite_difference_method
finite_element_method
finite_volume_method
first_order_accurate
forward_difference_scheme
forward_time_centered_space_scheme   (FTCS scheme)
halley_method
implicit_time_stepping_method
large_eddy_simulation
leapfrog_method
level_set_method
multigrid_method
newton_raphson_method   (see "halley_method")
runge_kutta
second_order_accurate
### staggered_grid  (already in arakawa system ??)
successive_over_relaxation_method
unconditionally_stable  ####
upwind_scheme


CF Standard Name Assumptions

  • Many of these are "Location Assumptions".
above_geoid                  (3 in CF)
above_land_surface           (not in CF)
above_reference_datum        (1 in CF)
above_reference_ellipsoid    (5 in CF)
above_sea_floor              (1 in CF)
above_sea_floor_surface      (not in CF)
above_sea_level              (1 in CF)
above_threshold               (5 in CF)
 
at_***                        (51 in CF)
at_cloud_base                 (1 in CFFl
at_cloud_top                  (3 in CF)
at_equilibrium                (not in CF)
at_freezing_level             (1 in CF)
at_land_surface               (not in CF;  e.g. air pressure)
at_maximum_upward_derivative  (1 in CF)
at_saturation                 (4 in CF)
at_sea_floor                  (3 in CF)
at_sea_floor_surface          (not in CF;  e.g. water pressure)
at_sea_ice_base               (8 in CF)
at_sea_level                  (1 in CF)
at_top_of_***                 (3 in CF)
at_bottom_***                 (not in CF)
 
assuming_***                 (32 in CF)
   (insert as a prefix to everything in this block ??)
 
below_geoid         (1 in CF)
below_sea_level     (1 in CF)
below_sea_surface   (1 in CF)
below_surface       (1 in CF)
below_threshold     (3 in CF)
 
between_air_and_sea_water     (1 in CF)
between_sea_water_and_air     (2 in CF)
 
due_to_***                     (399 in CF)
due_to_all_land_processes      (2 in CF)
due_to_convective_cloud        (1 in CF)
due_to_diffusion               (18 in CF)
due_to_dry_convection          (1 in CF)
due_to_dry_deposition          (35 in CF)
due_to_dry_troposphere         (1 in CF)
due_to_dust_ambient_aerosol    (2 in CF)
due_to_emission_from_grazing   (in CF)
 
excluding_anthropogenic_land_use_change (in CF)
excluding_baseflow (in CF)
excluding_litter (in CF)
 
expressed_as_***       (140 in CF)
expressed_as_carbon    (67 in CF)
expressed_as_chlorine  (7 in CF)
expressed_as_nitrogen  (24 in CF)
 
for_***                       (13 in CF)
for_biomass_growth            (1 in CF)
for_biomass_maintenance       (1 in CF)
for_boussinesq_approximation  (1 in CF)
for_momentum (2 in CF;  both "for_momentum_in_air")
 
per_capita
per_unit_area          (already used in CF)
per_unit_length_of_wave_crest
per_unit_mass          (already used in CF, and synonym for "specific")
per_unit_time           ??
per_unit_width         (e.g. discharge_per_unit_width)
                       (see CF: sea_water_transport_across_line,
                        and "transport_across_unit_distance")