Skip to content

Latest commit

 

History

History
75 lines (50 loc) · 3.96 KB

Readme.md

File metadata and controls

75 lines (50 loc) · 3.96 KB

Modflow-setup

Modflow-setup is a Python package for automating the setup of MODFLOW groundwater models from grid-independent source data including shapefiles, rasters, and other MODFLOW models that are geo-located. Input data and model construction options are summarized in a single configuration file. Source data are read from their native formats and mapped to a regular finite difference grid specified in the configuration file. An external array-based Flopy model instance with the desired packages is created from the sampled source data and configuration settings. MODFLOW input can then be written from the flopy model instance.

Version 0.1

Tests codecov Binder Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.

Getting Started

For more details, see the modflow-setup documentation

Using a yaml-aware text editor, create a configuration file similar to one of the examples in the Configuration File Gallery.

The yaml file summarizes source data and parameter settings for setting up the various MODFLOW packages. To set up the model:

from mfsetup import MFnwtModel, MF6model

m = MF6model.setup_from_yaml(<path to configuration file>)

where m is a flopy MODFLOW-6 model instance that is returned. The MODFLOW input files can be written from the model instance:

m.simulation.write_simulation()

MODFLOW-NWT version:

m = MFnwtModel.setup_from_yaml(<path to configuration file>)
m.write_input()

Installation

See the Installation Instructions

How to cite

Citation for Modflow-setup

Leaf, A.T. and Fienen, M.N. (2022) Modflow-setup: Robust automation of groundwater model construction. (in revision) Front. Earth Sci. x:xx. doi: 10.3389/xxx

Software/Code Citation for Modflow-setup

Leaf, A.T. and Fienen, M.N. (2022). Modflow-setup version 0.1, U.S. Geological Survey Software Release (IP-137457; in review), 1 Aug 2022. https://doi.org/10.5066/P9O3QWQ1

MODFLOW Resources

Disclaimer

This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). 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. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software. It is the responsibility of the user to check the accuracy of the results.

Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.