CSN Assumption Names: Difference between revisions
From CSDMS
Line 386: | Line 386: | ||
unnamed_empirical_law #### | unnamed_empirical_law #### | ||
VSEPR (to compute molecular geometry) | VSEPR (to compute molecular geometry) | ||
<br/> | |||
<!-- ============================================= --> | |||
== {{ Bar Heading| text=Named Approximations}} == | == {{ Bar Heading| text=Named Approximations}} == |
Revision as of 14:08, 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, "approximations", limitations, provisos and other forms of clarification.
- CSDMS encourages model developers to include as many <assumption> 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 <assumption> 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 Wikipedia: 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
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 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 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 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
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
- These names all end in "_fluid". See Wikipedia: 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?
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 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 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".
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
quantum_harmonic_oscillator_model simple_pendulum_model (harmonic oscillator ?) standard_particle_physics_model vibrating_string_model
Thermodynamics Models black_body_model (See: Black body.) carnot_heat_engine_model (See: Carnot heat engine). gray_body white_body
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
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)
Geodynamics Models : :
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)
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 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
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) 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 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")