The PISM source code is hosted at github.com/pism/pism. The default branch is
stable0.5, the current stable version of PISM, but to get the
dev branch you can either clone the repository and then checkout the
dev branch, or you can ask for the
dev branch from the start:
git clone -b dev git://github.com/pism/pism.git pism-dev
See the Installation Manual for the list of tools and libraries necessary to build PISM.
For the development version you need PETSc 3.3 or 3.4. We normally configure PETSc to be built with shared libraries so that we can build PISM with shared libraries also. Thus the PETSc configure might be as simple as
cd $PETSC_DIR ./configure --with-shared-libraries make all
cd pism-dev mkdir 'your build directory' cd 'your build directory' ccmake .. # type 'c' as soon as it runs, then set variables as needed, # then 'g' to generate (you can toggle advanced mode with 't' # to get lots of control) make install
If you see configuration-related issues (missing libraries, etc.) at this stage then go back to
and fix them.
After exiting “ccmake” (e.g. by re-generating the makefile), do
make install pisms # very minimal test; should run and produce NetCDF (.nc) file make test # will do thorough test if python tools and NCO are available
The source code host site allows you to browse the source and see recent changes and to post issues, which you can tag as bugs, tasks or feature requests.
To get updates by e-mail, please go to http://groups.google.com/group/pism-commits and join the group. (This requires a Google Mail account.)
If you are using a different e-mail system, you can either
Here are the latest five commits (obtained using the RSS feed link above):
Get the latest features, bugs, and perhaps their fixes:
cd pism-dev git pull cd 'your build directory' make install
See the User's Manual to get the user-level view of PISM even if you think you know everything.
When working with the
dev branch you should build documentation yourself by getting doxygen and LaTeX—if you don't have them installed already–and then making the appropriate target:
cd 'your build directory' make manual # builds manual.pdf make installation # builds installation.pdf make forcing # builds forcing.pdf make browser # doxygen docs; view doc/browser/html/index.html when built
There is additional documentation for the new PISM Python bindings and inversion tools. See the PDF Installation Manual (installation.pdf; built by
make installation) for how to build the documentation for the Python bindings and inversion tools. You will need Sphinx to build these docs.