Reed M. Maxwell - Codes
[Home] [Research] [Teaching] [Group] [Publications] [Codes]

Reed M. Maxwell
Simulation Platforms

ParFlow
ParFlow is an open-source, object-oriented, parallel watershed flow model. It includes fully-integrated overland flow, the ability to simulate complex topography, geology and heterogeneity and coupled land-surface processes including the land-energy budget, biogeochemistry and snow (via CLM). It is multi-platform and runs with a common I/O structure from laptop to supercomputer. ParFlow is the result of a long, multi-institutional development history and is now a collaborative effort between CSM, F-Z Jülich, UniBonn, LLNL, WSU, LBL, and LTHE. ParFlow has been coupled to the mesoscale, meteorological code ARPS, the NCAR code WRF and the German Weather Service model COSMO.

ParFlow Blog

To get started with ParFlow, I would recommend the manual. It contains lots of useful information on getting started, a complete table of published studies that have used ParFlow for a range of applications, some very helpful annotated examples to get new users started and a complete library of the keys for running simulations and tools for postprocessing output. If you are building a model of a real domain there are helpful blogposts on a workflow for setting up and spinning up models on the ParFlow Blog. Also the blog contains posts on trouble shooting slow model performance and common errors when starting a simulation that will be useful to new users. Finally, the blog contains a lot of useful advice on getting ParFlow compiled on many different platforms.

A complete publication list for all ParFlow references now appears in the manual. However, good publications related to the development of ParFlow are AF1996, JW2001, MM2005, KM2006, KM2008, MK2008a, M2013; a publication related to ParFlow coupled to ARPS (PF.ARPS) is MCK2007 a publication related to PF-WRF is MLMSWT2011 and ParFlow coupled to COSMO SMSKS14.

ParFlow Version 3.2.0

ParFlow is released under the GNU LPGL license agreement. The code and User's Manual may be downloaded for OSX and Linux/Unix below. Before doing so, it is important that you read the parflow copyright and disclaimer.

Downloads
ParFlow is now on GitHub. The current release is linked below, we recommend starting there. The project may be accessed here.

ParFlow v3.2.0 User's Manual July 2016

The best resource for ParFlow questions is the user's email list. This is an active, searchable listserve with a large user base. To report bugs or request features, please use the ParFlow Issue Tracker on GitHub. Please note that ParFlow is an unsupported research code and while we will attempt to answer questions posted to this list, there is no guarantee that there will be any reply. Before emailing this list, please make sure you first refer to the manual, the blog and join the user's email list. Please include as much relevant information as possible, including the version number being used. For compile and runtime problems, please also include the machine type, operating system, MPI implementation, compiler, and any error messages produced. Developers who want to be added to the repository development group should contact us to follow best software productivity practices on GitHub.

If you are using ParFlow, please let me know, I try to keep a list of active users. If you use ParFlow in a publication, please cite the these papers that describe model physics:
Ashby S.F. and R.D. Falgout, Nuclear Science and Engineering 124:145-159, 1996
Jones, J.E. and C.S. Woodward, Advances in Water Resources 24:763-774, 2001
Kollet, S.J. and R.M. Maxwell, Advances in Water Resources 29:945-958, 2006
Maxwell, R.M. Advances in Water Resources 53:109-117, 2013

If you use ParFlow coupled to CLM in a publication, please also cite two additional papers that describe the coupled model physics:
Maxwell, R.M. and N.L. Miller, Journal of Hydrometeorology 6(3):233-247, 2005
Kollet, S.J. and R.M. Maxwell, Water Resources Research 44:W02402, 2008

SLIM
SLIM is a Lagrangian, particle-tracking model for simulating subsurface and surface transport of reactive (such as microbial agents and metals) and non-reactive contaminants, diagnosing travel times, paths etc, and integrates seamlessly with ParFlow.

For an example of ParFlow and SLIM working together, please see MWH2007, this example from MCT2008, KM2008, SSMM2012, SM2012a, SM2012b, AMS2013, dRGM2013 and CWM2014.

For more information or to obtain the code, please contact me by email.


Colorado School of Mines Geology and Geological Engineering
Send comments & questions to rmaxwell @ mines.edu (remove spaces) Disclaimer
Last Modified: July 23, 2016