Title: SMOS L2 OS Operational Processor Software User Manual
Contents
1. 145 145 145 146 146 147 147 Doc SO MA ARG GS 0018 Operational Issue 1 Rev 7 Page 24 TOOLS C fail to memory for matrix st tools c sumMat function with the same dimensions transposeMat function allocate Function that generates the error and possible error description inputs matrices are not tools c sumMat function fail to allocate memory for matrix sum tools c diffMat function inputs matrices are not With the same dimensions tools c diffMat function for matrix dirf tools c prodMat function input matrices are not with compatible dimensions fail to allocate eee tools c prodMat function fail to allocate memory P matrix prod tools scalProdMat function fail to allocate eei for matrix scalProd tools c keepDiagMat function dimensions of input o are not equal tools c keepDiagMat function fail to allocate Bea for matrix diag tools c inverseMat function dimensions of input facets are not equal COOLS Cy inverseMat function fail to allocate Pens for matrix lIl COOLS C inverseMat function fail to allocate mere fOr matrix ill tools c inverseMat function ll matrix is not eooo positive interpHermit c not enough sampling in the deena for Hermit interpolation interpHermit c index for interpolation is not E iterativeScheme c fail to allocate memory for Baa X retrieval with all polarisations iterativeScheme c fail to allocate me2. bias 2 correction ial first Cannot write main header of OSDAP2 Cannot set element data Function that generates the error and possible error description absolute uncertainty relative uncertainty bias 1 correction on guess of not exist index for index for index Lor index Lor Internal Error Name of return code No L2 product generation FRROR_CODE_FORWARD_MODEL SUPPORT_INITATTITUDEMODEL_ XL CHANGE _ CART_CS_X1 KRROR_CODE_FORWARD_MODEL_SUPPORT_INITATTITUDEMODEL_XL_ CHANGE _ CART_CS_Y1 FRROR_CODE_FORWARD_MODEL SUPPORT_INITATTITUDEMODEL XL CHANGE _ CART_CS_Z1 BRROR_CODE FORWARD MODEL SUPPORT_INITATTITUDEMODEL_ ALL OCMAT_TOD_J2000 BRROR_CODE FORWARD MODEL SUPPORT_INITATTITUDEMODEL QUA TERNIONS_TO_VECTORS KRROR_CODE_FORWARD_MODEL_ SUPPORT_INITATTITUDEMODEL_ ALL OCMAT_U FRROR_CODE_FORWARD_MODEL SUPPORT_INITATTITUDEMODEL_ ALL OCMAT_MAT BKRROR_CODE FORWARD MODEL SUPPORT _INITATTITUDEMODEL PRO DMAT KRROR_CODE FORWARD _ MODEL SUPPORT _INITATTITUDEMODEL_ XP_ ATTITUDE _INIT BRROR_CODE FORWARD MODEL SUPPORT_INITATTITUDEMODEL_XP_ ATTITUDE USER _ SET ERROR CODE FORWARD MODEL SUPPORT_INITATTITUDEMODEL XL _ CART_TO_GEOD_1 KRROR_CODE FORWARD MODEL SUPPORT_INITATTITUDEMODEL XL _ CART_TO_GEOD_2 ERROR _CODE TOOLS _CFIDATEFPUNCTIONS_PROCESSINGFROMTRANSP ORTTIME ERROR CODE TOOLS CPIDATEFUNCTIONS FRROR_CODE_FORWARD_MODEL SUPPORT_COMPUTEGEOMETRY_NOMEA SUREMENT BRROR_CODE FORWARD MODEL SUPPORT _COMPUTE
3. use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_SGLINT Bi Static Scattering Coefficients Look Up Table used in Sun glint correction o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_SGLINT validity start time MIR_SCSx1C_ sensing stop time lt AUX_SGLINT validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_SSS___ Monthly Sea Surface Salinity over Discrete Global Grid o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_SSS____ validity start time MIR_SCSx1C_ sensing stop time lt AUX_SSS___ validity stop time f multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o MPL _ORBSCT Orbit scenario used to initialise ESA EARTH EXPLORER CFI functions o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt MPL_ORBSCT validity start time MIR_SCSx1C_ sensing stop time lt MPL_ORBSCT validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 a y ICM CSIC Ss cy LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Da
4. All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS poc SO MA ARG GS 0018 Ss See ae Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 30 Internal Error Name of return code No L2 product generation Exit Function that generates the error and possible error description code RETURN_CODE_CANCEL_ORDER 299 Order cancelled via Ctrl C or cancel xml All rights reserved ARGANS ACRI st 2008 2009 ICM CSIC SMOS L2OS _ oc O MA ARG GS 0018 LOCEAN SA CETP Operational eo Rev IFREMER Processor Software Date 29 June 2009 User Manual Page 31 E ARGANS 7 GSL Log INFO Messages The SMOS L2 SSS processor outputs several types of log messages advance info debug warning amp error The default setting for the Log_Level specified in the job order is INFO at this level it is required that a limit of approximately 10 INFO log messages are sent to the GSL in addition to the advance messages and any error or warning messages During normal processing exactly 102 ADVANCE messages are generated START END and 100 progress messages ERROR messages result in processor termination Any number of WARNING messages may be issued during processing The following INFO messages are sent to the GSL in this sequence if there are no processing errors INFO message Notes Start of processing Immediately after A 000_STA_OOO Number of gridpoints selected for proces
5. IT Ly check_validity_period c invalidity period of the Eoo 1723 readLut c Unable to read a Lut Sy readLut c fail to allocate memory for a LUT La readXmlFunctions c faa to get Product informations Las getMonthFromTransportTime c fail to retrieve month of the year from time given in EECFI transport time format iep RADec c fail to compute right ascension and declination LTO mathematical exception I read tmosifTfectLUT c Cannot find a node in file readAtmoskffectLUT c Error occured in oe readAtmosEffect LUI function All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS Doe SO MA ARG GS 0018 ne ate Operational Issue 1 Rev 7 ARGANS sae ei ne Processor Software Date 29 June 2009 User Manual Page 29 Internal Error Name of return code No L2 product generation Exit Function that generates the error and possible error description code Fo 178 readFlatSeaCoer c Cannot find a node in file DE ERROR CODE READ INPUTS DATA SELECTION READFLATSEA 178 r adF latSeaCoert c Error occured in readFlatSeacCoef Pe ERROR CODE READ INPUTS DATA SELECTION READSSSLUT_NOOPE 179 readSSSLUT c Cannot get information of product F Eo Foa a atin 179 readSSSLUT c Cannot load data for SSSLUT A ERROR CODE READ INPUTS DATA SELECTION READTHRESHOLDS N 180 readThresholds c Cannot get information of product OOPEN CNFLOS2 ERROR CODE READ INPUTS DATA SELECTION READTHRESHOLDS_N 180 readTh
6. L2 OS Doe SO MA ARG GS 0018 ne ate Operational Issue 1 Rev 7 ARGANS sae ei ne Processor Software Date 29 June 2009 User Manual Page 26 Internal Error Name of return code No L2 product generation Exit Function that generates the error and possible error description code ERROR CODE READ INPUTS DATA SELECTION READFOAMLUT READ 154 readFoamLUT c Cannot get Min or Max Valid Bertone ERROR CODE READ INPUTS DATA SELECTION READFOAM NOLUT 154 readFoamLUT c Cannot read Foam LUT ERROR_CODE READ INPUTS DATA SELECTION _READGALACTICMAP _ loa readGalacticMap c Cannot read GalacticMap LUT ERROR CODE READ INPUTS DATA SELECTION READAUXDATAPROCL 156 readAuxDataProcLUT c Cannot read AuxDataProc LUT Ul NOLUT ERROR _CODE READ INPUTS DATA SELECTION _READAUXDATAPROCL 150 readAuxDataProcLUT c Cannot get product UT_NOOPEN informations of AuxDataProc from CNFOS2 ERROR CODE READ INPUTS DATA SELECTION _INITIMEMODEL NON 157 initTimeModel c Cannot get node ODE FRROR_CODE READ INPUTS _DATA SELECTION_INITIMEMODEL NOO initTimeModel c Cannot open Time Model product PEN ERROR CODE READ INPUTS DATA SELECTION INITIMEMODEL NOD aa initTimeModel c Cannot load a Time Model ATA ERROR CODE READ INPUTS _ DATA SELECTION _READDGG _NODATA 158 readDgg c Cannot get data from file ERROR CODE READ INPUTS DATA SELECTION READDGG L58 readDgg c Error occured in readDgg function ERROR_CODE_READ_INPUTS_DATA_SELECTION_READDGG_NOOPEN 158 readDgg c Ca
7. as described in AD xx e To launch OS processing the Job Order must contain o one MIR SCSxIC Product o the following Auxiliary data files AUX_ATMOS_ AUX_CNFOSx AUX_DGG__ AUX_DISTAN AUX_ECMWF_ AUX_FOAM__ AUX_FLTSEA AUX_GAL_OS AUX_GAL20S AUX_RGHNS1 AUX_RGHNS2 AUX_RGHNS3 AUX_SGLINT AUX_SSS___ MPL_ORBSCT o Related Task_Table Llc sea to L2 OS processing All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS _poc SO MA ARG GS 0018 Operational Issue 1 Rev 7 Processor Software Date 29 June 2009 User Manual Page 13 E j ICM CSIC d LOCEAN SA CETP IFREMER ARGANS 3 Main Input Product One MIR_SCSx1C 4 Triggering Ingestion of a MIR_SCSxIC in the PDPC Core PAS 5 List of supporting products needed o AUX_ATMOS_ Physical Constants used by Atmospheric Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_ATMOS_ validity start time MIR_SCSx1C_ sensing stop time lt AUX_ATMOS_ validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_CNFOSx Processor Configuration Parameters for L2 Ocean Salinity o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_CNFOSx validity start time MIR_SCSx1C_ sensing stop time lt AUX_CNFOSx validity stop time The x of the AUX _CNFOSx filename is the same as the x in the MIR_SCSx1C_ fi
8. products CNF_ L20S __ 5 3 3 The main configuration file AUX_CNFOSD The main configuration file for dual polarisation is OM_OPER_AUX_CNFOSD_20050101T000000_20500101T000000_vvwv_rrr_8 EEF All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 4 ICM CSIC R GS LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 18 vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in SMOS_ROOT smos products AUX_ CNFOSD All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS _ poc SO MA ARG GS 0018 E j ICM CSIC O owi E LO LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 Page 19 User Manual 6 Return codes When the processor stops it returns with a specific code The return code may help targeting the origin of errors Below is a list of return codes and identification of the error source Two special return codes are 0 for normal termination of the processing and 255 when the processing is cancelled Other return codes are groupes in two categories If the return code is lower than 127 L2 output products may be incomplete Above 128 the return code indicates that no L2 output product is generated but product reports containing errors amp warnings are still produced by the processor
9. 2009 User Manual Page 6 E j ICM CSIC d LOCEAN SA CETP IFREMER ARGANS 1 Introduction 1 1 General This document is the user manual of the SMOS L2 SSS core processor The core processor has been developed to be operated on Linux 64 bit platforms It is operated from the command line interface provided the configuration of the processor is valid Configuration of the software includes many files switches selectors and parameters that are delivered in the distribution packages 1 2 Guide to this document This document addresses the L2 OS core processor installation and use For detailed information on the processor numerous documents are released along with the software For scientific aspects of the SMOS L2 OS processing see the Algorithm Theoretical Baseline Document R D 1 For inputs and output data including the configuration files see the L2 products specification document R D 4 and the SMOS L1 auxiliary data specification format R D 13 For details on the data processing see the Detailed Processing Model R D 3 For details on the material released along with the processor see the Operational Processor Software Release Document SO RN ARG GS 0019 1 3 Applicable Documents The list of applicable documents is available in the Operational Processor Software Release Document SO RN ARG GS 0019 1 4 Reference Documents The list of reference documents is available in the Operational Processor Sof
10. 8 _ For V4 pre QR 3 17 12 2008 Post V4 pre QR update 06 03 2009 For V4 FAT 5 6 03 04 2009 Post V4 FAT 1 4 17 02 2009 For V4 TRR Lo Lt Issue Revision Date Description as 0 15 02 2008 First version of the document Version 1 0 SO MA ACRI GS 4424 to version 1 1 SO MA ACRI GS 4424 Page Section Comments 8 2 2 Binary executable file updated Version 1 1 to version 1 2 SO MA ARG GS 0018 13 11 2008 Page Comments all all Reformatted header footer amp title pages for ARGANS 4 Added new chapter on L2 OS dependency model orchestration 5 Added task tables amp updated operational configuration tables 5 2 3 amp Updated main configuration files AAUX_CNFOSF amp 5 3 3 AUX_CNFOSD 3 23 Updated private configuration file CNF_L2OS__ 7 New section listing GSL log messages added Version 1 2 to version 1 3 SO MA ARG GS 0018 Page Comments this Added doc ID to change record pre QR RID jcd 101 5 1 1 Correction amp replaced reference pre QR RID jcd 102 7 3 2 3 2 1 Red Hat Version amp prototype typo corrected References to SO Ses RN ARG GS 0019 added pre QR RID jcd 104 10 4 1 Corrections to AUX_ file names amp validity time duration pre OR RID jcd 105b 6 Exit code replaced by return code pre QR RID jcd 105 7 Clarification of info warning amp error m
11. 9 User Manual Page 14 E j ICM CSIC d LOCEAN SA CETP IFREMER ARGANS o AUX_FOAM_ Physical Constants used by Foam Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_FOAM ___ validity start time MIR_SCSx1C_ sensing stop time lt AUX_FOAM__ validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_FLTSEA Physical Constants needed by Flat Sea Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_FLTSEA validity start time MIR_SCSx1C_ sensing stop time lt AUX_FLTSEA validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_GAL_OS AUX_GALAXY Map convolved with the Weighting Function AUX_ WEF o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_GAL_OS validity start time MIR_SCSx1C_ sensing stop time lt AUX_GAL_OS validity stop time f multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_GAL20S AUX_GALAXY Map 2 convolved with the Weighting Function AUX_ WEF___ o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_GAL2OS validity start time MIR_SCSx1C_ sensing stop time lt AUX_GAL2OS validity stop time If multip
12. ANGLE XPTARGET STATION KRROR_CODE FORWARD MODEL SUPPORT COMPUTEANGLE XPTARGET EXTRAMAIN E ICM CSIC w LOCEAN SA CETP ARGANS IFREMER SMOS L2 OS Operational Processor Software Date 29 June 2009 User Manual Exit code LoL 131 1l Le e Lol jike A 131 ie aie Lol Lois lody ie Sl ds a Lo Loy Loy Loo Doc SO MA ARG GS 0018 Issue 1 Rev 7 Page 22 Function that generates the error and possible error description FUNCTION xX unit vector FUnCE LON Y unit vector FUNCT LON ZA unit vector initAttitudeModel c EE CFI XL CHANGE CART CS returns in error for initAttitudeModel c EE CFI XL CHANGE CART CS returns in error for initAttitudeModel c EE CFI XL CHANGE CART CS returns in error for initAttitudeModel c fail to allocate memory for TOD J2000 matrix initAttitudeModel cC EE CFI FUNCTION xl_quaternions_to_vectors returns in error initAttitudeModel c fail to allocate memory for matrix initAttitudeModel c fail to allocate memory for matrix mat initAttitudeModel c of matrices Error while computing product initAttitudeModel c EE CEL function XP_ATTITUDE_INIT returns in error initAttitudeModel c EE CEI FUNnCL ion XP_ATTITUDE_USER_SET returns in error initAttitudeModel c EE CFI function XL_CART_TO_GEOD returns in error for first snapshot initAttitudeModel c EE CFI Tunction XL_CART_TO_GEOD returns in error for last snapshot CFIDateFunctions c getProcessin
13. DATA_PROCESSOR_GHOPHYERRORANDBIAS_ INDEX WEIGHT_DIM2 ERROR _ CODE_AUX_DATA_PROCESSOR_GHOPHYERRORANDBIAS_ INDEX DIM RROR CODE_AUX_DATITA PROCESSOR GEOPHYERRORANDBILAS_INDEX E _DIM4 ia CODE_AUX_DATA_PROCESSOR_APPLYBEFG_BIAS2 Exit code 128 F L22 dane 129 Ly 130 LaO Loy t20 129 Page 21 product Doc SO MA ARG GS 0018 Issue 1 Rev 7 Processor Software Date 29 June 2009 User Manual Function that generates the error and error description writeUDPFile c Cannot set outer dimension writeUDPFile c writeUDPFile c writeUDPFile c product setHlementData c main n c executable applLyBEPG c On prior apply BEPG lt sc On Prior applyBEFG c applyBEFG c appLlyBEPrG c geophyErrorAndBias geophyErrorAndBias interpolation along geophyErrorAndBias interpolation along geophyErrorAndBias interpolation along geophyErrorAndBias interpolation along All rights reserved ARGANS ACRI st 2008 2009 wrong number unable to unable to unable to geophysical parameter unable to compute geophysical parameter unable to geophysical parameter c Look Up Table does Cannot get node Cannot get check sum of data block of arguments compute compute compute compute Cy Computation of dimension 1 failed ew Computation of dimension 2 failed Tor Computation of dimension 3 failed Cy Computation of dimension 4 failed passed to the
14. Internal Error Name L2 ouput product may be incomplete Return Function that generates the error and error description code E 8 writeFixedHeader c Cannot set data in fixed header TA ERROR CODE WRITE OUTPUTS WRITEUDPFILE GETHEADER 9 writeUDPFile c Cannot get OSUDP2 header All rights reserved ARGANS ACRI st 2008 2009 ERROR CODE WRITE OUTPUTS _WRITEUDPFILE EDITPRODUCT 10 writeUDPFile c Cannot edit product SUDP2 ERROR_CODE_ WRITE OUTPUTS _WRITEKUDPFILE NODELETE Lly writeUDPFile c Cannot delete object ERROR_CODE_WRITE_OUTPUTS_WRITEUDPFILE_GETDATASET 12 writeUDPFile c Cannot get data set of OSUDP2 Raa product ERROR CODE WRITE OUTPUTS WRITEUDPFILE GETDATASETRECORD 13 writeUDPFile c Cannot get data set record of OSUDP2 product ERROR CODE WRITE OUTPUTS WRITEUDPFILE WRITEDATASETRECO 14 writeUDPFile c Cannot write data set record for RD OSUDP2 product ERROR CODE WRITE OUTPUTS WRITEUDPFILE SKETELEMENTDATA lo meee writeUDPFile c Cannot set data for OSUDP2 product ERROR CODE _WRITEHE OUTPUTS WRITESPECIFICHEADER_ GETNODE Bop writeSpecificProductHeader c Cannot get node while Eo SPH ERROR_CODE_WRITE_OUTPUTS_WRITEMAINHEADER_GETNODE IN writeMainHeader c Cannot get Node while writing Bee product header ERROR CODE WRITE OUTPUTS WRITEFIXEDHEADER_ GETNODE 18 writeFixedHeader c Cannot get Node while writing Fee header BRROR_ CODE WRITE OUTPUTS_WRITESGPECIFPICHEADER SE TOUTERD 19 writeSpecificProductHeader c Cannot set ou
15. LOCK 43 writeUDPFile c Cannot create data block ERROR CODE WRITE OUTPUTS _WRITEDAPP ILE WRITEPRIORANDSIG 44 writeUDPFile c Cannot write prior and sigma MA ERROR __ CODE_WRITE_OUTPUTS_WRITEDAPF ILE WRITEESTIMANDSIG 43y writeUDPFile c Cannot write estim and sigma MA ERROR __ CODE_WRITE_ OUTPUTS _WRITEDAPF ILE WRITEHEADER 46 writeUDPFile c Cannot write header of OSDAP2 All rights reserved ARGANS ACRI st 2008 2009 A i ICM CSIC x d LOCEAN SA CETP ARGANS IFREMER Internal Error Name L2 ouput product may be incomplete Return code ERROR_CODE_WRITE_OUTPUTS_WRITEDAPFILE_SETOUTERDIMENSIO 47 N ERROR_CODE_WRITE_OUTPUTS_WRITEDAPFILE_GETNODE ad SMOS L2 OS Operational ERROR _ CODE WRITE OUTPUTS WRITEDAPEFILE GHRICHECKSUM ERROR CODE WRITE OUTPUTS WRITEDAPFILE WRITEFIXEDHEADER writeUDPFile c Cannot write fixed header of OSDAP2 product ERROR CODE WRITE OUTPUTS WRITEDAPFILE WRITEMAINHEADER ERROR CODE WRITE OUTPUTS SET_BLEMENT DATA Internal Error Name of return code No L2 product generation ERROR _ CODE_MAIN_WRONG_ARG ERROR _ CODE_AUX DATA PROCESSOR_APPLYBEFG SIGMA _ ABS ERROR_ CODE_AUX_DATA_ PROCESSOR_APPLYBEFG _SIGMA_REL ERROR _ CODE_AUX_DATA_PROCESSOR_APPLYBEFG BIAS1 ERROR CODE AUX DATA PROCESSOR_APPLYBEFG FIRSTGUESS ERROR _ CODE AUX DATA PROCESSOR _GEHOPHYBRRORANDBIAS NO_TA BLE ERROR_ CODE_AUX_DATA_PROCESSOR_GHOPHYERRORANDBIAS_ INDEX WEIGHT_DIM1 ERROR _ CODE_AUX_
16. LUT c Cannot load Look up table for LUT a roughness model 2 ERROR_CODE_READ_INPUTS_DATA_SELECTION_READROUGH2LUT_NO 165 readRough2LUT c Cannot load bounds of Look up MINMAX table for roughness model 2 ERROR CODE READ INPUTS DATA SELECTION READROUGH2LUT_NO 165 readRough2LUT c Cannot open the file OPEN ERROR CODE READ INPUTS DATA SELECTION READROUGHI1LUT_NO LOO readRough1LUT c Cannot load bounds of Look up MINMAX table for roughness model 1 ERROR CODE READ INPUTS DATA SELECTION READROUGH1LUT_NO 160 readRough1LUT c Cannot load Look up table for LUT roughness model 1 ERROR_CODE_READ_INPUTS_DATA_SELECTION_READROUGH1LUT_NO readRoughlLUT c Cannot open the file OPEN ERROR _CODE_CONFIG_PROTO_READJOBORDER_NODATA readJobORder c Cannot find data in the job order file All rights reserved ARGANS ACRI st 2008 2009 Internal Error Name of return code No L2 product generation FRROR_CODE_CONF IG PROTO_READJOBORDER_NONODE ERROR CODE CONE IG PROTO _READJOBORDER VARNOTSETL ERROR CODE CONFIG PROTO _READJOBORDER_NOOPEN ERROR CODE CONP IG PROIO_NOMEM ERROR_CODE_CONFIG_PROTO_READCNF_L20S_NOCLOSE ERROR_CODE_CONF IG_PROTO_READCNF_L20S_NODATA ERROR_CODE_CONF IG_PROTO_READCNF_L20S_NOOPEN ERROR_CODE_CONFIG_PROTO_READCNF_L20S_XML_RW_API_HOME_E NVNOTFOUND NOTF OUND LOD ERROR CODE CHECK VALIDITY PERIOD PRODUCT NOTVALID BKRROR_CODE READ INPUTS _ DATA SELECTION_READLUT ERROR CODE READ INPUTS_DATA SELECTION_READLUT_ ALLOCLUT BRROR_CODE
17. OOT smos products Processor libraries SMOS_ROOTIlibpackages SMOS_ROOT is an environment variable pointing to the processor installation directory In order to run correctly the processor needs the following hardware and software resources 3 2 1 Hardware e LINUX Operating System 64 bits x86_64 e 4 Gb of RAM e At least 4Gb of disk space for installation this does not include space needed for creating or running jobs 3 2 2 Software The SMOS L2 operational processor uses external libraries They are included in the software package Some libraries need licensing such as the Earth Explorer CFI library Therefore you must accept the licenses of all third party software to use the SMOS L2 prototype processor Third party software are e Earth Explorer CFI software Contact http eop cfi esa int to obtain the license e HDF5 library All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 a ICM CSIC R GS LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 9 e Log4c e XML2 e XML_RW_API from Indra Espacio www indra es e GSL from Indra Espacio www indra es All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 4 ICM CSIC Ss cy LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 10 4 L2 OS Depende
18. READ INPUTS _DATA_ SELECTION_GETPRODUCT_INF O ERROR CODE TOOLS GET MONTH FROM TRANSPORT TIME ERROR CODE FORWARD MODEL SUPPORT _RADEC ERROR CODE DIVISION BY AERO ERROR CODE READ INPUTS_DATA_SELECTION_READATMOSEFPFECTL UT_NONODE BRROR_CODE READ INPUTS_DATA SELECTION_RBEADATMOSEFPFECTL UT E j ICM CSIC O owi E LO LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 ERROR CODE CONFIG PROTO READCNF L209 5MOS CNF L20895 ENV ERROR CODE_ READ INPUTS_DATA SELECTION_GET_VALIDITY_PER SMOS L2 OS poc SO MA ARG GS 0018 Page 28 User Manual Exit Function that generates the error and possible error description code Loy readJobORder c Cannot find tag in the job order Box cannot find node LG6d readJobORder c Cannot find tag in the job order o cannot set variable lola readJobORder c Cannot open job order file LOS config_proto c Cannot allocate memory 169 readCNF_L20 c Cannot close private configuration E CNF_L20S 169 readCNF_L20 c Cannot retrieve data from file Eo 169 readCNF_L20 c Cannot open private configuration E CNF_L20S 169 readCNF_L20 c environment valiable XML RW_API HOME not set Unable to find private configuration file CNF_L20S__ 169 readCNF_L20 c environment vaiable SMOS_CNF_L20S not set Unable to find private configuration file CNF_L20S__ L700 get_validity_period c fail to get validity period
19. SMOS L2 OS Doc SO MA ARG GS 0018 g Ca ICM CSIC O i RS a LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 1 Title SMOS L2 OS Operational Processor Software User Manual Doc code SO MA ARG GS 0018 Issue 1 Revision 7 Date 29 June 2009 Name Function Company Signature Date Prepared SMOS Team Expert Support Laboratories Reviewed P Spurgeon Project manager ARGANS Approved S Lavender Quality control ARGANS Released N Wright Project manager ESA All rights reserved ARGANS ACRI st 2008 2009 en j ICM CSIC d LOCEAN SA CETP IFREMER ARGANS External Distribution Name N WRIGHT ESA ESRIN S DELWART ESA ESTEC J C DEBRUYN ESA ESTEC Internal Distribution Name Expert Support Laboratories ACRI st J L Vergely S Lavender P Spurgeon C Mugerin SMOS L2 OS Operational Doc SO MA ARG GS 0018 Issue 1 Rev 7 Processor Software Date 29 June 2009 User Manual Quantity 1 1 Quantity W All rights reserved ARGANS ACRI st 2008 2009 Page 2 SMOS L2 OS ___poc SO MA ARG GS 0018 a ELC Operational Issue 1 Rev 7 LOCEAN SA CETP P E ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 3 Change Record __Issue_ Revision Date Description Approval 1 0 15 02 2008 _ First version 1 _ 06 05 2008 _ Post V3 FAT 2 13 11 200
20. Sel TNSTALLATIONOF THE CORE PROCESSOR rererua natua EN EA EASES EEEE RA 8 32 TREEORGANIZATION ruio a E EEE A E O E A ER OE AROS 8 4 L2 OS DENNY Ease nc ees css sha Uh sence aai NASA aIia Aaaa eaa saaa 10 Me Pa ara scat tiv heacence te no es cep vee macs te cep vw ern ences teed eo sce widen Pe eee ee 10 VINTON aE E EEE E E A AEE 12 Ao EO PROC E SIG aa A ETE E AE A TEE 12 5 OPERATIONAL CONFIGURATIONS ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccees 16 SA MAROC acc eset cn eee cca eat ne eects eects eoeres wat cn ec on pena ie REE EE EEES 16 5 2 FULLPOLARZATION MODE ssciscosccannedsnecstuaserennesnseantebsananhedisicestensane one icucssebosaaaheridmeniedseimoneniensseanasaahetisuanhenee 16 5 3 DUAL POLARIZATION MODE ccsccscceccecceccceccecceccccecceecesccusceccusceccescesccsscsscscescescesccsccescuscescescessessctscesceees 17 6 RETURN CODED iccicscucsssctcasccccasecducscctacesusseciesibeancevecdesdusxecesdeccsaccsecdlanuiscussasdevascuecatcecasdeeibersiacenssslesiesevied ees 19 7 GSL LOG INFO MESSAGES essossosessesscsesscosessosessessossosessessosecssssessessosessessosesssssessosessessessosessessessosessesso 31 APPENDIX A FEEDBACK FORM sassciciciccsccccasdisccccvccincericsiescicctsascrtiasceeisteinsapcuniceeasettessrsiacaveisicsetarsonsieeast 32 All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS _poc SO MA ARG GS 0018 Operational Issue 1 Rev 7 Processor Software Date 29 June
21. WRITEREPORT WRITEDATABLOCK oL writeReport c Cannot write data block ERROR_CODE_WRITE_OUTPUTS_WRITEREPORT_TYPE_NOTEXIST aL writeReport c Product type not exist ERROR CODE WRITE OUTPUTS _WRITEREPORT_EDIT_ PRODUCT 3L writeReport c Cannot edit product report ERROR_CODE_WRITE_OUTPUTS_WRITEDAPFILE_GETHEADER 32y writeDAPFile c Cannot get OSDAP2 header ERROR_CODE_WRITE_OUTPUTS_WRITEDAPFILE_EDITPRODUCT ay writeDAPFile c Cannot edit product OSDAP2 ERROR_CODE_WRITE_OUTPUTS_WRITEDAPFILE_NODELETE 34 writeDAPFile c Cannot delete object BRROR CODE WRITE OUTPUTS WRITEDAPF ILE GETDATASET B53 writeDAPFile c Cannot get data set of OSDAP2 PLoaucr ERROR CODE WRITE OUTPUTS _WRITEDAPP ILLE GETDATASETRECORD oy writeDAPFile c Cannot get data set record a OSDAP2 product ERROR CODE WRITE OUTPUTS WRITEDAPFILE WRITEDATASETRECO a WRLEEGDAPPIle c Cannot write data set record for RD FRROR CODE WRITE OUTPUTS WRITEDAPF ILE SE TE LEMENTDATA writeDAPFile c Cannot set data for OSDAP2 product ERROR CODE WRITH OUTPUTS _WRITEDAPF ILE SHTOUTERDIM 35 writeUDPFile c Cannot set outer dimension FRROR CODE WRITE OUTPUTS WRITEDAPFEF ILE CREATEPRODUCT 40 writeUDPFile c Cannot create OSDAP2 product FRROR_CODE WRITE OUTPUTS _WRITEDAPF ILE CREATEHEADER AL writeUDPFile c Cannot create header for OSDAP2 eae ERROR_CODE_ WRITE OUTPUTS _WRITEDAPFILE GETCOUNT AP writeUDPFile c Cannot get count attribute BERROR_CODE WRITE _OUTPUTS_WRITEDAPFILE CREATEDATAB
22. _ L208 20050101T000000_20500101T000000_vwv_rrr_1 EEF vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in All rights reserved ARGANS ACRI st 2008 2009 ICM CSIC SMOS L2 OS ___ poc SO MA ARG GS 0018 ES LOCEAN SA CETP Operational Issue 1 Rev 7 IFREMER Processor Software Date 29 June 2009 User Manual Page 17 ARGANS SMOS_ROOT smos products CNF _ L2OS__ 5 2 3 The main configuration file AUX_CNFOSF The main configuration file for dual polarisation is SM_OPER_AUX_CNFOSF_20050101T000000_20500101T000000_vvv_rrr_8 EEF vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in SMOS_ROOT smos products AUX_ CNFOSF 5 3 Dual polarization mode 5 3 1 The task table The task table for dual polarisation 1s SM_OPER_CNF_TSKTBL_20080801T000000_20500101T000000_vwv_rrr_1 xml vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in SMOS_ROOT smos task_tables MIR_ SCSD1C 5 3 2 The private configuration file Same private configuration is used for dual and full polarization modes OM_OPER_CNF_L2O0S____20050101T000000_20500101T000000_vwv_rrr_1 EEF vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in SMOS_ROOT smos
23. al chain the PDPC Core will be responsible for running multiple L2 OS Processor job orders with the associated input data simultaneously on the operational hardware in order to optimise processing power The processing of auxiliary data files shall be performed off line in the CEC facilities Unlike the nominal L2 OS processing task the pre processors and the post processors will not be launched directly by the PDPC Core but will be triggered upon arrival of new input data 4 1 L2 OS Auxiliary Data L2 OS processing depends on the availability of the set of auxiliary data shown in the table below ID Product description Source Update rate AUX_FLTSEA Physical Constants needed by Flat ICM CSIC None Sea Model ARGANS AUX_RGHNS1 Look Up Tables needed by L2 IPSL None Processor for the IPSL Ocean ARGANS Roughness Model AUX_RGHNS2 Look Up Tables needed by L2 IFREMER None ARGANS Processor for the IFREMER Ocean All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS E ICM CSIC Doc SO MA ARG GS 0018 Operational Issue 1 Rev 7 LOCEAN SA CETP IFREMER Processor Software Date 29 June 2009 User Manual Page 11 RoughnessModel S S C s S lt CSSst i i SS S S C 73 FSC lt S7 7 S d ARGANS AUX_RGHNS3 Look Up Tables needed by L2 ICM CSIC None Processor for the ICM CSIC Ocean ARGANS Roughness Model AUX_FOAM__ Physical Constants used by Foam IFREMER None Mo
24. del ARGANS AUX_SGLINT Bi Static Scattering Coefficients IFREMER None Look Up Table used in Sun glint ARGANS correction AUX_ATMOS _ Physical Constants used by IPSL None Atmospheric Model ARGANS for Dual Polarisation L2 Ocean ESLs Salinity AUX_CNFOSD Processor Configuration Parameters ARGANS If required by AUX_CNFOSF Processor Configuration Parameters ARGANS If required by for Full Polarisation L2 Ocean ESLs Salinity AUX_DISTAN Distance to the coast and monthly IFREMER None Sea Ice Flag information over IPSL Discrete Global Grid ARGANS AUX _ SSS Monthly Sea Surface Salinity over IFREMER None Discrete Global Grid IPSL ARGANS AUX_GAL OS AUX_GALAXY Map convolved IFREMER If required by with the Weighting Function AUX_ IPSL ESLs WEF ARGANS AUX_GAL20S AUX_GALAXY Map 2 convolved IFREMER If required by with the Weighting Function AUX_ IPSL ESLs WEF ARGANS AUX_ECMWE _ ECMWE data on the ISEA 4 9 DGG ECMWE Every 3 hours corresponding to SMOS halforbit preprocesso r AUX DGG __ ISEA4 9 Discrete Global Grid used Ll None in geolocation MPL_ORBSCT Orbit scenario used to initialise ESA L1 If required by EARTH EXPLORER CFI functions DPGS Table 1 L2 OS Auxiliary Data Files For each auxiliary data file the table shows the source and update rate All the files listed are mandatory for processing The update rate should give an indication of the period for which the file is valid
25. equal ERROR_CODE TOOLS _ TOOLS _INVERSEDIAGMAT ALLOCMAT 138 tools c inverseDiagMat function fail to allocate M for matrix invDiag ERROR_CODE_TOOLS_TOOLS_INVERSEDIAGMAT_NONDIAGMAT L36 tools c inverseDiagMat function input matrix is not diagonal Found non diagonal term different from O All rights reserved ARGANS ACRI st 2008 2009 Internal Error Name of return code No L2 product generation FRROR_CODE_TOOLS_TOOLS_TRANSPOSEMAT_ALLOCMAT KRROR_CODE_TOOLS_TOOLS_SUMMAT_ SIZEMATS KRROR_CODE_TOOLS_TOOLS_SUMMAT_ALLOCMAT ERROR CODE TOOLS_TOOLS_DIFEMAT_ SIZBEMATS BRROR_CODE TOOLS _ TOOLS _DIFEFMAT_ ALLOCMAT ERROR CODE TOOLS TOOLS _PRODMAT SIZEMATS BKRROR_CODE TOOLS_TOOLS_PRODMAT_ALLOCMAT BRROR_CODE_ TOOLS_TOOLS_SCALPRODMAT_ ATLLOCMAT KRROR_CODE_TOOLS_TOOLS_KEEPDIAGMAT_SIZEMAT KRROR_CODE _ TOOLS_TOOLS_KBEEPDIAGMAT_ ALLOCMAT KRROR_CODE_TOOLS_TOOLS_INVERSEMAT SIZEMAT KRROR_CODE_TOOLS_TOOLS_INVERSEMAT_ ALLOCMAT_LL KRROR_CODE_TOOLS_TOOLS_INVERSEMAT_ ALLOCMAT TILL ERROR CODE TOOTS TOOLS _INVERSEMAT DLLNOTDEPPOSITIVE FRROR_CODE_TOOLS_INTERPHERMIT_NSAMPLINGTOOLOW FRROR_CODE_TOOLS_INTERPHERMIT_INDEXINVALID ASE2 ASE4 BRROR_CODE MATINPROCESSING ITERATIVESCHEME ALLOCMAT X_C BKRROR_CODE_ MAINPROCESSING_ITERATIVESCHEME ALLOCMAT X_C E ICM CSIC 4 LOCEAN SA CETP ARGANS IFREMER SMOS L2 OS Processor Software Date 29 June 2009 User Manual Exit code Io 140 140 14i 14l 142 142 143 144 144 145
26. essages pre QR RID jcd 105 64 75 4 3 5 2 Removed AUX_AGDPT_ no longer required by operational Table 1 processor 4 3 5 2 Replaced AUX_TIME__ by MPL_ORBSCT Table 1 4 1 Explained update rate fields pre QR RID jcd 105a Version 1 3 to version 1 4 SO MA ARG GS 0018 Page Comments All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 8 eet Operational Issue 1 Rev 7 kul LOCEAN SA CETP P ane al ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 4 7 Added Start of processing amp End of processing to list of INFO messages PR 0050 3 Updated configuration file tables Version 1 4 to version 1 5 SO MA ARG GS 0018 Page Comments 11 1 Corrected AUX_ORBSCT to MPL_ORBSCT 86 6 __ Added RETURN_CODE_CANCEL_ORDER 255 3 2 Added missing config amp schemas directories to tree 8 3 2 1 3 2 2 Removed unnecessary references to hardware software descriptions in OPSRD In l Version 1 5 or version 1 6 SO MA ARG GS 0018 Page Comments 82 Section __ ERROR CODE CONFIG PROTO_READPARAMINDICES NO OPEN description PR FAT GUI 2 13 16 Removed The file name is correctly constructed amp The file version field vvv must be the one accepted for this version of the processor appended as specified by the Fixed Header Creation_Date to If multiple files fu
27. ftware Date 29 June 2009 User Manual Page 27 Internal Error Name of return code No L2 product generation Exit Function that generates the error and possible error description code F animes tania incaaialinaiiaimaiamanins 161 readiem c Cannot Get dataset T ERROR CODE READ INPUTS DATA SELECTION READLSM NOCOUNT Lol readLsm c Cannot get the count of data blocks eee 161 readLsm c Cannot open product ERROR _CODE_ READ INPUTS DATA SELECTION READCOMMONCSTLUT 162 readCommonCstLUT c Cannot get data from node _NODATA ERROR CODE READ INPUTS DATA SELECTION _READCOMMONCSTLUT 162 readCommonCstLUT c Cannot get node ko ERROR CODE READ INPUTS DATA SELECTION READCOMMONCSTLUT 162 readCommonCstLUT c Cannot open product ee Fatale E ca 163 readUserGp c Cannot get node E a aii 163 readUserGp c Cannot open product N ERROR_CODE READ INPUTS DATA SELECTION READUSERGP_NOMEM 163 readUserGp c Cannot allocate memory ERROR CODE READ INPUTS DATA SELECTION _READROUGH3COEKF_N 164 readRough3Coef c Cannot find coefficient value in ERROR CODE READ INPUTS DATA SELECTION _READROUGH3COEF_N 164 readRough3Coef c Cannot find a node in file ERROR_CODE READ INPUTS _DATA SELECTION _READROUGH3COEKF_N 164 readRough3Coef c Cannot load wind speed ranges for OW INDRANGE a roughness models 3 ERROR CODE READ INPUTS DATA SELECTION _READROUGH3COEKF_N 164 readRough3Coef c Cannot open the file ERROR_CODE READ INPUTS DATA SKLECTION_READROUGH2Z2LUT_NO 165 readRough2
28. gTimeFromTransportTim e SS CFI function xl_time_transport_to_processing returns in error CP IDaterunctions c Error occured in CFIDateFunctions c file computeGeometry c no measurement found cannot reah list of snapshots computeAngle c EE CFI function XP_TARGET_STATION returns in error computeAngle c EE CFI function XP_ TARGET EXTRA MAIN returns in error All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS poc SO MA ARG GS 0018 z E ICM CSIC R w LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 23 Internal Error Name of return code No L2 product generation Exit Function that generates the error and possible error description code ERROR_CODE_FORWARD_MODEL_SUPPORT_COMPUTEANGLE_XPTARGET 133 computeAngle c EE CFI function EXTRATOSUN F o eae rerurns in error FRROR_CODE FORWARD MODEL SUPPORT COMPUTEANGLE XPTARGET L33 computeAngle c EE CFI t nction EXTRATOMOON Ee a e returns in error ERROR_CODE_FORWARD_MODEL_SUPPORT_COMPUTEANGLE_XLTIMETR Ilo computeAngle c EE CFI LUNCE1ONn ANSPORTTOASCIM Eoo ve wees FeLuIrnsS in error ERROR_CODE_ FORWARD MODEL SUPPORT _COMPUTEGNANGLE CHANGE 133 computeGalacticNoiseAngle c fail tO compute CARTCS Eos ERROR_CODE_FORWARD_MODEL_SUPPORT_COMPUTEGNANGLE_ALLOCM 133 computeGalacticNoiseAngle c fail tO allocate AT Roe for Matrix ERROR CODE FORWARD MODEL SUPPORT _COMPUTEGNANGLE PRODMA Loy com
29. le files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_RGHNSI Look Up Tables needed by L2 Processor for the IPSL Ocean Roughness Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_RGHNSI validity start time MIR_SCSx1C_ sensing stop time lt AUX_RGHNSI validity stop time f multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_RGHNS2 Look Up Tables needed by L2 Processor for the IFREMER Ocean Roughness Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_RGHNS2 validity start time All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0018 Operational Issue 1 Rev 7 LOCEAN SA CETP IFREMER Processor Software Date 29 June 2009 User Manual Page 15 MIR_SCSx1C_ sensing stop time lt AUX_RGHNS2 validity stop time f multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date ARGANS o AUX_RGHNS3 Look Up Tables needed by L2 Processor for the ICM CSIC Ocean Roughness Model o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_RGHNS3 validity start time MIR_SCSx1C_ sensing stop time lt AUX_RGHNS3 validity stop time If multiple files fulfil the above criteria
30. lename If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_DGG__ ISEA4 9 Discrete Global Grid used in geolocation o Mandatory o Dependency check MIR_SCSxIC _ sensing start time gt AUX_DGG validity start time MIR_SCSxIC _ sensing stop time lt AUX_DGG validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_DISTAN Distance to the coast and monthly Sea Ice Flag information over Discrete Global Grid o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_DISTAN validity start time MIR_SCSx1C_ sensing stop time lt AUX_DISTAN validity stop time f multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date o AUX_ECMWF_ ECMWF data on the ISEA 4 9 DGG corresponding to SMOS half orbit o Mandatory o Dependency check MIR_SCSx1C_ sensing start time gt AUX_ECMWF_ validity start time MIR_SCSx1C_ sensing stop time lt AUX_ECMWE_ validity stop time If multiple files fulfil the above criteria use the one with the latest generation time as specified by the Fixed Header Creation_Date All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS _poc SO MA ARG GS 0018 Operational Issue 1 Rev 7 Processor Software Date 29 June 200
31. lfil the above criteria use the one with the latest generation time FAT_V4_ACT_ 32 6 _ Added new error codes 183 188 251 254 Removed file lists added references to master versions of con figuration files Updated GSL info messages Wanton 1 6 to version 1 7 SO MA ARG GS 0018 to version 1 7 SO MA ARG GS 0018 Cid Page Comments 5 3 8 a2 replaced explicit version by L2OS___vv_vv exe All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 ICM CSIC a i rational Ae E LOCEAN SA CETP Operationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 5 Table of Content 1 INTRODUCTION eci 6 EA AE eas as tee aes se eet ee E A pepien oe caaleae vann aed doneoaaeanecmeeeeuieeesctee 6 k2 QUDFTO TS DOCUMEN gs crcearseecsearee csc NEEE poets cv insets mca seascape AEAEE EAEAN KESA 6 L3 APPLICABLE DOCUMENTS peint NENNEN 6 LA REFERENCE DOCUMENTS erien A A A A AEAEE REAREA 6 Mo E WO e ETO EE APE E A E A AEEA EE A E E A T AET A 6 2 OVERY IE Y aa A EE 7 A RO O E E E a uounoaunenieoareadinadamanntabonteds 7 2 DPA reoeie ce ce pce E ete cca bevrc ala apes cient vance ars ie fem dtc TE ea teagadeecee ada cees 7 2o BREAL POMNI PE eT U a E eeu nae buasueeeunacn neooutiuscs sch netwes 7 3 INSTALLATION AND OPERATION 2 ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccces 8
32. mat or in HDF5 format All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 a y ICM CSIC Ae GS LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 8 3 Installation and operation 3 1 Installation of the core processor The software is intended to be installed on a Linux 64 bit operating system environment The Red Hat 5 Enterprise operating system is recommended because it is the environment on which the processor has been implemented and tested We assume hereafter that the processor and all necessary auxiliary and input data files have already been installed and that an environment variable SMOS_ROOT has been set pointing to the installation directory To install to test and to use the processor from source codes follow the procedure in section 4 1 of the Operational Processor Software Release Note SO RN ARG GS 0019 HDF view is needed to visualize breakpoint report files To download this software follow the link http hdf ncsa uiuc edu hdf java html hdfview Installation procedure is embedded in the downloaded file 3 2 Tree organization After installation of the processor the following file directory structures will be accessible Type Files Path Processor Binary executable SMOS_ROOT dev L2OS___vv_vv exe Input configuration files SMOS_ROOT smos config data and schema SMOS_ROOT smos schemas SMOS_R
33. mory for matrix X retrieval with Stokes 1 All rights reserved ARGANS ACRI st 2008 2009 Internal Error Name of return code No L2 product generation ERROR_CODE_MATNPROCESSING_ITERATIVESCHEME_ALLOCMAT_CO BRROR_CODE_ MATINPROCESSING ITRERATIVESCHEME ALLOCMAT XMO D KRROR_CODE_MAINPROCESSING_ITERATIVESCHEME ALLOCMAT_F KRROR_CODE_MAINPROCESSING_UPDATEPARAMETER_MATH KRROR_CODE_MATNPROCESSING_COMPUTEMR4_ ALLOCMAT MR4 FRROR_CODE_FORWARDMODEL_COMPUTETBFROMGROUNDTOANTENNA_A LLOCMAT_ TBIARGET ERROR_CODE_DECISIONTREE_SETL2FLAGS_ALLOCMEM DESC ERROR_CODE_DECISIONTREE_SETL2FLAGS_ ALLOCMEM REPORTS BERROR_CODE READ INPUTS_DATA SELECTION _NOGRIDPOINT FRROR_CODE_CONF IG PROTO_READPARAMINDICES_NOOPEN ERROR CODE CONFIG PROTO _READPARAMINDICES NONODE KRROR_CODE_CONF IG PROTO _READPARAMINDICES_ NODATA ERROR CODE CONFIG PROTO _READPARAMINDICES MULTIINDEX KRROR_CODE_ READ INPUTS_DATA_SELECTION_READECMWE KRROR_CODE_READ_INPUTS_DATA_SELECTION_READECMWF _GPIDNO TSUPPORITED ERROR_CODE_READ_INPUTS_DATA_SELECTION_READECMWF_NODATA ERROR_CODE_READ_INPUTS_DATA_SELECTION_READECMWF_NOOPEN ERROR CODE READ INPUIS DATA SELECTION_READECMWF_GET_ CO UNI ERROR_CODE_READ_INPUTS_DATA_SELECTION_READECMWF_GET_DA TASET ERROR_CODE_READ_INPUTS_DATA_SELECTION_READECMWF_GET_DA TASET_RECORD BRROR_ CODE READ INPUTS _DATA_ SELECTION_READF OAMLUT_NOOP EN E j ICM CSIC O owi E LO LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Da
34. ncy Model The Dependency Model is the set of rules designed for each processor to generate its outputs based on specific combinations of input data files This model tells the checking module which the valid relations are between files in order to successfully process SMOS data to upper processing levels The interaction between the L2 OS Processor and the DPGS is physically done through the interface between the PDPC Core and the processing hosts where the processor is installed The PDPC Core shall be responsible for providing the best set of inputs to the L2 OS Processor in order it can process products with the best possible quality The PDPC Core shall select the inputs accordingly to a configured set of rules for each executable This set of selection rules is the dependency model The orchestration of the execution of each L2 OS processing tasks thus consists in the configuration of the PDPC Core accordingly to the dependency model for the L2 OS Processor executable The number of inputs delivered for each product type should be the least possible to avoid increasing the transfer flow across the network Nominal L2 OS processing will be launched as part of the SMOS processing chain by the PDPC Core through its Processing Framework providing the L2 OS Processor with the required inputs The list of inputs will be made available through the Job Order which also gives the time periods in which each product should be used In the operation
35. nnot get information on product ERROR CODE READ INPUTS DATA SELECTION READDGG_NOMEM 158 readDgg c Cannot allocate memory ERROR_CODE_READ_INPUTS_DATA_SELECTION_READHEADER_NONOD 159 readHeader c Cannot get data from node EDATA ERROR_CODE_READ INPUTS_DATA_ SELECTION READHEADER_NONOD readHeader c Cannot get node E ERROR CODE READ INPUTS _DATA SELECTION READL1C_NODELETE 160 readLlc c Cannot delete object ERROR _CODE READ INPUTS DATA SELECTION_READLIC_NODATA 160 readLic c Cannot get data eos CODE READ INPUTS DATA SELECTION READL1IC_NOMEM 160 readLic c Cannot allocate memory Fa CODE_READ_INPUTS_DATA_SELECTION_READL1C_NODATASE 160 readiie c Cannot get dataset T ERROR CODE READ INPUTS DATA SELECTION READL1C_NOCOUNT 160 readLic c Cannot get the count of data blocks ee 160 readLic c Cannot open product FRROR_ CODE READ INPUTS DATA SELECTION READLSM NODELE TE 161 readLsm c Cannot delete object ERROR _CODE_READ INPUTS DATA SELECTION READLSM NONODEDA TA ERROR CODE READ INPUTS DATA SELECTION _READLSM NONODE 161 readLsm c Cannot get Node ERROR CODE READ INPUTS DATA SELECTION READLSM NODATASE 16l readLsm c Cannot get dataset record ooo ERROR_CODE_READ_INPUTS_DATA_SELECTION_READLSM_NOMEM 161 readLsm c Cannot allocate memory All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS poc SO MA ARG GS 0018 z E ICM CSIC R w LOCEAN SA CETP Operational Issue 1 Rev 7 ARGANS IFREMER Processor So
36. puteGalacticNoiseAngle c Error while computing T ene OF matrices ERROR CODE CONFIG PROTO _READITERCOEBF RETRIEVPARAMID 134 readiterCoer c r readiterCoef function fails to read Boen ERROR_CODE_CONFIG_PROTO_READITERCOEF_NOOPEN Loe readIterCoef c Cannot open the product CNFOS2 ERROR CODE CONFIG PROTO READITERCOEF NODATA 134 readIterCcoef c Cannot load IterCoef data ERROR_CODE_CONFIG_PROTO_READITERCOEF_ALLOC_LUT 134 readiterCoef c fail TO allocate memory for Eo lut ERROR_CODE_CONFIG_PROTO_READITERCOEF_GET_NODE Lo4 readIterCoef c Cannot get node ERROR CODE CONFIG PROTO _READITERCOBF GETNODEDATA 134 readiterCoef c Cannot get node data EFRROR_CODE_ FORWARD MODEL SUPPORT COMPUTEERRORMODEL ALL lL 5 computeErrorModel c fail to allocate memory for OCMATC_MOD_EARTH Ean GC mod Earth ERROR CODE FORWARD MODEL COMPUTEROUGHNESSTB1 HERMIT 130 computeRoughnessTbl c fail tO compute hermit Pee ERROR_CODE_FORWARD_MODEL_COMPUTEROUGHNESSTB1 LINEAR 136 computeRoughnessTblL c fail tO compute linear Eoas ERROR_CODE_FORWARD_MODEL__COMPUTEROUGHNESSTB2_LINEAR 1363 computeRoughnessTb2 c fail toO compute linear ete ERROR_CODE_ FORWARD MODEL COMPUTESUMOFCONTRIB MATHERR 136 computeSumOfContribution c mathematical exception ERROR_CODE_FORWARD_MODEL_FLATSEA_MATHERR 136 flatsea c mathematical exception ERROR_CODE_TOOLS_TOOLS_INVERSEDIAGMAT_NONSQUAREMAT Lory COOLS C inverseDiagMat function dimensions of em matrix are not
37. resholds c Cannot get node oo ERROR CODE READ INPUTS DATA SELECTION READTHRESHOLDS N 180 readThresholds c Cannot load data for THRESHOLDS a E 181 readPostProc c Cannot open the product PostProcLUT PEN e cl eeeiamaliaaeti Leds readPostProc c Cannot get node ODE e ima iaiataiiclenai 181 readPostProc c Cannot load data for PostProcLUT ATA ERROR CODE READ INPUTS DATA SELECTION READSSABSCLUT 182 readSSAbscLUT c Error occured in readSSAbschUT ERROR_CODE_GENERIC_INTERP_INEXISTANT_ARRAY_DIMENSION Looy interp c Error occured in GenericInterp function r inexistent array dimension ERROR_CODE_GENERIC_INTERP_INVALID_INDEX 184 interp c Error occured in GenericInterp function invalid index ERROR_CODE_GENERIC_INTERP INVALID COEFFICIENT 165 interp c Error occured in GenericInterp function Ba invalid coefficienL ERROR_CODE_GENERIC_INTERP_VECT_INVALID_DIMENSION 186 interp c Error eccured in GenericInterpVect FUNCTION invalid dimension ERROR_CODE NEAREST NEIGHBOUR_OUT_OF_ MEMORY Lod LOOLS c Error eccured in nearestNeighbour re function out of memory ERROR CODE _UNKNOWN_RETRIEVAL MODE 188 returnCodes h Unknow retrieval mode ERROR_CODE_SIGILL ZO 1 trapped SIGILL illegal instruction ERROR_CODE_SIGBUS Boe trapped SIGBUS bad memory reference ERROR_CODE_ SIGSEGV 2554 trapped SIGSEGV invalid memory reference ERROR_CODE_SIGFPE 234 trapped SIGFPE floating point exception oF including div 0 amp overflow
38. sing after module readLIcFile is d Computing angles Measurement selection completed Followed by A 000_PRO_000 Followed by A 001_ PRO_OOO to A 025_PRO_000 Number of gridpoints to be processed configuration 1 d Number of successful retrievals with configuration 1 d Number of gridpoints to be processed with Followed by A 026_PRO_000 to configuration 2 d A 050_PRO_000 Number of successful retrievals with Number of gridpoints to be processed with configuration 3 d Number of successful retrievals with configuration 3 d Number of gridpoints to be processed with configuration 4 d Number of successful retrievals with configuration 4 d Writing output files End of processing Followed by A 100_END_000 Followed by A 051_ PRO _OOO to A 075_PRO_000 configuration 2 d Followed by A 076_PRO_OOO to A 100_PRO_000 All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 Ps ICM CSIC O on E LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 32 Appendix A Feedback Form The form below is the template of the feedback form The form is aimed at reporting software problems or at requesting changes in the SMOS L2 SSS operational processor The forms shall be sent to smos argans co uk HHHH Contact Person Name and institu
39. te 29 June 2009 SMOS L2 OS poc SO MA ARG GS 0018 Page 25 User Manual Exit Function that generates the error and possible error description code 147 iterativeScheme c fail to allocate memory for Ben co 147 iterativeScheme c fail to allocate memory for ee X mod 147 iterativeScheme c fail to allocate memory for Beer F 147 update parameter c mathematical error computeMR4 c fail to allocate memory for matrix MR4 149 computeTBFromGroundToAntenna c fail allocate Ba memory for matrix tbTarget 150 setL2Flags c fail allocate memory retrieval descriptor setL2Flags c fail allocate memory retrieval reports read_inputs_data_selection c for processing readParamindices c of AUX_CNFOSD F readParamindices c readParamiIndices c Cannot load ParamIndices data 152 readParamiIndices c Parameter index not unique loa readEcmwf c Cannot set ECMWF data readEcmwf c The Grid Point Id is not supported no gridpoint selected 127 152 Cannot get product informations Cannot get node Loy readEcmwf c Cannot load data for Ecmwf Lacy readEcmwf c Cannot get information of product Bier ever readkEcmwf c Cannot get number of DataSets of eects Ecmw 1S readEcmwf c Cannot get DataSets of product Ecmwf 153 readEcmwf c Cannot get DataSetRecords of product eee 154 readFoamLUT c Cannot get product informations of Peers All rights reserved ARGANS ACRI st 2008 2009 SMOS
40. te 29 June 2009 User Manual Page 16 5 Operational configurations 5 1 Introduction The SMOS L2 SSS processor handles many files that are either input files or output files Input files are loaded in the processor They include either data or configuration information A technical description of the content of all files handled by the prototype processor is available in R D 4 or R D 16 We focus hereafter on the configuration that is recommended for operational purpose DPGS It addresses the main files for the two modes of measurement of SMOS e the full polarization mode e the dual polarization mode We detail below the main files for each mode that are e the task table file CNF_TSKTBL e the private configuration file CNF_L2OS e the main configuration file AUX _CNFOSx that contains o Iterative scheme configuration Geophysical parameter definition Threshold file Physical constant definition Post Processor configuration file Overall quality threshold O O O O 5 2 Full polarization mode 5 2 1 The task table The task table for full polarisation is SM_OPER_CNF_TSKTBL_20080801T000000_20500101T000000_vwv_rrr_1 xml vvv is the processor version eg 306 rrr is the release version eg 001 and it can be found under the installation directory in SMOS_ROOT smos task_tables MIR_SCSF1C 5 2 2 The private configuration file Same private configuration is used for dual and full polarization modes SM_OPER_CNF
41. ter IM dimension SMOS L2 OS Doe SO MA ARG GS 0018 ne ate Operational Issue 1 Rev 7 LOCEAN SA CETP ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 20 Internal Error Name L2 ouput product may be incomplete Return Function that generates the error and error description code ERROR CODE WRITE OUTPUTS WRITEUDPFILE SKETOUTERDIM 20 wrateUDPFile c Cannot set outer dimension ERROR CODE WRITE OUTPUTS _WRITHUDPEILE CREATE PRODUCT al writeUDPFile c Cannot create OSUDP2 product ERROR_CODE_WRITE_OUTPUTS_WRITEREPORT_CREATEPRODUCT Ley writeReport c Cannot create product report ERROR CODE WRITE OUTPUTS WRITEREPORT CREATEHEADER Loy writeReport c Cannot create product header ERROR CODE WRITE OUTPUTS_WRITEREPORT_CREATEDATABLOCK Za writeReport c Cannot create data block ERROR_CODE_ WRITE OUTPUTS _WRITEREPORT_GETNODE voy writeReport c Cannot get Node while writing La product report ERROR_CODE_ WRITE OUTPUTS_WRITEREPORT_ SETOUTERDIM 26 writeReport c Cannot set outer dimension ERROR_CODE_WRITE_OUTPUTS_WRITEUDPFILE_ CREATEHEADER Lly writeUDPFile c Cannot create header for OSUDP2 Bie ERROR CODE WRITE OUTPUTS_WRITEKUDPFILE GETCOUNT AOp writeUDPFile c Cannot get count attribute ERROR _CODE_WRITE OUTPUTS WRITEUDPFILE CREATEDATABLOCK PAF writeUDPFile c Cannot create data block ERROR_CODE_WRITE_OUTPUTS_WRITEREPORT_WRITEHEADER 30 writeReport c Cannot write header ERROR CODE WRITE OUTPUTS _
42. tion Initiated date Level low medium high critical Status open pending closed Type problem coherence potential improvement Completed date Description Report in detail the context from which the feedback emerged Expected improvement Describe improvements expected if the lesson learned from the feedback is applied Recommendations for implementation List documents activities software or data set affected by implementation deemed necessary to obtain the expected improvement Propose solution s and assess workload needed Difficulty of implementation easy normal tricky Reviewed by SMOS PM project team date Workload low medium shigh hours days Implementation yes no Justification Justify implementation or no implementation All rights reserved ARGANS ACRI st 2008 2009
43. tware Release Document SO RN ARG GS 0019 1 5 Abbreviations The list of acronyms is available in the Operational Processor Software Release Document SO RN ARG GS 0019 All rights reserved ARGANS ACRI st 2008 2009 SMOS L2 OS ___poc SO MA ARG GS 0018 lt 5 ICM CSIC O on LOCEAN SA CETP perationa Issue 1 Rev 7 ARGANS IFREMER Processor Software Date 29 June 2009 User Manual Page 7 2 Overview 2 1 Introduction Figure 1 shows the organisation and data flow of the Processor The processing is launched through the command line interface shell window The user can follow the execution using the information generated by the processor on standard output stdout or on standard error output stderr within the shell window Visualization of products can be done using SMOSview The breakpoint report files in HDF5 format can by visualized with hdfview Level 1 Data Analysis Command line stdout stderr Or PFW log progress SMOSview Predecccccccccccccvcccesscccsscccsscceseecescees Breakpoint Breakpoint 8 4 GUI reports i hdfview Figure 1 Overview of the SMOS L2 SSS processor and its files 2 2 Data GUI To visualize SMOS products use SMOSview 2 3 Breakpoint report GUI The operational processor should not be configured so that breakpoint reports are generated The breakpoint report GUI is either a text editor or HDF view because the breakpoint reports are either in text for
44. validity duration Where no update of the file is expected the file should be valid for the duration of the mission although updates will probably occur All rights reserved ARGANS ACRI st 2008 2009 lt eel oe COC a ech came d E ICM CSIC Doc SO MA ARG GS 0018 Operational Issue 1 Rev 7 LOCEAN SA CETP IFREMER Processor Software Date 29 June 2009 User Manual Page 12 ARGANS 4 2 Conventions The following conventions are used in sections that follow when defining the dependencies e Mandatory Optional defines whether a supporting product is always needed for a processing task mandatory or the processing can still be performed in its absence through a backup solution optional e Triggering defines the conditions that must be met to launch the processing task e MIR_SCSxIC shall refer to either MIR_SCSDIC dual polarisation or MIR_SCSFIC full polarisation Either one of these products will be used as input to the L2 processor but not both e AUX_CNFOSx shall refer to either AUX _CNFOSD dual polarisation or AUX_CNFOSF full polarisation Either one of these products will be used as input to the L2 processor but not both MIR_SCSx1C must match AUX_CNFOSx ie x D for both or x F for both 4 3 L2 OS processing 1 Executable to be Called by PDPC Core L2OS___ lt vv gt _ lt rr gt exe 2 Processing Task e Processing of an ocean Llc product to a SMOS sea surface salinity products UDP and DAP
Download Pdf Manuals
Related Search