PyGDH: the Python-based Grid Discretization Helper

PyGDH (pronounced as "pigged") is an open source (released under a modified BSD License) Python 2 library. PyGDH makes it relatively easy for users to write Python programs that describe and solve systems of ordinary and partial differential equations (optionally time-dependent) on simple one-dimensional and two-dimensional spatial domains.

Flexibility, followed by ease-of-use, were the primary considerations in the design of PyGDH. Users define mathematical problems by writing Python programs that describe discretized equations directly (in terms of the finite volume method, for now), and PyGDH provides machinery to simplify this process. The full expressiveness of the Python language remains available when setting up mathematical problems and when performing postprocessing on numerical solutions. The intention is to offer users most of the flexibility that comes with writing numerical code from scratch, without all of the work.

While PyGDH is very much a work in progress, it has been used successfully in past and ongoing research projects. We have used it to implement models involving large-deformation mechanics along with mass transfer. We hope that it will be useful to others.

Recent Announcements

  • PyGDH 0.1.1 released This release fixes bugs in initialization and interpolation. The documentation is updated with a minor correction as well. The example code in the documentation has not changed.
    Posted Jan 11, 2016, 11:16 AM by Kenneth Higa
  • PyGDH 0.1.0 released! PyGDH 0.1.0 is now publicly available through the link under "Downloading PyGDH."
    Posted Jan 7, 2016, 3:07 PM by Kenneth Higa
  • PyGDH 0.1.0 approved for release! The initial version PyGDH has been approved for release by the Department of Energy and Berkeley Lab. It will be publicly available as soon as we decide on a hosting ...
    Posted Jan 6, 2016, 10:03 AM by Kenneth Higa
Showing posts 1 - 3 of 3. View more »

System requirements

PyGDH requires a Python 2 environment (it is known to work under Python 2.6 and 2.7) with NumPy and SciPy installed, and optionally, h5py, the underlying HDF5 library, and the Cython compiler (along with a C compiler). PyGDH has been used on Windows, Mac, and GNU/Linux (Debian and CentOS) systems.

Downloading PyGDH

The PyGDH documentation is available from this site on the Documentation page. It is also a work in progress but is already fairly comprehensive and includes many examples. Currently, it is only available as a PDF file.

The PyGDH software and example source code from the documentation are available from bitbucket.org in "zip" and "tar.gz" formats. Detailed installation instructions are provided in the Documentation.