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

doc/source/colocate.rst

0 → 100644
+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.

doc/source/documentation.rst

+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>`_

doc/source/figs/HCHO/timeseries_001.png

0 → 100644
+59.9 KiB
Loading image diff...

doc/source/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -39,6 +39,7 @@ Contents 
   obsoper

   gridding

   superobs

   colocate

   pymods

   history

   documentation

doc/source/pymod-cso_colocate.rst

0 → 100644
+5 −0
Original line number Diff line number Diff line 
.. Documentation for module.



.. Import documentation from ".py" file:

.. automodule:: cso_colocate