ModelMuse – Version 3.10.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 software has been approved for release by the U.S. Geological Survey (USGS). Although the software has been subjected to rigorous review, the USGS reserves the right to update the software as needed pursuant to further analysis and review. No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. Furthermore, the software is released on condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from its authorized or unauthorized use. This version of ModelMuse is packaged for personal computers using the Microsoft Windows 7, 8, 8.1, or 10 operating systems. Executable files for personal computers are provided as well as the source code. Although not a supported operating system, some users have reported success on using ModelMuse on MacIntosh computers under WINE. Instructions for installation, execution, and compiling 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: For 32 or 64-bit operating systems: ModelMuseSetup32_3_10.exe ModelMuse32_3_10.zip For 64-bit operating systems: ModelMuseSetup64_3_10.exe ModelMuse64_3_10.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 ModelMuseSource3_10.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. If no previous version of ModelMuse is installed, the default installation directory will be C:\Program Files\USGS\ModelMuse3_10 or C:\Program Files (x86)\USGS\ModelMuse3_10. If a previous version of ModelMuse is installed, the default installation directory will be the directory for the previous version of ModelMuse. 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: |--ModelMuse3_10 | |--bin ; ModelMuse, ModelMonitor, and MF2005_Importer | | executables. | |--doc ; Documentation files ModelMuse will also create a subdirectory of the "Public Documents" directory named "ModelMuse Examples" containing sample models and data. | |--data ; Data files and example models described in the | | documentation or the ModelMuse help. | |--examples ; Sample models. Included in directory ModelMuse3_10\doc are the reports on ModelMuse as Portable Document Format (PDF) files. The PDF files are 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 "ModelMuse Examples\examples" folder under Public Documents. Many of the ones for PHAST reproduce sample models distributed with PHAST or described in the ModelMuse help. Most of 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 "ModelMuse Examples\data" folder. E. COMPILING The 32 and 64-bit version of ModelMuse and ModelMonitor are compiled with Delphi 10.2 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 components which must be installed in Delphi 10.2 before compiling ModelMuse. Some are included with the ModelMuse source code. Additional 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 XE2 and 10.2 1. If the component can be installed with the "Tools|GetIt Package Manager" in Delphi 10.2, do so. 2. If the component comes with an installer, run the installer. 3. If you are compiling the components from source code, you need to add the directories containing the source code to the Library path for both the Windows 32 and Windows 64 bit platforms. Select "Tools|Options" then look in "Environment Options|Delphi Options|Library". 4. 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/ Add the following JCL directories to the Library path if they are not added automatically when installing the JCL. source\common source\windows JVCL Version 3.50 was used in compiling ModelMuse. Installing Graphics32 http://graphics32.org/wiki/ Download the latest version of Graphics32. It should be version graphics32-1-9-1 or more recent. Comment out MouseUp(mbLeft, [], 0, 0); in TCustomImage32.DblClick in GR32_Image.pas. Build the runtime package first. Then install the design time package. To compile the design-time package, you may need to edit the search path for the design time Project (Project|Options|Delphi compiler|Search path) so that it includes the dcp and/or bpl output directories. For example: C:\Users\Public\Documents\RAD Studio\9.0\Dcp;C:\Users\Public\Documents\RAD Studio\9.0\Bpl Installing GLScene http://glscene.sourceforge.net For compiling with Delphi 10.2, use GLScene_v1.5. 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. This is done by changing {.$DEFINE GLS_Graphics32_SUPPORT} to {$DEFINE GLS_Graphics32_SUPPORT} Required changes to the GLScene source code to compile it with Delphi 10.2 include the following: In FXCollectionEditor.pas, remove System.Actions from the uses list. In GLSceneEdit.pas, remove System.Actions from the uses list. In GLSMemo.pas, change line 417 from FScrollBars: System.UITypes.TScrollStyle; to FScrollBars: Vcl.StdCtrls.TScrollStyle; In GLSMemo.pas, change line 448 from procedure SetScrollBars(Value: System.UITypes.TScrollStyle); to procedure SetScrollBars(Value: Vcl.StdCtrls.TScrollStyle); In GLSMemo.pas, change line 3598 from procedure TGLSCustomMemo.SetScrollBars(Value: TScrollStyle); to procedure TGLSCustomMemo.SetScrollBars(Value: Vcl.StdCtrls.TScrollStyle); Add the source directory for GLScene for both 32 and 64-bit compilation. Build GLScene_RunTime.dpk and then install GLScene_DesignTime.dpk. As with Graphics32 the projects search path may need to include the dcp and/or bpl output directories. Typical paths for those would be the following. C:\Users\Public\Documents\Embarcadero\Studio\19.0\Bpl C:\Users\Public\Documents\Embarcadero\Studio\19.0\Dcp In the design time package, be sure that the correct package is listed under "Requires". Get and install VirtualTreeView version 6.6 or later. http://www.jam-software.com/virtual-treeview/ https://github.com/Virtual-TreeView/Virtual-TreeView-XE2 MadExcept version 4 or later must be installed. It can be obtained from http://www.madshi.net/ TurboPower Abbrevia http://sourceforge.net/projects/tpabbrevia/ Deactivate UnzipZipxSupport in AbDefine.inc TurboPower Abbervia is also available through the GetIt Package Manager in Delphi 10.2 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 MMJLabel ModelCube QMostRecentlyUsedFiles Quadtree QZoomBox2 RbwController RbwDataGrid RbwDynamicCursor RbwEdit RbwParser RbwRollupPanel RbwRuler xbase The GraphicEX and xygraph directories do not have packages but they need to be added to the search path.