CSN Assumption Names
From CSDMS
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, approximations, limitations, conventions, provisos and other forms of clarification.
- CSDMS encourages model developers to include as many <assume> tags in their 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 <assume> tag. For someone familiar with a particular modeling domain, the terms that have been collected here should be easily recognized and understood as part of that domain's standard terminology.
- Given a collection of models that have Model Metadata Files which include a standardized listing of assumptions it will be straightforward to write software that allows the CSDMS modeling framework to automatically check whether two components to be coupled are compatible and alert users to potential problems or mismatches. Reports can also be generated automatically that quantify the degree of compatibility. Similarly, opportunities for valid model coupling can then also be automatically identified.
Conserved Quantity Assumptions
- These names all end in "_conserved". See Conservation Law and links therein.
angular_momentum_conserved electric_charge_conserved energy_conserved linear_momentum_conserved mass_conserved momentum_conserved potential_vorticity_conserved ######## sediment_mass_conserved water_mass_conserved Note: Perhaps there should be a separate standard assumption name to indicate the substance that is being transported and conserved like sediment_transport or water_transport. Perhaps we need assumption names that indicate the physical processes that are modeled.
######## conserves_energy conserves_mass conserves_momentum conserves_potential_vorticity
Coordinate System and Angle Conventions
- Many of these end in the word "_system".
cartesian_coordinate_system (same as "rectilinear") geographic_coordinate_system orthogonal_curvilinear_coordinate_system measured_clockwise_from_north (all "bearing" angles, e.g. wind "from" angles) measured_counter_clockwise_from_east measured_counter_clockwise_from_x_axis (standard math) right_hand_rule_coordinate_system x_axis_directed_downwind x_axis_directed_offshore y_axis_directed_alongshore z_axis_directed_downward (positive_downward) z_axis_directed_upward (positive_upward)
- Perhaps we should put "directed" at the end of the terms that contain "directed" above.
Equations, Laws and Principles
- An <assume> tag should be provided for each equation that a model (or model component) uses. Most equations have standard names, as shown in the examples below.
- These all end in "_equation", "_law" or "_principle", except for the "law of the wall".
adams_williamson_equation (See: Adams-Williamson equation.) 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 (See: Eikonal equation.) einstein_field_equations euler_equation (inviscid flow) euler_lagrange_equation exner_equation faraday_law faxen_law fick_law flint_law fresnel_equations friedmann_equations fourier_law gauss_law_for_electricity gauss_law_for_magnetism gay_lussac_law geodesic_equation geometric_optics_equation gibbs_helmholtz_equation gibrat_law (See: Gibrat's law.) 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 hubble_law huygens_fresnel_principle (See: Huygens-Fresnel principle.) ideal_gas_law (See: Ideal gas law. Also an "ideal_gas_model" ??) joule_first_law joule_second_law kepler_first_law_of_planetary_motion kepler_second_law_of_planetary_motion kepler_third_law_of_planetary_motion kirchoff_circuit_laws Kirchoff circuit laws kirchoff_diffraction_formula kirchoff_thermal_radiation_law 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 nernst_equation (See: Nernst 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 zipf_law (See: Zipf's law.)
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. Sometimes called "piston 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
- These names all end in "_fluid". See Non-newtonian Fluid and links therein.
- 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?
auxetic_material (See: Auxetics.) bingham_plastic_fluid (See: Bingham plastic). carreau_fluid casson_fluid (industry standard model for molten milk chocolate) 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) quemada_fluid (Used to model blood. See: Hemorheology.) 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 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 finite flat_spacetime infinite linear metastable (See: Metastability). multiple_valued_function ### nonlinear orthogonal single_valued_function ### ??? spatially_uniform static_equilibrium steady_state symmetric uniform ### degenerate
Named Model-Type Assumptions
- These may be used for the <how_modeled> tag.
- These names all end in "_model".
Agent-Based Models agent_based_model (See: Agent-based model.) reynolds_flocking_model schelling_segregation_model Schelling segregation 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_at_a_station_model hydraulic_geometry_downstream_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_model (routing flow through a channel network) rational_regime_model
Chemistry Models atomic_shell_model bohr_model nuclear_shell_model (See: nuclear shell model.) rutherford_model valence_bond_model vespr_model (See: VESPR theory.)
Cosmological Models baum_frampton_model (a cyclic model) big_bang_model (See: Big bang). big_bounce_model big_crunch_model conformal_cyclic_model cyclic_model dark_energy_model (and dark_mass_model ?) lambda_cdm_model (standard model of Big Bang cosmology) steinhardt_turok_model (a cyclic model)
Earthquake Models rough_fault_model slider_block_model spring_block_seismic_model travelling_wave_model (include the word "earthquake"? ####)
Ecological Models exponential_growth_model food_web_model Food web kolmogorov_predator_prey_model logistic_growth_model lotka_volterra_model Lotka-Volterra natural_selection_model Natural selection population_growth_model trophic_cascade_model Trophic cascade
Evaporation (and sometimes Transpiration) Process Models (See: Methods for estimating ET.) asce_standardized_evaporation_model (in CUAHSI HIS HydroModeler) blaney_criddle_evaporation_model debruin_evaporation_model (lakes and ponds) energy_balance_evaporation_model hargreaves_evaporation_model (remove the "s" in hargreaves ??) jensen_haise_evaporation_model kohler_nordenson_fox_evaporation_model (lakes and reservoirs) kohler_parmele_evaporation_model penman_evaporation_model penman_monteith_evaporation_model priestley_taylor_evaporation_model shuttleworth_evaporation_model (a modified penman model) stewart_rouse_evaporation_model (lakes and ponds) thornthwaite_water_balance_model ########
General Physics Models double_pendulum_model (See: Double pendulum.) foucault_pendulum_model (See: Foucault Pendulum.) harmonic_oscillator_model quantum_harmonic_oscillator_model simple_pendulum_model (harmonic oscillator ? gravity pendulum?) standard_particle_physics_model vibrating_string_model
Geodynamics Models
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
Infiltration Process Models (Hydrology) beven_infiltration_model (assumes Ks decays exponentially) green_ampt_infiltration_model horton_infiltration_model philip_infiltration_model richards_1d_infiltration_model richards_3d_infiltration_model scs_curve_number_infiltration_model (remove "curve number"?) smith_parlange_infiltration_model
Infiltration Models (Ventilation Models) lbl_infiltration_model sherman_grimsrud_infiltration_model
Nonlinear Science Models aperiodic_tiling_model (See: Aperiodic tiling.) bond_percolation_model (what type of lattice ??) cellular_automata_model diffusion_limited_aggregation_model dimer_model (and "double_dimer_model" ?) fisher_droplet_model ising_model lattice_gas_model (includes: lattice_gas_automata_model and lattice_boltzmann_model. See: Lattice gas automaton.) logistic_map_model penrose_tiling_model potts_model (See: Potts model.) sandpile_model (Per Bak, self-organized criticality) self_similar_tree_model site_percolation_model (what type of lattice ??)
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
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
Thermodynamics Models black_body_model (See: Black body.) carnot_heat_engine_model (See: Carnot heat engine). gray_body white_body
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
Water Wave Models airy_wave_model Airy waves capillary_wave_model (type of wave vs. model for waves?) cnoidal_wave_model Cnoidal waves stokes_wave_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) boussinesq_buoyancy_approximation dispersion_relation (could be linear) kramers_kronig_relations
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
- These names all end in "_process". See: Wikipedia: Thermodynamic process and links therein.
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 thermal_equilibrium #### (See "black_body_model".) (See: Thermal equilibrium).
Atmosphere and Radiation Modeling Assumptions
- See additional assumptions in "CF Convention 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
Ground Water 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) law_of_the_wall (also listed with equations) liquid_water_equivalent (used to clarify a quantity like precipitation_rate) manning_equation (also listed with equations) 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
- Many of these end with the word "_process", which is part of the standard terminology. Many others end with "_distribution".
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_multiplicative_cascade_process (is there "additive", too?) random_walk_process (symmetric or unsymmetric) rayleigh_distributed risk_process schramm_loewner_evolution_process (See: SLE process). second_order_stationary_process self_avoiding_random_walk semi_markov_process stationary_process storage_process uniform_distributed uncorrelated weak_stationarity_of_order_k weibull_distributed weiner_process
Shape and Geometry Assumptions
- Most of these names end in "_shaped".
circle_shaped concave concave_upward (long profiles) convex ellipse_shaped ellipsoid_shaped (e.g. for earth) half_plane 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
- These are used to describe the numerical method that a model uses to solve the equations it uses to compute variables of interest. The equations could be ODEs, PDEs, algebraic equations (e.g. root finding), etc. We probably don't need separate assumption names like "ode" and "pde" because that is implied by the equation name. See Equations, Laws and Principles for a standardized list of equation names.
- 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 Convention Standard Name Assumptions
- CF Convention Standard Names often include additional information and assumptions in the name itself. The ones in this section were found in the list of CF Standard Names and the number of occurrences found is listed in parentheses. It is not yet clear how some of these should be captured with standard assumption names.
- 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_*** (33 in CF) assuming_clear_sky (24 in CF) assuming_deep_snow (1 in CF, for surface_albedo) assuming_no_aerosol_or_cloud (1 in CF) assuming_no_snow (1 in CF, for surface_albedo) assuming_no_tide (2 in CF) assuming_sea_level_for_geoid (4 in CF) 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")