Home

Title: SMOS L2 OS Prototype Processor Software User Manual Doc

1. L2_OS_Configuration_Parameters 1 Iterative_Scheme 1 List_of_lterconf 1 Iterative_Conf 1 List_of_retrived_Parameters 1 retrievedParamld 2 SMOS GUI XML editor example The above example shows the edition of a XML SMOS configuration file AUX_CNFOSD Tree distinct zones are drawn gt The top menu e File menu This menu accesses the following command o Save To save the modifications o Export in operational format To save the file in operational format that is without any additional tags o Close To close the window e Edit menu This menu accesses the following command o Undo To save the modifications o Find string CTRL F is useful for finding the tag the user is looking for o Collapse to hide the tree structure o Expand all for a quick access to the attributes and values of the whole hierarchy gt The left panel is dedicated to the whole XML hierarchy from the top to the bottom Three different icons are used o a this icon denotes that this tag has one or several sons name is not editable All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 ARGANS EXSM ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Issue 2 Rev 18 Software User Manual Doc SO MA ARG GS 0021 Date 25 January 2013 Page 66 o D no sons are available below this tag The text associated is the tag value editable by default but can be made not editable o A this icon i
2. will modify the private configuration file pointed to in the Job Order according to the entered values The job configuration panel will display a message e Zone selected in green color e Or Entire globe applied in blue color if no processing window is selected The limits of the selected zone can be checked by editing the private configuration file see section 6 2 3 The limits are also written in the job configuration panel Job parameters scrollable text area Note that if the orbit does not intersect the region selected no grid points are available for processing and an error will be reported when the job is started Users may wish to initially select a thin horizontal strip from 180 W to 180E which will usually include some grid points unless the Lic half orbit is incomplete 6 2 7 Job execution Once the configuration phase is over the processor is ready to be launched Two different running modes are available 1 Direct launch 2 Scheduled launch The direct launch mode is used by selecting the Run now option Clicking on the button Launch will run the job gt If no job is already running the job is launched gt Ifa job is already running then the job will be launched only if the maximum number of allowed concurrent jobs is set to an appropriate value e g greater than 1 Otherwise the job will be queued until it is possible to be run The scheduled mode is used when the Schedule option is se
3. ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual Doc SO MA ARG GS 0021 Issue 2 Rev 18 Date 25 January 2013 Page 64 xmledit false true false If this attribute is set to true an edit button is added to the interface allowing to open a new XML editor loading the file pointed on see example below xmledit true txtedit false true false If this attribute is set to true an edit button is added to the interface allowing opening a new text editor loading the file pointed to txtedit true description none Any string chain Tag description description tag description unit none All units poss 1ble Unit description unit d1 listdir none be scanned Any directory to If present create a list of all available subdirectories contained in the tag value listdir SMOS_ROOT smos_GUI_SSScore inputs listfiles none be scanned Any directory to If present create a list of all available files contained in the tag value listfiles SMOS_ROOT smos_GUI_SSScore inputs Xmledit attribute example lt iterSchemeFile type file xmledit true gt data TDS inputs SM_ TI lt iterSchemeFile gt EST _AUX_ITCO EF 20070101T000000 20781231T235959 0000002 All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS
4. Seale factor for 25 computation seas Seale facor for C 26 computation sea Seale factor for C7 computation sco Seale factor for C 28 computation SES Seale factor for 29 computation 5052 Seale factor for CG0 computation sess Seale factor for CGI computation sea Seale factor for C2 computation sess Seale factor for G3 computation sess Sat factor for 34 computation Ses Seale factor for 085 computation Table 5 Description of the post processor configuration tags 7 2 6 Overall_Quality_Thresholds The SMOS L2 SSS processor estimates the overall quality of the output products Thresholds are needed for that All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Physical_constants tags Tag ESA A e classified as low SSS a A classified as low SSS A o O O classified as low SST Tg Qual High SST Above this threshold grid points are classified as low SST Tg Qual Low _WS Below this threshold grid points are classified as low WS Hi Above this threshold grid points are classified as low WS All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP Date 2 201 IFREMER Software User ate 25 January 2013 Manual Page 51 Table 6 Description of the overall quality threshold tags 7 2 7 Flags amp filters definitions Measurem
5. polarisation frame as well as at the antenna polarisation frame with a vector of four floating numbers Tb 0 H or X polarisation in K All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 E ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 60 Tb 1 V or Y polarisation in K Tb 2 2 Re Thy or 2 Re Txy Tb 3 Z Im Thv or 2 Im Txy In the proposed user s model Stokes 3 and 4 parameters are set to zero 9 3 Geophysical parameter retrieval from the data model of the processor User s models are functions of geophysical parameters In this tutorial this is only wind speed A collection of geophysical parameters are available to the users Values at the target including their evolutions if any along the iterative process are retrieved from the processor data model with the following line of code to be inserted in the computeForwardModelContribution routine ws measurementHandle gt gridpoint gt geophyParamValue configHandle gt index gt ind WS The list of geophysical parameters available this way is available in the DDD with the description of the param index structure in the file config_proto h 9 4 Where to call the user s model The computeForwardModelContribution function calls many forward models The user s model is called by this function Since it
6. ARGAN S SMOS processor graphical user interface Version 3 R0 November 05 2008 Prototype Processor V3 SMOS About SMOS GUI interface window Y All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 a Kz e Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 23 5 FOLDER HANDLING In the folder panel all the folders already existing are listed with details on the author the creation date and appropriate comments 5 1 Create a new folder The button New allows to open a window in which the user will specify the folder name blank characters are allowed but will be replaced by underscores the author name optional and appropriate comments optional Note Special characters such as are not allowed in the folder names Da New folder pane Folder name Author Creation date 06 November 2008 12 17 56 Comment J CANCEL Create a new Folder 5 2 Manage the created folders Renaming modifying author or comment and getting folder info are achieved through the use of a panel identical to the one for folder creation The folder export button opens a navigation window that allows the user to select the destination of the exported file A process is launched that creates a unique file named as the folder with th
7. Attribute Default Admissible Purpose Example Value values editable true true false Allow to edit the editable true next tags data type text text double Impose a type to the type double float int file next tags data A dir check is done to ensure that the data has the imposed type list none Any list of To impose a list of list 1 3 5 8 values comma admissible values separated No check is performed in this mode range none Two 2 values To impose a range range separated by alof admissible 2 35 15 45 comma values The following check is performed Vmin lt V lt Vmax fpattern none Any string chain When type is set to fpattern CONF_ file this attribute allows restricting Search will bear on the the file search to list of files matching the elements containing search condition the entered string CONF_ chain Multiple chains comma separated can be provided fextent EEF Any string chain By convention all fextent DBL the definition files are of extension EEF After the file selection the extension is subtracted from the name Tf the type is file the data must be a text string A selection button is added to the panel in order to select the file from the disk If not specified a default type is imposed to double when range attribute is used All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013
8. L2OSPP_ type file gt SMOS_ROOT smos_GUI_SSScore bin L2OSPP_06_00 exe lt default_processor_binary gt lt max_jobs description Maximum number of jobs editable true list 1 2 3 4 5 6 7 8 type int gt 1 lt max_jobs gt lt refreshing_period description Refreshing Period s list 2 5 10 30 type int unit s gt 2 lt refreshing_period gt lt configuration_selection description New job order configuration editable false gt data_core_v4 lt configuration_selection gt lt hdfview description HDFView Software location type file gt SMOS_ROOT smos_GUI_SSScore bin hdfview hdfview lt hdfview gt lt jrepath description Java Runtime Environment location type file gt SMOS_ROOT smos_GUI_SSScore jre1 6 0_01 lt jrepath gt lt gconf gt 8 1 Error Codes The prototype processor shares the same error codes as the prototype processor for a complete list see the OPSUM R D 23 section 6 The GUI can also return standard Java runtime error codes All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ARGANS ExXeerl eee Software User Date 25 January 2013 ST IFREMER rae Manual age 59 9 Modification of the L2OS open prototype tutorial 9 1 Introduction In this section a tutorial details the procedure to modify the source code of the open prototype It is assumed that the processor has been installed suc
9. Non editable variable When a new job is created files from this directory are copied into the job workspace to be configured and used during the processor run hdfview HDFview software location default is SMOS_ROOT bin hdfview hdfview See HDFview install procedure in section 3 2 jrepath Java Runtime Environment location All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS boc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 Date 2 201 ARGANS Eo E IFREMER Software User na 5 January 2013 Manual Page 58 fa ICM CSIC Description File global_conf xml Type XML Path SMOS_ROOT properties XML File structure lt xml version 1 0 encoding ISO 8859 1 standalone no gt lt gconf gt lt SMOS_ROOT type dir description SMOS ROOT INSTALL DIRECTORY gt home username L20S smos_GUI_SSScore lt SMOS_ROOT gt lt xml_rw_api_home description xml_rw_api_home editable false gt SMOS_ROOT lt xml_rw_api_home gt lt LD_LIBRARY_PATH description LD_LIBRARY_PATH editable false gt SMOS_ROOT libpackages memalloc64 SMOS_ROOT libpackages proclogs SMOS_ROOT libp ackages l1pp external_libs lib64 SMOS_ROOT libpackages xml_rw_api_linux64 projects bin lt LD_LIBRARY_PATH gt lt default_job_name description Default Job Name gt SMOS_job lt default_job_name gt lt default_processor_binary description Default Processor Binary Name fpattern
10. Orderld 1 gt Conf 1 gt List_of_Procs 1 gt List_of_Constants_Files 1 The job order file lists all input and output file names of the processor 6 2 3 Edit private configuration file Access to the private configuration file is via the job order file Use the find string feature to search the CNF_L2OS chain Job Parameters Enter searched string CNF_L20S Name Lalclor j E Previous Next Close File Edit A fpattern CNF_L20S_ Ta A btedit true z xsi schemaLocation H http 213 170 46 150 smos schemas H A type ffile mledit true 5010 1TO0U0007 xmins xsi H http www w3 org 2001 XMLSchema ir Y Start 1 xmins H http 213 170 46 150 smos schemas 2006 04 19 185548 972 Y Stop 1 editable true 2006 04 19 194948 972 Y List_of_Procs 1 A count 1 count H 1 Y Proc 1 i Y Task_Name 1 El description Private configuration project SMOS nme SSS_L2_proto dev L20S__01_00 exe F Y Task_Version 1 01_00 fpattern CNF_L20S_ Y Breakpoint 1 Y Enable 1 txtedit true A editable true st A list OFF ON y fil OFF type ile Y List_of_Brk Files 1 A count 0 xmledit true y Y List_of_Inputs 1 y A En En Asse q gt Select File Edit xmL File Edit as TXT File Uob_Order Conf 1 Co
11. SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual Page 45 ICM CSIC LOCEAN SA CETP IFREMER Tag Description Note Geophy_Param Geophy_Param ind_Rain Index of the total rain rate parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ice_sea_conc Index of the sea ice concentration Must be unique parameter The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ZNT Index of the roughness length from Must be unique ECMWE atmospheric surface model The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Acard Index of the Acard coefficient of Must be unique cardioid model The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_EWSS Index of eastward surface stress Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_NSSS Index of northward surface stress Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_NSLHF Index of net downward la
12. THE MAIN WINDOWS lt a 17 5 FOLDER HANDLING ecsscssesseccsccacesciscscestescssesssusdcescessscesoossascessccacesesssscescousseesvasvacesceeascsssossdsbossssscossessesesse 23 5 1 CREATE A NEW BOLDER a ea 23 5 2 MANAGE THE CREATED FOLDERS cccccccscecscecscecscscseecscecseecsescueessescsescseseeeecuausuausuauauauaueusueueueuaueuaueueueuenenens 23 6 JOBS HANDLING AAPP nn ksss sssassss sesso eose sria S issass s 24 Gell JJOBCREATION eua E eae bed E ET AA E A A oes cate Bae A 24 6 2 JOB CONFIGURATION 0 diia 26 7 CONFIGURATION FILES sisescsscssccidsescesescessscasessocucesesdscscsoccesecsenessassecesesesosses sees coevsssesssoescecoov essessscsaseesse 36 Fell INTRODUCTION daa 36 7 2 THE MAIN CONFIGURATION FILE cccccccecscecscecececscecseecseecseeceesceescueececsceeaceeusueeceeuceeeseeuseeusueueueusueueueueueneuenees 36 TS MOB ORDER a a cias 54 7 4 THE PRIVATE CONFIGURATION FILE ccccccccccncncncnononononononononononononononononononononnnnnnnnnnnnnonononononononononononononeneneninenes 54 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE ssssssssssssssssscrccccessssssceseccecsees 57 8 1 ERROR CODES ada 58 9 MODIFICATION OF THE L20S OPEN PROTOTYPE TUTORIAL sccccccssossssscsscccssssssseccees 59 9 1 SINTRODUCTION a scccseaccencheastewsded sjectecactioecdccensentensnes a a dacdeeseaswastion dood eo e T coeaeubendenenen EEE EERENS 59 9 2 INSERT A NEW USERS MODEL cntuescaceucedeccatees cocudcesenensevecdensdlede
13. Version 2 11 to version 2 12 SO MA ARG GS 0021 52 Table 7 Added description of Param max distance from boresight calculated by xi eta Version 2 12 to version 2 13 SO MA ARG GS 0021 Table 1 Added Switch_ott Table 3 Added Tg_swell Tg_old_sea Tg_young_sea Version 2 13 to version 2 14 SO MA ARG GS 0021 6 1 8 Updated configuration description now non editable updated example global_conf xml Added reference to OPSUM error codes 241 24 Clarified that the GUI does not include SMOSview Version 2 14 to version 2 15 SO MA ARG GS 0021 Updated example XML file directories Version 2 15 to version 2 16 SO MA ARG GS 0021 30 6 2 6 Added note explaining that selected window may not include any grid points All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 is nl On Table 3 Table 5 Table 7 51 48 Tables MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 LOCEAN SA CETP diese cad O ae ld 2013 IFREMER oftware User y Manual Page 6 Section 1 4 Removed unreferenced AD s Version 2 16 to version 2 17 SO MA ARG GS 0021 7 2 3 Table 3 Added RFL std RFL nsig amp Tg_num_RFI max Tg_num_outliers_max Row above Tg_num_outliers_max added in row above JCD comment 5a RFL nsig JCD comment 5b Added paragraph explaining that messages like WARNING The property smos dyn interface x y w h is empty or does not exist can be safely ignored See Appendix
14. container of the definitions of count L2OS science flags Flag Definition of an L2OS science flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS science flag definitions appear here List_of_L2OS_science_flags List_of_L2OS_out_of_range_flags Tag container of the definitions of count L2OS out of range flags Flag Definition of an L205 out of range flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L20S out of range flag definitions appear here List_of_L2OS_out_of_range_flags Table 7 Description of the flag definition tags The processor selects filters by their unique name which must not be modified Each filter has a description not used by the processor and a list of tests identifying by name each flag to be tested Currently the following filters are defined and used in the processor Filter Name Description Detect_snapshot_out_of_range Detect_snapshot_outliers Filter applied to grid point and measurements before performing snapshot level out of range tests Filter applied grid point and measurements before performing snapshot level outlier tests based on std ra Detect_outliers Filter applied to grid points befo
15. retrieved parameter Absolute error of prior for 1 retrieved parameter Prior error rel Relative error of prior for 1 retrieved parameter Prior _error_abs Absolute error of prior for 2 retrieved parameter Prior _error_rel Relative error of prior for 2 retrieved parameter Prior_error_abs Absolute error of prior for 3 retrieved parameter Prior_error_rel Relative error of prior for 3 retrieved parameter SSS SST UNIO VN10 tec WSn phi_wsn HS MSQS omega Uwav Guess_prior false Only used if Guess_prior false All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 LOCEAN SA CETP SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 IFREMER Software User Date 25 January 2013 Manual Tag Description Prior _error_abs Absolute error of prior for 4 retrieved parameter Prior _error_rel Relative error of prior for 4 retrieved parameter Prior_error_abs Absolute error of prior for 5 retrieved parameter Prior_error_rel Relative error of prior for 5 retrieved parameter Prior_error_abs Absolute error of prior for 6 retrieved parameter Prior_error_rel Relative error of prior for 6 retrieved parameter Prior_error_abs Absolute error of prior for 7 retrieved parameter Prior_error_rel Relative error of pr
16. 4 Breakpoint report GUI The breakpoint report GUI is either a text editor or HDFview if the breakpoint reports are in text or HDF5 format Any prototype processor modification induces breakpoint report modification and therefore an update of the breakpoint report GUI The data GUI shall be updated whenever one of the data products it deals with is modified During SMOS life it is anticipated that processor modifications will be more frequent than product format modifications Therefore it is expected that the breakpoint reports files will change frequently with regard to their content add or remove variables The viewer does not require any modification to give access to the data in the reports if the content of the breakpoint report file is modified 2 5 File management The processor uses and produces several files Some of them are reused for many processor runs and or shared by many users Sharing input files reduces data volumes but has some limitation For instance if an input file is modified while the file is used as input to the current computations the prototype processor may produce unexpected results For file sharing between users standard access rights by users and groups of LINUX operating system are used All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 Software User Date 25 January 2013 Page 14 AR GANS IFREMER SMOS L2 OS SO MA _GS E os Prototype Processor aes ie a ania LOCEAN SA CETP
17. ACRL Manual 3 Installations and operation 3 1 Installation of the core processor To install to test and to use the processor from source codes follow the procedure in section 2 1 of the SMOS L2 OS Prototype Processor Software Release Document SO RN ARG GS 0022 3 2 Installation of the GUI The SMOS L2 processor and its GUI are delivered as several compressed archive files along with installation instructions Both software packages are 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 and the GUI have been implemented and tested For the installation procedure of the GUI refer to the Prototype Processor Software Release Document SO RN ARG GS 0022 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 and that the GUI components have been correctly installed and configured 3 3 Installation of HDF view HDF view is needed to visualize breakpoint report files Installation of the software is detailed in the Prototype Processor Software Release Document SO RN ARG GS 0022 The HDF view can be directly launched using the GUI To point on the installed version or any other previously installed version modify the corresponding global configuration
18. ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 EAN SA CETP Date 2 201 IFREMER Software User ate 25 January 2013 Manual Page 21 Folder list Folder management panel Folder Utilities Test Folder 04 February 2008 18 10 35 3 jobs NEW CLOSE L This panel gives access to the following functions Zone Name Function Folder Utilities New Create a new folder Rename Rename the selected folder Modify Allow adding or modifying the folder author and the folder comment Info Display all folder information Delete Delete the selected folder Export Make a compressed archive file with the whole folder tree structure Close Close the panel 4 1 2 Exiting SMOS GUI In order to quit the SMOS GUI the user must select the Exit item in the Application pull down menu AU rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 P Pr Pa a Pr dde sor rae De n ee LOCEAN SA CETP yp ssue 2 Rev Software User Date 25 January 2013 REMER Page 22 Manual Global configuration Ne Exit Application pull down menu Warning All running jobs will be deleted at exit time Details on interface behaviour regarding programmed jobs is given in section 6 2 7 4 1 3 Version From the main window the pull down menu gt About provides the main references of SMOS GUI click anywhere in the displayed window to close it
19. L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Page 65 ICM CSIC LOCEAN SA CETP IFREMER Manual File Edit v Data_Block 1 z A editable true editable H true A type xml A xmins http 213 170 46 150 smos schemas xsi schemaLocation H http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema A xsi schemaLocation http 213 170 46 150 smo e Y L2_OS Configuration Parameters 1 xmins xsi H http www w3 org 2001 XMLSchema ir Y Iterative_Scheme 1 Y List_of_lterconf 1 xmins H http 213 170 46 150 smos schemas A count 4 Y Iterative_Conf 1 Y nRetrievedParam 1 type H text A description number of geophysical A list 0001 0002 0003 0004 0005 000 count H o A type lint 0005 d a Y List_of_retrived_Parameters 1 ESCOPEOn A count 10 A type text List of values SSS SST UN10 VN10 tec WSn phi_wsn Y retrievedParamid 1 A description Name of 1st retrieve A list SSS SST UN10 VN10 tec WSr value ll SSS Y retrievedParamid 2 A description Name of 2nd retrieve A list SSS SST UN10 VN10 tec WSr gt Name of 2nd retrieved parameter Y retrievedParamid 3 A description Name of 3rd retrieve A list SSS SST UN10 VN10 tec WSr UN10 gt retrievedParamid 4 a P retrievedParamta a E
20. dielectric All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual A LOCEAN SA CETP IFREMER Page 49 constant Epsilon0 Permitivity of free space Omega factor Acceleration of free fall Orbit duration Orbitduration Po Omega_sun Apparent solid angle of the Sun at 1 4 Ghz seen from Earth Faraday Constant U parameter of the cardioid model B parameter of the cardioid model TB_gal_mean Sky irradiance of galactic noise model O Table 4 Description of the tags with the physical constants 7 2 5 The post processor configuration file Post processing in the frame of the SMOS L2 SSS processor includes the computation of indicators on the quality of the retrieval For such computation thresholds and weights are needed All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Post_processing tags Tg Chi2_P_ max Maximum admissible value for Dg_chi2_P Dg_chi2_P in the UDP is scaled by multiplying by 1000 Tg_Chi2_P_max is not scaled Tg Chi2 P min Minimum admissible value for Dg_chi2_P Dg_chi2_P in the UDP is scaled by multiplying by 1000 Tg Chi2_P_min is not scaled Tg chi2 Threshold to set the quality flag of the retrieval process Tg sigma max Maximum SSS retrieved sigma acceptable Tg SSS max Maximum salinity acceptable Tg SSS min Min
21. in the job list and click on Modify button A panel is displayed where the processor target can be changed Once the above is completed modify the configuration file AUX_CNFOSD F so that the switch_rough selector is set to 4 as a new model is added To edit this file refer to section 6 2 2 and 6 2 4 Edit the AUX_CNFOSD F as a text file search for switch_rough occurrence and change the value of the tag Save modifications and process the job All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP IFREMER Software User Date 25 January 2013 Manual Page 62 APPENDIX A XML Editor Tool A XML editor tool The SMOS GUI provides an internal XML editor which is able to edit XML documents of the SMOS L2 OS Processor and display it as a JAVA tree component The purpose of developing and integrating a specific editor is to secure access to data by imposing attributes to the XML tags Moreover data inherit attribute values from their close ancestors to the top of the tree Note No DTD Document Type document definition is allowed This editor behaves accordingly to specific preset attributes We present hereafter the list of predefined attributes and the corresponding effect on the editor Note Any type of attributes may be added to a tag in order to describe the associated data Only specific predefined attribute
22. is a new model for roughness contribution a new case to the selector of roughness models is added to the switch function dealing with switch_roug selector New code lines are case 4 ws measurementHandle gt gridpoint gt geophyParamValue configHandle gt index gt ind WS my contribution ws tbRough break To update the processor type the following command in the SMOS_ROOT dev directory make An updated version of the processor executable should be generated although the name of the executable is the same If compilation error occur check the new code consistency and compile again make command 9 5 Testing the code modification All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS SO MA _GS E os Prototype Processor o E EN ania LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 61 To be able to test the newly created executable the user must now copy it into the bin directory of the Graphical User Interface see in section 3 2 To discriminate new and old processor executable it might be preferable choosing a different name for the new version To activate the new model the user shall create a new job and make sure that the new binary 1s correctly selected for this job see procedure at section 6 1 It is also possible to use an existing job and point on the new binary by modifying the job see section 4 1 1 1 Select the job
23. needed by the processor All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Thresholds tags oo and descending orbits A rect peep oer a o ascending and descending orbits me o oO value from which measurement becomes an l outlier RFI std Standard deviation value above which 7 measurements are considered at risk of RFI contamination mee perrea IS suspected of RFI contamination RFI cl Coefficient used to adjust measurement gt radiometric accuracy from the current RFI LUT AUX_DGGRFI RFI c2 Coefficient used to adjust measurement gt radiometric accuracy from the current RFI LUT AUX_DGGRFI PE a noise to flag a grid point SS below this threshold lead to the discarding SS measurements contaminated by erroneous galactic noise OOOO pe pO PO Tg_high_ SSS Boundary between medium SSS and high SSS Tg_high_ SST Boundary between medium SST and high SST Tg_high_wind Boundary between medium wind and high wind Tg ice concentration Maximum of ice concentration for retrieval execution Tg_low_SSS Upper limit for very low SSS Tg_low_SST Upper limit for very low SST Tg low SST_ice Temperature under which ice could be present ON Kelvin All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 LOCEAN SA CETP diese cad O ae aie 2013 IFREMER oftware User y Manual Page 47 z Tg_low_wind Upper limit f
24. parameter see section 8 3 4 GUI startup The GUI is launched by typing the following commands cd SMOS_ROOT smos_GUI_SSScore launch_smos sh Several error messages of the type WARNING The property smos dyn interface x y w h is empty or does not exist are generated by Java and can be safely ignored At launch time verification is done for the presence of the smos and libpackages soft links described in the Prototype Processor Software Release Document SO RN ARG GS 0022 The following error message is displayed in case one of the links is not present in the GUI installation directory All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 ARGANS ICM CSIC IFREMER k LOCEAN SA CETP SMOS L2 OS Doe SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual Page 15 Message The following paths have not been found in the directory host ubuntu SMOS L20S smos_gui_dev smos path soft link to the smos products libpackages path soft link to the third party libraries Please correct the problem before going further Refer to the Software User Manual installation instructions Important note The GUI contains environment variables that are set during the first launch of the interface Once the package is installed it is preferable not to move the directory structure to another location but to perform a new install instead 3 5
25. smos_GuL 5 D configuration_selection 1 Y hdfview 1 A description HDFView Software location A tvpe ffile jrepath 1 5 ine vate gconf hdfview 1 Global configuration panel setting HDFview binary location All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual Page 36 LOCEAN SA CETP IFREMER 7 CONFIGURATION FILES 7 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 This section addresses the later group of files listed below Main configuration file which includes o Iterative scheme configuration Geophysical parameter definition Thresholds Physical constants Overall quality thresholds o Post Processor configuration Private configuration file o User selection of grid points o Hidden switches o Selection of schema Job order A technical description of the content of all files handled by the prototype processor is available in R D 4 In this section the configuration parameters are detailed and their role in the processing is addressed It is assumed that the user has a basic knowledge of the MIRAS instrument and of the SSS retrieval algo
26. 03_02 exe Origin Job O Comment ok cancel The option Origin job is provided in order for the user to be able to base the new job on a former one In order to use this option it is necessary to click on the check box aside the Select button which is then enabled By clicking on the Select button the following panel is displayed which allows to select a job in a specific folder see next image All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 y ICM CSIC SMOS L2 OS Doc SO MA ARG GS 0021 a Sl OCEAN SA CETP Prototype Processor Issue 2 Rev 18 ARGANS Eo IFREMER Software User Date 25 January 2013 i Manual Page 25 New Job panel Job name SMOS_job5 Author Creation date 31 January 2008 17 28 00 Job status New Processor Executable mount users fr smos_gui_Core_v2 0 bin Origin Job IK Origin Job selection panel Comment Folder list Job list CANCEL Note It is important to ensure that the job selected as origin is compatible with the processor version used for the new job In case the default processor binary cannot be found in the bin directory of the GUL the following message is displayed along with possible recovery action to undertake Job management panel Folder list testl Job list Job Execution The default processor binary has not been found in the bin direct
27. 2 model 2 from SMOS L2 OS IDoc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 IFREMER duel Manual age 40 Tag Description Note IFREMER 3 model 3 from ICM CSIC Switch_rough3 Sea surface model 3 selector for Valid if switch_roug coefficients 3 For ICM CSIC only Switch_rough_harmonics If true process higher order roughness Only implemented model harmonics for roughness model 2 IFREMER Switch_err_mode Account for model error if true Switch_store_gal If true galactic noise computed by this model is written to the DAP Switch_card Activate cardioid model instead of flat sea model Switch_ott Index of the OTT used by the processor 0 no OTT 1 AUX_OTTIx_ 2 AUX_OTT2x_ 3 AUX_OTT3x_ with offsets to apply to Llc TB Delta_sn Maximum admissible time between two Valid if measurement to compute Stokes 1 retrievalMode 2 Tg_WS_roughness Wind speed above which roughness contributions are computed Tg_WS_foam Wind speed above which foam contributions are computed List_of_Guess_Datas List of guess_prior tags Set to false true or guess_prior Use First guess for the 1 retrieved parameter guess_prior Use First guess for the 2 retrieved parameter guess_prior Use First guess for the 3 retrieved parameter guess_prior Use Fi
28. By specifying multiple bits in the mask and or test result flags defined in the product specification that use several bits eg Fg_sc_land_sea_coastl 2 may be defined with meaningful names eg Fg_sc_land Fg_sc_ocean Fg_sc_coast Fg_sc_near_land All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Flag tag Tag Description Note Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP Software User Date 25 January 2013 IFREMER Pane Manual age 52 Tag Description Note Flag Close container Remaining L2OS measurement flag definitions appear here List_of_L2OS_measurement_flags List_of_L2OS_control_flags Tag container of the definitions of count L2OS control flags Flag Definition of an L2OS control flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS control flag definitions appear here List_of_L2OS_control_flags List_of_L2OS_science_flags Tag
29. D 4 With this graphical interface the user can among many other functions e Define names of input files and output files All rights reserved ARGANS ACREst 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 18 LOCE ETP ARGANS ExXe ad Software User Date 25 January 2013 ST IFREMER i Manual Page 13 e Define processor operation mode correction retrieval mode roughness model e Select geophysical parameters to be adjusted during iterative retrieval and its operating mode dual polarisation full polarisation or Stokes 1 e Select a processing latitude longitude window where SSS is retrieved e Select grid points where SSS is retrieved e Sets thresholds for sea ice detection Sun glint contribution and measurement validity control e Activate breakpoints To some extent the configuration interface gives access to LUT and coefficient files see section 2 4 of R D 4 For example coefficients of the roughness model 3 ICM can be modified through this interface 2 3 GUI Processor Operation The operation GUI can start the processor with selected configurations Processor runs can be scheduled queued paused resumed and cancelled Information generated by the processor on standard output stdout or on standard error output stderr is available through this interface The interface monitors processing progress and reports status of past processor runs 2
30. HW_Identifier Unique identifier of the hardware involved in the processing nnnn where n are digits or characters List_of_Input_Sc hemas Repeated variable number of times Product_Type Product type name Version of schema to be used with the version of the processor List_of_Input_Sc Tag end hemas List_of_Output_ Schemas Repeated 4 times for UDP DAP UDP report and DAP report sema Version List_of_Output_ Tag end Schemas Limits in lat lon of selected area ow Start_Lat Latitude lower limit for area selection Start_Lon Longitude lower limit for area selection End_Lat Latitude upper limit for area selection All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ost Tagend o o ICM CSIC SMOS1L20S boc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor a Rev 18 mm IFREMER Software User ate 25 January 2013 Manual Page 56 Description Longitude upper limit for area selection GridPointID Grid point ID Param Maximum distance calculated from xi eta from boresight for valid measurements scaled by 100 Default value 200 ie complete fov Table 10 Description of tags of the private configuration file All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ICM CSIC LOCEAN SA CETP Software User Date 25 January 2013 IFREMER Manual Page 57 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE Th
31. I since advanced users who might use the processor without the GUI will focus on the description of the configuration files in section 7 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 Input Output Data Description Document R D 4 the SMOS Ll auxiliary data specification format R D 11 For details on the data processing see the Data Processing Model R D 3 For details on the material released along with the processor see R D 10 1 3 Structure of the Document This document is organised to describe the GUI tool use element by element where the identified elements are e Section 2 3 and 4 Operational environment installation resources overview of the main windows e Section 5 Folder handling e Section 7 Database handling e Section 8 Jobs handling All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Prototype Processor Issue 2 Rev 18 Date 25 January 2013 Page 10 Manual 1 4 Applicable Documents The complete list of reference documents with issues amp dates is available in the Software Release Document SO RN ARG GS 0019 For readability a list of applicable documents titles
32. MOS_ROOT smos_GUI_SSScore folders folder M These directories should be manually cleaned They are not used by the processor but by the GUI All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual Page 16 Job workspace SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Input data SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Inputs Results of the run SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Outputs Reference run results SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Outputs_ref Control of processing SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Control Note The above temporary spaces are not used for the Core processor These spaces are used by the GUI to store shell scripts and files needed to manage the processing In order to run correctly SMOS GUI needs the following hardware and software resources 3 6 1 Hardware and software requirements Hardware and software requirements are detailed in the SMOS L2 OS Prototype Processor Software Release Document SO RN ARG GS 0022 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ICM CSIC LOCEAN SA CETP Software User Dat
33. O312 ___ 2 13 24032010 buidozt4___ _ __ 2 14 1405 2010 build 0315 2 s 1806 2010 buido3zt 6 ooo 2 16 0712 2010 bwia03 17 o 2 17 2705 2011 build05_00pre FAT 2 17 22062011 PostOS_OOFAT 2 18 30 11 2012 build06_00pre FAT 2 18 2501 2013 Post06 00FAT_ _ Version 1 0 SO L2 SSS ACR 012 to version 1 1 SO L2 SSS ACR 012 04 10 2006 1 4 1 5 and Remove list of reference documents list of applicable documents 1 6 and list of acronyms and add a reference to Software Release Document 2 New section with an general introduction of the prototype processor environment Numbering of existing section 2 3 etc shifts 62 Table 1 Updated according to IODD changes 63 Table 2 updated according to IODD changes All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 NININININININININININININININININININ MOS L2 ICM CSIC SMOSL20S boc SO MA ARG GS 0021 LOCEAN SA CETP essa o eines aia 2013 IFREMER eee eee l gt Manual Page 3 Section 6 4 6 5 3 2 Figures 8 2 5 8 2 6 Appendix A Appendix B New appendix with software problem report change request form Appendix C Formerly Appendix B Updated with new list ls IR of files on DVD Version 1 1 to version 2 0 SO MA ACRI GS 4412 Document reference name changed Formerly SO L2 SSS ACR 012 All Delete word prototype 1 4 1 5 1 6 Update reference to new version of Software Release Do
34. RI st 2009 2010 201 1 2012 2013 SMOS L2 OS IDoc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 IFREMER Page 4 Manual age 43 Tag Description Note ind_TatmEq Index of the equivalent atmospheric Must be unique temperature parameter The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Tair Index of the air temperature at 10 m parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_TCWV Index of the total column water vapor content parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_tec Index of the Total Electronic Content parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Tp Index of the mean period of wind waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind U Index of the wind friction velocity from ECMWE atmospheric model parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Uwa
35. SMOS L2 OS boc SO MA ARG GS 0021 a ES KM Se Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP A EZ 201 ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 1 Title SMOS L2 OS Prototype Processor Software User Manual Doc code SO MA ARG GS 0021 Issue 2 Revision 18 Date 25 January 2013 Name Function Company Signature Date Prepared SMOS Team Expert Support Laboratories Reviewed P Spurgeon Project manager ARGANS Released S Delwart Project manager ESA All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 25 January 2013 Manual Page 2 Change Record Issue Revision Date Description Approval AAA Review 1 II a ie Qualification Review 1 2 10 09 2007 Update for version 2 of the graphical user interface of the L2 OS operational processor 2 1 15 12 2007 Update to version 2 2 of the processor and version 2R1 1 of the GUI 2 2 15022008 V3QR 2 3 06 05 2008 PostV3FAT 2 4 1211 2008 For V4 pre QR 2 5 18 12 2008 Updated RIDs from pre QR 2 6 0202 2009 ForvW4TRR_____ ___ 2 7 0703 2009 Forv4FAT___ ___ 2 8 29062009 PostV4deltaFAT______ ____ 2 9 0408 2009 Post AlgoWal 16 2 10 1109 2009 build 309 2 07 01 2010 buia n ____ 2 12 27012010 build
36. T CLOSE Job Configuration Panel k Four zones are displayed 1 Input dataset 2 Break Points Configuration 3 Processing Window 4 Job execution 6 2 1 GUI testing To launch the tests select folder Test Folder in the Job management panel then select one of the two jobs e dual_pol_test_job e full_pol_test_job Click on button Configure in the Job management panel All rights reserved ARGANS ACRE st 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 18 LOCEAN ETP ARGANS EA toe Software User Date 25 January 2013 ST IFREMER Saa Manual age To run the selected test click on button LAUNCH in the Job configuration panel All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS d A ICM CSIC IDoc SO MA ARG GS 0021 wi LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 Date 2 201 ARGANS Eo E IFREMER Software User a January 2013 Manual age 28 6 2 2 Edit Job Order This button gives access to the job order file MPL_JOBORD file It opens the XML file through the XML editor tool see annexe A Job order tor job SMOS job2 in Folder Ear File Edit Vv Job_Order A editable false A xmins http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema instance A xsi schemaLocation http 213 170 46 150 smos schemas SM_TEST_MPL_JOBORD_0004 xsd gt
37. Testing the installation The GUI is delivered with two jobs in order to test the installation Before running the jobs make sure to complete the installation procedure detailed in SO RN ARG GS 0022 Refer to section 6 2 1 to complete the tests 3 6 Tree organization After installation the following file directory structures will be accessible Type Files Path GUI Libraries Geospatial Data SMOS_ROOT smos_GUI_SSScorellib gdal_install Abstraction Library amp Java MOS_ROOT smos_GUL_SSScorelgui jars run time libraries SMOS_ROOT smos_GUI_SSScore gui jedit SMOS_ROOT smos_GUI_SSScore gui logs Java runtime environment SMOS_ROOT smos_GUI_SSScore jre1 6 0_01 Configuration files SMOS_ROOT smos_GUI_SSScore properties Images SMOS_ROOT smos_GUI_SSScore gifs User manual this document SMOS_ROOT smos_GUI_SSScore doc Processor Binary executable SMOS_ROOT smos_GUI_SSScore bin HDFview installation SMOS_ROOT smos_GUI_SSScore bin hdfview_install_lin package ux64amd_vm bin Input configuration files SMOS_ROOT smos_GUI_SSScore inputs Processor data and schema SMOS_ROOT smos_GUI_SSScore smos soft link Processor libraries SMOS_ROOT smos_GUI_SSScore libpackages soft link Shell files SMOS_ROOT smos_GUI_SSScore shells Temporary spaces SMOS_ROOT smos_GUI_SSScore tmp and SMOS_ROOT smos_GUI_SSScorelpids Jobs Global workspace SMOS_ROOT smos_GUI_SSScore folders Folders S
38. _of_Iterconf Tag container of the four configurations Iterative_Conf Iterative scheme configuration 1 4 All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC ec a IFREMER D Manual Tag Description Note __nRetrievedParam __ Number of retrieved parameters 1 to 10 retrievedParamld retrievedParamld Name of 1 retrieved parameter retrievedParamld Name of 2 retrieved parameter retrievedParamld Name of 3 retrieved parameter retrievedParamld Name of 4 retrieved parameter retrievedParamld Name of 5 retrieved parameter retrievedParamld Name of 6 retrieved parameter retrievedParamld Name of 7 retrieved parameter retrievedParamld Name of 8 retrieved parameter retrievedParamld Name of 9 retrieved parameter Name of 10 retrieved parameter Only used if Prior_error_abs First_guess First guess for 1 retrieved parameter First_guess First guess for 2 retrieved parameter First_guess First guess for 3 retrieved parameter First_guess First guess for 4 retrieved parameter First_guess First guess for SU retrieved parameter First_guess First guess for 6 retrieved parameter First_guess First guess for 7 retrieved parameter First_guess First guess for 8 retrieved parameter First_guess First guess for 9 retrieved parameter First_guess First guess for 10
39. agement pull down menu In order to create open manage the jobs the user has to click on the top icon or to select Job Management gt Jobs in the main window pull down menu The following window appears containing all the functions necessary to navigate in the folders to select open create change comment or rename a job Note It is not allowed to create a job if no folder exists All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS __ poc SO MA ARG GS 0021 a EE TOES Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP ARGANS ENa RI RENEK Software User Date 25 January 2013 Manual Page D P ooo o 2 ol Folder list Job Utilities E NE Job list A SENSE Job Execution ontigure CLEAN Job Management Panel b The list of existing jobs is displayed depending on the selected folder The creation date and the status of execution are also written in this list All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doe SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Manual Page 20 ICM CSIC LOCEAN SA CETP IFREMER This panel gives access to the following functions Zone Name Function Job Utilities New Create a new job from scratch or based on an existing job Rename Rename the selec
40. amp codes is given below Reference Title Code A D 1 Level 2 Processor ICD and Operational Constraints SO ID IDR GS 0003 1 5 Reference Documents The complete list of reference documents with issues amp dates is available in the Software Release Document SO RN ARG GS 0019 For readability a list of reference documents titles amp codes is given below Reference Title Code R D 1 SMOS L2 OS Algorithm Theoretical SO TN ARG GS 0007 Baseline Document R D 2 SMOS L2 OS Operational Processor SO TN ARG GS 0011 Computation Resources Requirements R D 3 SMOS L2 OS Detailed Processing Model SO TN ARG GS 0008 R D 4 SMOS Level 2 and Auxiliary Data SO TN IDR GS 0006 Product Specification R D 5 SMOS L2 OS Architectural Design SO DD ARG GS 0017 Document R D 6 SMOS L2 OS Detailed Design Document SO DD ARG GS 0012 R D 7 SMOS L2 OS Software Verification and SO TP ARG GS 0013 Validation Plan Unit Test R D 8 SMOS L2 OS Table Generation SO TN ARG GS 0014 Requirement Document R D 9 SMOS L2 OS Prototype Processor SO MA ARG GS 0021 Software User Manual R D 10 SMOS L2 OS Prototype Processor SO RN ARG GS 0022 Software Release Document R D 11 SMOS Level 1 and Auxiliary Data SO TN IDR GS 0005 Product Specification R D 12 XML Read Write API Software User SO ID IDR GS 0009 Manual R D 13 General Softwar
41. cal parameter along with the indices All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Parameter_Index tags The data should not be modified by the user Tag Description Note ind_SSS Index of the Sea Surface Salinity Must be unique in the list parameter of indices Name Name of the geophysical parameter NameLong Long name of the geophysical parameter unit Unit of the geophysical parameter desc Description of the geophysical parameter origin Origin of the geophysical parameter Optional originID Identifier of the origin of the geophysical Not used parameter ind_SST Index of the Sea Surface Temperature Must be unique parameter The tags name nameLong unit desc origin originld are repeated here All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Manual Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 Date 25 January 2013 Page 42 Tag Description Note Geophy_Param Geophy_Param ind_WS Index of the Wind Speed parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WSn Index of the neutral wind parameter speed Must be unique The tags name nameLong unit desc origin originld are rep
42. cccecccsesceeeceuecseceeeseseseseseaeeeseseeeseaeseseseeeseeescsescsusesesceeseaseceeeceneueneeaes 9 1 4 APPLICABEE DOCUMENTS ceci iii 10 1 5 REFERENCE DOCUMENTS ia 10 16 ABBREVIATIONS asta eiii 11 2 OVERVIEW AAA O 12 Dele INTRODUCTION a e ence danenncecmeevececancescsenaedecedusenadecaneesencencesescueevecedegasnencnedvacacasuengsenseveceets 12 2 2 GUI CONFIGURATION FUNCTIONALITIES cccccccscecseeceeeceeecececeeeceeeceeeceeecececeeeceeeceueseeeceeeauaeaueesueeauaeauanauanees 12 2 3 GUI PROCESSOR OPERATION ccccccccscecececececececececececeeeceeeceeeceeeceeeceeecueecuceauaucuaeauaeausesuaeauauauauauauauaeauaeauanees 13 24 BREAKPOINT REPORT Aaa 13 2 5 BILE MANAGEMEN E cased aedeneasaascaeaenadencussecensanacdens 13 3 INSTALLATIONS AND OPERATION ccccccssssssssscccscssscsccecccscesssssecccesccessssssceccseccscsssenecescesscssssenecees 14 3 1 INSTALLATION OF THE CORE PROCESSOR cccccccecececesececesecececesececececececececesesecesescescceuceseceseseseseecsesesesesvevevevess 14 3 2 INSTALLATION OF THE CUL A A costusceeieveseccs 14 3 3 INSTALLATION OF HDF VIEW cccccccccececececececececececececesecesecesecesesesecesecesesesesesesesesceuseseseseceseseseseseseseseeteeeess 14 Bed IGUESTARTUP dida tdt anita steeds 14 3 5 TESTING THE INSTALLATION ia 15 3 0 PREBJORGANIZATION aa 15 4 THE GRAPHICAL USER INTERFACE cssssssssssssssssscccscccsssssscesccsccessssssceccecsesssscsccescessssssscececees 17 A T
43. cessfully see section 3 1 Users who want to modify the processor code will most likely change the brightness temperature model at the surface This tutorial explain 1 how to insert user s model in the source code 2 how to retrieve geophysical parameters to feed the user s model 3 where to call the user s model 4 how to update the processor 5 how to use the user s forward model Before any source code change the user need to make sure that he she has write permission on the source code files under the SMOS_ROOT dev directory 9 2 Insert a new user s model In this tutorial the user s model is very simple It simulates a contribution to the surface brightness temperature in H and V polarisation directions due to roughness effect that is proportional to the wind speed WS TbH TbV 0 1 WS To add this model to the global forward model used by the processor to compute brightness temperatures that are compared to the measurement a new function is created in the SMOS_ROOT dev forward_model forward_model c function The new function is inserted after line 87 include and before the function computeForwardModelContribution is defined The new code lines are int my contribution double ws double my TB 4 my TB O 0 1 ws my TB 1 0 1 ws my TB 2 0 0 my TB 3 0 0 return RETURN CODE SUCCESS The general forward model handles the four Stokes parameters at the surface target
44. cument 2 1 Update figure 1 2 1 and 2 4 Visualization tool is not available in this version of the GUI 3 1 Update installation instructions 3 2 Updated file tree description 3 Po 33 Updated processor and GUI dependencies 6 and 7 Sections swap Job handling comes before configuration description Po 6 Section updated for modified job configuration panel 7 Section modified according to the new configuration file Configuration files of the prototype are merged into the AUX_CNFOS2 file New section for the job order file EA GUI configuration file example updated Appendix C Appendix C with list of break points removed List of available break point is given through the break point list of the GUI See section 6 2 3 Version 2 0 to version 2 1 SO MA ACRI GS 4412 17 12 2007 31 Updateinstallation instructions 9 New section tutorial for open prototype modification Version 2 1 to version 2 2 SO MA ACRI GS 4412 3 3 1 o Page 2 2 2 3 2 4 Minor updated and clarifications 3 Sectionrenamed o 3 New section for operational processor installation All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L2 OS boc SO MA ARG GS 0021 LOCEAN SA CETP goa o comes aia 2013 IFREMER eee eee l gt Manual Page 4 o Section Comments 3 2 3 4 1 3 4 2 inor updates 6 2 5 eneration of the list of grid points is clarified 7 2 1 to 7 2 5 Tabl
45. deltaP Variation of the 1 retrieved parameter to compute derivative deltaP Variation of the 2 retrieved parameter to compute derivative deltaP Variation of the 3 retrieved parameter to compute derivative deltaP Variation of the 4 retrieved parameter to compute derivative deltaP Variation of the 5 retrieved parameter to compute derivative deltaP Variation of the 6 retrieved parameter to compute derivative deltaP Variation of the 7 retrieved parameter to compute derivative deltaP Variation of the 8 retrieved parameter to compute derivative deltaP Variation of the 9 retrieved parameter to compute derivative deltaP Variation of the 10 retrieved parameter to compute derivative itMax Maximum number of iteration lamdaMax Maximum of Marquardt diagonal amplifier Tg_num_meas_min Minimum number of measurements to start the retrieval Switch_foam Compute foam coverage of contribution RetrievalMode Select between five retrieval modes 0 full polarisation 1 dual polarisation from dual 2 dual polarisation from full 3 Stokes 1 from dual 4 Stokes 1 from full strategy 1 5 Stokes 1 from full strategy 2 6 Stokes 1 from full strategy 3 Switch_gal Model for galactic noise contribution 0 Model 0 1 Model 1 2 Model 2 Switch_roug Model for sea surface roughness effects 0 None 1 model 1 from IPSL LOCEAN All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013
46. e 25 January 2013 IFREMER Pave Manual age 17 4 The graphical User Interface 4 1 The main windows At launch time as the GUI is loading the next window is displayed 8 ARGANS Interface components are loading Please wait SMOS Then the main SMOS Interface appears 12 EMOS GUI Version oie Prototype Processor V3 Application Job Management Job Execution Graphics ES Ea 8 sau 4 1 1 User Interface principles SMOS GUI is dedicated to run SMOS Processor All the functions are accessible from the main window menu which is split in 3 main functionalities Application to access the global parameter configuration window and the exit function All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP IFREMER Software User Date 25 January 2013 Manual Page 18 Job Management create or manage folders and jobs configure and run jobs Job Execution launch the job viewers monitor running or scheduled jobs check pas jobs Graphics to access shortcut to HDFview access the user manual this document in PDF format and GUI current version about function 4 1 1 1 Job management ES smos OPERATION Version 2 R1 1 Core Processor V2 3 Application Job Management Job Execution Graphics La Folders pr ia Jobs Y Job Folder Man
47. e Library User Manual SO MA IDR GS 1002 R D 14 SMOS L2 OS Input Output Data SO TN ARG GS 0009 Definition R D 15 SMOS L2 OS Architectural Design Same as R D 6 Document Detailed Design Document is available in electronic version only The DDD is a web site dedicated to the documentation of the Operational Processor All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 IDoc SO MA ARG GS 0021 SMOS L2 OS P Protot e Processor ra o ii aaa LOCEAN SA CETP yp ssue 2 Rev IFREMER Software User Date 25 January 2013 Page 11 Manual Reference Title Code R D 16 SMOS L2 OS Algorithm Validation Plan SO TP ARG GS 0015 R D 17 SMOS L2 OS Algorithm Validation Test SO TR ARG GS 0016 Procedure Report R D 18 SMOS L2 OS Parameter Data List SO TN ARG GS 0010 R D 19 Earth Explorer Mission CFI Software EE MA DMS GS 0003 Explorer_Lib Software User Manual R D 20 SMOS L2 OS Operational Processor SO MA ARG GS 0018 Software User Manual R D 21 SMOS L2 OS Prototype Processor SO RN ARG GS 0022 Software Release Document R D 22 Earth Explorer Mission CFI Software CS MA DMS GS 0001 Mission Conventions document R D 25 Software Verification and Validation Plan SO TP ARG GS 0025 Acceptance Test R D 26 Software Verification and Validation Plan SO L2 SSS ACR 0009 System Test 1 6 Abbreviations The list of ac
48. e SMOS GUI contains global parameters that can be configured through the internal XML editor tool see image below SMOS prototype OPERATION ersion 1 R1 Application Job Management Job Execution Graphics Help Global configuration wat e Exit a The global configuration panel accesses the following parameters SMOS_ROOT At first launch of the GUI this variable is automatically set to the GUI install directory xml rw_api home Non editable variable This variable is based on SMOS_ROOT one and is used to configure processor runs LD_LIBRARY_PATH Non editable variable This variable is based on SMOS_ROOT and is used to configure processor runs Default job name By default a unique name is given to a job created through the processor This name is constituted with this root name and a counter number increasing as jobs are created Default processor binary When several versions are available the creation panel will select this value by default Default processor binary can be modified here max_jobs Several jobs can run at the same time The number entered manually by the user should depend on the computer speed and available amount of RAM memory This option should only be used if the computer has a multi processor structure and has enough RAM memory to run several processing e g 4 Gb x max_jobs Refreshing period This period in seconds is used for updating the job progress information zone Configuration selection
49. e extension tar gz that is copied into the destination directory selected by the user The following message is displayed when the copy is over x Successful export of the directory in the file users fr SMOS test_ tar gz All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS SO MA GS a Ss KM Se Prototype Processor e ie a ania LOCEAN SA CETP i ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 24 6 JOBS HANDLING A complete run of SMOS prototype will be achieved after a full configuration of the job 6 1 Job creation From the job creation window the button New opens a window in which the user will specify the job name blank characters are allowed but will be replaced by underscores gt the author name optional and appropriate comments optional The processor executable binary can also be changed on this panel Click on Processor Executable button a selection window will be displayed listing every L20SPP_ files contained in the bin directory The user is invited to select the desired binary for the concerned job any location is allowed By default the binary is set in the global configuration window see section 8 Sus E New Job panel Job name SMOS _job2 Author Creation date 06 November 2008 12 23 17 Job status New Processor Executable 1ost ubuntu SMOS L20S smos_GUI_SSScore bin L2OSPP_
50. e to the __gsl__ file added V4 pre QR minutes action All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 LOCEAN SA CETP diese cad O be Elio 2013 IFREMER ni l gt Manual Page 5 Version 2 5 to version 2 6 SO MA ARG GS 0021 Table 5 Explained Tg_Chi2_P_max amp Tg_Chi2_P_min amp scaling of Dg_chi2_P in UDP Explained how to view the scheduled run date time Version 2 6 to version 2 7 SO MA ARG GS 0021 Removed incorrect Table 1 from missing ind_ tags above 3 6 Added gui jedit amp gui logs to Type GUI corrected typo libpackage s Version 2 7 to version 2 8 SO MA ARG GS 0021 Table 7 Updated CNF_L2OS with List_of_Hosts 8 Updated global_conf xml Now only 2 test jobs removed old mire test job Updated table 3 with clarified descriptions from IODD Version 2 8 to version 2 9 SO MA ARG GS 0021 7 2 1 Change in configuration UST gt Uwav interdependence of geophysical parameters see AlgoVal 16 MoM Version 2 9 to version 2 10 SO MA ARG GS 0021 1 2 3 1 Corrected references 40 Table 1 Added Switch_rough_harmonics Switch_store_gal removed Switch_retr Added Tg_fara_meas_min Tm_fara_delta_angle_max Added Generate_DAP Removed Supress_DAP 3 6 Added directory for Outputs_ref 0 7 4 Replaced AD 5 with RD 14 Version 2 10 to version 2 11 SO MA ARG GS 0021 14 3 1 Corrected reference to Prototype Processor Software Release Document
51. eated here Geophy_Param Geophy_Param ind_phi_wsn Index of the azimuth of neutral wind parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Tsea_air Index of the air sea difference parameter temperature Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_UST Index of the friction velocity from ECMWF Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ OMEGA Index of the inverse wave age parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_HS Index of the parameter inverse wave height Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_MSQS Index of the Mean Square Slope of Wave parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_TAU Index of the optical thickness of the atmosphere parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param All rights reserved ARGANS AC
52. ent and grid point selection is defined in the ATBD and DPM and implemented via a number of filters defined in the configuration file Each filter specifies a number of flag names to test if any of these flag tests are met the filter is activated and the measurement grid point is rejected Flags the names of which must all be unique are defined in the configuration file as a bitmask to be applied by the processor to each measurement grid point and a test result if the test result value matches the flag is considered to be true This flag filter mechanism allows measurement grid point selection to be managed via the configuration file without the need to recompile the processor This flexibility may be needed for example when there are changes to the Level 1 products or to the measurement grid point selection criteria when agreed by ESL There are 5 different categories of flags each set defining a list of flag names masks amp tests List_of_L1c_measurement_flags applied to Llc measurements List_of_L2OS_measurement_flags applied to L2OS measurement flags List_of_L2OS_control_flags applied to L2OS grid point control flags List_of_L2OS_science_flags applied to L2OS grid point science flags List_of_L2OS_out_of_range_flags applied to L2OS grid point out of range flags For detailed definitions of the L2OS flags see the IODD RD 14 amp the L2 product specification RD 4 For the Llc flags see the L1 product specification RD 11
53. er A delete button is available to erase the jobs from the list multiple selection is possible The deletion bears only on the list The jobs are not physically erased from the simulator Past Job Control Panel Job Name Folder Launch Date Il Run Time s ji SMOS_job folder_test 2 gt Finished SMOS_job folder_test 2006 06 20 15 49 00 5 Finished SMOS_job1 test 2006 06 21 17 45 42 6 Finished SMOS_job1 test 9 2 Finished 6 2 9 Graphical software S SMOS OPERATION Version 2 R1 1 Core Processor V3 Application Job Management Job Execution Graphics T y gt a HDFView software SILOS The interface presents a shortcut command in order to launch HDFview to edit HDF breakpoint report files The commands are defined through the XML editor of the global configuration panel see section 8 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOSL20S boc SO MA ARG GS 0021 SS Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP ARGANS Kei Software User Date 25 January 2013 ST IFREMER Pase Manual age 35 5 Global configuration Panel File Edit Y gconf A editable true editable H true D SMOS_ROOT 1 D xml_rw_api_home 1 description HDFView Software location gt LD_LIBRARY_PATH 1 D default_job_name 1 fil gt default_processor_binary 1 type us Db max_jobs 1 D refreshing_period 1 Value mostrubuntu smos 205
54. er 2008 02 04 15 28 39 0 install_test_folder 2008 02 04 15 28 44 34 IL DELETE PAUSE Each line of the list is dedicated to a job It allows to check the progress of the run through the Run time given in seconds and the Progress given in percentage It is also possible to edit the output log file of any running job and monitor the progression of the computation As shown in the above snapshots the names and availability of the buttons displayed in this window depend and may vary according to the type of job selected e On arunning job the user can gt Pause then Resume it gt Delete it gt Edit the log file in real time e On a scheduled job it is allowed to gt Queue it equivalent to run it immediately if no other job is already running according to the maximum number of possible concurrent jobs gt Delete it gt View the scheduled run date time scroll or maximize the window to see the last entry in the row All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L208 Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ICM CSIC LOCEAN SA CETP Software User Date 25 January 2013 IFREMER Pase Manual age 34 e A queued job can only be deleted The launching is automatic when it is detected to be possible The past job control panel gives access to formerly run jobs It allows viewing the log files _gsl_ saved in each job fold
55. es revised for consistency with the interface Appendix 3 Appendix added with processor error codes 6 1 heck on processor binary presence added with error message 3 2 Check on processor soft links to products and libraries presence on GUI startup added with error message 3 2 6 2 7 6 2 8 4 1 11 4 1 2 efer to section 6 2 7 for the behavior of the GUI when closed 6 1 Clarification on copies of configurable files Tutorial updated Page lt ZI x pP lt O 4 2 O ie N ctr Q lt O 4 O S W A Nn 4 gt Q ye Q He aN IN N All Update of the L2OS processor version to be 2 3 Minor updates Version 2 3 to version 2 4 SO MA ARG GS 0021 12 11 2008 all i i Updated graphics amp images from latest GUI version Table Added List_of_Params Table 3 Added Tg_gal_noise_pol_max Tg_WS_gal Tm_gal_noise_pol Tg_Acard_max Tg Acard_min Tg_sigma_Acard_max lt O 4 2 O 5 ie P mt O lt O 4 m e 5 N U A Nn gt gt ye Q Q Nn o p Replaced references to IODD with Product Specs corrected Red Hat 4 to 5 replaced obsolete A D 2 with A D 5 pre QR RID jed 151 Added doc ID to change record pre QR RID jcd 152 pre QR RID jcd 153 files pre QR RID jcd 157 all libraries pre QR RID jcd 155 jed 160 amp 161 UN Expanded datasets to set of auxiliary data files pre QR RID jcd 163 Referenc
56. es4 ea Limit of delta between forward model and Lic ffov Stokes 4 TBs in EAFFOV Tm_sun_limit Limit of acceptable sun glint contribution Tm_fara_delta_angle_max Limit of error between targ2SatZenithAngle amp AUX_FARA x faraday rotation angle Ts_snapshot_out_of_ range Maximum proportion of land ice within a snapshot below which all measurements are discarded fm_12 rfi snapshot_out_of_range set if any have fm_out_of_ range set Prem ARA computing snapshot standard deviations Ts Limit for snapshot XX YY standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12 rfi high _snapshot_std set Ts_std_stokes3 Limit for snapshot Stokes 3 standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12 rfi high _snapshot_std_stokes3 set Ts_std_stokes4 Limit for snapshot Stokes 4 standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12 rfi high _snapshot_std_stokes4 set Table 3 Description of the tags with the thresholds meas_min _std 7 2 4 Physical_constants The SMOS L2 SSS processor uses several physical constants that are listed in the table below The user should not change the values of these tags All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Physical_constants tags epsilonInf High frequency limit value of relative
57. hy_Param ind_SP Index of the surface pressure parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_UN10 Index of the neutral wind zonal component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_VN10 Index of the neutral wind meridional component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WSwav Index of the wind speed from ECMWF WAM wave model parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WS_U Index of the wind zonal component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WS_V Index of the wind meridional component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_PP1D Index of the peak period of 1D spectrum of waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated here All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doe
58. imum salinity acceptable ooo araso Zeroordersensitiviy aS aT arasa FirstordersensiiviydS4T Tg Acard max Maximum value of valid retrieved Acard Tg Acard min Minimum value of valid retrieved Acard Tg sigma Acard max Maximum value of sigma of valid retrieved Acard Generate DAP Boolean If false no OSDAP2 is generated if true OSDAP2 is written sen Seale factor for CQ computation seor Seale factor for OO computation 5032 Seale factor for CG computation se sat factor for 4 computation sca sale facor for CS computation scs Seale factor for C 6 computation All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 MOS L2 OS ICM CSIC S Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 u o Software User Date 25 January 2013 Manual Page 50 sas o o sa cir for computation OOOO OOOO se Seale factor for O8 computation sca Seale factor for CO computation sor Seale factor for C 10 computation sc sale facor for CO computation ses Seale factor for CUA computation sca Sat factor for US computation sess Seale factor for C 16 computation sess Seale factor for CU computation sea Seale factor for C9 computation sea Seale factor for 20 computation sos Seale factor for CO computation sca Seale factor for 22 computation seas Seale factor for C03 computation seas Seale factor for 24 computation sea
59. ion All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013
60. ior for 7 retrieved parameter Prior_error_abs Absolute error of prior for 8 retrieved parameter Prior_error_rel Relative error of prior for 8 retrieved parameter Prior_error_abs Absolute error of prior for 9 retrieved parameter Prior_error_rel Relative error of prior for 9 retrieved parameter Prior_error_abs Absolute error of prior for 10 retrieved parameter Prior_error_rel Relative error of prior for 10 retrieved parameter sig_th_mod Uncertainty of the forward model in H Accounted for in the polarisation at target level cost function and in sig_tv_mod Uncertainty of the forward model in V outlier detection polarisation at target level sig_st3_mod Uncertainty of the forward model Stokes 3 at target level sig_st4_mod Uncertainty of the forward model Stokes 4 at target level KappaDia Factor for multiplying Marquardt diagonal lamdaini Initial value of the Marquardt diagonal amplifier deltasig Increment to standard ratio for convergence deltaChi Cost function variation for convergence fCon Maximum of conditioning factor List_of_Delta_Parameters List of deltaP tags All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS IDoc SO MA ARG GS 0021 LO ee T Prototype Processor Issue 2 Rev 18 IFREMER Software User Date 25 January 2013 Manual Tag Description Note
61. lected The user is invited to enter the date and time of run in the format hh mm mm dd yyyy All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP IFREMER Software User Date 25 January 2013 Manual Page 32 Job Execution RUN NOW SCHEDULE 17 22 06 22 2006 It is possible to replace numbers in the date zone or by positioning the mouse cursor in the zone to be modified and by clicking on the up down arrow menu by this way numbers will increase one by one Clicking on the button Launch will schedule the job gt If the scheduling date is passed the user will be warned and invited to modify his selection LS x A Warning the schedule time is passed please modify your selection gt Else the job is scheduled When exited or crashed the interface behaves differently according to running or programmed jobs The following situations alone or mixed can be met before crash 1 One or several jobs were running or paused 2 One or several jobs were scheduled 3 One or several jobs were queued When the interface is exited e running jobs are deleted e queued jobs are queued again when interface is launched e scheduled jobs are scheduled again only if scheduling time is not passed 6 2 8 Job monitoring Two monitoring tools are proposed to follow or analyse the job runs SMOS protot
62. mes 1 xmins H http 213 170 46 150 smos schemas A count 1 Y Input File 1 editable true V File_Name 1 E AANA lt lt gt gt 22222 A description Definitions of geoStem parameters Configuration d A editable true count H 1 A fextent EEF A fpattern AUX_CNFOSD description Definitions of geoStem parameters Ci A btedit true A type lfile A xmledit true fextent EEF x men Inputs 1ESI_AVA_UNFOSD_ 2UUU LU 11 UUDU 4 Y State 1 fpattern AUX_CNFOSD Non Alternative Y List_of_Time_Intervals 1 p count 1 txtedit true Y Time_Interval 1 Y Start 1 type file 2006 04 19 185548 972 AAA Y Stop 1 E 2006 04 19 194948 972 meni tus s V File_Name 1 i X le T Inputs SM TEST AUX CNFOSD eae SET Select File Edit XML File Edit as TXT File J Uob_Order List_of_Procs 1 Proc 1 List_of_Inputs 1 Input 16 List_of_File_Names 1 Input_File 1 File_Name 1 File Edit Y Earth_Explorer_File A editable true gt Earth_Explorer_Header 1 gt Data_Block 1 All configuration parameters are listed in section 7 6 2 5 Edit Break Points list This button gives access to the break points management panel It allows activating break points defined in the DPM R D 3 Break points are places in the processing where some of the local variables are copied in a file for detailed investigation Data storage format is either HDF5 or text files The user must be awa
63. ncugcuses REEE ERRERA 59 9 3 GEOPHYSICAL PARAMETER RETRIEVAL FROM THE DATA MODEL OF THE PROCESSOR ccccccccccccncncncnoninininnonons 60 9 4 WHERE TO CALL THE USER S MODEL ccccccccecscecececececeeeceeeceeecececeeeceeeceeecuceceaecueecuaeaeaeauaeauaeauaeauaeauaeauaeananees 60 9 5 TESTING THE CODE MODIFICATION ccccccconcccncnnnnncnonononononononononononononnnnnononononnnnnnnnnnnnnonononononononononononononenonininenes 60 APPENDIX A XML EDITOR TOOL csscscsscsssccsescscsosessssctesscsososscenccnssssvcsosecsscsebscevecesecoscsassssesceseces sossessecncesese 62 APPENDIX B FEEDBACK FORM oocssesssccssesosscssssscssesssssescncncscnsocsssendscsssensasessebsstessonsesesoonsssnscsesecosecesseescessos 68 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 ARGANS ICM CSIC SMOS L2 OS boc SO MA ARG GS 0021 Loctanrsvcere Ponpe Prose ham zRo 1S ST IFREMER one Manual List of Tables Table 1 Description of the iterative scheme configuration tags oooonoccccnoncccnoncnononcnononaninnncnnnns 41 Table 2 Description of the geophysical parameter definition tags oocoonooccconccccnoncnonananonancnnnno 46 Table 3 Description of the tags with the thresholds 200 0 eeeeseeesseceeeeeeeeeeneeceaeeneesseeeenees 48 Table 4 Description of the tags with the physical CONStantS oooooococonocccnoncccnnnnccnoncconnnacinnncninns 49 Table 5 Description of the post processor configuration tags oooccnocccnonononnnaonnnnnnononcn
64. nfig_Files 1 File 1 File_Name 1 Then click on a Edit XML file button to display the file through the XML editor or in a text editor using Edit TXT file A complete definition of the private configuration file is given in A D 5 All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 ed 4 LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 29 6 2 4 Edit auxiliary configuration file To access this file a procedure identical to the above for the private configuration file must be followed Find string must locate the AUX_CNFOSD F chain note that the correct AUX_CNFOS file type should be selected to match the Llc input file type D dual polarisation F full polarisation Then click on Edit XML file button see annexe A to use the XML editor tool or Edit TXT file oe eehilelse pa Enter searched string AUX_ENFOSO File Edit nter searched string comme EETA PSS a Y Input 16 l Next Close aLocation H http 213 170 46 150 smos schemas Im V File_Tyl Search for previous occurence AUX_CNFOSD xmins xsi H http www w3 0rg 2001 XMLSchema ir V File_Name_Type 1 Stem List_of_File Na
65. of FAT minutes for JCD comments referenced above Version 2 17 to version 2 18 SO MA ARG GS 0021 7 4 Table 7 7 2 3 Table 3 Deleted Switch_af Tg_gal_noise_pol_max Tm_gal_noise_pol Tm_out_of_range Added Switch _OTT_AscDes Switch _GN2_AscDes RFI_cl RFI c2 Tg_num_meas_outliers_min Tg_num_meas_RFI_outliers_min Tg_num_RFI_outlier_max Tg_current_RFI_max_X Tg_current_RFI_max_Y Tm_out_of_range_affov Tm_out_of_range_eaffov Tm_out_of_range_stokes3_affov Tm_out_of_range_stokes3_eaffov Tm_out_of_range_stokes4_affov Tm_out_of_range_stokes4_eaffov Ts_snapshot_out_of_range Ts_meas_min Ts_std Ts_std_stokes3 Ts_std_stokes4 7 2 1 Table 1 Corrected definitions of First_guess amp Prior_error_abs rel now Only used if Guess_prior false clarified definition of Guess_prior 1 2 1 Added new section Flags amp filters definitions amp new Tables 7 o S 7 4 Table 7 enumbered now Table 10 dded list of tables gt A 2 R All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 ARGANS Eo E IFREMER Software User Date 25 January 2013 Page 7 Manual Table of Content 1 INTRODUCTION E A E E E O 9 Ved GENERAL deca 9 1 2 GUIDE TO THIS DOCUMENT 335escs cess se0c0seeccb 5bestectece cen ii aiii 9 1 3 STRUCTURE OF THE DOCUMENT 0 cccccccccccccc
66. on_tree Clear Fm_valid for suspicious measurements Acard_grid_point_decision_tree Clear Fg_ctrl_valid for ignored grid points Table 8 Names amp descriptions of filters Up to 32 flags may be defined for each filter and the count for each filter must match the number of flags specified as Reject in the list of tests All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Filters tag Tag Description Note Name Name of the filter Must be unique Description Verbose filter description Reject Flag name The tag Reject is repeated here count 1 times Remaining filter definitions appear here Table 9 Description of filter definition tags All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 3 S LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 54 7 3 Job order The job order file MPL_JOBORD provides the processor with input and output file names The simplest way to change the name of an input or output file is to find using the FIND STRING button the File Name tag of the file type the user want to modify For example to select a new AUX ATMOS file push the button FIND STRING and enter the file type 1 e AUX_ATMOS KG Tag finder Enter searched string AUX_ATM os le Pre
67. oncnnncnnnn nos 50 Table 6 Description of the overall quality threshold tags ooonoococnnocccnoncccnnaccnnoncconnncconnncnnnno 51 Table 7 Description of the flag definition tags eee eesecsseceseeeeeecsaeceeeeeeeeeaeecaessseesseeenaees 52 Table 8 Names amp descriptions of IS a 53 Table 9 Description of filter definition tags cia dd ia 53 Table 10 Description of tags of the private configuration filO oononnnnnnncnnnonnccnnonnnorncnnnnnnnoo 56 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 3 LOCEAN SA CETP E 1 ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 9 1 Introduction 1 1 General This document is the user manual of the SMOS L2 OS Prototype Processor and its Graphical User Interface GUD Both the prototype processor and the GUI have been developed to be operated on Linux 64 bit platforms They are two independent software packages The processor can be 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 The GUI helps the user to set up configuration files and to operate the processor The GUI gives access to basic visualization tools for the output products as well 1 2 Guide to this document The user manual of the processor is embedded in the manual for the GU
68. or low wind speed Tg_medium_SSS Boundary between low SSS and medium SSS Tg_medium_SST Boundary between low SST and medium SST D Tg_medium_wind Boundary between low wind and medium wind Tg_moonglint_max minimum of measurements flagged for moonglint to flag a grid point Tg_num_meas_outliers_min Minimum number of measurements per polarisation for applying the measurement outlier test ya gt 3 a D Un lt E a Tg_num_meas_RFI_outliers_ Minimum number of measurements per min polarisation for applying the RFI measurement outlier test point flag a grid point as suspected of RFI contamination Tg num RFI outlier_max Percentage of measurements flagged for possible by RFI outlier detection above which Fm_L2_RFI_ outlier is set Minimum to flag a grid point as likely to be contaminated by X polarisation RFI as indicated by the current RFI LUT AUX_DGGRFI Minimum to flag a grid point as likely to be contaminated by Y polarisation RFI as indicated by the current RFI LUT AUX_DGGRFI P 2 a zs rj pa 5 o Pa of ice is suspected to flag a grid point Tg max rainfall Limit of acceptable rain Tg_TEC_gradient Threshold for TEC gradient Tg lat ice Acard Latitude min for ice detection from Acard model Tg SST ice Acard SST threshold for ice detection from Acard model Tg Acard_ice Acard threshold for ice detection Tg fara meas min Threshold for of non inte
69. ory Please correct the problem before going further 1 Check that variable default_processor_binary points on an existing processor in the global configuration panel 2 Check the presence of the binary processor in the bin directory 3 Refer to the Software User Manuel installation instructions Job creation cancelled All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS AR ICM CSIC Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 LOCEAN SA CETP ARGANS Exe E IFREMER Software User Date 25 January 2013 Manual Page 26 If selected the whole configuration of the selected former job will be copied into the new one instead of the one defined as the default dataset in the global configuration panel see section 8 6 2 Job configuration After the job creation from the job creation window select the newly created job in the proposed list and click on the button Configure in the Job Execution zone The following window appears tates Configuration panel tor job SMOS job2 in Folder fest Folder Job Parameters Name SMOS_job2 Folder Test_Folder Processor version host ubuntu SMOS L20S smos_GUI_SSScore bin L2 OSPP_03_02 exe Origin Job None UL Cteatis e hlosas 4 Input Dataset Break Points Configuration Edit Job Order Edit Break Points List Processing Window Job Execution Selection Entire globe applied RUN NOW LAUNCH Loc EDI
70. r break points can be added to the list of selected break points following the same procedure Break point can be removed from the list of selected break point by selecting them multiple selection is also allowed and pushing the Delete Break Point button Once the list of selected break points is complete it shall be saved pushing the Save button To confirm the break point system activation the Breakpoint Enable tag of the Job Order shall be set to ON See section 6 2 2 to edit the job order The data file in HDF format generated by the break point will be available in the Outputs directory of the job directory The file name is the name of the break point It is editable through the HDF view software 6 2 6 Processing window selection This button allows entering a processing window limits manually or on a world map The following window is displayed All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 Software User Date 25 January 2013 Page 31 LOCEAN SA CETP IFREMER Manual ZoomIn Zoom Out Reset to Globe Save Selected zone and Close The user is invited to select a rectangular area by dragging the mouse over the map or by entering the latitude longitude numerical values directly in the corresponding boxes Once the zone is selected a click on the button named Save selected zone and Close
71. re performing measurement level outlier tests Detect_RFL outliers Filter applied to grid points before performing All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Ee 2 Rev 18 Software User Date 25 January 2013 IFREMER Page 53 Manual measurement level RFI outlier tests Detect_measurement_outliers Filter applied to measurements before performing measurement level outlier tests Set_RFI flag_from_outlier_tests Set Fm_L2_RFI from RFI outlier tests Set_RFI_flag_from_snapshot_tests Set Fm_L2_RFI from RFI snapshot tests Set_sun_flag_from_Llc Set Fm_L1c_sun measurement flag from Llc flag s Set_RFI_flag_from_Llc Set Fm_L1c_RFI measurement flag from Llc flag s Measurement_decision_tree Clear Fm_valid for suspicious measurements Grid_point_decision_tree Clear Fg_ctrl_valid for ignored grid points Poor_quality Set Fg_ctrl_poor_retrieval if retrieval results flagged as suspicious Poor_quality_Acard Set Fg_ctrl_poor_retrieval for Acard if retrieval results flagged as suspicious Poor_geophysical Set Fg_ctrl_poor_geophysical if geophysical conditions may have contaminated retrievals Poor_geophysical_Acard Set Fg_ctrl_poor_geophysical for Acard if geophysical conditions may have contaminated retrievals Dg_user Criteria for Dg_user DAP counter Acard_measurement_decisi
72. re that break point activation slows down the processing and might generate very large data file It is strongly recommended to limit the processing to 1 to 10 ISEA grid points when break points are in use All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 18 9 S LOCEAN SA CETP i ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 30 ay Breakpoint management tor job SMOS Jobe in Folder Test Folder Selected Break Points Available Break Points Break Points utilities BP_PRP_3_1 3 BP_PRP_3_1 1 BP_PRP_3_14 BP_PRP_3_1 2 _Add Break Point BP_PRP_3_1 5 BP_PRP_3_1 6 BP_PRP_3 2 2 BP_PRP_3 1 7 A e pl do BP_PRP_3_5 1 BPLPRP31 8 0 Save BP_PRP_3 2 1 BP_PRP_3_3 1 Close BP_PRP_3 4 1 BP_PRP_3 4 2 BP_PRP_5 1 BP_PRP_7_1 1 BP_PRP_7_2 1 BP_PRP_7_2 2 BP_PRP_8 1 BP_PRP_8 2 BP_PRP_12 1 Breakpoint management multiple breakpoints can be selected by holding shift or alt key The list of available break points is located in the centre of the panel Upon the users needs and according to the DPM one or several break points are selected from the available list To select multiple breakpoints the User has to hold the shift or the alt key Then the break points can be added to the list of selected break points pushing the Add Break Point button Othe
73. rithm see R D 1 This document is aimed at giving the user key information on the processor configuration Format of the files is not addressed here all configuration files are in XML and header structures defined for files of an Earth Explorer mission are out of the scope of this document All XML tags documented in the next sections are under the Data_Block tag Descriptions given below are also available in the Graphical User Interface Tags that contain only other tags sons are in yellow The tag name is repeated after the last tag contained by the father O OOO 7 2 The main configuration file The main configuration file is referenced with AUX_CNFOSD or AUX_CNFOSF in its filename It contains most of the configuration data of the processor Tables in next subsections give details on the file content In these tables items highlighted in yellow are tags With the interface items highlighted in green can be edited and their content is detailed in the next sections 7 2 1 The iterative scheme configuration The iterative scheme configuration includes key information for the iterative scheme e g selection of forward model or maximum number of iterations All the data are repeated three times because up to three SSS retrievals are attempted per grid point All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Iterative _Scheme tags Tag Description Note List
74. ronyms is available in the Software Release Document SO RN ARG GS 0019 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 LoceaNsascere Pros Preso Zen IFREMER Manual Page 12 2 Overview 2 1 Introduction Although the L2 OS processor can be operated in batch mode the software is released with a Graphical User Interfaces GUI that simplifies its use Figure 1 shows an overview of the processor and its environment Main functionalities of the GUI are e Configuration of the processor with access to all processor configuration files see R D 4 e Management of processor runs scheduler log progress pause stop The GUI gathers all the functionalities sketched by the three boxes in light blue of Figure 1 except for SMOSview visualization of products can be done using SMOSview The breakpoint report files in HDF5 format can by visualized with hdfview which software can be launched from the GUL n z O Level 1 Graphical User Interface Configu ration ms A a Operator GUI Or PFW Operation SMOS view stdout stderr log progress Breakpoint GUI hdfview Breakpoint reports Figure 1 Overview of the SMOS L2 SSS processor files and graphical user interfaces 2 2 GUI configuration functionalities The configuration GUI generates configuration files see section 2 5 of R
75. rpolated o AUX_FARA x measurements Tg_swell Threshold above which sea state is classified as a swell dominated otherwise sea state is wind waves dominated Tg old sea Threshold fraction for old waves if omega is below this threshold waves are old above this threshold waves are young direction and the moon direction Tm DT ice Threshold of difference between actual and flat sea _ model brightness temperatures above which ice contamination is suspected fm_suspect_ice true Tm high gal noise High galactic noise boundary All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOS L2 OS boc SO MA ARG GS 0021 LOCEAN SA CETP goa O rare aie 2013 IFREMER oftware User y Manual Page 48 ET Tm_high_sun_glint Boundary between medium sun glint and high sun glint Tm_low_sun_glint Upper limit for no sun glint Po Tm Max GN Error Limit of acceptable galactic background error E ETA Tm_medium_sun_ glint Boundary between low sun glint and medium XX Y Y TBs in AFFOV m out of ra eaffov Limit of delta between forward model and Llc m_out_of ra T T m out of range stokes3 aff Limit of delta between forward model and Llc ov Stokes 3 TBs in AFFOV Tr nge_stokes3 ea Limit of delta between forward model and Llc ffov Stokes 3 TBs in EAFFOV Tm out of range stokes4 aff Limit of delta between forward model and Llc ov Stokes 4 TBs in AFFOV Tm _out of range stok
76. rst guess for the 4 retrieved parameter guess_prior Use First guess for the 5 retrieved parameter guess_prior Use First guess for the 6 retrieved parameter guess_prior Use First guess for the 7 retrieved parameter guess_prior guess_prior guess_prior Use First guess for the 8 retrieved parameter Use First guess for the 9 retrieved parameter Use First guess for the 10 retrieved All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 If true first guess is taken as equal to the prior if false processor uses first guess from this LUT for initialisation SMOS L2 OS _ boc SO MA ARG GS 0021 ICM CSIC a IFREMER Manual Tag Description Note parameter Repeat tags above Repeat tags above Repeat tags above Table 1 Description of the iterative scheme configuration tags 7 2 2 The geophysical parameter definitions The SMOS L2 SSS processor handles a list of geophysical parameters for which a detailed definition in needed Each geophysical parameter is identified by a unique index During the processing whenever the processor needs a geophysical parameter value the index is used to retrieve the value from the list of geophysical parameter values The index is used to store the definition name unit of the parameter as well The geophysical parameter definition file provides the prototype processor with the definition of the geophysi
77. rt list of grid points is useful when breakpoint reports are activated and the processor is fast to produce small L2 products Processing window can be defined using the GUI List of grid point can be set up by editing the private configuration file as a text file OverWriteMeasu Brightness tepmeratures of Lic file are patched with brighness rement temperatures computed for outlier detection Gaussian noise is added to brightness temperaturetures according to either radiometric All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 LOCEAN SA CETP diese cad O aye ae 2013 IFREMER oftware User y Manual Page 55 Description Ps uncertainty or Stddev see below if Stddev gt 0 OverWritePrior Prior after bias correction in AGDP module are patched with random values with gaussian probability distribution function with mean prior and standard deviation uncertainty on prior icUncertainty Seed of the random number generator with gaussian probability distribution function Seed is random if tag value is negative Mean bias to be added to brightness temperatures when patched Standard deviation of noise to be added to brightnes temperature when they are patched Radiometric uncertainty of Lic product is used in stddev lt 0 api Host_Name Host name for the Processors are installed as identified by PDPC Core It is a logical name with DNS not an IP direction
78. s allow the performance of specific checks on data value entered by the user Example list ot Itertont editelole true coum 3 gt rereana lt nMin type int range 1 256 description Minimum number of measurement to start the retrieval gt 5 lt nMin gt lt swltea foam lisit ceue iailse ceseription Comouce toan Coverage ancl contribution gt true lt switch_foam gt In the above example the variable nMin has the type int and can be edited inherited from the ancestor list_of IterConf It is editable which means that the value can be changed through the GUI XML editor The value is 5 and any modification can only be ranged between 1 and 256 Beyond this range or if the value is not a integer number the user is warned with a specific message The attributes description is displayed in the editor and is considered only as static information Predefined Attributes The list of predefined attributes is given below Please note 1 that this list is extendable for specific checks Please contact ARGANS for integration 2 by default all the data are editable and of type text 3 all attributes and values are written in lowercase All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual IDoc SO MA ARG GS 0021 Issue 2 Rev 18 Date 25 January 2013 Page 63
79. s for attribute value is not editable The number between square brackets is a counter used to discriminate tags using the Same name Log for SMOS_jobtotol in folder user_guide cor 2 c log4c A editable true A version 1 1 0 C config 1 gt C category root o C category system 9 C category NOBP FOM 1 A appender stdout A list enabled disabled A name NOBP FOM 1 A priority trace Ly enabled gt C category BP FOM 2 2 gt C category NOBP FOM 3 gt C category NOBP FOM 4 gt C category NOBP FOM 5 gt 1 category NOBP FOM 7 When the attribute name exists the counter number is replaced with the value of the attribute see left corner example gt The right panel is used to display a tag value along with all its associated attributes The inherited attributes are flagged with a H Note The editable tags are written in blue When editable the value associated to the tag 1s written in green Below the right zone a button band is available and is dependent on the tag attributes gt If the value is not editable then the buttons is changed to lot editable gt If the value is editable and the tag is not of type file the buttons is Update Value gt If the value is editable and the tag is of type file the buttons are Update Value Select File gt If the value is editable and the tag is of type directory the buttons are Update Val
80. te XML path to the selected tag Earth_Explorer_File Data_Block 1 filenames 1 iterSchemeFile 1 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Manual Prototype Processor Issue 2 Rev 18 Date 25 January 2013 Page 68 IDoc SO MA ARG GS 0021 Appendix B 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 Prototype Processor The forms shall be sent to smos argans co uk Feedback form Number HHH Contact Name and institution Initiated date Person Level low medium shigh critical Status open pending c losed 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 PM SMOS project date team Workload low medium high hours days Implementation yes no Justification Justify implementation or no implementat
81. ted job Modify Allow adding or modifying the job author and the job comment Info Display all job information Delete Delete the selected job Export Make a compressed archive file with the whole job tree structure Close Close the panel Job Execution Configure Allows to configure and run the job if not running Clean This function is used only if the GUI or the computer crashes for any reason human bug while a job is running At recovery time the interface will not be able to modify the status of the running jobs if any that will remain running and when running the configuration of a job cannot be accessed so the job will remain inaccessible forever The only way to enter the configuration again is to clean the status of the job and bring it back to New 4 1 1 2 Folder management Each job is stored in a folder In order to open create and manage the folders the user has to click on the top Icon or to select Folders in the Job Management pull down menu The following window appears containing all the functions necessary to list the existing folders to select create change comment or rename a folder It allows the user to create a new folder where to organize the storage of all the simulations Note The number of jobs contained in each folder is displayed along with the creation date in the folder list zone All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 LOC SMOS L2 OS Doc SO MA
82. tent heat flux Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SSHF Index of net downward sensible heat Must be unique flux accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SSR Index of net downward shortwave flux at Must be unique surface accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS __ poc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 18 ICM CSIC LOCEAN SA CETP Date 2 201 IFREMER Software User ate 25 January 2013 Manual Tag Description Note Index of net downward thermal radiative Must be unique flux at surface accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Table 2 Description of the geophysical parameter definition tags 7 2 3 The thresholds The SMOS L2 SSS processor performs many tests to check the retrieval conditions and to verify the usefulness of the data Often the tests are comparisons between measurements or geophysical parameter values on the one hand and thresholds on the other hand The table below gathers all the thresholds
83. ue Select Directory gt If the value is editable and the tag is of type file and the pointed file is an XML editable file then the buttons become Update alue Select File Edit XML File gt If the value is editable and the tag is of type file the pointed file is an XML editable file and the text is editable then the buttons become All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS ATA KR SS o Prototype Processor a ie E ans LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 25 January 2013 Manual Page 67 Select File Edit XML File Edit as TXT File Clicking on the button Edit XML File will open a new XML editor with the file pointed to by the tag value Clicking on the button Edit as TXT File will open a simple text editor able to display xml format This editor allows modifying the file and save it When a value is modified the button Update value is enabled The user has to click on this button to update the left panel structure with the newly entered value Then the option Save located on the top menu File is enabled To make the change permanent the user has to click on Save At any moment an undo is possible through the use of the top Edit menu option Undo Note When the Save option is activated all the undo history is lost At the bottom of the window one can see the comple
84. v Index of the wind friction velocity from ECMWE WAM wave model parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_2mDT Index of the dew point temperature at 2m parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Cd Index of the drag coefficient with waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Prototype Processor Software User Manual ICM CSIC LOCEAN SA CETP IFREMER IDoc SO MA ARG GS 0021 Issue 2 Rev 18 Date 25 January 2013 Page 44 Tag Description Note ind_phi_wind Index of the azimuth of wind parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SHWW Index of the significant height of wind waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SLP Index of the sea level pressure parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geop
85. vious Next Close na Clicking enter or Next button will expand the xml tree of the job order file highlight and select the File Type tag that has AUX ATMOS for value The tag to be changed is the next File_Name tag further down on the XML tree 7 4 The private configuration file The private configuration file CNF_L2OS is used to define system parameters This file is in XML ASCII format Complete definition of the file name along with header and Data_Block tag fields are provided in the section 2 5 4 of the IODD R D 14 The role of the private configuration file is to define 1 State of so called hidden switches that allows special operation modes of the prototype processor 2 Versions of schemas to be used with input and output products 3 Processing window 4 List of grid points to be processed Items 1 3 and 4 are key configuration parameters for open prototype users If the number of grid points of the list of selected grid points set with the count attribute of the tag List_of_grid_points is not zero it means that the processor will consider only the grid points with identifier listed in the list of grid point If such list is defined it takes precedence to the processing window which is ignored The L2 OS UDP and DAP product will contain only the grid point processed whereas in the case of a full or window processing all grid points of the Llc file with be present in the L2 products Defining a sho
86. ype OPERATION Version 1 R1 Application Job Management Job Execution Graphics Help age Job control panel SLDS Past jobs control panel 1 The job control panel 2 the past jobs control panel All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 18 Date 2 201 ARGANS Eo TH IFREMER Software User paa 5 January 2013 Manual age 33 A ICM CSIC The job control panel is used to monitor alive runs This means that all the running scheduled or queued jobs can be monitored through this functionality When selecting Job Control Panel from the main window pull down menu the following window appears only if containing a job E Job Control Panel ee ee d aa Job Name Folder Launch Date Run Time s Status Progress Process ID test4 install_test_folder 2008 02 04 15 15 19 lo Scheduled 0 1856946237 4 il pevere Paust queve LOG EDIT CLOSE Example of scheduled job E Job Control Panel j j O om Job Name Folder Launch Date Run Time s Status Progress 0 test4 install_test_folder 2008 02 04 15 20 43 5 Ill DELETE PAUSE RUN NOW LOG EDIT CLOSE Example of running job I Job Control Panel am Folder Launch Date i Progress install_test_fold

Title: SMOS L2 OS Prototype Processor Software User Manual Doc

Contents

Download Pdf Manuals

Related Search

Related Contents