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
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Field | Field | The field to use for subsetting and calculations. |
| Input | String For Output | String | String to be added at the beginning of the Output Results file. |
| Input | Trigger | Unknown | Port that when changed causes the module to run. |
| Output | Numeric Output 1 | Number | A numeric value computed from the expression. |
| Output | Numeric Output 2 | Number | A numeric value computed from the expression. |
| Output | Numeric Output 3 | Number | A numeric value computed from the expression. |
| Output | String Output 1 | String | A string value computed from the expression. |
| Output | String Output 2 | String | A string value computed from the expression. |
| Output | Output Second Moment Object | Renderable | A renderable object displaying the second moment ellipse and mass lines. |
Properties
| Property | Type | Description |
|---|---|---|
| Allow Run | Boolean | When on, the module runs every time a setting is changed. |
| Execute | Button | Forces the module to run even if Allow Run has been turned off. This allows the user to make a number of changes before updating. |
| Explode | Double | The explode distance applied to the input field. |
| Update Information Window | Boolean | When on, the Information window receives a report every time the module is run. |
| Inputs | Results | Reported values of the input controls used by the volumetrics calculation. See Reported Results above. |
| Outputs | Results | All volumetric and mass results. See Reported Results above. |
Input Settings
| Property | Type | Description |
|---|---|---|
| Nodal Data Component | Choice | The nodal data component used for the calculation. Options are the nodal data components of the input field. |
| Nodal Units | Linked Analyte Unit | The 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 Units | Linked Coordinate Unit | The 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
| Property | Type | Description |
|---|---|---|
| Water Filled Porosity | Double | The 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 Porosity | Double | The fraction of total volume occupied by air. Used for Soil Vapor basis mass and activity calculations. |
| Soil Density | Double | The 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 Density | Double | The 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 Density | Double | The 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 Values | Boolean | Enables the cost calculations. When off, no dollar values are computed or reported, and the Volume Dollars and Mass Dollars rates are disabled. |
| Volume Dollars | Double | The cost per unit volume, used along with the total volume to indicate the cost of removal. |
| Mass Dollars | Double | The value per unit mass, used along with the total chemical mass to determine the value of the chemical mass. |
Output Settings
| Property | Type | Description |
|---|---|---|
| Volume Units | Choice: Cubic Feet, Cubic Yards, Cubic Meters, Liters, Acre Feet, Barrels, Specify | The units in which volume is reported. When linked, set from the input coordinate units, with a default of Cubic Meters. |
| Volume Units Ratio | Double | If 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 Units | String | If Volume Units is set to Specify, the units label used in the output. |
| Mass Units | Choice: Kilograms, Metric Tons, Pounds, U.S. Short Tons, Ounces (Troy), Specify | The 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 Ratio | Double | If Mass Units is set to Specify, the factor needed to convert between the user-specified units and kilograms. |
| Mass Specified Units | String | If Mass Units is set to Specify, the units label used in the output. |
| Output Results To File | Boolean | Writes 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 String | String | A leading string written for every entry in the output file. |
| Filename | File | The output filename, used when Output Results To File is on. |
| Output Filetype | Choice: Tabbed File (Excel), Mirror Display, Tabbed Multi-Line | The 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 File | Boolean | Causes the output file to be written over instead of appended to. |
Area Moment Of Inertia
| Property | Type | Description |
|---|---|---|
| Display Mass Along Major Eigen Vector | Boolean | Toggles the visibility of the mass line along the major eigenvector. |
| Display Mass Along Minor Eigen Vector | Boolean | Toggles the visibility of the mass line along the minor eigenvector. |
| Display Mass Along Interm Eigen Vector | Boolean | Toggles the visibility of the mass line along the intermediate eigenvector. |
| Segments In Lines | Integer | The 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 Axis | Boolean | Strips the node data from the lines, leaving them colored by the axis they represent. |
| Ellipsoid Resolution | Integer | The number of faces used to approximate the analytically smooth ellipsoid. The higher the resolution, the smoother the ellipsoid. |
| Ellipsoid Scale | Double | A 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 Color | Color | The solid color of the second moment ellipsoid. |
Output Port Settings
| Property | Type | Description |
|---|---|---|
| Numeric Expression 1 | Expression | Python 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 2 | Expression | Python expression for the second numeric output port. The same variables as Numeric Expression 1 are available. |
| Numeric Expression 3 | Expression | Python expression for the third numeric output port. The same variables as Numeric Expression 1 are available. |
| String Expression 1 | Expression | Python 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 2 | Expression | Python f-string expression for the second string output port. The same variables as String Expression 1 are available. |