Installation tutorial

As it follows you will see how to install ModelMuse and all the packages (MODFLOW, MT3DMS, MODPATH, exc…) needed to perform numerical modeling. In this instructions we will also provide you instructions to install all the PEST suite inside ModelMuse.

Note 1: Numerical models that are based on MODFLOW, and associated programs, are not compatible with MacOS, it is necessary to use PCs. Windows virtual partitions can only be used if you are very experienced in IT management of your computer.

Note 2: This tutorial could be not be updated at the latest version of ModelMuse, anyway the procedure is usually the same.

Graphical User Interface ModelMuse and modeling codes #

• Donwload and install ModelMuse v5.1

• Launch ModelMuse, when you are asked “What do you want to do?” select “Create a new MODLFOW model” and “Next”.
• Go ahead selecting “Next” and “Finish” leaving everything as default.
• The main ModelMuse window opens. By installing the Graphical User Interface, the necessary modelling codes (MODFLOW, MT3DMS, etc.) are NOT set up and must be downloaded separately. Go to Model | MODFLOW Program locations… as shown below.

• Click on the link as reported in the picture below to go to the MF6 page, then click on “View software release” and download the ZIP file

• Unzip the folder and copy it directly in C:\mf6 or create a dedicated folder with a very short path (for example C:\EXE\mf6)
• Get back to ModelMuse and Model | MODFLOW Program Locations | Modflow 6 and browse the path to the executable file of MODFLOW 6 …\mf6\bin\mf6.exe;
• Now the pathline should be no more highlighted in red.

The procedure is the same also for the other codes, let’s see i.e. MODPATH:

• Open again the MODFLOW Program Locations window;
• Go to MODPATH v7 string and open the link to the MODPATH v7 page
• Download and unzip the software;
• Update the path in the same way as for Modflow 6.

Set up of PEST in ModelMuse #

• The PEST path is specified going to Model | PEST properties…

• Go to Basic | PEST Directory and open the link to the PEST homepage, then here go to Donwload – Programs

• Download the zip files indicated in the figures (PEST, PEST_HP, GW utilities, PLPROC):

• Unzip and copy the whole content of each folder (many exe files!) inside the folder pest17. Copy only the content of the different folders, without the folders themselves or the pdf files in them (e.g “documentation”).

• Copy the pest17 folder in a short path position, for instance; C:\PEST17 , C:\Program Files\PEST17 or C:\EXE\PEST17
• Browse the PEST path in the Basic | PEST Directory and set to “Active” the PEST Status;

Run Check #

In order to be sure that everything is correctly setup:

• Download the test model Test.gbp and save it in C:\TEST
• Go to File | Export | MODFLOW 6 Input Files…

• Create input files and run MODFLOW and MODPATH at once. Close ModelMonitor, close the mfsim.lst file and the test.lst file and press any key to close the command window.

• Inspect the C:\TEST folder. You should see 74 items.

• Open the Test.pst file, that should look like the picture.

• Go back to ModelMuse, File | Export | PEST | Export PEST Control File, overwrite, save the new Test.pst file and run PESTCHEK. Close the command window.

• Go again to File | Export | PEST | Export PEST Control File, overwrite, save the new Test.pst file and run PEST. Wait until finished (approx. 10 mins).

• Inspect the C:\TEST folder. You should see 104 items.
• Open the Test.res file; it should look like the picture.

• Go back ModelMuse and see the scatterplot of measured vs modelled heads. From Data | Data Visualization… select PEST Observation results and upload the Test.res file.