Data input
==========
The data input component provides functions for reading remote sensing images,
hotspot locations and (effective) wind fields.

Source databases
----------------
The location and type of emission sources are used input for plume detection and
emission quantification. *ddeq* uses xarray datasets to store point source
information. The dataset contain source names (`source'), longitudes (`lon_o'),
latitudes (`lat\_o'), labels for visualization (`label') and source types (`type').

*ddeq* includes a small list of sources as a comma-separated values (CSV) file
that primarily contains cities and power plants used in previous studies. 
User-defined files containing other sources can be prepared in the same format. 

The CSV file can be read with the following function:

.. autofunction:: ddeq.misc.read_point_sources


In addition, *ddeq* includes the CoCO2 global emission point source database:

.. autofunction:: ddeq.coco2.read_ps_catalogue


Remote sensing images
---------------------
Sentinel-5P/TROPOMI images can read using `xr.open_dataset` after being downloaded
and prepared by `ddeq.download_S5P`

.. autofunction:: ddeq.smartcarb.read_level2

.. autofunction:: ddeq.coco2.read_level2


Wind fields
-----------

.. autofunction:: ddeq.wind.read_at_sources

.. autofunction:: ddeq.wind.read_field