Introduction to Water Level Reports

<< Click to Display Table of Contents >>

Navigation:  EQuIS Library > Reports > EarthSoft Standard Reports > Water Levels >

Introduction to Water Level Reports

Water Level Reports – Overview

Data Requirements and Options

Reported Value Parameter

Calculation Parameters



oOther Outputs

Unit Conversion


The Water Levels (database function) and Water Levels II (Class) Reports are included in the standard suite of reports provided with EQuIS Professional and EQuIS Enterprise. The Water Level Reports return the field-measured water level elevations as indicated by the user:

directly from EQuIS

as calculated or estimated water level elevation based on

ouser specifications

omeasured datums

oif LNAPL thickness and density are stored in the datab=ase


This article will instruct on how to use the report, what options are available within the report, and what data are required to complete each of the options.


To open the Water Level Reports in EQuIS Professional:

1.Select Reports from the Open section of the Home ribbon to open the Reports window.

2.Select Water Levels or Water Levels II and hit Enter or double-click to open one or both reports.


Water Level Reports – Overview


The Water Level Reports return water level data based on selected parameters. The report is capable of calculating estimated water levels for wells that contain light non-aqueous phase liquid (LNAPL), because free product present within a monitoring well depresses the water level such that the measured water level is not representative of the true water level within the ground. The report includes three fields to which all other metadata can be related:

SYS_LOC_CODE – Name of sampling location

MEASUREMENT_DATE – Date and time that water level measurement was obtained.

Water Level Elevation – The Water Level Report returns the following two main fields and others:

oEXACT_ELEV – Water level elevation based on Reported Value parameter inputs, expressed as a numeric value.

oWATER_LEVEL – Water level elevation based on Reported Value parameter inputs, expressed as a text field, maintaining the number of significant figures.


The report also returns an uncalculated water_level_depth column, populated as follows:

equals DT_WATER_LEVEL.WATER_LEVEL_DEPTH when the DEPTH_UNIT of the report result comes from DT_WATER_LEVEL.DEPTH_UNIT

equals a converted DT_WATER_LEVEL.WATER_LEVEL_DEPTH if the depth_unit comes from DT_FACILITY.ELEV_UNIT or DT_WELL.DEPTH_UNIT


Data Requirements and Options


The DEPTH_UNIT field is determined in order by DT_FACILITY, DT_WELL, then DT_WATER_LEVEL. One of these fields must be populated in order for the report to return the water level elevations associated with the selected locations.


Data for the Water Level Report is extracted primarily from DT_WATER_LEVEL. This data table may be found by selecting Data Tables and then selecting DT_WATER_LEVEL. To accommodate various methodologies in collecting and storing water level data, there are four different fields to store the water level information in DT_WATER_LEVEL:

1.WATER_LEVEL_DEPTH – Measured depth to water from a reference point on a well. The value is entered by the user and stored in the database.

2.WATER_LEVEL_ELEVATION – Measured elevation of water above a reference point; usually meters or feet above sea level. This value may be stored in the database or calculated by EQuIS when the Water Level Report is generated.

3.CORRECTED_DEPTH – Measured depth to water corrected for LNAPL presence, if necessary, by the user prior to import.

4.CORRECTED_ELEVATION – Measured water level elevation corrected for LNAPL presence, if necessary, by the user prior to import.


Within DT_WATER_LEVEL there is also an additional field that allows users to specify whether the recorded water level was above or below the reference point:


DIP_OR_ELEVATION – Dip is populated when the measured water level is below the reference elevation. Elevation is used where the measured water level is above the reference elevation (e.g. height of water above a transducer) above a sea bed or above an artesian well. The concept of Dip and Elevation is illustrated below.




Reported Value Parameter


The Reported Value Parameter includes three options for user selection:




1.water_level_elev – This is the default selection, which populates WATER_LEVEL and EXACT_ELEV values directly from DT_WATER_LEVEL.WATER_LEVEL_ELEV.


2.corrected_elevation – This option populates the WATER_LEVEL output column directly from DT_WATER_LEVEL.CORRECTED_ELEVATION.


For the above two Reported Value input selections, the Calculation\Elevation and/or Calculation\Depth parameters are not used.


3.calculate – When this option is selected, the water_level and exact_elev may be calculated based on the Calculation\Elevation and Calculation\Depth parameter selections as explained below.



Calculation Parameters


The following calculation for the water level elevation is performed based on dip_or_elevation values, the selected Elevation parameter, which determines the reference_elev, and the selected Calculation\Depth parameter which determines the water_depth:






                     = REFERENCE_ELEV + WATER_DEPTH when DIP_OR_ELEVATION = elevation


The values for reference elev and water depth can be collected, stored, and calculated using various methodologies as stated in the following.





Report Output Column – REFERENCE_ELEV: The user selection can be one of four options, explained below.




1.historical_reference_elev This option populates REFERENCE_ELEV directly from DT_WATER_LEVEL.HISTORICAL_REFERENCE_ELEV. If other selected elevation fields are null or have no applicable record, water level reports use this value instead. If reports try to use this field but it is null, output will vary:

a.With Reported Value = 'calculate' and Elevation = 'historical_reference_elev', the REFERENCE_ELEV, WATER_LEVEL, and EXACT_ELEV fields are blank.

b.Otherwise, REFERENCE_ELEV is blank, and WATER_LEVEL and EXACT_ELEV are populated as if REFERENCE_ELEV = 0.

2.measure_datum If this option is selected, the REFERENCE_ELEV output is populated from DT_MEASURE_DATUM.DATUM_VALUE and DT_MEASURE_DATUM.STEP_OR_LINEAR to take into account the potential for a change in the elevation of the top of the well. The elevation of the top of the well may change due to many circumstances, including any of the following examples:

a.Linear – A gradual change in ground level (e.g. degassing and subsidence at a landfill) or

b.Step – A sudden change (e.g. a truck hitting the well)

The elevation value is entered in DT_MEASURE_DATUM.DATUM_VALUE. If the STEP_OR_LINEAR field is not populated, calculations will use "Linear" for that datum. When specifying DT_MEASURE_DATUM.STEP_OR_LINEAR, include a description of whether the elevation change was a step or linear change, examples of which are as follows:

1.Linear – In the case of the landfill, the reference elevation was measured on 1st Jan and equaled 200 ft. Then, on returning on 1st June, it was re-measured to 199 ft, representing a gradual change in the elevation. If a Water Level Report was run for 15 March, it would return a MEASURE_DATUM value of 199.5 ft. After 1st June, it would return 199 ft.


For Linear, note the output considers DT_MEASURE_DATUM with start_date prior to and closest to (or before, call it as A) and after and closest to measurement_date (call it as B) in the calculations:

reference_elev = A + (B-A) / (B_start_date - A_start_date) * (measurement_date - A_start_date)


2.Step – A sudden elevation change, such as a truck damaging the well stickup, the reference elevation on 1st Jan was 200 ft, but on 1st June, the truck hits and knocks 1 ft off the well. Running a report for data on 15 March would return a MEASURE_DATUM of 200 ft, however, running a report for 2nd June would return an elevation of 199 ft.


For Step 2, if a location has more than one start_date record in DT_MEASURE_DATUM, the report returns one record per location where the DT_MEASURE_DATUM.START_DATE is the nearest date preceding the DT_WATER_LEVEL.MEASUREMENT_DATE.


3.surf_elev – This option populates REFERENCE_ELEV from VW_LOCATION.SURF_ELEV, which maps to DT_COORDINATE.ELEV.

4.top_casing_elev – This option populates REFERENCE_ELEV directly from the database: DT_WELL.TOP_CASING_ELEV.





Report Output Column: WATER_DEPTH: The user selection can be one of three options, explained below.




1.corrected_depth – WATER_DEPTH will be DT_WATER_LEVEL.CORRECTED_DEPTH directly retrieved from the database (Figure 4)

2.water_level_depth – WATER_DEPTH populates from DT_WATER_LEVEL. WATER_LEVEL_DEPTH (Figure 4)

3.calculate – WATER_DEPTH is calculated from Product Thickness as described below.




water_depth = DT_WATER_LEVEL.WATER_LEVEL_DEPTH - lnapl_density * (DT_WATER_LEVEL.WATER_LEVEL_DEPTH - lnapl_depth)


= DT_WATER_LEVEL.WATER_LEVEL_DEPTH if lnapl_depth is not available.


Note: As stated above, water_depth is determined by the Calculation\Depth parameter, which is not available when the Water Level\Reported Value parameter is not selected as calculate in the Water Levels II. If needed, users may select Water Level\Reported Value as calculate first, select Calculation\Depth, and then change Water Level\Reported Value back to intended values.


Other Outputs


The above describes how reference_elev, water_level, exact_level and water_depth of the report output are generated. The other non-direct or calculated outputs are introduced below:

Depth_unit – Determined in the order of DT_FACILITY.ELEV_UNIT, DT_WELL.DEPTH_UNIT, and DT_WATER_LEVEL.DEPTH_UNIT.

lnapl_thickness – Determined by DT_WATER_LEVEL.WATER_LEVEL_DEPTH - lnapl_depth.

dnapl_thickness – Determined by measured_depth_of_well - dnapl_depth.

lnapl_density – Determined in the order of the Water Level\User-estimated product density: parameter (hidden) or RT_ANALYTE_DETAIL.SPECIFIC_GRAVITY where cas_rn = DT_WATER_LEVEL.LNAPL_CAS_RN or the Water Level\Default Specific Gravity – Parameter (hidden, defaults to 0.8). Note that the hidden parameters can be made visible and editable to the user after the report is published to ST_REPORT.


Note: If water level data has associated LNAPL data and the Analytical and Water Results Report is the desired output, a null or numeric DT_WATER_LEVEL.LNAPL_CAS_RN is required to run the Analytical and Water Results Report. LNAPL_CAS_RN from DT_WATER_LEVEL is mapped to numeric field REPORT_RESULT_VALUE in the Analytical and Water Results Report. Another option is to not populate DT_WATER_LEVEL.LNAPL_CAS_RN and instead use the Water Level\Default Specific Gravity: parameter stated above in determining the report's lnapl_density.


Unit Conversion


The Water Level Report will not return reference_elev, water_level and exact_level data if the associated unit is null. The user must populate either DT_WATER_LEVEL.DEPTH_UNIT, DT_FACILITY.ELEV_UNIT or DT_WELL.DEPTH_UNIT for water level data to display in the Water Level Report. Also, the report will not return values if the units used do not have a conversion factor listed in RT_UNIT_CONVERSION_FACTOR for both ways (e.g., ft to ft bgs and ft bgs to ft).


Unit conversion for reference_elev, water_level, exact_level:


Here is how the original unit of each Calculation>Elevation parameter selection is retrieved:





the original unit is converted to – DT_FACILITY.ELEV_UNIT, DT_WELL.DEPTH_UNIT, or DT_WATER_LEVEL.DEPTH_UNIT, in order.

If DT_MEASURE_DATUM is selected for the Calculation>Elevation parameter, any reported REFERENCE_ELEVs for MEASUREMENT_DATEs that are prior to the START_DATE set in DT_MEASURE_DATUM will use DT_WATER_LEVEL.HISTORICAL_REFERENCE_ELEV for the report REFERENCE_ELEV field.


Unit conversion for measured_depth_of_well, water_depth, lnapl_depth, lnapl_thickness, dnapl_depth and water_level_depth from the original unit of DT_WATER_LEVEL.DEPTH_UNIT, DT_WELL.DEPTH_UNIT or DT_FACILITY.ELEV_UNIT to the output unit of