!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!
!!! CSO - CAMS Satellite Operator
!!!
!!! Settings for S5p/CO processing.
!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


!-----------------------------------------------------------------------
! user specific settings:
!-----------------------------------------------------------------------

! include user specfic settings:
#include cso-user-settings.rc


!======================================================================
!===
!=== Inquire
!===
!======================================================================


!-----------------------------------------------------------------------
! inquire DataSpace
!-----------------------------------------------------------------------

! Obtain names of all available S5p files.
! Stored as csv with processing type, processor version, filenames, etc.

! full time range:
cso.s5p.co.inquire-table-dataspace.timerange.start        :  ${my.full-timerange.start}
cso.s5p.co.inquire-table-dataspace.timerange.end          :  ${my.full-timerange.end}

! API url:
cso.s5p.co.inquire-table-dataspace.url                    :  https://finder.creodias.eu/resto/api

! collection name:
cso.s5p.co.inquire-table-dataspace.collection             :  Sentinel5P

! product type, always 10 characters!
!   L2__CO___
!   L2__CO____
!   ...
cso.s5p.co.inquire-table-dataspace.producttype            :  L2__CO____

! target area;
!!~ empty for no limitation:
!cso.s5p.co.inquire-table-dataspace.area                   :  
!~ domain specified as:  west,south,east,north
cso.s5p.co.inquire-table-dataspace.area                   :  ${my.region.west},${my.region.south},${my.region.east},${my.region.north}

! template for download url given "{product_id}":
cso.s5p.co.inquire-table-dataspace.download_url           :  https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value

! output table, date of today:
cso.s5p.co.inquire-table-dataspace.output.file            :  ${my.work}/Copernicus-inquire/Copernicus_S5p_CO_dataspace__%Y-%m-%d.csv


!-----------------------------------------------------------
! overview plot of versions
!-----------------------------------------------------------

! renew existing plots?
cso.s5p.co.inquire-plot.renew                    :  True

! listing files:
cso.s5p.co.inquire-plot.file                     :  ${cso.s5p.co.inquire-table-dataspace.output.file}
!!~ specify dates ("yyyy-mm-dd") to use historic tables,
!!  default is table of today:
!cso.s5p.co.inquire-plot.filedate                 :  2023-08-07

! annote:
cso.s5p.co.inquire-plot.title                    :  S5p/CO %Y-%m-%d

! output figure, date of today:
cso.s5p.co.inquire-plot.output.file              :  ${my.work}/Copernicus-inquire/Copernicus_S5p_CO_dataspace__%Y-%m-%d.png


!======================================================================
!===
!=== convert (and download)
!===
!======================================================================


! renew existing files (True|False) ?
cso.s5p.co.convert.renew                  :  True
!cso.s5p.co.convert.renew                  :  False

! time range:
cso.s5p.co.convert.timerange.start        :  ${my.timerange.start}
cso.s5p.co.convert.timerange.end          :  ${my.timerange.end}


!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
! input files
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

! listing of available source files,
! created by 'inquire-dataspace' job:
cso.s5p.co.convert.inquire.file                   :  ${my.work}/Copernicus-inquire/Copernicus_S5p_CO_dataspace__%Y-%m-%d.csv
!!~ historic inquire ...
!cso.s5p.co.convert.inquire.filedate               :  ${cso.s5p.co.inquire-plot.filedate}

! selection keyword:
my.s5p.co.selection                                :  C03

! Provide ';' seperated list of to decide if a particular orbit file should be processed.
! If more than one file is available for a particular orbit (from "OFFL" and "RPRO" processing),
! the file with the first match will be used.
! The expressions should include templates '%{header}' for the column values.
! Example to select files from collection '03', preferably from processing 'RPRO' but otherwise from 'OFFL':
!   (%{collection} == '03') and (%{processing} == 'RPRO') ; \
!   (%{collection} == '03') and (%{processing} == 'OFFL')
!
#if "${my.s5p.co.selection}" == "C03"
cso.s5p.co.convert.selection                     :  (%{collection} == '03') and (%{processing} == 'RPRO') ; \
                                                     (%{collection} == '03') and (%{processing} == 'OFFL')
#else
#error unsupported my.s5p.co.selection "${my.s5p.co.selection}"
#endif

! input directory;
! files are searched here or downloaded to if not present yet;
! supported templates:
!   %{processing}
cso.s5p.co.convert.input.dir                      :  ${my.work}/Copernicus/S5P/%{processing}/CO/%Y/%m

! remove downloaded input files after convert?
cso.s5p.co.convert.downloads.cleanup              :  False

! selection names:
cso.s5p.co.convert.filters                        :  lons lats valid quality

! filter settings:
cso.s5p.co.convert.filter.lons.var                :  PRODUCT/longitude
cso.s5p.co.convert.filter.lons.type               :  minmax
cso.s5p.co.convert.filter.lons.minmax             :  ${my.region.west} ${my.region.east}
cso.s5p.co.convert.filter.lons.units              :  degrees_east

! filter settings:
cso.s5p.co.convert.filter.lats.var                :  PRODUCT/latitude
cso.s5p.co.convert.filter.lats.type               :  minmax
cso.s5p.co.convert.filter.lats.minmax             :  ${my.region.south} ${my.region.north}
cso.s5p.co.convert.filter.lats.units              :  degrees_north

! skip pixel with "no data", use the "qa_value" variable to check:
cso.s5p.co.convert.filter.valid.var               :  PRODUCT/qa_value
cso.s5p.co.convert.filter.valid.type              :  valid

! Comment in "PRODUCT/qa_value" variable:
!   "A continuous quality descriptor, 
!   varying between 0 (no data) and 1 (full quality data). 
!   Recommend to ignore data with qa_value < 0.5" 
! 0.5 is the recommended use so what we will use here
cso.s5p.co.convert.filter.quality.var             :  PRODUCT/qa_value
cso.s5p.co.convert.filter.quality.type            :  min
cso.s5p.co.convert.filter.quality.min             :  0.5
cso.s5p.co.convert.filter.quality.units           :  1


!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
! output files
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

! output directory and filename:
! - times are taken from mid of selection, rounded to hours
! - use '%{processing}' for the processing name
! - use '%{orbit}' for orbit number
cso.s5p.co.convert.output.filename            :  ${my.work}/CSO-data/${my.region}/S5p/CO/${my.s5p.co.selection}/%Y/%m/S5p_CO_%{orbit}.nc

! pack variables on output:
cso.s5p.co.convert.output.packed              :  True
! zlib compression level, 0 for no compression:
cso.s5p.co.convert.output.complevel           :  1

! global attributes:
cso.s5p.co.convert.output.attrs               :  format Conventions \
                                                     author institution email
!
cso.s5p.co.convert.output.attr.format         :  ${my.cso.format}
cso.s5p.co.convert.output.attr.Conventions    :  ${my.cso.convention}
cso.s5p.co.convert.output.attr.author         :  ${my.attr.author}
cso.s5p.co.convert.output.attr.institution    :  ${my.attr.institution}
cso.s5p.co.convert.output.attr.email          :  ${my.attr.email}

! no need to swap layes:
cso.s5p.co.convert.swap_layers                :  False


! ~ variables

! which fields to be put out ?
cso.s5p.co.convert.output.vars    :  longitude longitude_bounds \
                                       latitude latitude_bounds \
                                       track_longitude track_longitude_bounds \
                                       track_latitude  track_latitude_bounds \
                                       time \
                                       qa_value \
                                       pressure kernel \
                                       vcd vcd_errvar \
                                       solar_zenith_angle


! 
! Describe per variable:
! * .dims :  dimensions list:
!     pixel       : selected pixels
!     corner      : number of footprint bounds (probably 4)
!     layer       : number of layers in atmospheric profile (layers in kernel)
!     layeri      : number of layer interfaces in atmospheric profile (layer+1)
!     retr        : number of layers in retrieval product (1 for columns) ;
!                   for error covariance use (retr,retr0) to avoid repeated dimensions
!     track_scan  : original scan index   in 2D track
!     track_pixel : original ground pixel in 2D track
! * .specal  : keyword to select special processing
!     * None                     : no special processing (default)
!     * track_longitude          : longitudes at centers of original 2D track
!     * track_latitude           : latitudes  at centers of original 2D track
!     * track_longitude_bounds   : longitude bounds at centers of original 2D track
!     * track_latitude_bounds    : latitude  bounds at centers of original 2D track
! * .units   : target units if different from original
! * .oper    : special postprocessing, currently supported:
!     * square      :  fill variable with squared valued (used to form variance from standard deviation)
! In case no special processing is needed:
! * .from : original variable (group path and variable name)
!

! center longitudes; remove bounds attribute, no coordinate ...
cso.s5p.co.convert.output.var.longitude.dims                   :   pixel
cso.s5p.co.convert.output.var.longitude.from                   :   PRODUCT/longitude
cso.s5p.co.convert.output.var.longitude.attrs                  :   { 'bounds' : None }
! center latitudes; remove bounds attribute, no coordinate ...
cso.s5p.co.convert.output.var.latitude.dims                    :   pixel
cso.s5p.co.convert.output.var.latitude.from                    :   PRODUCT/latitude
cso.s5p.co.convert.output.var.latitude.attrs                   :   { 'bounds' : None }

! corner longitudes; no units in file:
cso.s5p.co.convert.output.var.longitude_bounds.dims            :   pixel corner
cso.s5p.co.convert.output.var.longitude_bounds.from            :   PRODUCT/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds
cso.s5p.co.convert.output.var.longitude_bounds.units           :   degrees_east
! corner latitudes, no units in file:
cso.s5p.co.convert.output.var.latitude_bounds.dims             :   pixel corner
cso.s5p.co.convert.output.var.latitude_bounds.from             :   PRODUCT/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds
cso.s5p.co.convert.output.var.latitude_bounds.units            :   degrees_north

! original track:
!~ center lon; remove bounds attribute, no coordinate ...
cso.s5p.co.convert.output.var.track_longitude.dims             :   track_scan track_pixel
cso.s5p.co.convert.output.var.track_longitude.special          :   track_longitude
cso.s5p.co.convert.output.var.track_longitude.from             :   PRODUCT/longitude
cso.s5p.co.convert.output.var.track_longitude.attrs            :   { 'bounds' : None }
!~ center lat; remove bounds attribute, no coordinate ...
cso.s5p.co.convert.output.var.track_latitude.dims              :   track_scan track_pixel
cso.s5p.co.convert.output.var.track_latitude.special           :   track_latitude
cso.s5p.co.convert.output.var.track_latitude.from              :   PRODUCT/latitude
cso.s5p.co.convert.output.var.track_latitude.attrs             :   { 'bounds' : None }
!~ corner lons
cso.s5p.co.convert.output.var.track_longitude_bounds.dims      :   track_scan track_pixel corner
cso.s5p.co.convert.output.var.track_longitude_bounds.special   :   track_longitude_bounds
cso.s5p.co.convert.output.var.track_longitude_bounds.from      :   PRODUCT/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds
cso.s5p.co.convert.output.var.track_longitude_bounds.units     :   degrees_east
!~ corner lats
cso.s5p.co.convert.output.var.track_latitude_bounds.dims       :   track_scan track_pixel corner
cso.s5p.co.convert.output.var.track_latitude_bounds.special    :   track_latitude_bounds
cso.s5p.co.convert.output.var.track_latitude_bounds.from       :   PRODUCT/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds
cso.s5p.co.convert.output.var.track_latitude_bounds.units      :   degrees_north

! time value per scan line
cso.s5p.co.convert.output.var.time.dims                        :   pixel
cso.s5p.co.convert.output.var.time.special                     :   time-delta
cso.s5p.co.convert.output.var.time.tref                        :   PRODUCT/time
cso.s5p.co.convert.output.var.time.dt                          :   PRODUCT/delta_time

! quality flag:
cso.s5p.co.convert.output.var.qa_value.dims                   :   pixel
cso.s5p.co.convert.output.var.qa_value.from                   :   PRODUCT/qa_value
!~ skip some attributes, cf-checker complains ...
cso.s5p.co.convert.output.var.qa_value.attrs                  :   { 'valid_min'  : None, 'valid_max'  : None, \
                                                                    'valid_min_' : None, 'valid_max_' : None }

! Convert bottom pressure half level pressures (zero at top):
cso.s5p.co.convert.output.var.pressure.dims                    :   pixel layeri
cso.s5p.co.convert.output.var.pressure.special                 :   pbottom_to_pressure
cso.s5p.co.convert.output.var.pressure.pbottom                 :   PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/pressure_levels
cso.s5p.co.convert.output.var.pressure.units                   :   Pa

! averaging kernel (processor v2.4.0 and higher):
cso.s5p.co.convert.output.var.kernel.dims                      :   pixel layer retr
cso.s5p.co.convert.output.var.kernel.from                      :   PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/column_averaging_kernel
cso.s5p.co.convert.output.var.kernel.units                     :   1
!~ skip some attributes:
cso.s5p.co.convert.output.var.kernel.attrs                     :   { 'coordinates' : None }

!! averaging kernel (processor before v2.4.0):
!! convert from kernel in m to unitless version;
!! the "layer" coordinate has values that seem the middle of 1 km layers
!cso.s5p.co.convert.output.var.kernel.dims                      :   pixel layer retr
!cso.s5p.co.convert.output.var.kernel.special                   :   kernel_by_dh
!cso.s5p.co.convert.output.var.kernel.avk                       :   PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/column_averaging_kernel
!cso.s5p.co.convert.output.var.kernel.layer                     :   PRODUCT/layer
!cso.s5p.co.convert.output.var.kernel.units                     :   1

! vertical column density:
cso.s5p.co.convert.output.var.vcd.dims                         :   pixel retr
cso.s5p.co.convert.output.var.vcd.from                         :   PRODUCT/carbonmonoxide_total_column

! error variance in vertical column density (after application of kernel),
! fill with single element 'covariance matrix', from square of standard error:
! use dims with different names to avoid that cf-checker complains:
cso.s5p.co.convert.output.var.vcd_errvar.dims                  :   pixel retr retr0
cso.s5p.co.convert.output.var.vcd_errvar.special               :   square
cso.s5p.co.convert.output.var.vcd_errvar.from                  :   PRODUCT/carbonmonoxide_total_column_precision
!~ skip standard name, modifier "standard_error" is not valid anymore:
cso.s5p.co.convert.output.var.vcd_errvar.attrs                 :   { 'standard_name' : None }

! description:
cso.s5p.co.convert.output.var.solar_zenith_angle.dims         :   pixel
cso.s5p.co.convert.output.var.solar_zenith_angle.from         :   PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle
cso.s5p.co.convert.output.var.solar_zenith_angle.units        :   degree


!======================================================================
!===
!=== listing
!===
!======================================================================

! csv file that will hold records per file with:
! - timerange of pixels in file
! - orbit number
cso.s5p.co.listing.file                :  ${my.work}/CSO-data/${my.region}/S5p/CO/${my.s5p.co.selection}__listing.csv

! renew table if file already exists?
cso.s5p.co.listing.renew               :  True

! time range:
cso.s5p.co.listing.timerange.start     :  ${my.timerange.start}
cso.s5p.co.listing.timerange.end       :  ${my.timerange.end}

! filename filters relative to listing file that should be scanned for orbit files;
! names could include time templates ;
! if same orbit is found in multiple directories, the first found is used;
! remove existing table for safety to ensure that this is done correctly ...
cso.s5p.co.listing.patterns            :  ${my.s5p.co.selection}/%Y/%m/S5p_*.nc

! extra columns to be added, read from global attributes:
cso.s5p.co.listing.xcolumns            :  orbit


!======================================================================
!===
!=== catalogue
!===
!======================================================================

! listing file with filenames/timerange.
cso.s5p.co.catalogue.input.listing               :  ${cso.s5p.co.listing.file}

! time range:
cso.s5p.co.catalogue.timerange.start             :  ${my.timerange.start}
cso.s5p.co.catalogue.timerange.end               :  ${my.timerange.end}

! target filenames; templates:
! - time values
! - %{orbit}   : from listing
! - %{varname} for variable
cso.s5p.co.catalogue.output.file                 :  ${my.work}/CSO-data-catalogue/${my.region}/S5p/CO/${my.s5p.co.selection}/%Y/%m/%d/S5p_CO_%{orbit}__%{varname}.png

! map domain (west east south north)
cso.s5p.co.catalogue.domain                      :  ${my.region.west} ${my.region.east} ${my.region.south} ${my.region.north}

! figure size (inches), default is (8,6):
cso.s5p.co.catalogue.figsize                     :  ${my.region.figsize}

! renew existing files?
cso.s5p.co.catalogue.renew                       :  False
!cso.s5p.co.catalogue.renew                       :  True

! variables to be plotted:
cso.s5p.co.catalogue.vars                        :  vcd vcd_errvar qa_value

!! color for no-data values in track, default '0.8' (gray):
!cso.s5p.co.catalogue.color_nan                   :  white

!! extra keyword arguments for map:
!cso.s5p.co.catalogue.map                         :  resolution='h'

! convert units:
cso.s5p.co.catalogue.var.vcd.units                         :  umol/m2
! style:
cso.s5p.co.catalogue.var.vcd.vmin                          :   0.0
!cso.s5p.co.catalogue.var.vcd.vmax                          :  100.0
cso.s5p.co.catalogue.var.vcd.vmax                          :  None

! show error as std.dev, convert to vcd units:
cso.s5p.co.catalogue.var.vcd_errvar.units                  :  umol/m2
! style:
!cso.s5p.co.catalogue.var.vcd_errvar.vmax                   :  100.0
cso.s5p.co.catalogue.var.vcd_errvar.vmax                   :  None

! style:
cso.s5p.co.catalogue.var.qa_value.vmin                     :   0.5
cso.s5p.co.catalogue.var.qa_value.vmax                     :   1.0
cso.s5p.co.catalogue.var.qa_value.colors                   :   ['red','yellow','green']


!-----------------------------------------------------------
! catalogue index
!-----------------------------------------------------------

! target location:
cso.s5p.co.catalogue-index.outdir                    :  ${my.work}/CSO-data-catalogue/${my.region}/S5p/CO/${my.s5p.co.selection}

! title:
cso.s5p.co.catalogue-index.header                    :  CSO catalogue
! show info on created page?
cso.s5p.co.catalogue-index.info                      :  True

! create new page for each value?
cso.s5p.co.catalogue-index.newpage                   :  True

! content type:
cso.s5p.co.catalogue-index.type                      :  list
! define row values:
cso.s5p.co.catalogue-index.name                      :  date
cso.s5p.co.catalogue-index.values                    :  TimeSeries( ${my.timerange.start}, ${my.timerange.end}, '1 day', '%Y%m%d' )

! create new page for each value:
cso.s5p.co.catalogue-index.date.newpage                   :  True
! content type:
cso.s5p.co.catalogue-index.date.type                      :  table-row
! define row values:
cso.s5p.co.catalogue-index.date.name                      :  orbit
cso.s5p.co.catalogue-index.date.values                    :  CsvFile( '%{date[0:4]}/%{date[4:6]}/%{date[6:8]}/orbits.csv' )

! content type:
cso.s5p.co.catalogue-index.date.orbit.type                :  table-col
! define column values:
cso.s5p.co.catalogue-index.date.orbit.name                :  var
cso.s5p.co.catalogue-index.date.orbit.values              :  ${cso.s5p.co.catalogue.vars}

! content type:
cso.s5p.co.catalogue-index.date.orbit.var.type            :  img
! define image:
cso.s5p.co.catalogue-index.date.orbit.var.img             :  %{date[0:4]}/%{date[4:6]}/%{date[6:8]}/S5p_CO_%{orbit}__%{var}.png
cso.s5p.co.catalogue-index.date.orbit.var.kwargs          :  height=300



!======================================================================
!===
!=== gridded orbits
!===
!======================================================================


!-----------------------------------------------------------
! gridded orbits
!-----------------------------------------------------------

! time range:
cso.s5p.co.gridded.timerange.start        :  ${my.timerange.start}
cso.s5p.co.gridded.timerange.end          :  ${my.timerange.end}
! create one gridded file per hour:
cso.s5p.co.gridded.timerange.step         :  hour

! renew existing files?
cso.s5p.co.gridded.renew                  :  True

! target directory, incl. subdir for resolution and filters:
my.gridded.dir                              :  ${my.work}/CSO-gridded/${my.region}__r01x01/S5p/CO/${my.s5p.co.selection}__${my.s5p.co.gridded-selection}

!~

! grid definition:
!~ same as pixel selection on conversion:
cso.s5p.co.gridded.grid.west              :  ${my.region.west}
cso.s5p.co.gridded.grid.east              :  ${my.region.east}
cso.s5p.co.gridded.grid.south             :  ${my.region.south}
cso.s5p.co.gridded.grid.north             :  ${my.region.north}
! resolution:
cso.s5p.co.gridded.grid.dlon              :  0.1
cso.s5p.co.gridded.grid.dlat              :  0.1

! level of recursive splitting of footprint into triangles,
! and assignment of centroids to grid cells;
! for 4-corner footprints, number of centroids is:
!  1 (levels=0), 4 (1), 8 (2), 16 (3), 64 (5), 256 (7)
cso.s5p.co.gridded.mapping.levels         :  5

!~

! keywords for source files; 
! the first one should have the footprints;
! here the only source are the converted files:
cso.s5p.co.gridded.sources                  :  data

! input files for each source type:
!~ here: specify listing file, 
!  this is only supported for a single source
cso.s5p.co.gridded.source.data.listing      :  ${cso.s5p.co.listing.file}
!!~ alternative: filename patterns with time templates,
!!  but here the source files do not have time stamps
!cso.s5p.co.gridded.source.data.filenames    :  ${my.work}/CSO-data/S5p/RPRO/CO/${my.region}/%Y/%m/S5p_*.nc

!~

! filter description:
my.s5p.co.gridded-selection                 :  qa08

! switch:
#if "${my.s5p.co.gridded-selection}" == "qa08"

! keywords for filters:
cso.s5p.co.gridded.filters                  :  quality

! minimum quality value required:
cso.s5p.co.gridded.filter.quality.var       :  qa_value
cso.s5p.co.gridded.filter.quality.type      :  min
cso.s5p.co.gridded.filter.quality.min       :  0.8
cso.s5p.co.gridded.filter.quality.units     :  1
       
#else
#error unsupported  my.s5p.co.gridded-selection "${my.s5p.co.gridded-selection}"
#endif
        
!~

! target file, might contain templates:
!   %Y,%m,etc     : time values
cso.s5p.co.gridded.output.file             :  ${my.gridded.dir}/%Y/%m/S5p_CO_%Y%m%d_%H%M_gridded.nc

! pack floats as short values?
cso.s5p.co.gridded.output.packed            :  True
! zlib compression level (default 1, 0 for no compression):
cso.s5p.co.gridded.output.complevel         :  1

! data variables to be created:
cso.s5p.co.gridded.output.vars              :  yr

! input variables:
!   data:vcd    : variable "vcd" from source "data"
cso.s5p.co.gridded.output.yr.source         :  data:vcd


!-----------------------------------------------------------
! catalogue of gridded fields
!-----------------------------------------------------------

! time range:
cso.s5p.co.gridded-catalogue.timerange.start        :  ${my.timerange.start}
cso.s5p.co.gridded-catalogue.timerange.end          :  ${my.timerange.end}
! create one gridded file per hour:
cso.s5p.co.gridded-catalogue.timerange.step         :  hour

! renew existing files?
!cso.s5p.co.gridded-catalogue.renew                  :  True
cso.s5p.co.gridded-catalogue.renew                  :  False

! target directory for catalogue:
my.gridded-catalogue.output.dir                     :  ${my.gridded.dir}/catalogue

! input files:
cso.s5p.co.gridded-catalogue.input.file             :  ${my.gridded.dir}/%Y/%m/S5p_CO_%Y%m%d_%H%M_gridded.nc
!!~ idem for daily average:
!cso.s5p.co.gridded-catalogue.input.file             :  ${my.gridded.dir}/S5p_CO_%Y%m%d_aver_gridded.nc

! target files, time tempates and variable name are replaced:
cso.s5p.co.gridded-catalogue.output.file            :  ${my.gridded-catalogue.output.dir}/%Y/%m/%d/S5p_CO_%Y%m%d_%H%M_gridded_%{var}.png
!!~ idem for daily average:
!cso.s5p.co.gridded-catalogue.output.file            :  ${my.gridded-catalogue.output.dir}/%Y/%m/%d/S5p_CO_%Y%m%d_aver_gridded_%{var}.png

! figure size (inches), default is (8,6):
cso.s5p.co.gridded-catalogue.figsize                :  (6,6)

! variables to be plotted:
cso.s5p.co.gridded-catalogue.vars                   :  yr

! variable:
cso.s5p.co.gridded-catalogue.var.yr.source          :  yr
! convert units:
cso.s5p.co.gridded-catalogue.var.yr.units           :  umol/m2
! style:
cso.s5p.co.gridded-catalogue.var.yr.vmin            :   0.0
!cso.s5p.co.gridded-catalogue.var.yr.vmax            : 100.0
cso.s5p.co.gridded-catalogue.var.yr.vmax            : None




!-----------------------------------------------------------
! gridded catalogue index
!-----------------------------------------------------------

! target location:
cso.s5p.co.gridded-catalogue-index.outdir                    :  ${my.gridded-catalogue.output.dir}

! title:
cso.s5p.co.gridded-catalogue-index.header                    :  CSO catalogue
! show info on created page?
cso.s5p.co.gridded-catalogue-index.info                      :  True

! create new page for each value?
cso.s5p.co.gridded-catalogue-index.newpage                   :  True

! content type:
cso.s5p.co.gridded-catalogue-index.type                      :  list
! define row values:
cso.s5p.co.gridded-catalogue-index.name                      :  date
cso.s5p.co.gridded-catalogue-index.values                    :  TimeSeries( ${my.timerange.start}, ${my.timerange.end}, '1 day', '%Y%m%d' )

! create new page for each value:
cso.s5p.co.gridded-catalogue-index.date.newpage              :  True
! content type:
cso.s5p.co.gridded-catalogue-index.date.type                 :  table-row
! define row values:
cso.s5p.co.gridded-catalogue-index.date.name                 :  time
cso.s5p.co.gridded-catalogue-index.date.values               :  Range( 0, 23, 1, '%2.2i00' )

! content type:
cso.s5p.co.gridded-catalogue-index.date.time.type            :  table-col
! define column values:
cso.s5p.co.gridded-catalogue-index.date.time.name            :  var
cso.s5p.co.gridded-catalogue-index.date.time.values          :  ${cso.s5p.co.gridded-catalogue.vars}

! content type:
cso.s5p.co.gridded-catalogue-index.date.time.var.type        :  img
! define image:
cso.s5p.co.gridded-catalogue-index.date.time.var.img         :  %{date[0:4]}/%{date[4:6]}/%{date[6:8]}/S5p_CO_%{date}_%{time}_gridded_%{var}.png
cso.s5p.co.gridded-catalogue-index.date.time.var.kwargs      :  height=300



