.. |vspace| raw:: latex \vspace{5mm} .. |br| raw:: html
.. _cawa_usage: ======================================= How to run the CAWA Processing Software ======================================= Test of the Installation ======================== If all installation steps described in :ref:`cawa_installation` were finished successfully, the CAWA TCWV and CTP GPF processors are now ready to run. First, test their availability with: :: $SNAP_INSTALL_DIR/bin/gpt -h The three operators - CawaTCWV.Meris - CawaTCWV.Modis - CawaCTP.Meris should now appear in the listing of available SNAP operators, together with a short description. The Pixel Classification Step ============================= The pixel classification with IdePix is applied on the L1b input products. The operators for MERIS and MODIS - Idepix.Meris - Idepix.Modis should also appear in the listing of available SNAP operators, together with a short description. A more detailed information on the distinct operator can be obtained with :: $SNAP_INSTALL_DIR/bin/gpt -h e.g. :: $SNAP_INSTALL_DIR/bin/gpt -h Idepix.Modis (see :numref:`gpt_h_idepix_modis`). .. _gpt_h_idepix_modis: .. figure:: pix/gpt_h_idepix_modis.png :align: center :scale: 80 % GPF information for Idepix MODIS operator.. Processing Parameters --------------------- The gpt command given above shows the possible IdePix processing parameters. To ensure a correct workflow towards the TCWV and CTP processing, the following IdePix processing parameters must be set as they deviate from the default (:numref:`idepix_params`): |vspace| |br| .. _idepix_params: .. table:: Processing parameters deviating from defaults for CAWA IdePix classification step. +-----------------------------+-----------------+----------------------------------------------+ | **Operator** | **Parameter** | **Value** | +=============================+=================+==============================================+ | Idepix.Meris (for TCWV) | reflBandsToCopy | reflectance_13,reflectance_14,reflectance_15 | +-----------------------------+-----------------+----------------------------------------------+ | Idepix.Meris (for CTP) | none | | +-----------------------------+-----------------+----------------------------------------------+ | Idepix.Modis (for TCWV) | outputCawaRefSB | true | +-----------------------------+-----------------+----------------------------------------------+ Applying these processing parameters, the calls for Idepix.Meris (TCWV, CTP) and Idepix.Modis (TCWV) would look like: IdePix MERIS TCWV: :: gpt Idepix.Meris -SsourceProduct= -PreflBandsToCopy=reflectance_13,reflectance_14,reflectance_15 -f NetCDF4-BEAM -t IdePix MERIS CTP: :: gpt Idepix.Meris -SsourceProduct= -f NetCDF4-BEAM -t IdePix MODIS TCWV: :: gpt Idepix.Modis -SsourceProduct= -PreflBandsToCopy=reflectance_13,reflectance_14,reflectance_15 -f NetCDF4-BEAM -t TCWV Processing =============== The TCWV processing is applied on the 'extended' IdePix products as described in :ref:`cawa_products`. The gpt command in :numref:`gpt_h_tcwv_modis` and :numref:`gpt_h_tcwv_modis` shows the possible TCWV processing parameters for MERIS and MODIS, respectively. .. _gpt_h_tcwv_meris: .. figure:: pix/gpt_h_tcwv_meris.png :align: center :scale: 80 % GPF information for TCWV MERIS operator. .. _gpt_h_tcwv_modis: .. figure:: pix/gpt_h_tcwv_modis.png :align: center :scale: 80 % GPF information for TCWV MODIS operator. Processing Parameters --------------------- The operators for MERIS and MODIS - CawaTCWV.Meris - CawaTCWV.Modis do not require any non-default parameters and are invoked via the SNAP gpt tool like: :: -SsourceProduct= -f NetCDF4-CAWA -t However, as discussed in :ref:`cawa_products`, it is strongly recommended to use IdePix 'extended' products containing ERA-Interim data which provides more realistic prior variables. If these are not available, the processor will use processor parameters for prior 2m temperature, mean sea level pressure and AOT. They can be explicitly provided by the user, so a TCWV processor call may look like: :: CawaTCWV.Meris -SsourceProduct= -Ptemperature=285.0 -Ppressure=990.0 -Paot_13=0.25 -f NetCDF4-CAWA -t However, these values would be constant for all pixels of the given scene, so the resulting TCWV retrieval may be poor. CTP Processing ============== The CTP MERIS processing is applied on the 'extended' IdePix products as described in :ref:`cawa_products`. The gpt command in :numref:`gpt_h_ctp_meris` shows the possible CTP MERIS processing options. .. _gpt_h_ctp_meris: .. figure:: pix/gpt_h_ctp_meris.png :align: center :scale: 80 % GPF information for TCWV MERIS operator. Processing Parameters --------------------- The operators for MERIS - CawaCTP.Meris does not require any non-default parameters and is invoked via the SNAP gpt tool like: :: CawaCTP.Meris -SsourceProduct= -f NetCDF4-CAWA -t Data Analysis Tools =================== SNAP Desktop Application ------------------------ The TCWV and CTP products generated within the CAWA project are provided in CFcompliant NetCDF-4/HDF5 format, which is supported by a variety of tools for further scientific analysis and processing. One of the important tools are the BEAM toolbox and its successor SNAP. BEAM is the Basic ERS & Envisat (A)ATSR and MERIS Toolbox and is a collection of executable tools and an application programming interface (API) which had been developed to facilitate the use, viewing and processing of data of various sensors. However, it is more recommended to use the latest version of the SNAP toolboxes which do not only provide most of all existing BEAM functionalities and product support, but also various new features as well as support for the new sensors onboard the Sentinel-x satellites. The SNAP desktop application is directly available after having installed SNAP as described in :ref:`cawa_installation`. .. _gpt_h_snap_desktop: .. figure:: pix/snap_desktop.png :align: center :scale: 80 % The SNAP desktop application splash screen.