# `cso_inquire` module

The `cso_inquire` module provides some general classes to support inqueries of data portals.

## Class hierchy

The classes and are defined according to the following hierchy:

- `UtopyaRc`

  - `CSO_Inquire_Plot`

## Classes

class cso_inquire.CSO_Inquire_Plot(rcfile, rcbase='', env={}, indent='')

  Bases: `UtopyaRc`

  Create plot of data version versus time to indicate the available orbits.

  The information on orbits is taken from a csv table created by for example the `CSO_DataSpace_Inquire` class. Specifify the name of the table file in the settings:

      ! listing file:
      <rcbase>.file     :  ${my.work}/Copernicus/Copernicus_S5p_NO2_%Y-%m-%d.csv

  The date templates are by default filled for the current day. Alternatively, specify an explicit date:

      !~ specify dates ("yyyy-mm-dd") to use historic table:
      <rcbase>.filedate  :  2022-01-28

  The plot could also be created by combining multiple tables; use a semi-colon to seperate the file names (and eventually the dates):

      ! listing files:
      <rcbase>.file       :  ${my.work}/Copernicus/Copernicus_S5p_NO2_%Y-%m-%d.csv ; \
                             ${my.work}/Copernicus/Copernicus_S5p_NO2_pal_%Y-%m-%d.csv
      !~ specify dates ("yyyy-mm-dd") to use historic tables:
      !<rcbase>.filedate  :  2022-01-28 ; 2022-01-28

  The created plot shows a time line and on the vertical ax the processor versions; a bar indicates when a certain version was used to process orbits:

  Specify the name of the target plot:

      ! output table, date of today:
      <rcbase>.output.file            :  ${my.work}/Copernicus_S5P_NO2_%Y-%m-%d.png

  Optionally define a creation mode for the (parent) directories:

      ! directory creation mode:
      <rcbase>.dmode                         :  0o775

  The following flag is used to ensure that the plot is renewed:

      ! renew existing plots?
      <rcbase>.renew                    :  True