A schematic view of zppyΒΆ
The following example provides a schematic view of how zppy
functions.
For this example, assume a researcher has 200 years of simulation data.
Figure 1 displays some of the tasks they might configure zppy to run:
20-year atmosphere monthly and seasonal climatologies, optionally regridded
20-year atmosphere monthly and seasonal climatologies resolving the diurnal cycle (eight times per day in this example, meaning eight data points per day with each point representing a three-hour time block of monthly or seasonally averaged values), optionally regridded
10-year atmosphere monthly time-series, optionally regridded
10-year atmosphere daily time-series, optionally regridded
10-year atmosphere monthly time-series, globally averaged
10-year land monthly time-series, optionally regridded
The scientist can also configure zppy to generate helpful plots such as:
E3SM Diags for 20-year periods, (E3SM Diags includes many diagnostic sets β this example assumes the researcher would like to run them all)
MPAS-Analysis for 50-year periods
Global time series plots for 50-year periods
The figures illustrate schematically how zppy would function in this example. Figure 1 shows how zppy uses sections of the configuration file and bash/Jinja2 templates to launch jobs. Figure 2 shows two possible job dependency graphs.
The top graph in Figure 2 shows the dependencies for the years 1-20 E3SM Diags task. This task requires the monthly climatology for years 1-20. Because the researcher wants to run the diurnal cycle diagnostic set, the diurnal climatology for years 1-20 is also required. Since the scientist wants to run the area mean time series, ENSO, and QBO diagnostic sets, the monthly time-series for years 1-10 and years 11-20 are required.
The bottom graph in Figure 2 shows the dependencies for the global time series plots. The plots for years 1-50 require the the monthly time-series for years 1-10, 11-20, 21-30, 31-40, and 41-50 in addition to MPAS-Analysis for years 1-50. The plots for years 51-100 have similar requirements β however the graph calls attention to the fact that MPAS-Analysis for years 51-100 itself depends on MPAS-Analysis for years 1-50.
![_images/zppy_jobs.png](_images/zppy_jobs.png)
Figure 1. Illustration of how zppy uses sections of the configuration file and bash/Jinja2 templates to launch various jobs. climo stands for climatology and ts stands for time series. Note that the configuration file is abridged β see the zppy tutorial for more complete examples.
![_images/zppy_dependencies.png](_images/zppy_dependencies.png)
Figure 2. Two possible job dependency graphs. climo stands for climatology and ts stands for time series.