# CSO - CAMS Satellite Operator

The CAMS Satellite Operator (CSO) is a tool box to facilitate assimilation of satellite observations in regional air quality models. The development of CSO is part of the Copernicus Atmospheric Monitoring Service (CAMS).

The CSO toolbox contains two main entities:

- A pre-processor written in Python that can be used to download and convert satellite data, in particular Sentinel-5p data (TROPOMI instrument).

- An observation operator written in Fortran that could be added to the source code of a simulation model. With this operator, the module could write out simulations of the satellite data and use these in a data assimilation procedure.

For a step-by-step introduction to CSO, follow the Tutorial.

# Contents

- Tutorial
  - Run script
  - Job tree
  - Running a single job step
  - Job files
  - Step 1 - Inquire S5p archive
  - Step 2 - Convert to CSO format
  - Step 3 - Example plot
  - Step 4 - Create listing file
  - Step 5 - Catalogue of figures
  - Step 6 - Demo program for observation operator
  - Step 7 - Catalogue of simulation output
  - Step 8 - Demo with MPI parallel domain decomposition
  - Step 9 - Gridded averages
  - Step 10 - Update documentation
- Sentinel-5p NO2 data processing
  - Product description
  - Averaging kernels
  - CSO processing
  - Inquire Sentinel-5p/NO2 archives
  - Conversion to CSO format
  - Listing file
  - Catalogue
  - Configuration of observation operator
  - Sim-Catalogue
- Sentinel-5p SO2 data processing
  - Product description
  - CSO processing
  - Inquire Sentinel-5p/SO2 archive
  - Conversion to CSO format
  - Listing file
  - Catalogue
  - Configuration of observation operator
  - Sim-Catalogue
- Sentinel-5p SO2-COBRA data processing
  - Product description
  - CSO processing
  - Inquire Sentinel-5p/SO2-COBRA archive
  - Conversion to CSO format
  - Listing file
  - Catalogue
- Sentinel-5p HCHO data processing
  - Product description
  - CSO processing
  - Inquire Sentinel-5p/HCHO archive
  - Conversion to CSO format
  - Listing file
  - Catalogue
  - Configuration of observation operator
  - Sim-Catalogue
- Sentinel-5p CO data processing
  - Product description
  - CSO processing
  - Inquire Sentinel-5p/CO archive
- Sentinel-5p CHOCHO data processing
  - Product description
  - Download GlyRetro data
  - CSO processing
  - Inquire archives
  - Conversion to CSO format
- Sentinel-5p O3 data processing
  - Product description
  - CSO processing
  - Inquire Sentinel-5p/O3-profile archives
  - Conversion to CSO format
- Synthetic Sentinel-4 NO2 data processing
  - Product description
  - Downloading
  - Configuration of observation operator
- VIIRS AOD data processing
  - Product description
  - CSO processing
  - Inquire VIIRS archives
  - Download VIIRS AOD data
- Observation operator
  - Retrieval simulation equations
  - Notations
  - Requirements
  - Source code overview
  - Compiling and running tutorial
  - Initialization
  - Logging
  - MPI parallel code
  - Settings for test program
  - Listing file
  - Satellite data
  - Simulation state definition
  - Horizontal mapping
  - User defined variables
  - Formula application
  - Output files
  - Catalogue of simulations
  - Gradient computation
- Gridding
  - Create gridded fields
  - Catalogue of gridded fields
  - Averages over time
  - Aggregations over regions
- Super-observations
  - Create super-observations
- Co-locating
  - Collect co-located pixels
  - Plot timeseries over co-located pixels
- Data portals
- Python modules
  - CSO modules
  - Tools
- History and future
  - Versions
  - To be included
  - To be done
  - How to create a version tag
- Documentation
  - Generation
  - Source files
  - Installation of Sphinx
  - Configuration
  - How to add a new module to the documentation?
  - Online publication with Gitlab Pages

# Indices and tables

- Index

- Module Index

- Search Page