ModelMuse – Version 2.12.0.0 NOTE: Any use of trade, product or firm names is for descriptive purposes only and does not imply endorsement by the U.S. Government. This version of ModelMuse is packaged for personal computers using the Microsoft Windows XP or Vista operating systems. Executable files for personal computers are provided as well as the source code. Instructions for installation, execution, and testing are provided below. TABLE OF CONTENTS A. DISTRIBUTION FILE B. INSTALLING C. EXECUTING THE SOFTWARE D. EXAMPLES E. COMPILING A. DISTRIBUTION FILES ModelMuse is distributed as either an installer or a zip file. Either version may be used for installing ModelMuse. Both contain the same version of ModelMuse for use on personal computers: ModelMuseSetup2_12.exe ModelMuse2_12.zip Both distribution files contain: Compiled runfiles for ModelMuse, ModelMonitor, and MF2005_Importer.exe. ModelMuse documentation in PDF files. Example models Supplementary materials The file ModelMuseSource2_12.zip contains the source code for ModelMuse, ModelMonitor, and MF2005_Importer.exe. B. INSTALLING The distribution file is an installer. Execution of the distribution file will install ModelMuse in a directory chosen by the user. By default, ModelMuse will be installed in C:\Program Files\USGS\ModelMuse2_12. If the new version of ModelMuse is installed over an older version, the program may be installed in the same directory as the older version of the program. The installer will associate files with the extensions .gpt, .gpb, and .mmZlib with ModelMuse. The following directory structure will be created in the installation directory: |--ModelMuse2_12 | |--bin ; ModelMuse, ModelMonitor, and MF2005_Importer | | executables. | |--doc ; Documentation file | |--data ; Data files and example models described in the | | documentation or the ModelMuse help. | |--examples ; Sample models. Included in directory ModelMuse2_12\doc is the report on ModelMuse as a Portable Document Format (PDF) file. The PDF file is readable and printable on various computer platforms using Acrobat Reader from Adobe. The Acrobat Reader is freely available from the following World Wide Web site: http://www.adobe.com/ The zip file contains the same files in the same directory structure. To install it, unzip the file retaining the directory structure of the zip file. Unlike the installer, unzipping the files from a zip file will not associate ModelMuse project files with extensions .gpt, .gpb, or .mmZLib with ModelMuse. This can be done manually. The manual method used to associate ModelMuse project files with ModelMuse varies among the various Windows operating systems. Consult your operating system help for more details. Searching the operating system help for "To associate a file name extension with a file type" may give the required information. C. EXECUTING THE SOFTWARE There are several ways to execute the software. 1. Double click on it in Windows Exporer. 2. Double-click on the desktop short cut for ModelMuse that is optionally created by the installer. 3. Double click on a file with one of the extensions associated with ModelMuse (.gpt, gpb, mmZlib). D. EXAMPLES Several example models are included in the examples folder Many of the ones for PHAST reproduce sample models distributed with PHAST or described in the ModelMuse help. The ones for MODFLOW are described in the ModelMuse help. Data files used in the examples described in the ModelMuse documentation or help are in the data folder. E. COMPILING ModelMuse and ModelMonitor are compiled with Delphi XE from Embarcadero. http://www.embarcadero.com/ The help system for ModelMuse is compiled with Help and Manual version 5 from EC Software. http://www.helpandmanual.com/ MF2005_Importer is compiled with the Intel Fortran compiler. ModelMuse uses a number of custom comoponents which must be installed in Delphi XE before compiling ModelMuse. Some are included with the ModelMuse source code. Addition required files or components are listed below. In some cases, the files must be altered before they can be used with ModelMuse. The required changes are listed below. General instructions for installing packages in Delphi XE 1. If the component comes with an installer run the installer. 2. If you are compiling the components from source code, you need to add the directories containing the source code to the Library path. (Tools|Options) then look in "Environment Options|Delphi Options|Library" 3. If you are compiling the components from source code and the components are separated into run-time and design-time packages, you build the runtime package and then build and install the design-time package. Install JCL and JVCL They can be obtained from http://www.delphi-jedi.org/ Installing Graphics32 http://graphics32.org/wiki/ Download the latest version of Graphics32. It should be graphics32-1-9-0 or later. If there is not a package for Delphi XE use the package for Delphi 10 after changing the name and adding the following lines near the beginning G$32.inc. {$IFDEF VER220} {$DEFINE INLININGSUPPORTED} {$DEFINE COMPILER2010} {$DEFINE COMPILER2009} {$DEFINE COMPILER2007} {$DEFINE COMPILER2006} {$DEFINE COMPILER2005} {$DEFINE COMPILER7} {$DEFINE COMPILER6} {$IFNDEF BCB} {$DEFINE DELPHI2010} {$ELSE} {$DEFINE BCB7} {$ENDIF} {$ENDIF} Comment out MouseUp(mbLeft, [], 0, 0); in TCustomImage32.DblClick. If you are using the package for version 10, you may need to do the following. 1. If required, in GR32_Transforms.pas, Gr32_Polygons.pas prepend "GR32_Math." to any ambiguous overload calls. 2. Then open the design-time package and update or remove the reference to the runtime package. Build the runtime package first. Then install the design time package. Installing GLScene Download GLScene_v1.1_March_2011_SVN_revision_5593.7z or later Open and read the readme.html file in the source directory of GLScene. Graphics 32 support must be added by modifing GLScene.inc so make the required change. Build GlScene1.1\DelphiXE\GLScene_RunTime.dproj and then install GlScene1.1\DelphiXE\GLScene_DesignTime.dproj. Get and install VirtualTreeView version 4.8.7 or later. http://www.soft-gems.net/ MadExcept version 3 must be installed. It can be obtained from http://www.madshi.net/madExceptDescription.htm. TurboPower Abbrevia http://sourceforge.net/projects/tpabbrevia/ Deactivate UnzipZipxSupport in AbDefine.inc EZDSL http://www.boyet.com/FixedArticles/EZDSL.html http://blog.boyet.com/blog/ezdsl/ezdsl-for-delphi-xe/ In EZDSLHSH.PAS, place the line {$OVERFLOWCHECKS OFF} before the HashBKDR function. The Components directory has additional components that need to be installed. They are in the following subdirectories of the Components directory. addbtn95 ade ButtonEdit datagrid GLWidget ModelCube QMostRecentlyUsedFiles Quadtree QZoomBox2 RbwController RbwDataGrid RbwDynamicCursor RbwEdit RbwParser RbwRadioGroup RbwRuler xbase The GraphicEX directory does not have a package but it needs to be added to the search path.