user manual for betco version 1 - uga hydrology

A-1

User manual

for

BETCO Version 1.00

Document Version 1.00

ERMS# 540534

October 2005

BETCO Version 1.00 ERMS# 540534 User manual, Version 1.00 October 2005

A-2

INTENTIONALLY LEFT BLANK.


A-3

TABLE OF CONTENTS

1.0 INTRODUCTION .................................................................................................................... 5 1.1 License ................................................................................................................................... 5 1.2 Software Identifier ................................................................................................................. 6 1.3 Points of Contact.................................................................................................................... 6 1.4 Software Description ............................................................................................................. 6

2.0 CONTROL LOGIC/CONTROL FLOW .................................................................................. 7 2.1 Execution of BETCO............................................................................................................. 7 2.2 BETCO Flowcharts................................................................................................................ 7

3.0 DATA STRUCTURES............................................................................................................. 9 3.1 Input ....................................................................................................................................... 9 3.2 Output .................................................................................................................................... 9 3.3 ALLOWABLE/PRESCRIBED RANGES FOR INPUT/OUTPUT ...................................... 9

4.0 BETCO REQUIRED TRAINING.......................................................................................... 10 5.1 Excel File Input.................................................................................................................... 11 5.2 CSV File Input ..................................................................................................................... 11 5.3 Memory Value and Time Difference Interval Selection ..................................................... 12 5.4 Adjusted Data Full Graph and Printing ............................................................................... 14 5.5 Saving Adjusted Pressure Head Data Output ...................................................................... 15 5.6 Finishing Dataset ................................................................................................................. 16

6.0 REFERENCES ....................................................................................................................... 17

List of Figures Figure 5-1. Flowchart of the Main Program. .................................................................................... 8 Figure 5-1. Starting Environment for BETCO (Application Form). .............................................. 10 Figure 5-2. The Open File Dialog................................................................................................... 11 Figure 5-3. Excel File Browser Dialog. .......................................................................................... 12 Figure 5-5. Application Appearance with Data. ............................................................................. 14 Figure 5-6. Save Dialog. ................................................................................................................. 15 Figure 5-7. Append Data to Excel Window.................................................................................... 16


A-4

INTENTIONALLY LEFT BLANK.


A-5

1.0 INTRODUCTION

This document serves as the Users Manual (UM) and Design Document for the software Barometric and earth Tide Response Correction (BETCO), as used by the Sandia National Laboratories (SNL) Repository Performance Department for application to the Waste Isolation Pilot Plant (WIPP) and other projects. This document provides the necessary information to use the BETCO software. This document also describes the working design of BETCO.

In Section 2, the functional requirements for which the software was designed are presented. In Section 3, the software components involved in developing, building, and running BETCO are presented. The theoretical and mathematical bases for the code are given in Section 4. In Section 5, the control and logic flowchart is presented and it illustrates the design according to the BETCO Functional Requirements as outlined in the approved BETCO Requirements Document (RD), ERMS #540533. Section 6 contains the file data structures for input and output and Section 6 describes the allowable data ranges. Section 7 describes the operation of BETCO and serves as a UM.

1.1 License

Copyright (2005) Sandia Corporation. Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive license for use of this work by or on behalf of the U.S. Government. Export of this program may require a license from the United States Government.

NOTICE:

For five (5) years from November 7, 2005, the United States Government is granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable worldwide license in this data to reproduce, prepare derivative works, and perform publicly and display publicly, by or on behalf of the Government. There is provision for the possible extension of the term of this license. Subsequent to that period or any extension granted, the United States Government is granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable worldwide license in this data to reproduce, prepare derivative works, distribute copies to the public, perform publicly and display publicly, and to permit others to do so. The specific term of the license can be identified by inquiry made to Sandia Corporation or DOE.


A-6

NEITHER THE UNITED STATES GOVERNMENT, NOR THE UNITED STATES DEPARTMENT OF ENERGY, NOR SANDIA CORPORATION, NOR ANY OF THEIR EMPLOYEES, MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY LEGAL LIABILITY OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS, OR USEFULNESS OF ANY INFORMATION, APPARATUS, PRODUCT, OR PROCESS DISCLOSED, OR REPRESENTS THAT ITS USE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS.

Any licensee of this software has the obligation and responsibility to abide by the applicable export control laws, regulations, and general prohibitions relating to the export of technical data. Failure to obtain an export control license or other authority from the Government may result in criminal liability under U.S. laws.

(End of Notice)

1.2 Software Identifier

Code Name: BETCO Version: 1.00

1.3 Points of Contact

Code Sponsor: Rick Beauheim SNL Org. 6822 [email protected] Code Author: Nathaniel Toll SNL Org. 6822 [email protected]

1.4 Software Description

BETCO removes fluctuations due to barometric pressure and Earth tides in aquifer water-level measurements. BETCO adjusts water level measurements according to barometric and Earth tide measurements collected at equal intervals and time and applying a multiple regression technique. The input for the utility is either an ASCII comma-separated-value (CSV) table or Excel spreadsheet of observed water levels and barometric pressures in consistent units (either head or pressure) and the measurement time. The output is a matrix of adjusted water-level measurements versus time in either Excel of CSV format.


A-7

2.0 CONTROL LOGIC/CONTROL FLOW

In this section, the control logic and flow of BETCO are presented. Section 5.1 gives an example of the typical execution of BETCO and Section 5.2 presents a flowchart that describes the BETCO control logic and control flow.

2.1 Execution of BETCO

To execute BETCO, open the executable BETCO.exe by using the Windows Start- Programs menu or double clicking on its icon in the program files directory BETCO.

2.2 BETCO Flowcharts

Figure 5-1 is a flowchart outlining the control logic and flow of BETCO. The numbers in bold in the parentheses refer to the Functional Requirements listed in Section 2.1. For example, (R.6, R.8) means that this block implements the functional requirements of R.6 and R.8.


A-8

Main

Read Excel or CSV input data file.

User selects delay memory of well/aquifer system

default is set at 12 time intervals. User can also set

difference interval for the times between observations.

Software runs guassianelimination to calculate the

unit response vector. A correction is calculated for

each pressure head observation based on the updated unit response. Correction applied to pressure head data in

memory.

Diagnostic graph of the cumulative

response is displayed on

screen. Corrected Data is displayed

Is the Cumulative response graph the best for the aquifer system?

User changes the memory (m) value

no

yes

User can view large scale graph of corrected data against raw data, print

same data, or output data to Excel or CSV.

Exit or analyze new data file

(R.1, R.8)

(R.2, R.3, R.5))

(R.2, R.4)

(R.7, R.8, R.9)

Figure 5-1. Flowchart of the Main Program.

Notes: The BETCO software uses an event driven program flow. While the process for adjusting data proceeds in a linear fashion as illustrated in Figure 5-1, the actual flow of the code may be halted, restarted, or ended by the user via program user events at any time.


A-9

3.0 DATA STRUCTURES

3.1 Input

Manual User Input

Two parameters are entered by the user: the memory value of the well aquifer system, and the time differencing interval of the data. These parameters are changed via scroll bars and may be updated iteratively until the user is satisfied with the step response function.

Input ASCII CSV File

The input ASCII CSV file is a constrained structure consisting of three to four comma separated columns. The columns are ordered: decimal time, well water PSI, barometric pressure, and (optionally) earth tides. The well pressure head and barometric pressure must be in identical units.

Input Excel Spreadsheet

The input Excel spreadsheet format is not constrained at run time. The only requirements are that three columns exist, one for decimal time, one for well pressure head, a column for barometric pressure, and an optional column for earth tide data. Units must be identical for the well pressure head and the barometric pressure. At run-time, the user selects the appropriate columns from the Excel spreadsheet. The Excel spreadsheet import dialog allows selected columns from multicolumn worksheets to be used. Multi-sheet workbooks are compatible with the import dialog.

Improper Input

Improper input data format on the part of the user will result in an error and require the user to clear the application memory and begin again.

3.2 Output

Output Adjusted Pressure Heads File

An output ASCII CSV or Excel spreadsheet may be created after the data are corrected. The output file format and included columns are left to the user’s discretion at run-time. The user has the option to output the decimal time, raw well pressure head, barometric pressure, optional earth tide data, and corrected well water pressure.

3.3 ALLOWABLE/PRESCRIBED RANGES FOR INPUT/OUTPUT

Ranges or limits for input and output values are not restrictive. Pressure head and barometric pressure values must be in consistent units. Every pressure head measurement must be paired


A-10

with a barometric pressure measurement collected at the same time. The BETCO software is capable of processing a maximum of 65,536 observations when using Excel data files and is constrained only by computer memory when using ASCII CSV files.

4.0 BETCO REQUIRED TRAINING

Users of BETCO should be proficient in the use of Microsoft Windows and the Microsoft Office Suite.

To interpret the input and output of BETCO users should have a basic knowledge of groundwater hydrology.

5.0 OPERATION

To execute BETCO, open the executable BETCO.exe by using the Windows – Start - Programs menu or double clicking on its icon in the program files directory BETCO. The application will load to a blank Application Form as shown in Figure 5-1.

Figure 5-1. Starting Environment for BETCO (Application Form).


A-11

5.1 Excel File Input

The first step in the BETCO program flow is to input data. This is accomplished by clicking on the file menu, then selecting the Open Data File option. This will bring up a dialog to select a file for input as shown in Figure 5-2. As described in Section 6.0, the options for input file formats are either Excel (.xls) or Comma Separated Values (.csv). The open file dialog can filter on either of these two file types (no other file types are visible to the open dialog). Select a file and click the open button or double click the desired file. For the tutorial, browse to the installation directory and select the WIPP30-sample.xls file (Figure 5-2).

Figure 5-2. The Open File Dialog.

Input Column Selection

When the input file selected has an .xls extension, an Excel spreadsheet browser will open and prompt the user to select the columns to load. If the time, pressure head, and barometric pressure are in sequential columns, as shown in Figure 5-3, then the user need only select the header of the time column. If they are in non-continuous non-sequential columns they must be selected individually by clicking the radio button of the column to select and then clicking on the header of the desired column. Once the time, pressure head, and barometric pressure columns have been selected, click the Load Data button.

5.2 CSV File Input

As stated in Section 7.1, the open file dialog can filter on either .csv or .xls files. No other file types are visible to the open dialog. When loading a .csv file, the BETCO application requires a file with a specific structure. The file must contain no headers and must have three columns: time, pressure head, and barometric pressure. No column selection is possible as with the Excel spreadsheet format. Once the file is selected in the open dialog, the data are loaded.


A-12

Figure 5-3. Excel File Browser Dialog.

5.3 Memory Value and Time Difference Interval Selection

The BETCO software has only two parameters that may be adjusted by the user: the maximum response time or memory and the time difference interval. These are adjusted using scroll bars in the middle left of the application window (Figure 5-5). As the value of the maximum response time or time difference interval are adjusted, the step (or cumulative) response time graph and adjusted data graph are updated. For the WIPP30 data provided in the installation directory, a local maximum step response is first observed at 7 hours when removing barometric effects alone and at 12 hours when removing barometric and earth tide effects, for more details on response refer to the work of Rasmussen and Crawford (1997) or Spane (2002). In the case of a confined aquifer, the ideal is to set the maximum response time to first local maximum even though higher maxima may be observed at longer time lags (Figure 5-4). For an unconfined aquifer data set, the maximum response time should be set when the first minimum is observed. An explanation of the various cumulative response behaviors for different well/aquifer combinations is provided by Rasmussen and Crawford (1997) and Spane (2002). The time difference interval is used when the time between actual pressure observations is short because the ideal time interval is between 30 and 120 minutes. For example, if the data were


A-13

Figure 5-4. Response Functions.

collected at 15 minute intervals, it would be preferable to set the difference interval in the data to between 2 or 8. At these settings, the software will be differencing the data every 30 to 120 minutes. If the data were collected between 30- and 120-minutes intervals, then the time difference interval can remain set at the default of one.


A-14

Figure 5-5. Application Appearance with Data.

Once the optimum maximum response time and time difference interval are selected, the user may save the data to a file, view the data in a large format graph, and print a graph.

5.4 Adjusted Data Full Graph and Printing

To open a full version of the adjusted data graph, click on the Open Full Graph button in the lower right hand corner of the application window (Figure 5-5). As with any of the graph panels in the BETCO software, the graph can be zoomed by holding the left mouse button and dragging a box over the area of interest from left to right. To zoom out simply hold down the left mouse button and move the cursor to the left. To pan, click and hold on the graph with the right mouse button and move the graph in the graph window. To print, click the printer icon in the upper right hand corner and a print dialog will appear. When finished, close the graph window to return to the main application window.


A-15

5.5 Saving Adjusted Pressure Head Data Output

The save dialog is used to save adjusted pressure head data and can be accessed by selecting the Save Corrected Data option from the file menu or by clicking on the Save Data button in the lower right hand of the main application window (Figure 5-5). Either one will call a save dialog as shown in Figure 5-6.

Figure 5-6. Save Dialog.

As with input files, two file formats are available for output of the adjusted data. The data can be appended to an existing Excel spreadsheet, or saved to a new .csv file. The data may also be previewed by clicking on the preview button. To save the data to an existing Excel spreadsheet, click on the Open Existing Excel File button and select the appropriate Excel file. Because these data will append existing data, the Excel spreadsheet containing the original raw pressure data is typically used. After selecting the file, the window will expand to an Excel spreadsheet browser as shown in Figure 7-6. In this window, you must select the top of the column where the data will be appended and click the radio buttons for the data you wish to append. Once this is done, click the Append button. The final step is to save the data to the Excel spreadsheet by clicking the Save Output button. No data are actually saved to the Excel spreadsheet until the Save Output button is clicked.

To save to ASCII CSV, simply click the Save to CSV button as shown in Figure 5-6. A save file dialog will appear where you can select the target directory and fill in the filename.


A-16

Figure 5-7. Append Data to Excel Window.

5.6 Finishing Dataset

Upon saving the adjusted data, the application can be closed or reset to allow processing of additional data. To clear the application memory, select Clear App Memory from the File menu. Clearing the application memory is required to process new data. To exit the application, simply select Exit from the file menu or click on the close window button in the upper right hand corner of the main application window.


A-17

6.0 REFERENCES

Garcia, A. L., 2000, Numerical Methods for Physics (Prentice Hall, Englewood Cliffs NJ).

Rasmussen, T. C. and L. A. Crawford, 1997, Identifying and removing barometric pressure effects in confined and unconfined Aquifers, Ground Water, 35(3):502–511.

Spane, F. A., 2002, Considering barometric pressure in groundwater flow investigations, Water Resources Research, 35(6):1–17.

van Camp, M., and P. Vauterin, 2005, Tsoft: Graphical and interactive software for the analysis of time series and earth tides, Computers & Geosciences, 31(5) 631–640.

user manual for betco version 1 - uga hydrology

Documents