Flopy is a package of tools written in Python for MODFLOW groundwater flow model construction, simulation and output analysis. Flopy is build on top of well know and powerful Python packages as Numpy and works with Matplotlib and Pandas that allows to do a great amount of analysis with few lines of code. Several new capabilities in the water balance analysis can be done with Flopy bringing a better control to the modeler in terms of a more available and user friendly information of the inputs, outputs and discrepancies of the model. This tutorial shows the complete procedure to read, simulate and output analysis of a MODFLOW NWT model of a tunnel development with time. The tutorial include a discussion and review of the different tools available in Flopy and the interaction with QGIS.

Stress periods are defined based on particular stages on the groundwater flow conditions and requirements to hidrogeological flow regime. Time steps are mostly defined based on the computational power, desired output and convergence objectives. It can be possible that boundary conditions varies at times different from the temporal discretization defined by the stress periods and time steps. MODFLOW 6 has a time-series functionality capable of distribute the transient boundary conditions on the determined time steps. The tutorial shows a model on transient flow conditions with boundaries conditions distributed at different time intervals. A comparison of the applied well rate vs. observed pumping rate and applied constant head vs observed head has been done on a Jupyter Notebook.

Example of the wetting/drying capabilities in MODFLOW 6 on a groundwater model on steady and transient flow conditions. The simulation represent the groundwater flow of a 2 layer model at the following stress periods: no pumping, pumping from 2 wells, recovery from pumping in 50 days. The model has been implemented with the recharge package (RCH), river package (RIV), and well package (WEL).

The tutorial also runs some Python script for the translation of model results and boundary conditions in VTK geometry. The Python script has a interactive feature for the representation of selected stress periods and time steps. A discussion of the water table at pumping and recovery was done on the last of the tutorial.

MODFLOW 6 has been compiled using gfortran on the Mac/OS operating systems. Because the program uses relatively new Fortran capabilities gfortran version 4.9 or newer must be used. If you have gfortran installed on your computer, you can tell which version it is by entering “gfortran --version” at a terminal window.

This tutorial show the procedure to compile and run MODFLOW 6 on a Terminal in MAC/OS operating sytem.

Based on the new file format and keywords from MODFLOW 6 it is more simple to understand a model while inspecting the input files. This tutorial show a example of a steady and transient flow model in MODFLOW 6 for a period of 30 days divided into 4 stress periods. The tutorial has a introduction to the model geometry, input files and boundary conditions, a model simulation in transient flow conditions and output visualization as VTU files in Paraview. The tutorial also includes a discussion on the water balance from the groundwater flow system at the end of the simulation.

Basic tutorial to learn the procedure to build, simulate and represent a MODFLOW 6 model. The tutorial shows a introduction to the model file system on steady state conditions. The model for this tutorial is implemented with the following boundary conditions: Drains, Recharge, Wells, and Constant Head. The grid is regular with a width of 50 meters and it has 30 rows and 24 columns; the model has 4 layers and a total thickness of 130 meters. The model is called "hatari01" and is inspired in the "twri" model from the MODFLOW 2005 documentation adapted to MODFLOW 6. The model defines a constant horizontal hydraulic conductivity as well as vertical conductivity. After the simulation a Python code is run on a Jupyter Notebook to create the Unstructured VTK files for the heads, water table and boundary conditions representation as 3D objects in Paraview.

MODFLOW model output representation is key to understand the groundwater flow regime, to study the interaction with surface water and depending ecosystems and to evaluate the impact to anthropogenic and climate change requirements. Until now, there has been few open source software capable of generating3D representations and those software had limited options for color scales, cross sections and other graphical tools. On the research for more options we found Paraview, a open source software for data representation designed to analyze extremely large datasets using distributed memory computing resources.

In order to represent MODFLOW output into Paraview, a VTK file for unstructured grids is needed, this VTK type is called VTU where the "U" comes from unestructured. The tutorial show the complete procedure to process a MODFLOW model output into a VTU file and the representation in Paraview.

MODFLOW computes the groundwater heads over a porous / fractured media upon a series of boundary conditions as recharge, evapotranspiration, drains, well and others on steady and transient conditions. Free and commercial software is available for the MODFLOW model construction and MODFLOW output representation. Despite the fact the capabilities of these softwares, there are some gaps in data processing and representation; isometric views, animation and custom cross sections are still difficult to achieve under the existing tools, specially on multilayered models with transient conditions over series of time steps and stress periods.

There is a particular open source software for data representation that is of our interest, it is called Paraview (paraview.org). This visual application was designed to analyze extremely large datasets using distributed memory computing resources, in fact the term "para" in Paraview comes from the parallelization of computer cores.
 

Flopy is the Python library to create, run and represent results from MODFLOW models, including support for MODFLOW 6. With Flopy, the model definition and set up of boundary conditions can be done with lines of Python code, and some Python tools of optimization and machine learning can interact with the MODFLOW models. This tutorial show a basic example of model creation, configuration and simulation in Python 3 on a Jupyter Notebook. The tutorial also shows the procedure to import the MODFLOW results done with Flopy in Model Muse.