OverviewΒΆ

Introduction

This first recipe covers essential features of gospl in the form of interactive Jupyter notebooks and Python scripts. Over the course of this recipe, you will learn:

  • data structure used in gospl input file,

  • how to generate simple initial conditions like topography, tectonic and precipitation to force a simulation,

  • how to extract some of the outputs from the model to visualise them in Jupyter notebooks using multiple approaches/libraries,

  • how to export gospl outputs (hdf5) in other common formats such as netcdf, geotiff, ZMap, and

  • how to extract information relative to drainge basins and rivers longitudinal profiles.

The simulation proposed here uses data freely available from the web and will run without additional dataset. The dataset are imported in the jupyter notebooks from the following THREDDS servers:

  1. Topography file from NOAA ETOPO5,

  2. Precipitation file from the CPC collection.

In this example, we show how to use the global model to run a simulation for a particular continental-scale region here the Gulf of Mexico. This is done by building an unstructured spherical mesh with high resolution (approx. 25 km) around North America and a coarse (>1000 km) elsewhere.

Note

The recipe should take around 20/30 minutes to do on a single CPU (actually the simulation itself runs in less than 5 minutes but you will need time to understand how to build the input files and perform the provided post-processing analysis). Obviously, gospl can be ran at much higher resolution (<10 km) globally but will take much more time!

The recipe is actually a coarser version of the following simulation which takes a bit longer to run but has been built using the exact same notebooks.

recipe1