Running the numerical models VS2DT and VS2DH ouside of the graphical user interface. Contents -------- A. Introduction B. Input data requirement for VS2DT C. Input data requirement for VS2DH D. Making the executables easily assessable E. Running VS2DT F. Running VS2DH A. Introduction --------------- It is anticipated that most users will not need to run the numerical models VS2DT or VS2DH outside of the graphical user interface. If you need to make manual changes in the model input files (VS2DT.DAT and VS2DH.DAT), you can export these files from the preprocessor, make the changes in a text editor, and then run the simulation in the postprocessor in standalone mode. Alternatively, you can run VS2DT or VS2DH in batch mode outside of the GUI; this approach will greatly reduce execution times. The VS2DI software package includes executables for running VS2DT and VS2DH without the user interface. These executables are compiled directly from the Fortran source codes (vs2dt3_3.f and vs2dh3_3.f). Information on how to run these programs is given below. B. Input data requirement for VS2DT ----------------------------------- The numerical model VS2DT requires the following two input files: vs2dt.fil - This is known as the "namelist file" and contains the names of input file and output files to be opened by the program. This file must be named vs2dt.fil. The first line of this file must contain the name of the model data file, which is described next. vs2dt.dat - This is known as the "model data file" and contains input data to VS2DT. The default file name is vs2dt.dat. However, this file can have a different name as long as it matches the name on the first line of the namelist file. These two files can be easily generated by the VS2DTI preprocessor by using the "Export data" command from the "File" menu. Alternatively, the model data file vs2dt.dat can be created manually by following the instructions in the file vs2dtInputInstructions.pdf. The above two files should be kept together in one directory. When the program is executed, output files containing simulation results will be generated in the same directory. C. Input data requirement for VS2DH ----------------------------------- The numerical model VS2DH requires the following two input files: vs2dh.fil - This is known as the "namelist file" and contains the names of input file and output files to be opened by the program. This file must be named vs2dh.fil. The first line of this file must contain the name of the model data file, which is described next. vs2dh.dat - This is known as the "model data file" and contains input data to VS2DH. The default file name is vs2dh.dat. However, this file can have a different name as long as it matches the name on the first line of the namelist file. These two files can be easily generated by the VS2DHI preprocessor by using the "Export data" command from the "File" menu. Alternatively, the model data file vs2dh.dat can be create manually by following the instructions in the file vs2dhInputInstructions.pdf. The above two files should be kept together in one directory. When the program is executed, output files containing simulation results will be generated in the same directory. D. Making the executables easily assessable ------------------------------------------- The executables for running VS2DT and VS2DH are vs2dt3_3.exe and vs2dh3_3.exe. Both are located in the "bin" directory under the software installation directory. To make the these executables accessible from any directory, without needing to type the full pathname, the bin directory must be included in the PATH environment variable. On Windows 7, XP, and 2000 systems, click the "Start" button, select "Settings", and then "Control Panel". Double-click "System" and select the "Advanced" tab, and click the "Environmental Variables" button. If a "PATH" environmental variable already exists, then click on it so that it is selected. Next, click the "Edit" button. In the "Variable Value" box, append the following to the end ;\bin where is the directory in which the software is installed. (Don't forget the leading semicolon.) For example, if the software is installed in the default location, you would append ;C:\Program Files\USGS\vs2di_1.3\bin Click "OK". If a "PATH" environmental variable does not exist, then click the "New" button. Enter "PATH" in the "Variable name" box. In the "Variable value" box, enter \bin where is the directory in which the software is installed. For example, if the software is installed in the default location, you would enter C:\Program Files\USGS\vs2di_1.3\bin Click "OK". On Windows 98 systems, add the following line to the end of AUTOEXEC.BAT: PATH=%PATH%;\bin where is the directory in which the software is installed. For example, if the software is installed to the default location, the above line would be PATH=%PATH%;C:\Program Files\USGS\vs2di_1.3\bin Reboot your system after modifying AUTOEXEC.BAT. E. Running VS2DT ---------------- To run the VS2DT: 1. Open a DOS command prompt window. 2. Change to the directory containing the input files (see Section B). 3. If you have added the "bin" directory to your PATH environmental variable (see Section D), type the command "vs2dt3_3" (without quotes). If you chose not to add the "bin" directory to your PATH environmental variable, you will have to type the complete pathname. For example, if you installed the software to the default location, you would type the command "C:\Program Files\USGS\vs2di_1.3\bin\vs2dt3_3" (including quotes). F. Running VS2DH ---------------- To run the VS2DH: 1. Open a DOS command prompt window. 2. Change to the directory containing the input files (see Section C). 3. If you have added the "bin" directory to your PATH environmental variable (see Section D), type the command "vs2dh3_3" (without quotes). If you chose not to add the "bin" directory to your PATH environmental variable, you will have to type the complete pathname. For example, if you installed the software to the default location, you would type the command "C:\Program Files\USGS\vs2di_1.3\bin\vs2dh3_3" (including quotes).