ts — Time Series Files

The ts task generates per-variable time-series files from E3SM simulation output using NCO’s ncclimo. It produces one file per variable covering a specified year range. Time-series files produced by ts are required inputs for the e3sm_diags — E3SM Diagnostics, global_time_series — Global Time Series Plots, e3sm_to_cmip — CMIP6 Conversion, ilamb — Land Benchmarking, livvkit — Ice Sheet Validation, and pcmdi_diags — PCMDI Metrics tasks.

Configuration example

[ts]
active = True
years = 1:100:10

  [[atm_monthly_180x360_aave]]
  input_files = eam.h0
  input_subdir = archive/atm/hist
  mapping_file = /path/to/map_ne30pg2_to_cmip6_180x360_aave.nc
  grid = 180x360_aave
  vars = FSNTOA,FLUT,FSNT,FLNT,FSNS,FLNS,SHFLX,QFLX,TS,TREFHT

  [[land_monthly]]
  input_files = elm.h0
  input_subdir = archive/lnd/hist
  input_component = elm
  mapping_file = /path/to/map_r05_to_cmip6_180x360_aave.nc
  grid = 180x360_aave

Parameters

These 9 parameters are specific to the ts task.

Parameter	Required	Default	Description
`area_nm`	No	`"area"`	Name of the area variable in the input files.
`dpf`	No	`30`	Days per file (for daily or sub-daily data).
`extra_vars`	No	`""`	Additional variables to include alongside the primary `vars` list.
`job_nbr`	No	`0`	Number of simultaneous `ncclimo` jobs. `0` uses `ncclimo`’s default.
`tpd`	No	`1`	Time-steps per day (for sub-daily data, e.g., `8` for 3-hourly).
`input_component`	No	`""`	Model component that generated the input files (e.g., `eam`, `eamxx`, `elm`, `mosart`). Used to set processing type internally.
`vrt_remap_vars`	No	`""`	Variables to additionally regrid from model levels to pressure levels after generating time-series files. Output is written to a sibling `ts_vrt_remap/` directory. Empty string disables vertical remapping.
`vrt_remap_file`	No	`""`	Path to the target vertical grid file (pressure levels) for `ncremap`. Defaults to a standard file under `diagnostics_base_path` when empty.
`vrt_in_file`	No	`""`	Path to the source vertical coordinate file for `ncremap`. Needed for EAMxx. When left empty, `zppy` derives it at run time from the run’s own output.

Parameters at the top-level

For top-level parameters, see top-level parameters.

Dependencies

Upstream (what ts depends on):

None.

Downstream (what depends on ts):

e3sm_to_cmip — CMIP6 Conversion — Monthly-atm ts: monthly-atm e3sm_to_cmip. Monthly-lnd ts: monthly-lnd e3sm_to_cmip.
e3sm_diags — E3SM Diagnostics — Monthly-atm ts: enso_diags, qbo, area_mean_time_series, mp_partition. Monthly-rof ts: streamflow. Daily-atm ts: tropical_subseasonal, precip_pdf.
global_time_series — Global Time Series Plots — Monthly-atm-glb ts: the 5 classic atm plots, plots for specific atm variables. Monthly-lnd-glb ts: plots for specific lnd variables.
ilamb — Land Benchmarking – Monthly-lnd ts: required. Monthly-atm ts: optional.
livvkit — Ice Sheet Validation – Monthly-lnd ts.
pcmdi_diags — PCMDI Metrics — Monthly-atm ts: mean_climate, variability_modes_atm,variability_modes_cpl, enso