TNO Intern

Commit aea2ad8a authored by Arjo Segers's avatar Arjo Segers
Browse files

Added tools to collect and plot time series of co-located pixel averages.

parent 963bb1c5
Loading
Loading
Loading
Loading
+65 −0
Original line number Diff line number Diff line

.. Label between '.. _' and ':' ; use :ref:`text <label>` for reference
.. _colocate:

***********
Co-locating
***********

The CSO package contains a tool to collect pixels that are
*co-located* with (for example) observaton sites.


Collect co-located pixels
=========================

The CSO post processing tools could be used to create grid averages.

The configuration of a co-location job looks like::

    ! single step:
    cso.gridded.class        :  utopya.UtopyaJobStep
    ! co-location collection task:
    cso.gridded.task.class   :  cso.CSO_CoLocate
    cso.gridded.task.args    :  '${PWD}/rc/settings.rc', \
                                          rcbase='cso.colocate'

The actual work is done by the :py:class:`.CSO_CoLocate` class,
see its description for details on the configuration.

The input for co-location is:

* a csv table with location information (names, longitudes, and latitudes)
* CSO files with pixel data

The result is a set of files with time series of averages over pixels
within a distance of the selected locations::

  timeseries_202001_daily.nc
  timeseries_202002_daily.nc
                  :


Plot timeseries over co-located pixels
======================================

The :py:class:`.CSO_CoLocatePlotTimeSeries` class could be used
to create plots of time series from the output of the 
:py:class:`.CSO_CoLocate` class.

The configuration of a co-location job looks like::

    ! single step:
    cso.gridded.class        :  utopya.UtopyaJobStep
    ! catalogue creation task:
    cso.gridded.task.class   :  cso.CSO_CoLocatePlotTimeSeries
    cso.gridded.task.args    :  '${PWD}/rc/settings.rc', \
                                          rcbase='cso.colocate-plot'

The following is an example of a timeseries plot that shows averages
over co-located pixels with 100 km of a site for at daily and hourly resolution:

.. figure:: figs/HCHO/timeseries_001.png
   :scale: 70 %
   :align: center
   :alt: Timeseries of averages over pixels collected within 100 km of site.
+1 −0
Original line number Diff line number Diff line
@@ -50,6 +50,7 @@ The source tree of the documentation files is:
  * `pymod-cso_constants.rst <../../source/pymod-cso_constants.rst>`_
  * `pymod-cso_file.rst <../../source/pymod-cso_file.rst>`_
  * `pymod-cso_gridded.rst <../../source/pymod-cso_gridded.rst>`_
  * `pymod-cso_colocate.rst <../../source/pymod-cso_colocate.rst>`_
  * `pymod-cso_plot.rst <../../source/pymod-cso_plot.rst>`_
  * `pymod-cso_s5p.rst <../../source/pymod-cso_s5p.rst>`_
  * `pymod-cso_scihub.rst <../../source/pymod-cso_scihub.rst>`_
+59.9 KiB
Loading image diff...
+1 −0
Original line number Diff line number Diff line
@@ -39,6 +39,7 @@ Contents
   obsoper
   gridding
   superobs
   colocate
   pymods
   history
   documentation
+5 −0
Original line number Diff line number Diff line
.. Documentation for module.

.. Import documentation from ".py" file:
.. automodule:: cso_colocate
Loading