volumetrics

volumetrics

The volumetrics module calculates the volumes and masses of soil, water, air, and chemicals within a user specified domain (typically a constant concentration shell intersected with a set of geologic layers). The user selects the basis (Soil, Groundwater, Soil Vapor, or Volume Only), the analyte and coordinate units, and the soil and chemical properties used in the calculation. The module integrates volumes and masses across all cells in the input field and reports results in the module’s Properties panel and, optionally, the Information window.

The volumetrics module computes the volume and mass of everything passed to it. To compute the volume/mass of a plume, you must first use a module like plume or intersection to subset your model.

Info

Do not use plume shell or intersection shell upstream of volumetrics, since their output is a hollow shell without any volume.

The volumetrics module computes volumes and masses of analytes using the following method:

  • Each cell within the selected geologic units is analyzed.
  • The mass of analyte within the cell is integrated based on concentrations at all nodes (and computed cell division points).
  • The volumes and masses of all cells are summed.
  • Centers of mass and eigenvectors are computed.
  • For Soil basis, the mass of analyte is directly computed from the computed mass of soil (e.g. mg/kg). This is affected by the Soil Density parameter.
  • For Groundwater basis, the mass of analyte (Chemical Mass) is computed by first determining the volume of water in each cell using the Water Filled Porosity parameter and each individual cell’s volume. From the cell’s water volume, the mass of analyte is directly computed (e.g. mg/L).
  • For Soil Vapor basis, the Air Filled Porosity is used to determine the volume of air in each cell. With radon (activity) units, the total activity and the derived Rn-222 mass are reported instead of chemical volume and mass.
  • The volume of analyte (Chemical Volume) is computed from the Chemical Mass using the Chemical Density parameter.

If the mass of chemicals in a combined soil and ground water plume is to be estimated, one of the geologic layers should be set up to have a boundary within it that corresponds to the water table position. This creates two layers out of one geologic unit that can be used to separate the soil domain from the ground water domain. The appropriate Nodal Units can then be chosen for each domain, and the results summed.

Spatial Moments:

Connecting the Output Second Moment Object port to the viewer displays the second moment ellipsoid and the eigenvector lines (when enabled). Spatial moment analysis involves computing the zeroth, first, and second moments of a plume to provide measures of the mass, location of the center of mass, and spread of the plume.

Reported Results:

The Inputs and Outputs properties display the results of the most recent run. Inputs reports the values used by the calculation: the nodal units, coordinate units, analyte name, whether the data is log processed, the porosities and densities, and the volume and mass dollar rates. Outputs reports the total volume; soil, water and air volumes and masses; total activity and Rn-222 mass (radon units only); chemical volume and mass; average concentration; volume and mass dollars; the center of mass; and the major, intermediate and minor eigenvalues and eigenvectors of the mass-weighted second-moment tensor. Only the values applicable to the current basis are shown. The outputs can be copied for pasting into Excel, with or without headers.

Ports

DirectionNameTypeDescription
InputInput FieldFieldThe field to use for subsetting and calculations.
InputString For OutputStringString to be added at the beginning of the Output Results file.
InputTriggerUnknownPort that when changed causes the module to run.
OutputNumeric Output 1NumberA numeric value computed from the expression.
OutputNumeric Output 2NumberA numeric value computed from the expression.
OutputNumeric Output 3NumberA numeric value computed from the expression.
OutputString Output 1StringA string value computed from the expression.
OutputString Output 2StringA string value computed from the expression.
OutputOutput Second Moment ObjectRenderableA renderable object displaying the second moment ellipse and mass lines.

Properties

PropertyTypeDescription
Allow RunBooleanWhen on, the module runs every time a setting is changed.
ExecuteButtonForces the module to run even if Allow Run has been turned off. This allows the user to make a number of changes before updating.
ExplodeDoubleThe explode distance applied to the input field.
Update Information WindowBooleanWhen on, the Information window receives a report every time the module is run.
InputsResultsReported values of the input controls used by the volumetrics calculation. See Reported Results above.
OutputsResultsAll volumetric and mass results. See Reported Results above.

Input Settings

PropertyTypeDescription
Nodal Data ComponentChoiceThe nodal data component used for the calculation. Options are the nodal data components of the input field.
Nodal UnitsLinked Analyte UnitThe analyte unit name, multiplier and calculation type (basis). The Multiplier is the ratio of the user’s input units to grams/grams; for example, mg/kg (ppm) requires 0.001/1000, or 0.000001. The Calculation Type determines what type of units to process the Nodal Data Component in. When linked, all three are set from the selected Nodal Data Component.
Coordinate UnitsLinked Coordinate UnitThe coordinate unit name and multiplier. The Multiplier is the ratio of the user’s cubed coordinate units to liters; for example, meters requires 1,000, since there are 1,000 liters per cubic meter. When linked, set from the coordinate units of the input model.

Processing Settings

PropertyTypeDescription
Water Filled PorosityDoubleThe fraction of total volume occupied by water. Used for Soil and Groundwater basis mass calculations. For Soil basis this is treated as the total water content of the soil matrix; for Groundwater it is the pore water fraction.
Air Filled PorosityDoubleThe fraction of total volume occupied by air. Used for Soil Vapor basis mass and activity calculations.
Soil DensityDoubleThe density of the soil matrix in which the chemicals reside, in g/cm³ (kg/m³ and lb/ft³ are also available). Used for Soil basis.
Chemical DensityDoubleThe density of the chemical constituent for which mass estimates are being completed, in g/cm³ (kg/m³ and lb/ft³ are also available). This value is used to calculate the volume of chemical, as the mass is calculated directly from the nodal data.
Water DensityDoubleThe density of water, in g/cm³ (kg/m³ and lb/ft³ are also available). The default of 0.9999720 g/cm³ is the density of water at 4.5 degrees Celsius. Used for Groundwater basis.
Output Dollar ValuesBooleanEnables the cost calculations. When off, no dollar values are computed or reported, and the Volume Dollars and Mass Dollars rates are disabled.
Volume DollarsDoubleThe cost per unit volume, used along with the total volume to indicate the cost of removal.
Mass DollarsDoubleThe value per unit mass, used along with the total chemical mass to determine the value of the chemical mass.

Output Settings

PropertyTypeDescription
Volume UnitsChoice: Cubic Feet, Cubic Yards, Cubic Meters, Liters, Acre Feet, Barrels, SpecifyThe units in which volume is reported. When linked, set from the input coordinate units, with a default of Cubic Meters.
Volume Units RatioDoubleIf Volume Units is set to Specify, the factor needed to convert between the user-specified units and liters. For example, for cubic meters the ratio would be 1000.
Volume Specified UnitsStringIf Volume Units is set to Specify, the units label used in the output.
Mass UnitsChoice: Kilograms, Metric Tons, Pounds, U.S. Short Tons, Ounces (Troy), SpecifyThe units in which mass is reported. When linked, set from the analyte units for concentration-based calculations, falling back to the input coordinates for volume-only outputs.
Mass Unit RatioDoubleIf Mass Units is set to Specify, the factor needed to convert between the user-specified units and kilograms.
Mass Specified UnitsStringIf Mass Units is set to Specify, the units label used in the output.
Output Results To FileBooleanWrites a file, specified by the Filename, that contains all volumetrics information in a format suitable for input to programs like Excel (tab delimited .txt file). The file is written in append mode and will grow each time volumetrics runs; delete or move the file when finished with it.
Output StringStringA leading string written for every entry in the output file.
FilenameFileThe output filename, used when Output Results To File is on.
Output FiletypeChoice: Tabbed File (Excel), Mirror Display, Tabbed Multi-LineThe format of the output file. Tabbed File (Excel) writes a tab spaced single line, Mirror Display formats the output the same as the display window, and Tabbed Multi-Line separates the output by tabs on multiple lines.
Overwrite FileBooleanCauses the output file to be written over instead of appended to.

Area Moment Of Inertia

PropertyTypeDescription
Display Mass Along Major Eigen VectorBooleanToggles the visibility of the mass line along the major eigenvector.
Display Mass Along Minor Eigen VectorBooleanToggles the visibility of the mass line along the minor eigenvector.
Display Mass Along Interm Eigen VectorBooleanToggles the visibility of the mass line along the intermediate eigenvector.
Segments In LinesIntegerThe number of segments making up each eigenvector line. The larger the number of segments, the closer the node data along the line will match the node data of the model, but at the cost of speed.
Color Lines By AxisBooleanStrips the node data from the lines, leaving them colored by the axis they represent.
Ellipsoid ResolutionIntegerThe number of faces used to approximate the analytically smooth ellipsoid. The higher the resolution, the smoother the ellipsoid.
Ellipsoid ScaleDoubleA scaling factor for the second moment ellipsoid. A value of 1.0 (default) is analogous to one-sigma (67%) statistical confidence. Higher values provide an indication of the size of the eigenvalues with a higher statistical confidence.
Ellipsoid ColorColorThe solid color of the second moment ellipsoid.

Output Port Settings

PropertyTypeDescription
Numeric Expression 1ExpressionPython expression for the first numeric output port. Available variables: SoilVolume, SoilMass, WaterVolume, WaterMass, AirVolume, AirMass, TotalActivity, ChemicalVolume, ChemicalMass, AverageConcentration, VolumeDollars, MassDollars, CenterOfMassX, CenterOfMassY, CenterOfMassZ.
Numeric Expression 2ExpressionPython expression for the second numeric output port. The same variables as Numeric Expression 1 are available.
Numeric Expression 3ExpressionPython expression for the third numeric output port. The same variables as Numeric Expression 1 are available.
String Expression 1ExpressionPython f-string expression for the first string output port. Use {VariableName} to reference values. Available variables: AnalyteName, AnalyteUnits, CoordinateUnits, VolumeUnits, MassUnits, SoilMassUnits, WaterVolumeUnits, WaterMassUnits, AirVolumeUnits, AirMassUnits, ChemicalVolumeUnits, ChemicalMassUnits, ActivityUnits.
String Expression 2ExpressionPython f-string expression for the second string output port. The same variables as String Expression 1 are available.