Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

linux mac build Status win build status


Python-based tools for specifying, launching, visualizing, and analyzing environmental simulations, such as those for hydrology modeling.

EarthSim is designed as a lightweight "overview" site and project, relying on core code maintained in other general-purpose PyViz projects:

  • Bokeh: Interactive browser-based plotting
  • HoloViews: Easy construction of Bokeh plots for datasets
  • Datashader: Rendering large datasets into images for display in browsers
  • Param: Specifying parameters of interest, e.g. to make widgets
  • GeoViews: HoloViews with earth-specific projections

As such, this repository primarily consists of three things:

  • earthsim: A Python package with a small amount of code specific to environmental simulation
  • examples: A set of Jupyter notebooks that show how to use the various PyViz tools to solve earth-science problems
  • website: The example notebooks already run and rendered to HTML for simple exploration

In most cases, the examples (as notebooks or as the website) represent the main form of documentation, even for the Python package, so please see for more information, including installation and usage instructions.