================================== INSTALLATION AND SETUP OF PHRQCGRF ================================== This file contains the following information: 1) Installation of PHRQCGRF 1.1) Installation for the Windows 9x version 1.2) Installation for the Windows 3.1/DOS version 2) Setup of PHRQCGRF, both versions 3) Notes --------------------------------------------------------------------------- 1) INSTALLATION OF PHRQCGRF 1.1) Installation for the WINDOWS 9x VERSION: Copy the self-extracting compressed file "PCGRF2_2.exe" to the desired location, or create a new directory for it (such as "C:\PHRQCGRF"). Initiate the extraction by typing "pcgrf2_2 -d" at the command prompt of the directory. The "-d" execution option will preserve the directory structure while decompressing. One file and 3 directories will be decompressed: "PHRQCGRF.exe" "SAMPLES" (directory) "MANUAL" (directory) "SOURCE" (directory). The "SAMPLES" directory contains 4 sample files: "SAMPLEv1.smp" "SAMPLEv2.smp" "FIELDdst.fld" "FIELDtim.fld". These files may be used to test the PHRQCGRF program after setup. "SAMPLEv1.smp" and "SAMPLEv2.smp" demonstrate the file formats of PHREEQC versions 1 and 2, respectively. "FIELDdst.fld" and "FIELDtim.fld" demonstrate the field file formats for the distance and time comparison features of PHRQCGRF, respectively. IMPORTANT: The 2 sample field files, "FIELDdst.fld" and "FIELDtim.fld" are for use with the "Field Data / Simulation Data Comparison" main menu option only. They cannot be used for other program functions. The "MANUAL" directory contains 2 files: "MANPCGRF.ps" "MANPCGRF.pdf". These files contain the complete documentation for PHRQCGRF in PostScript and PDF formats, respectively. The "SOURCE" directory contains the 12 FORTRAN source code files for PHRQCGRF: "00MAIN.for" "01DIST.for" "02TIME.for" "03SPVSSP.for" "04ANIME.for" "05COMP.for" "06XTRACT.for" "07TOOL_A.for" "08TOOL_B.for" "09GRAPH.for" "10HELP.for" "11FORMAT.for". After extraction, the original self-extracting compressed "PCGRF2_2.exe" file will still be present in the directory, and may be deleted. "PCGRF2_2.exe" is not needed to operate the PHRQCGRF program. The file "PHRQCGRF.exe" is the main executable program. It may be run from the desktop or from a DOS prompt by typing "PHRQCGRF" at the command prompt of the PHRQCGRF directory. None of the other files are necessary for running PHRQCGRF. --------------------------------------------------------------------------- 1.2) Installation for the WINDOWS/DOS VERSION: Copy the self-extracting compressed file "PCGRFDOS.exe" to the desired location, or create a new directory for it (such as "C:\PHRQCGRF"). Initiate the extraction by typing "pcgrfdos -d" at the command prompt of the directory. The "-d" execution option will preserve the directory structure while decompressing. 6 files and 3 directories will be decompressed: "PHRQCGRF.exe" "DOSXMSF.exe" "DOSXNT.exe" "DOSXNT.386" "HELVB.fon" "ROMAN.fon" "SAMPLES" (directory) "MANUAL" (directory) "SOURCE" (directory). The "SAMPLES" directory contains 4 sample files: "SAMPLEv1.smp" "SAMPLEv2.smp" "FIELDdst.fld" "FIELDtim.fld". These files may be used to test the PHRQCGRF program after setup. "SAMPLEv1.smp" and "SAMPLEv2.smp" demonstrate the file formats of PHREEQC versions 1 and 2, respectively. "FIELDdst.fld" and "FIELDtim.fld" demonstrate the field file formats for the distance and time comparison features of PHRQCGRF, respectively. IMPORTANT: The 2 sample field files, "FIELDdst.fld" and "FIELDtim.fld" are for use with the "Field Data / Simulation Data Comparison" main menu option only. They cannot be used for other program functions. The "MANUAL" directory contains 2 files: "MANPCGRF.ps" "MANPCGRF.pdf". These files contain the complete documentation for PHRQCGRF in PostScript and PDF formats, respectively. The "SOURCE" directory contains the 10 FORTRAN source code files for PHRQCGRF: "PHRQCGRF.for" "DIST2.for" "TIME.for" "SPVSP.for" "MOVIE3.for" "COMPARE.for" "XTRACDAT.for" "UTILITY2.for" "PNTGRAF8.for" "HELP.for". After extraction, the original self-extracting compressed "PCGRFDOS.exe" file will still be present in the directory, and may be deleted. "PCGRFDOS.exe" is not needed to operate the PHRQCGRF program. To run PHRQCGRF from DOS, the "DOSXMSF.exe" file must be located either in the same directory as the executable file, "PHRQCGRF.exe", or be in the DOS path. To run the program under Windows 3.1 (or from a DOS window under Windows 3.1), the "system.ini" file, usually found in the WINDOWS directory, must be modified to include the following line: device=c:\phrqcgrf\dosxnt.386 in the "[386ENH]" section of the file. In implementing this, it is assumed that the path "c:\phrqcgrf\" is where the program file "PHRQCGRF.exe" resides, and that it also contains the "DOSXNT.386" file. If not, change the above line accordingly. If the user does not want to run PHRQCGRF under Windows, these modifications do not need to be made, and program operation will be restricted to the DOS environment. If problems arise with the above procedure, it is recommended that the program be executed from DOS only. The "PHRQCGRF.exe", "DOSXMSF.exe", "DOSXNT.exe", "HELVB.fon", and "ROMAN.fon" files are required for proper program execution. --------------------------------------------------------------------------- 2) SETUP OF PHRQCGRF, BOTH VERSIONS For the first execution, PHRQCGRF will be initialized using preset defaults. Other than changing the customization settings as desired, no other setup process is required. Refer to the user's manual for PHRQCGRF (contained in the self-extraction file) for information regarding customization settings. After execution, PHRQCGRF has been successfully installed and setup. The main menu option "Help and Information" allows quick access to most of the user's guide. You may browse this feature to get an overview of PHRQCGRF and its features. -------------------------------------------------------------------------- 3) NOTES After the first execution of PHRQCGRF, a file named "SETTINGS" is created in the directory of the program. It saves the customization settings of the most recent PHRQCGRF session. This file is automatically maintained. If "SETTINGS" is deleted, a new file will be created initialized at preset defaults. If the program option "view directory" is used, a small external file named "DIRECT.bat" is created in the directory of the program. This file is also automatically created and its deletion is of no consequence to proper PHRQCGRF operation. Because the sample files are located in the "samples" directory separate from the PHRQCGRF program, the path "samples\" must be included in the input file name entered when using them with PHRQCGRF. Alternatively, they can be moved to the PHRQCGRF directory. Refer to the "entering files and the path system" help topic under the main menu "help and information" option for more information on how to specify files. ==========================================================================