PISM 2.1 documentation

This Manual was built using revision v2.1-1-g6902d5502 committed on 2023-12-20 08:38:27 -0800.

• Acknowledgements
• Installing PISM
  • Required tools and libraries
  • Installing parallel I/O libraries
    • Installing HDF5-based parallel NetCDF
    • Installing PnetCDF
    • Installing NCAR ParallelIO
  • Installation Cookbook
    • Installing prerequisites on Debian or Ubuntu
    • Installing prerequisites and building PISM on Arch Linux
    • Installing required libraries on macOS
    • Installing PISM using Spack
    • Building PETSc
    • Building PISM
    • Common build problems and solutions
  • Quick tests of the installation
  • Next steps
  • Rebuilding PISM documentation
    • Manual
    • Source Code Browser
    • Re-building documentation without PISM’s prerequisites
• PISM User’s Manual
  • Getting started: a Greenland ice sheet example
    • Input data
    • First run
    • Watching the first run
    • Second run: a better ice-dynamics model
    • Third run: higher resolution
    • Fourth run: paleo-climate model spin-up
    • Grid sequencing
    • An ice dynamics parameter study
  • Ice dynamics, the PISM view
    • Stress balance models: SIA, SSA, and the First Order Approximation
    • A hierarchy of simplifying assumptions for grounded ice flow
    • Evolutionary versus diagnostic modeling
    • Climate inputs, and their interface with ice dynamics
  • Initialization and bootstrapping
    • Initialization from a saved model state
    • Bootstrapping
  • Modeling choices
    • Model domain, grid, and time
    • Ice dynamics and thermodynamics
    • The subglacier
    • Marine ice sheet modeling
    • Modeling individual outlet glaciers
    • Disabling sub-models
    • Dealing with more difficult modeling choices
  • Practical usage
    • Handling NetCDF files
    • Input and output
    • Understanding adaptive time-stepping
    • Scalar diagnostic quantities
    • Spatially-varying diagnostic quantities
    • Snapshots of the model state
    • Run-time diagnostic viewers
    • PISM’s configuration parameters and how to change them
    • Regridding
    • Signals, to control a running PISM model
    • Balancing the books
    • PETSc options for PISM users
    • Utility and test scripts
    • Using PISM for flow-line modeling
    • Managing source code modifications
    • ISMIP6 Greenland
  • Simplified geometry experiments
    • EISMINT II
    • MISMIP
    • MISMIP3d
    • ISMIP-HOM
  • Verification
    • Sample convergence plots
  • Validation case studies
    • An SIA flow model for a table-top laboratory experiment
    • An SSA flow model for the Ross Ice Shelf in Antarctica
  • Example: A regional model of the Jakobshavn outlet glacier in Greenland
    • Get the drainage basin delineation tool
    • Preprocess the data and get the whole ice sheet model file
    • Identify the drainage basin for the modeled outlet glacier
    • Cut out the computational domain for the regional model
    • Quick start
    • Spinning-up the regional model on a 5 km grid
    • Century run on a 2 km grid
    • Plotting results
  • Configuration parameters
  • Diagnostic quantities
    • Spatially-variable fields
    • Scalar time-series
• Climate forcing
  • Using time-dependent forcing
    • Introduction
    • Scalar time-dependent inputs
    • Spatially-variable time-dependent inputs
    • Periodic forcing
    • Adding time bounds
  • Examples and corresponding options
    • One way coupling to a climate model
    • Using climate anomalies
    • SeaRISE-Greenland
    • SeaRISE-Greenland paleo-climate run
    • Antarctic paleo-climate runs
  • Testing if forcing data is used correctly
    • Visualizing climate inputs, without ice dynamics
    • Using low-resolution test runs
    • Visualizing the climate inputs in the Greenland case
  • Surface mass and energy process model components
    • The “invisible” model
    • Reading top-surface boundary conditions from a file
    • Elevation-dependent temperature and mass balance
    • Temperature-index scheme
    • Diurnal Energy Balance Model “dEBM-simple”
    • PIK
    • Scalar temperature offsets
    • Adjustments using modeled change in surface elevation
    • Mass flux adjustment
    • Using climate data anomalies
    • The caching modifier
    • Preventing grounding line retreat
  • Atmosphere model components
    • Boundary conditions read from a file
    • Cosine yearly cycle
    • SeaRISE-Greenland
    • PIK
    • One weather station
    • Scalar temperature offsets
    • Scalar precipitation offsets
    • Precipitation scaling
    • Precipitation correction using scalar temperature offsets
    • Adjustments using modeled change in surface elevation
    • Using climate data anomalies
    • Orographic precipitation
  • Ocean model components
    • Constant in time and space
    • Reading forcing data from a file
    • PIK
    • Basal melt rate and temperature from thermodynamics in boundary layer
    • PICO
    • Scalar sea level offsets
    • Two-dimensional sea level offsets
    • Scalar sub-shelf temperature offsets
    • Scalar sub-shelf mass flux offsets
    • Scalar sub-shelf mass flux fraction offsets
    • Two-dimensional sub-shelf mass flux offsets
    • Scalar melange back pressure offsets
    • Melange back pressure as a fraction of pressure difference
    • The caching modifier
• Technical notes
  • Release checklist
  • CF standard names used by PISM
    • Existing standard names
    • Proposed standard names
    • Final technical notes
  • On the vertical coordinate in PISM, and a critical change of variable
  • Using Schoof’s parameterized bed roughness technique in PISM
    • An explanation
    • Theory
    • Practical application, and Taylor approximation
  • Calving front stress boundary condition
    • Notation
    • Calving front stress boundary condition
    • Shallow shelf approximation
    • Implementing the calving front boundary condition
  • Notes about the flow-line SSA
    • An observation
    • Discrete analog of this property
    • Discretization
  • BOMBPROOF, PISM’s numerical scheme for conservation of energy
    • Introduction
    • Conservation of energy in a shallow ice sheet
    • The core BOMBPROOF scheme
    • Stability properties of the BOMBPROOF scheme
    • Temperate basal boundary condition, and computing the basal melt rate
  • Computing steady-state subglacial water flux
    • The algorithm
  • Three-equation ocean model (implementation details)
  • Blatter stress balance solver: technical details
    • Notation
    • Introduction
    • Weak form
    • Boundary conditions
    • Solver implementation
    • Testing and verification
    • Known issues and future work
• Contributing to PISM
  • Submitting bug reports
  • PISM coding guidelines
    • File names
    • Source and header files
    • Inline functions and methods
    • Including header files
    • Naming
    • Namespaces
    • Formatting
    • Error handling
    • Function design
  • Git introduction for PISM developers
    • Recommended Git configuration
    • Working on a new branch
    • Writing better commit messages
  • Git branches
  • Development workflow
    • Setting up the environment
    • Editing source code
    • Compiling PISM
    • Debugging
    • Writing tests
    • Editing PISM’s manual
  • How do I…?
    • Create and use configuration flags and parameters
    • Create and use additional variables
    • Read data from a file
    • Write data to a file
    • Read scalar forcing data
    • Read 2D forcing fields
• Authorship
• References

---

Next