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 EVS Information Window and the module Properties panel.
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.
NOTE: 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 (all densities should be entered in g/cm³).
- 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).
- The volume of analyte (Chemical Volume) is computed from the Chemical Mass using the Chemical Density parameter.
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.
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 | Other | 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 the Allow Run toggle is set to on the module will run every time a setting is changed. |
| Execute | Button | This button will force the module to run even if the Allow Run toggle has been turned off. This allows the user to make a number of changes before updating. |
| Z Scale | Double | The Z exaggeration factor applied to the input field. |
| Explode | Double | The Explode factor applied to the input field. |
| Update Information Window | Boolean | When on, the Information window receives a report every time the module is run. |
Input Settings
| Property | Type | Description |
|---|---|---|
| Nodal Data Component | Choice | The Nodal Data Component used to subset the input. Options are populated from the input field. |
| Nodal Units | Linked Analyte Unit | The Nodal Units are set based on the input data and the selected Nodal Data Component. The Multiplier is the ratio of the user’s input units to grams/grams (for example, 1e-6 for mg/kg/ppm). The Calculation Type determines what type of units to process the Nodal Data Component in. |
| Coordinate Units | Linked Coordinate Unit | The Coordinate Units are set based on the coordinate units of the input model. The Multiplier is the ratio of the user’s input units to liters (for example, 1000 for cubic meters). |
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 Soil Density value allows the user to input the properties of the soil matrix in which the chemicals reside. If a combined soil and ground water plume is being estimated, set up a geologic boundary at the water table position so the soil and groundwater domains can be calculated separately. |
| Chemical Density | Double | The Chemical Density value allows the user to input the density of the chemical constituent for which mass estimates are being completed. This value is used to calculate the volume of chemical in the specified isosurface, as the mass units are calculated directly from the nodal data. |
| Water Density | Double | The Water Density value allows the user to specify the density of water. The default of 0.9999720 g/mL is the density of water at 4.5 degrees Celsius. |
| Volume Dollars | Double | The Volume Dollars value is used along with the total volume of the chemical to indicate the cost of the removal of the chemical. |
| Mass Dollars | Double | The Mass Dollars value is 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 | Volume Units is used to select which units the volume should be calculated in. |
| Volume Units Ratio | Double | If the Volume Units is set to Specify, the user must set the Volume Units Ratio. The ratio should be 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 the Volume Units is set to Specify, the user must set the Volume Specified Units label. This label will be used in the output. |
| Mass Units | Choice: Kilograms, Metric Tons, Pounds, U.S. Short Tons, Ounces (Troy), Specify | Mass Units is used to select which units the mass should be calculated in. |
| Mass Unit Ratio | Double | If the Mass Units is set to Specify, the user must set the Mass Unit Ratio. The ratio should be the factor needed to convert between the user-specified units and kilograms. |
| Mass Specified Units | String | If the Mass Units is set to Specify, the user must set the Mass Specified Units label. This label will be used in the output. |
| Output Results To File | Boolean | The Output Results To File toggle causes volumetrics to write 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 opened in append mode and will grow as volumetrics is run. Delete or move the file when finished with it. |
| Output String | String | The Output String will output a leading string for every entry into the output file. |
| Filename | String | If the Output Results To File toggle has been selected, the output filename must be set. |
| Output Filetype | Choice: Tabbed File (Excel), Mirror Display, Tabbed Multi-Line | The Output File Type choice is used to select the format of the output file. The default is a tab spaced single line output, the second choice formats the output the same as the display window, and the third option formats the output separated by tabs on multiple lines. |
| Overwrite File | Boolean | The Overwrite File toggle 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 | The Display Mass Along Major Eigen Vector toggle controls visibility of the mass-line along the major eigenvector. |
| Display Mass Along Minor Eigen Vector | Boolean | The Display Mass Along Minor Eigen Vector toggle controls visibility of the mass-line along the minor eigenvector. |
| Display Mass Along Interm Eigen Vector | Boolean | The Display Mass Along Interm Eigen Vector toggle controls visibility of the mass-line along the intermediate eigenvector. |
| Segments In Lines | Integer | The Segments In Lines value controls 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 | The Color Lines By Axis toggle strips the node data from the lines, leaving them colored by the axis they represent. |
| Ellipsoid Resolution | Integer | Ellipsoid Resolution determines the number of faces used to approximate the analytically smooth ellipsoid. The higher the resolution, the smoother the ellipsoid. The Export Results button must be used to have an output port for the ellipsoid. |
| Ellipsoid Scale | Double | The Ellipsoid Scale is 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 second moment ellipse is a solid color which can be selected using this control. |
Volumetric Output
| Property | Type | Description |
|---|---|---|
| Total Volume | Double | The total geometric volume of the selected domain. |
| Soil Mass | Double | The total mass of soil in the selected domain. Only applicable to Soil and Groundwater basis calculations. |
| Water Volume | Double | The total volume of water in the selected domain. Applicable to Groundwater basis. |
| Water Mass | Double | The total mass of water in the selected domain. Applicable to Groundwater basis. |
| Air Volume | Double | The total volume of air in the selected domain. Applicable to Soil Vapor basis. |
| Air Mass | Double | The total mass of air in the selected domain. Applicable to Soil Vapor basis. |
| Total Activity | Double | The total radon activity in the selected domain. Applicable to Soil Vapor basis with radon (activity) units. |
| Chemical Volume | Double | The output chemical volume. |
| Chemical Mass | Double | The output chemical mass. |
| Average | Double | The Average Concentration of the selected analyte (units match the Nodal Units control). |
| Volume Dollars | Double | The volume in volume dollars. |
| Mass Dollars | Double | The mass in mass dollars. |
| Center Of Mass | Coordinate 3D | The Center Of Mass of the output volume. |
Output Port Settings
| Property | Type | Description |
|---|---|---|
| Numeric Expression 1 | String | Python expression for the first numeric output port. Use variable names like SoilVolume, ChemicalMass, AverageConcentration, CenterOfMassX, etc. to reference volumetrics values. |
| Numeric Expression 2 | String | Python expression for the second numeric output port. |
| Numeric Expression 3 | String | Python expression for the third numeric output port. |
| String Expression 1 | String | Python f-string expression for the first string output port. Use {VariableName} placeholders such as {VolumeUnits}, {MassUnits}, {AnalyteName}, etc. to reference volumetrics values. |
| String Expression 2 | String | Python f-string expression for the second string output port. |