Modflow 2000 installation instructions for Mac

**This is a working in progress**

Modflow Installation: Mac 

This is a walk-through for installing Modflow 2000 GWT on MacOS/OSX operating systems, I have had success with this method on OSX Sierra. YMMV.

Note: No need to type the dollar sign as seen in some of the terminal instructions, the $ is to delineate that we are typing the following line into a terminal window.

  1. Applications –> Utilities –>Terminal: type into the terminal: xcodebuild -version

If this does not return a version number for Xcode it means you will need to install it.*

In the terminal type and press enter:

$ xcode-select –install

*Note this is only installing Xcode Command Line Tools, which is all we need, not the full Xcode package

  1. To make navigating easier we want to be able to open terminals in specific folders. Open system preferences –> Keyboard –>  Shortcuts –> Services. Locate “New Terminal at Folder” and check the box.

 

  1. Open an internet brower and go to: https://conda.io/miniconda.html

Select the appropriate miniconda 3.6 installer for your system and install it

 

  1. To open your terminal open your Applications folder –> Utilities –> Terminal

In the terminal type the following one line and press enter:

$ sudo easy_install pip

 

  1. Next type the following into the terminal and press enter:

$ conda install numpy

 

  1. Next type the following into the terminal and press enter:

$ sudo pip install https://github.com/modflowpy/pymake/zipball/master

 

  1. We will need gfortran so we will need to download it from: https://gcc.gnu.org/wiki/GFortranBinaries#MacOS

Select the appropriate OS X or MaxOS gfortran download, download it and install it

 

  1. In an internet browser type https://github.com/modflowpy/pymake into the address bar, press enter. This will take us to the  GitHub page for pymake: a python package for compiling MODFLOW.
    1. Click on the examples folder –> click make_mf2000.py –> click “Raw” button –> right click anywhere on the page, save to a location you’ll remember and make sure the file saves with the “.py” extension, the Desktop works (This is the python script that will compile the executable file we will need.)

 

  1. Back to the terminal use cd (change directory command) to path to where you saved the make_mf2000.py file
    1. If you saved it to the Desktop, type this:  $ cd Desktop
    2. Alternatively find it in a file explorer and
      1. When you’re in Finder, just right-click a folder and select “New Terminal at Folder”.

 

  1. If you put the file on the desktop you should see something like this in your terminal:  ~/Desktop $

Then type the following:   $ python make_mf2000.py

If everything works you should end up with folder on your desktop or wherever you are that is called temp. Inside is a shiny  new modflow2000 executable!

 

  1. Next, type this into your internet browser address bar:  https://water.usgs.gov/nrp/gwsoftware/mf2k_gwt/UNIX/mf2k_gwt.src.tar.gz

Save the file wherever you’d like, extract it, open the /bin folder (it should be empty), copy the executable we built in the  previous step (mf2000) into this folder and rename it to mf2k_gwt

 

  1. Open a terminal in this folder and type the following to tell your computer that this is an executable file:

$ chmod +x mf2k_gwt

 

  1. In your file explorer path to the /test folder in mf2k_gwt, then run test.sh, there are many ways to do this one way is open a  terminal in the folder and type:

$ ./test.sh

 

Now, according to the Readme.txt (located in /mf2k_gwt) if everything worked well you should see discrepancies of 0 in the check.out file in the /test folder that was created when you ran the test.sh script. Go ahead and open the Readme.txt file, read it, and then inspect the check.out file.

 

Extra tips:

Atom is a flexible and approachable text editor that works well for writing and reading MODFLOW files and lots of other things, you can find it here: https://atom.io/

Now to create a model, you’ll want to create new folder, copy in the executable and create/save your MODFLOW files in the same folder.

To run the program open a terminal in that folder and type: $ ./mf2k_gwt

“$ ./” is a common command for running executables.

Modflow 2000 installation instructions for Linux

Modflow Installation: Linux    

This is a walk-through for installing Modflow 2000 GWT on Linux operating systems, I have had success with this method on Linux mint and different flavors of Ubuntu. YMMV.

Note: No need to type the dollar sign as seen in some of the terminal instructions, the $ is to delineate that we are typing the following line into a terminal window.

  1. Open an internet brower and go to: https://conda.io/miniconda.html

Select the appropriate miniconda 3.6 installer for your system and install it

  1. Open your terminal, in Linux press ctrl+alt+t, in the terminal type the following line and press enter:

$ sudo apt-get install pip

now update with:

$ apt-get update

  1. Next type the following into the terminal and press enter:

$ conda install numpy

  1. Next type the following into the terminal and press enter:

$ pip install https://github.com/modflowpy/pymake/zipball/master

  1. We will need gfortran, so in the terminal:

$ sudo apt-get install gfortran

  1. In an internet browser type https://github.com/modflowpy/pymake into the address bar, press enter. This will take us to the Git Hub page  for pymake: a python package for compiling MODFLOW 2000
  2. Click on the examples folder -> click make_mf2000.py -> click “Raw” button -> right click anywhere on the page, save to a location you’ll remember and make sure the file saves with the “.py” extension, the Desktop works (This is the python script that will compile the executable file we will need.)
  1. Back to the terminal use cd (change directory command) to path to where you saved the make_mf2000.py file
    1. If you saved it to the Desktop, type this:  $ cd Desktop
    2. Alternatively find it in a file explorer and
      1. Right click anywhere in the window and select “open a terminal here”.
  1. If you put the file on the desktop you should see something like this in your terminal:   ~/Desktop $

Then type the following:   $ python make_mf2000.py

If everything works you should end up with folder on your desktop or wherever you are that is called temp. Inside is a shiny  new modflow2000 executable!

  1. Next, type this into your internet browser address bar:  https://water.usgs.gov/nrp/gwsoftware/mf2k_gwt/UNIX/mf2k_gwt.src.tar.gz

Save the file wherever you’d like, extract it, open the /bin folder (it should be empty), copy the executable we built in the previous step (mf2000) into this folder and rename it to mf2k_gwt

  1. Open a terminal in this folder and type the following to tell your computer that this is an executable file:

$ chmod +x mf2k_gwt

  1. In your file explorer path to the /test folder in mf2k_gwt, then run test.sh, there are many ways to do this one way is open a terminal in the folder and type:

$ ./test.sh

Now, according to the Readme.txt (located in /mf2k_gwt) if everything worked well you should see discrepancies of 0 in the check.out file in the /test folder that was created when you ran the test.sh script. Go ahead and open the Readme.txt file, read it, and then inspect the check.out file.

 

 

 

 

Extra tips:

Atom is a flexible and approachable text editor that works well for writing and reading MODFLOW files and lots of other things, you can find it here: https://atom.io/

Saving MODFLOW input files made in Atom as .prn seems to work fine

Now to create a model, you’ll want to create new folder, copy in the executable and create/save your MODFLOW files in the same folder.

if you have trouble with the executable, make sure it has been set as an executable by “chmod +x”, by typing “ls” into the terminal at your model folder you should see the executable be highlighted

To run the program open a terminal in that folder and type: $ ./mf2k_gwt

“$ ./” is a common command for running executables.

I’m working on an action file for Thunar so that you no longer need to put the MODFLOW executable in each model folder, I will update this when I have that figured out.

If you have any questions/suggestions, leave a comment


Continue reading "Modflow 2000 installation instructions for Linux"