>>>>>>>>>>>>>>> ERQMS version 1.0 integrated software <<<<<<<<<<<<<<<

ERQMS version 1.0 is software designed to enable QUAL2Kw to use the stream-aquifer seepage values computed by the SFR package of
MODFLOW2005. This allows using QUAL2KW to predict surface water quality that will result from steady one-period stream-aquifer system flow
simulations using MODFLOW2005 and SFR. Assuming availability of QUAL2KW (version 6) and MODFLOW2005 (version 1.12.00) models of the 
same physical system, ERQMS will: transfer input and output values between the two models, run both models iteratively, cause them to predict
the same stream flows at selected control locations, and provide a comparative analysis of flows and depths in the 'Analysis.qmsout' file. The two
models predict slightly different stream flow depths because they employ different simulation algorithms. ERQMS is available from the HydroShare
website as a stand-alone executable that runs under Windows 10 operating system.

Steps to install ERQMS:
1. Download ERQMS_V1.0.zip to a desired folder on your computer, unzip it. The folder will be organized as: a) 'doc' subfolder containing
   ERQMS user guide and Mockup of the '*.in' file; b) 'ERQMS_InputFileForEX11a-EX11b' subfolder; c) 'ExeFiles' subfolder that contains
   QUAL2KW and MODFLOW2005 executable files; d) 'lib' subfolder that contains python files relating to ERQMS executable file; e)
   'MODFLOW' subfolder that contains MODFLOW input files for examples (EX11a and EX11b); f) 'QUAL2KW' subfolder that contains
   QUAL2KW input files for the examples; g) ERQMS executable file; h) and several dll files relating to ERQMS executable file.
2. Make 'ERQMS_IO_Files' subfolder in ERQMS main directory. The subfolder contains the '*.in' file of ERQMS, and after running ERQMS, it will contain output files of
   ERQMS. May be, it contains input and output files of QUAL2KW and MODFLOW based upon user-specified address in the '*.in' file.
Note: the QUAL2KW and MODFLOW executable files that are provided in the 'ExeFiles' subfolder are:
	 A. QUAL2KW version 6 and build 07/23/2015 (On December 22, 2020  available at url: https://ecology.wa.gov/Research-Data/Data-resources/Models-spreadsheets/Modeling-the-environment/Models-tools-for-TMDLs)
	 B. MODFLOW 2005 version 1.12.00 and build 02/03/2017 (On December 22, 2020 available at url: https://www.usgs.gov/software/modflow-2005-usgs-three-dimensional-finite-difference-ground-water-model)

Steps to run ERQMS for the provided example, EX11a (running EX11b is analogous):
1.    In the first two lines of the provided 'EX11a.in' file, change the addresses of QUAL2KW and MODFLOW input/output files from:
      C:\Users\Admin\Desktop\ERQMS_V20\ERQMS_IO_Files\Examples\EX11a\QUAL2KW_Files and
      C:\Users\Admin\Desktop\ERQMS_V20\ERQMS_IO_Files\Examples\EX11a\MODFLOW_Files
      to user-specified addresses in the employed computer drive.
2.    Copy/move the QUAL2KW and MODFLOW executable files (qual2kw6.exe and mf2005.exe files respectively) from the 'ExeFiles' subfolder to the addresses specified in Step 1.
3.    Ensure the names of the two executable files in lines 3 and 4 of the '*.in' file to be the same as shown above.
4.    Make a batch file to run ERQMS. To do this:
        a.  Open Notepad software (or other text editor).
        b.  Write the name of ERQMS executable file with its extension, one white space and then the name of the '*.in' file with its extension in the first line.
        c.  Write 'pause' in the second line that keeps opening Windows command prompt. That helps user know about the process completion.
        d.  In the same folder as the ERQMS executable file, save this file using an arbitrary name and the 'bat' file extension.
5.    Double-click on the provided EX11a batch file (EX11a.bat) to run ERQMS for example EX11a (Use EX11b.bat to run EX11b).
6.    Notes: a) The 'ERQMS/ERQMS_InputFileForEX11a-EX11b' subfolder contains the '*.in' file for examples EX11a and EX11b, b) For each 
             example folder, the QUAL2KW and MODFLOW 'EX11a' and 'EX11b' subfolders respectively have other input files for both examples, c)
             there are 'SFR-OriginalInputFile' and 'QUAL2KW-OriginalInputFile' subfolders in MODFLOW and QUAL2KW subfolders to present the
             original SFR and QUAL2KW input files with all comments and data for both examples respectively, d) the examples transfer all values of
             physical parameters from QUAL2KW to MODFLOW-SFR and then seepages from MODFLOW-SFR to QUAL2KW. As specified in their '*.in'
             files, ERQMS considers all segments/reaches to check stream depths and flows for these examples.
Steps to view and understand ERQMS results:
       ERQMS prepares the 'Analysis.qmsout' file and places it within the 'ERQMS_IO_Files' subfolder. This file contrasts the stream flow and
       depth results from QUAL2KW and MODFLOW, and shows ones and the convergence of predictions from both models with respect to
       criteria specified by user in the '*.in' file. If acceptable convergence does not occur, ERQMS will cease after executing the maximum
       number of cycles specified in Table 6 of the '*.in' file.

Code Developer: Benjamin Thayer, B.Sc.;
Flowchart and Process Developer, and Tester: Saeid Masoudiashtiani, Ph.D.;
Concept and Process Developer, and Supervisor: Richard C. Peralta, Emeritus Professor, Ph.D.
Civil and Environmental Engineering Department
Utah State University, USA
July, 2022