Skip to main content
U.S. flag

An official website of the United States government

GRIDGEN: A Program for Generating Unstructured Finite-Volume Grids

January 6, 2017

Overview of GRIDGEN

GRIDGEN model grid from the cover of the GRIDGEN manual.
GRIDGEN model grid from the cover of the GRIDGEN manual.

GRIDGEN is a computer program for creating layered quadtree grids for use with numerical models, such as the MODFLOW-USG program for simulation of groundwater flow.

The program begins by reading a three-dimensional base grid, which can have variable row and column widths and spatially variable cell top and bottom elevations. From this base grid, GRIDGEN will continuously divide into four any cell intersecting user-provided refinement features (points, lines, and polygons) until the desired level of refinement is reached. GRIDGEN will then smooth, or balance, the grid so that no two adjacent cells, including overlying and underlying cells, differ by more than a user-specified level tolerance. Once these gridding processes are completed, GRIDGEN saves a tree structure file so that the layered quadtree grid can be quickly reconstructed as needed. Once a tree structure file has been created, GRIDGEN can then be used to

  1. export the layered quadtree grid as a shapefile, 
  2. export grid connectivity and cell information as ASCII text files for use with MODFLOW-USG or other numerical models, and 
  3. intersect the grid with shapefiles of points, lines, or polygons, and save intersection output as ASCII text files and shapefiles.

The GRIDGEN program is demonstrated by creating a layered quadtree grid for the Biscayne aquifer in Miami-Dade County, Florida, using hydrologic features to control where refinement is added.

 

Download Current Version of GRIDGEN

The current release is GRIDGEN v.1.0.02, released January 6, 2017.

 

Documentation for GRIDGEN

Lien, Jyh-Ming, Liu, Guilin, and Langevin, C.D., 2015, GRIDGEN version 1.0 -- A computer program for generating unstructured finite-volume grids: U.S. Geological Survey Open-File Report 2014-1109, 39 p., http://dx.doi.org/10.3133/ofr20141109.

This report describes the theory and input instructions at the time of the initial GRIDGEN release.

 

Superseded GRIDGEN Versions

The following versions of GRIDGEN have been superseded and are not actively supported by the USGS. The software versions below are provided online for historical reference only, and may contain outdated information or broken links.

 

Find MODFLOW-Related Software

Visit the MODFLOW and Related Programs page for a list of MODFLOW-related software.

 

How to Cite GRIDGEN

This USGS software has two citations associated with it.

  1. The report citation is for the original report or article documenting the underlying theory, methods, instructions, and (or) applications at the time the initial version of the software was released. This digital object identifier (DOI) is for the report.
  2. The software release citation is for the software/code itself (now referred to by USGS as a "Software Release") and references a specific version of the code and associated release date. This DOI links to the code.

In instances where an author is citing use of this software, it would be appropriate to cite both the report documenting the code and the specific software release version that was used.

Report Citation for GRIDGEN

Lien, Jyh-Ming, Liu, Guilin, and Langevin, C.D., 2015, GRIDGEN version 1.0 -- A computer program for generating unstructured finite-volume grids: U.S. Geological Survey Open-File Report 2014-1109, 39 p., http://dx.doi.org/10.3133/ofr20141109.

Software/Code Citation for GRIDGEN v1.0.02

Lien, Jyh-Ming, Liu, Guilin, and Langevin, C.D., 2017, GRIDGEN version 1.0.02 -- A computer program for generating unstructured finite-volume grids: U.S. Geological Survey Software Release, 06 January 2017, http://dx.doi.org/10.5066/F79G5JXV.

 

Publication Year 2017
Title GRIDGEN: A Program for Generating Unstructured Finite-Volume Grids
Product Type Software Release
Record Source USGS Digital Object Identifier Catalog