ESA > Join & Share > GPOD > GPOD SMOS L2OS Processor User Manual

GPOD SMOS L2OS Processor User Manual

The GPOD SMOS Level2 Ocean Salinity (SMOSL2OS) Service provides time-driven and data-driven scheduled processing of SMOS Level 1C products into Level 2 Ocean Salinity products. The service can also be used for on-demand.

1.1        Applicable Documents


SMOS L2 OS Operational Processor Software User Manual
SO-MA-ARG-GS-0018 1.13, 27 May 2011


SMOS L2 OS Detailed Processing Model
SO-TN-ARG-GS-0008, L2OS-DPM, ver. 2.10, 27 May 2011


SMOS L2 OS Input/Output Data Definition
SO-TN-ARG-GS-0009, L2OS-IODD, ver. 2.19, 9 May 2011


SMOS L2 OS Operational Auxiliary Data Files Configuration Control
SO-CS-ARG-GS-0039, L2OS-ADFCC v1.18, 8 June 2011


SMOS L2 OS Operational Processor Software Release Document
SO-RN-ARG-GS-0019, OPSRD, v2.15, 9 June 2011


1.2        Terms, Definitions and Abbreviated Terms



European Centre for Medium-range Weather Forecasting


Grid Processing-on-Demand


Institut français de recherche pour l'exploitation de la mer


Institut Pierre Simon Laplace


Microwave Imaging Radiometer using Aperture Synthesis


Ocean Salinity


Practical Saline Unit


Resource Description Framework


Soil Moisture and Ocean Salinity Mission (European Space Agency Earth Explorer Mission)


Sea Surface Salinity



1.3        Background

The Ocean Salinity processor version 5.00 integrated into G-POD generates Level 2 Sea Surface Salinity SMOS products MIR_OSUDP2 and MIR_OSDAP2 and quality control data. The Ocean Salinity processor takes as input Level 1C products, either:

·         MIR_SCSD1C – Science Data, Sea, Dual polarization, or

·         MIR_SCSF1C – Science Data, Sea, Full polarization

and as many as 22 auxiliary files:

1.                    AUX_FLTSEA - Physical Constants needed by Flat Sea Model

2.                    AUX_RGHNS1 - Roughness lookup tables for the IPSL ocean roughness model

3.                    AUX_RGHNS2 - Ifremer ocean roughness model lookup tables

4.                    AUX_RGHNS3 - ICM/Ciencias del Mar roughness model lookup tables

5.                    AUX_FOAM__ - Physical constants need by the foam model

6.                    AUX_SGLINT - Bistatic scattering coefficients used for sunglint correction

7.                    AUX_ATMOS_ - Physical constants used by atmospheric model

8.                    AUX_CNFOSD - Processor configuration parameters for L2 Ocean Salinity, Dual Polarisation

9.                    AUX_CNFOSF - Processor configuration parameters for L2 Ocean Salinity, Full Polarisation

10.                  AUX_DISTAN - Distance to the coast and monthly sea/ice flag info over the Discrete Global Grid (DGG)

11.                  AUX_SSS___ - Monthly Sea Surface Salinity over Discrete Global Grid

12.                  AUX_ECMWF_ - ECMWF data on the ISEA 4-9 Discrete Global Grid DGG corresponding to SMOS halforbit

13.                  AUX_DGG__  - Discrete Global Grid used in geolocation (ISEA4-9)

14.                  AUX_OTT1D_ - Ocean Target Transformation Lookup tables for the IPSL ocean roughness model  - Dual Polarisation

15.                  AUX_OTT1F_ - Ocean Target Transformation Lookup tables for the IPSL ocean roughness model  - Full Polarisation

16.                  AUX_OTT2D_ - Ocean Target Transformation Lookup tables for the Ifremer ocean roughness model - Dual Polarisation

17.                  AUX_OTT2F_ - Ocean Target Transformation Lookup tables for the Ifremer ocean roughness model -  Full Polarisation

18.                  AUX_OTT3D_ - Ocean Target Transformation Lookup tables for the Ciencias ocean roughness model - Dual Polarisation

19.                  AUX_OTT3F_ - Ocean Target Transformation Lookup tables for the Ciencias ocean roughness model - Full Polarisation

20.                  AUX_FARA_x - Faraday Angle based on refined VTEC

21.                  AUX_BULL_B - IERS Bulletin B used to initialise ESA EARTH EXPLORER CFI functions

22.                  AUX_MISP__ - Orbit mispointing used to initialise ESA EARTH EXPLORER CFI functions

23.                  AUX_BFP__  - Orbit best fit plane used to initialise ESA EARTH EXPLORER CFI functions

 In addition, the following files are also required for the Ocean Salinity processor:

·         the Task Table configuration file (SM_OPER_CNF_TSKTBL_20080801T000000_20500101T000000_vvv_rrr_1.xml1)

·         the private configuration file (SM_TEST_CNF_L2OS___20050101T000000_20500101T000000_001_rrr_s.EEF)

·         a joborder (SM_TEST_MPL_JOBORD_20050101T000000_20500101T000000_002_nnn_s.XML)

The auxiliary files are chosen according to a set of orchestration rules: each auxiliary file must have start-stop times that fully cover the input product, as well as being the latest generated, with the exception of OTTs (Ocean Target Transformations) which must also match the processing version of the Level 1C input products. Processor configuration files are always the latest version available.



1 Example filename only. In the filename, the placeholder x designates either F or D, for Full or Dual Polarisation; vvv indicates version and rr indicates release number of the configuration file; nnn indicates file counter and s site instance ID, for example '5' for G-POD joborders.

To set up an on-demand task:

Click on the Services button in the top menubar and search for SMOS.

In the results, click on the Ocean Salinity service:

In the service input page that is then displayed:



fill in the start and stop dates, a diagnostic site if desired, and click on the Query button. Input products matching your criteria are identified and shown in the results table mid-page.

Select the products you wish to process.

Then, scroll down to the Processing Parameters pane. Enter three digits, for example 009, in the field. This file version number will identify your results, so that you can easily match them with your set of configuration parameters.

The field is used by the Ocean Salinity task as it inserts processed results into the SMOS catalogue. The same goes for the quicklook server.

 For example, if the publish server is:


Results will appear on the machine elba under /EO_DATA/MIR_OSDAP2/YYYY/MM

You could configure an onlineResource URL:


The onlineResource URL could be:


You could configure a quicklook URL, for example:


The quicklook URL in the catalogue could then be:



If you wish to use a custom , a custom and/or a custom , you should load the default versions and modify them as you wish in the text area.

It is a good idea to save your custom configuration files server-side for future use and reference by clicking on the pencil button:


which activates a “Save” dialogue. Insert a name for your file and click on the icon of the floppy disk to save your configuration file server-side.


Finally press the Process It! button, or the Save in Workspace button if you prefer to save the task parameters for submission later.


To set up time-driven scheduled processing:

Log in to the GPOD portal with a user account which is enabled for scheduled processing, click on

Once the SMOS L2 SM Scheduler page is displayed, manually enter $(EXECDATE) and $(EXECDATE)+1D in the two fields under the