Home

SO-MA-ARG-GS-0021 Issue: 2 Revision: 17 Date: 22

1. Zone Name Function Job Utilities New Create a new job from scratch or based on an existing job Rename Rename the selected 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
2. Job list Job Execution The default processor binary has not been found in the bin directory 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 SMOS L2 OS d E ICM CSIC Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP ARGANS Exe Software User Date 22 June 2011 ST IFREMER Pave Manual age 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 Gontiguration pene 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 LC ete Blasss Ji Input Dataset Break Points Configuration Edit Job Order Edit Break Points List Processing Window
3. 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 true Only used if Guess prior true All rights reserved ARGANS ACRI st 2009 2010 2011 LOCEAN SA CETP SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 IFREMER Software User Date 22 June 2011 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 prior for 7 retrieved parameter Prior error abs Absolute error of prior for 8 retrieved para
4. install_test_folder 2008 02 04 15 28 44 34 IIl 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 Onarunning job the user can Pause then Resume it 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 Delete it 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 2009 2010 2011 SMOSL2OS poc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 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 folder A delete button is available to erase the jobs from
5. All rights reserved ARGANS ACRI st 2009 2010 2011 e ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 17 ARGANS ACRI IFREMER Software User Date 22 June 2011 Manual Page 7 Table of Content 1 INTRODUCTION p 9 DM OBNERAEGere e erieciee eere eet eet eet EE e Chee EE eres deese sad EEE dete cease EE A 9 1 2 GUIDE TO THIS DOCUMENT ecce eetee tete eene br ee e eade vene tee eee tbe vier eese ex ev ae our EEAO le e e eae ee ERN EE NER 9 1 3 STRUCTURE OF THE DOCUMENT ic cereo tee ee CARERE CAN FREE Ee NER R VEN VERE ER CERE CET EV ERE SERRE ENSE RERO REEL UU NERIS 9 14 APPLICABILE DOCUMBNIIS tectae cinere eoa ea eher n TUERI exe ee va e reo t e QUEE e cese a e erue EE 10 1 5 REFERENCE DOCUMENTS cccccccccccccccscccececsveceveceveuevsususuevsusesusesusususususususesusssuecsusesusveusvsusvsusvsusessesesevessveueens 10 1 6 ABBREVIATIONS unsrer iere ae ee tete diese be vede de e o bed ee e tete d te cite eo b ees 11 2 OVER VIEW A 12 21 INTRODUCTION needed e Dee de Ee deer 12 2 2 GUL CONHGURATION FUNCTIONALITIES nnec ene pee RE VR OPE QE RP UP E EEEE ERE EUROPE E EET ERE ERR PEU RUNE 12 2 3 GUL PROCESSOR OPERATION 5 cet eexeue ese eeeu Ae EEEE EAEE tere rv enero eene bes r ke re ete ere e re e EE RE 13 2 4 BREAKPOINT REPORT GUIX eeeeeeeeeeneene e e enn nnn nnn nnn nnne nnn nnn nnns nns ns ns a n sa s sana EESE p enean annua 13 2 5
6. BIEEMANAGEMENT eese eer aE e er Ea E cate eerie epe eee sere esie eese ree ic Pop N 13 3 INSTALLATIONS AND OPERATION eere esee eene seen nonas ette tasas assets eet en asses e sete sa sese see eese tn aene 14 3 1 INSTALLATION OF THE CORE PROCESSOR cccccccecccccccececesccccccececccecececccecccececececescccececseseesecceececeeseseeseceeseesevens 14 32 INSTALLATION OE THE GUL coreene eret Re ris Ee epe se see E ete lebe E ERU E eR ev US Park esee tee pe e etu e tot evi ve bet 14 3 3 INSTALEATION OE HDBVIEW 2 eeoee eroe oet eve o ERE E EE PETER RERO E COE ET U E SNR E CERE EE TEE VERS Co E ETE ENS EE EE RE MER TUNE NUS 14 E ECC UBI RSs 422 2 Rm m 14 3 5 TESTING THE INSTALLATION ee ee eoe co cscsce en enean en a ea nego su cseseovu cv esse en ee geo eu eee eo en eee eo ea eee ee e egeo ee ee eue e eue 15 3 6 TREEORGANIZATION vireran itane ere eiie E e Rite id ek R N vga 15 4 THE GRAPHICAL USER INTERFACE eene eee eren ee eee to eese enne seta to aee ease sese snae esee anas eee en eese ea aa 17 4 1 HE MAIN WINDOWS icti ceteetteete reste trente ttr emet rus e eeeetetie rire eee diee edet ede E eed 17 5 FOLDER HANDLING CEL 23 5l CREATE A NEW FOLDER ereiten e ERE AR ERE A EEE A ERE AR EREE A E EREE ERES 23 5 2 MANAGE THE CREATED FOLDER S serie sanee EE E E E E ea S 23 6 JOBS SES Ci 24 6 1 JOB
7. Shell files SMOS_ROOT smos_GUI_SSScore shells Temporary spaces SMOS_ROOT smos_GUI_SSScore tmp and SMOS_ROOT smos_GUI_SSScore pids Jobs Global workspace SMOS_ROOT smos_GUI_SSScore folders Folders SMOS_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 2011 ICM CSIC LOCEAN SA CETP IFREMER SMOSL2OS poc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 Manual Page 16 Job workspace S8MOS ROOT smos GUI SSScorelfolders 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
8. ersion 1 R1 Application Job Management Job Execution Graphics Help aget Job control panel S405 Past jobs control panel 1 The job control panel 2 the past jobs control panel All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 LOCEAN ETP ARGANS Exetel e diste Software User Date 22 June 2011 ST IFREMER B Manual age 33 a 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 BG Job Control Panel i 2 2277 OR mg Job Name Folder Launch Date Run Time s Status Progress Process ID test4 install test folder 2008 02 04 15 15 19 jo Scheduled 0 1856946237 4 ji pevere Paust queve LOG EDIT CLOSE Example of scheduled job B amp Job Control Panel j j 1 n Eg 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 LOGEDIT CLOSE Example of running job I Job Control Panel n E Folder Launch Date i Progress install test folder 2008 02 04 15 28 39 0
9. xmins http 213 170 46 150 smos schemas xsi schemaLocation H http 213 170 46 150 smos schemas A xmlns xsi http www w3 0rg 2001 XMLSchema A xsi schemaLocation http 213 170 46 150 smo r 7 L2 OS Configuration Parameters 1 xmins xsi H http www w3 org 2001 XMLSchema ir V Iterative Scheme 1 v List of Iterconf 1 xmins H http 213 170 46 150 smos schemas A count 4 V Iterative_Conf 1 7 nRetrievedParam 1 type H text A description number of geophysical A list 0001 0002 0003 0004 0005 00 count H 10 A type int 0005 d m 7 List of retrived Parameters 1 ExCuDEOD A count 10 A type text List of values SSS SST UN10 VN10 tec WSn phi_wsn V retrievedParamld 1 A description Name of 1st retrieve 7 A list SSS SST UN10 VN10 tec WSr Balu aa SSS Vv retrievedParamld 2 A description Name of 2nd retrieve A list SSS SST UN10 VN10 tec WSr gt Name of 2nd retrieved parameter V retrievedParamld 3 A description Name of 3rd retrieve A list SSS SST UN10 VN10 tec WSr UN10 P retrievedParamld 4 EM q P retrievedParamta 5 Z Thea L2_OS_Configuration_Parameters 1 Iterative_Scheme 1 List of Iterconf 1 terative Conf 1 List of retrived Parameters 1 retrievedParamld 2 SMOS GUI XML editor example The above example shows the editio
10. 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 hy Pai nition ophysical ral 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 2011 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Manual Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 Date 22 June 2011 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 repeated here Geophy Param Geophy Param ind phi wsn Index of t
11. Job Execution Selection Entire globe applied RUN NOW LauNcH Loc eniT 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 ACRI st 2009 2010 2011 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 17 LOCEAN ETP ARGANS Ee ipee ud eie Software User Date 22 June 2011 ST IFREMER Pase Manual age 27 To run the selected test click on button LAUNCH in the Job configuration panel All rights reserved ARGANS ACRI st 2009 2010 2011 iE ARGANS EXSM LOCEAN SA CETP SMOS L2 OS Prototype Process Software User Manual ICM CSIC IFREMER Doc SO MA ARG GS 0021 or IIssue 2 Rev 17 Date 22 June 2011 Page 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 59590902 in Folder eenroder File Edit 7 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 schema
12. Job status New Processor Executable iost ubuntu SMOS L20S smos GUI SSScore bin L2OSPP 03 02 exe Origin Job LJ 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 ICM CSIC SMOSL2OS Doc so MA ARG GS 0021 E Ss LOCEAN SA CETP Prototype Processor Issue 2 Rev 17 ARGANS ACRI IFREMER Software User Date 22 June 2011 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 J 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 GUI the following message is displayed along with possible recovery action to undertake Job management panel Folder list testi
13. June 2011 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 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 SMOSL2 OS
14. 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 VNIO 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 PPID 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 2011 SMOSL2OS IDoc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 Softw
15. 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 Software 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 O 2009 2010 2011 IDoc SO MA ARG GS 0021 SMOS L2 OS MES E Protot e Processor E E rs ee LOCEAN SA CETP yp ssue 2 Rev IFREMER Software User Date 22 June 2011 Page 11 Manual Reference Title Code R D 16 SMOS L2 OS Algorithm Validation Plan SO TP ARG GS 0015 R D 17 SMOSL2 OS Algorithm Validation Test SO TR ARG GS 0016 Procedure Report R D 18 SMOSL2 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 SMOSL2 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
16. 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 GUI 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 L1 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 2011 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Prototype Processor Issue 2 Rev 17 Date 22
17. V File Name Type 1 Stem 7 List of File Names 1 xmins H http 213 170 46 150 smos schemas A count 1 v Input File 1 editable true Y File Name 1 3 A description Definitions of geoStem parameters Configuration c A editable true count H 1 A fextent EEF A fpattern AUX_CNFOSD description Definitions of geoStem parameters Ct A txtedit true A type lfile A xmledit true fextent EEF x Inputs I EST AUAX UNFUSD ZUUDUIUII UUUU 1 7 State 1 fpattern AUX CNFOSD Non Alternative 7 List of Time Intervals 1 count 1 txtedit true 7 Time Interval 1 V Start 1 type file 2006 04 19 185548 972 Se V Stop 1 E 2006 04 19 194948 972 meni tus 7 File Name 1 i X lir n Inputs SM TEST AUX CNFOSD eae SET Select File Edit XML File Edit as TXT File J job 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 7 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 eith
18. in the Prototype Processor Software Release Document SO RN ARG GS 0022 The HDFview can be directly launched using the GUI To point on the installed version or any other previously installed version modify the corresponding global configuration 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 2011 s ARGANS ICM CSIC IFREMER k LOCEAN SA CETP SMOS L2 OS IDoc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 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
19. window the pull down menu gt About provides the main references of SMOS GUI click anywhere in the displayed window to close it ARGAN S SMOS processor graphical user interface Version 3 R0 November 05 2008 Prototype Processor V3 SMOS About SMOS GUI interface window Ye All rights reserved ARGANS ACRI st 2009 2010 2011 SMOSL2OS poc SO MA ARG GS 0021 E Kz n Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 22 June 2011 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 t New folder pane Wan Folder name Author Creation date 06 November 2008 12 17 56 Comment T 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
20. with the creation date in the folder list zone All rights reserved ARGANS ACRI st O 2009 2010 2011 LOC SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 EAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 21 Folder list Folder management panel m Folder Utilities Test Folder 04 February 2008 18 10 35 3 jobs NEW CLOSE k 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 All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 Page 22 LOCEAN SA CETP IFREMER Manual Global configuration We 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
21. 10 puldO3 11 S pT 12 2701 2010 buld03 12 o 2 13 24032010 pwldO3 14 o 2 14 1405 2010 buld03 15 2 15 1806 2010 puldO3 16 2 16 0712 2010 buldO3 17 2 17 2705 2011 buld05 O0pre FAT 2 17 22062011 PostOS OOFAT 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 and list of acronyms and add a reference to Software Release Document New section with an general introduction of the prototype processor environment Numbering of existing section 2 3 etc shifts 62 Tablel Updated according to IODD changes 63 Table updated according to IODD changes 64 Table 3 updated according toIODD changes 65 Table 4 updated according to IODD changes All rights reserved ARGANS ACRI st 2009 2010 2011 t3 r2 ro ro ro ro rto r2 ro pro to r2 r2 pP2 b2 P2 2 MOS I2 ICM CSIC SMOSL2OS IDoc SO MA ARG GS 0021 oe UE T c M IFREMER eee satis Manual Page 3 Section 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 Is CIR 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
22. 5 1 6 Update reference to new version of Software Release Document 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 a 33 Updated processor and GUI dependencies 6 and 7 Sections swap Job handling comes before configuration description 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 8 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 Updateinstalation instructions 9 New section tutorial for open prototype modification 72 Version 2 1 to version 2 2 SO MA ACRI GS 4412 6 2 4 6 2 3 Clarification Correct references a Page 1 2 i 2 1 2 2 2 3 2 4 3 3 1 3 2 New section for operational processor installation Installation procedure updated 34 1 3 42 All rights reserved ARGANS ACRI st O 2009 2010 2011 MOS I2 ICM CSIC SMOSL2OS J poc So MA ARG GS 0021 LOGAN Up E c M IFREMER eee satis Manual Page 4 a Page Section Comments 6 2 5
23. 72 1 to 7 2 5 Appendix 3 6 1 Check on processor binary presence added with error message 3 4 Check on processor soft links to products and libraries presence on GUI startup added with error message 32 27 628 4 1 1 1 lean function clarified 4 1 2 6 1 Version 2 2 to version 2 3 SO MA ACRI GS 4412 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 ON T zoumuam 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 puse Tg Acard max Tg Acard min Tg sigma Acard max Version 2 4 to version 2 5 SO MA ARG GS 0021 Replaced references to IODD with Product Specs corrected Red s Hat 4 to 5 replaced obsolete A D 2 with A D 5 pre QR RID jcd 151 Added doc ID to change record pre QR RID jcd 152 1 4 1 5 Added reference amp applicable document names amp acronyms pre QR RID jcd 153 Replaced SSS database with configuration amp auxiliary data files pre QR RID jcd 157 all mE Description of input files clarified pre QR RID jcd 159 jcd libraries pre QR RID jcd 155 jcd 160 amp 161 i Expanded datasets to set of auxiliary data files pre QR RID jcd 163 Reference to the __gsl___ file added V4 pre QR minutes action Type prong corrected pre QR RID jcd 162 All rights reserved A
24. C LOCEAN SA CETP IFREMER 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 HHHH Contact Name and institution Initiated date Person Level low medium high 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 implementation All rights reserved ARGANS ACRI st 2009 2010 2011
25. CREATION deret eese een etude e Ee ERE 24 6 2 JOB CONFIGURATION ecu eece EE e CHEER EC E EE OMEN e Der REE EE RENTE DC EE e RE UI E DLP RN ses REE TENE CERE ERE ME DL ORDER 26 7 CONFIGURATION FILES 4 ecce ceeeo eoa eo es eo e vea ea oet p ra eee vpr Y ose ee cua une ee eo ea aeuo aae une nb SoS aea KREERET 36 Tell INTRODUCTION moresco e tie meeterieceet tee tesietens esee rtestece siete bev tegets Prem E e see bert Eee Bie 36 7 2 THE MAIN CONFIGURATION FILE ccccccccsscsssscssscscccssccscccsescsesessecsecssecssecssecsueccseessecsseesseusueusseseseueseneseneneness 36 4 3 JOB ORDERS Jcecdectecesacecsicccececee tabececdedeceawetadadevacucenswataceceads eeenmetedegeuaccconseatbeednucedeeasuebbdedesesteessuebneddesetbeaseaet eens 50 7 4 THE PRIVATE CONFIGURATION FILE ccccccccscscscscscecececsceceeecseecececseeceeeceeeeusesuauceeeseaeeesesuaesuaeauaeauauauaeauaeananees 50 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE sscssssssssssscsssccsccesssssccscecsesces 53 8 1 ERROR CODES mitmene ee eaa E ara aae E AE E aE a aa AEA Daa AEAN E OE EE E A EE 54 9 MODIFICATION OF THE L2OS OPEN PROTOTYPE TUTORIAL e eren nennen nonu 55 9 1 INTRODUCTION ecesceorec es tot etesee ree e Pot utes iter s odit ee aaaea tee ese od eade otene stel eie Dee a dau 55 9 2 INSERT A NEW USER S MODEBL eee e ene e ene nn nnn nnn nn nnn nnne nnn nsn nsns nsn a nsns nsns ss nnn s s s sanas a nana np aae n ana nua 55 9 3 GEO
26. D 25 Software Verification and Validation Plan SO TP ARG GS 0025 Acceptance Test R D 26 X Software Verification and Validation Plan SO L2 SSS ACR 0009 System Test 1 6 Abbreviations The list of acronyms is available in the Software Release Document SO RN ARG GS 0019 All rights reserved ARGANS ACRI st 2009 2010 2011 MOS I2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 Manual Page 12 LOCEAN SA CETP IFREMER 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 GUI n z O Level 1 Graphical User Interface Configu ration ms n Operator GUI Or PFW Operation SMOSview stdout stderr log pro
27. 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 All rights reserved ARGANS ACRI st O 2009 2010 2011 MOS I2 ICM CSIC SMOSL2OS J poc s0 MA ARG GS 0021 LOGAN UE E c M IFREMER ee setae Manual Page 51 Description Hidden Switches Tag start 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 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 rescaleRadiometr Obsolete icUncertainty Seed 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 Stddev Standard deviation of noise to be added to brightnes temperature when they are patched Radiometric uncertainty of L1c product is used in stddev lt 0 bypass_xml_rw_ Input data reading is faster with this option api Ignore AGDP Do not process AUX_AGDP Ignore Pol Gal Do not process polarised galactic noise ie ignore LUT tQQ 00 amp Noise LUT tUU 00 in AUX GAL2OS H
28. Location http 213 170 46 150 smos schemas SM TEST MPL JOBORD 0004 xsd P 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 cNr L20s Name Lalclor j ew Previous Next Close File Edit A fpattern CNF_L20S_ aj Ta A tttedit true xsi schemaLocation H http 213 170 46 150 smos schemas H A type file mledit true osororroovgoo2 xmins xsi H http www w3 org 2001 XMLSchema ir V Start 1 xmins H http 213 170 46 150 smos schemas 2006 04 19 185548 972 V Stop 1 editable true 2006 04 19 194948 972 7 List of Procs 1 A count 1 count H 1 V Proc 1 V Task Name 1 description Private configuration project SMOS nme SSS L2 proto dev L2OS 01 00 exe 7 Task Version 1 01 00 fpattern CNF_L20S_ 7 Breakpoint 1 7 Enable 1 txtedit true A editable true e A list 0FF ON 7 fil OFF type ile V List of Brk Files 1 A count 0 xmledit true X 7 List of Inputs 1 F ux IT m gt Select Fi
29. PHYSICAL PARAMETER RETRIEVAL FROM THE DATA MODEL OF THE PROCESSOR eene 56 9 4 WHERE TO CALL THE USER S MODEL eene e e eene ene n enhn enhn enhn nnn nnn na nnns nnns enn sns anna anas ena n anna a nne naa n nua 56 9 5 TESTING THE CODE MODIFICATION e ecce nn eene nnn rera nn nn nnn nnns nns ansa nnns nsns s assa anna ERTE EREE asap nean Et 56 APPENDIX A XML EDITOR TOOL eee te cs oce eos soa iu Pase eris reos eo le rk seen Fase ea ab dsvesssesdsosvondssnscersesonesssueeseesses 58 All rights reserved ARGANS ACRI st O 2009 2010 2011 MOS I2 ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 IFREMER Ens Manual All rights reserved ARGANS ACRI st 2009 2010 2011 Software User Date 22 June 2011 Page 9 ARGANS IFREMER SMOS L2 OS SO MA ARG GS E te KA OT Prototype Processor mae sisi Tue LOCEAN SA CETP ACRI Manual 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
30. RGANS ACRI st 2009 2010 2011 MOS I2 ICM CSIC SMOSL2OS IDoc So MA ARG GS 0021 LOGAN Up D I M IFREMER eee satis 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 08 O 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 Version 2 11 to version 2 12 SO MA ARG GS 0021 52 Table 7 Added description of Param max distance from bores
31. S 0021 ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 IFREMER Pase 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 Uwav Index of the wind friction velocity from ECMWF WAM wave mode
32. SMOS L2 OS poc SO MA ARG GS 0021 a ES EM SE Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 22 June 2011 Manual Page 1 Title SMOS L2 OS Prototype Processor Software User Manual Doc code SO MA ARG GS 0021 Issue 2 Revision 17 Date 22 June 2011 Name Function Company Signature Date Prepared SMOS Team Expert Support Laboratories Reviewed P Spurgeon Project manager ARGANS Approved S Lavender Quality control ARGANS Released S Delwart Project manager ESA All rights reserved ARGANS ACRI st 2009 2010 2011 SMOS L2 OS poc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 2 Change Record Issue Revision Date Description Approval ENNNUd uim RN Review a Co MENNN 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 J1 02208 VjOR 2 3 06 05 2008 PotV3FAT O 2 4 1211 2008 ForV4pe QR O 2 5 18 12 2008 Updated RIDs from pre QR 2 6 0202 2009 ForV4TRR D 2 7 0703 2009 For VAFAT 2 8 29062009 Pos VAdela FAT 2 9 0408 2009 Post AlgoWal 16 2 10 1109 2009 buld03 09 2 1u 070120
33. SO RN ARG GS 0022 All rights reserved ARGANS ACRI st 2009 2010 2011 SMOSL2OS poc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 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 A Interface components are loading Please wait C SMOS Then the main SMOS Interface appears 4 EMOS Guile version 31077 Prototype Processor V3 Application Job Management Job Execution Graphics Li Es 8 se 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 O 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP IFREMER Software User Date 22 June 2011 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 managemen
34. acere Ponte Proessor Kei IFREMER Manual Page 49 sa o o soem compan SSS sca Seale factor for 06 computation scs SelefeorfrCO compuon ses Seale factor for OC computation Scr SelefeorfrCB compuon sca SeleheorfrCO compuon SCH Seale factor for C 10 computation SC Scale factor for CCI computation ses Seale factor for C 14 computation sca Seale facor for C05 computation sess Scale factor for C16 computation ses Seale factor for CA7 computation sea Seale factor for C09 computation soa Seale facor for C 20 computation soas Seale factor for C1 computation soa Seale factor for 22 computation seas Seale factor for C03 computation seas Seale factor for C 24 computation ser Seale factor for C 5 computation SCH Seale factor for C 26 computation sea SeleheorfrCODcomputim sceso T Seale factor for C 28 computation ses Seale factor for 29 computation ses Seale facor for G0 computation sess Seale facor for CG computation SCM Seale factor for G2 computation Sess Seale factor for CG3 computation sess Seale factor for 0GA computation ses Seale factor for CG9 computation Table 5 Description of the post processor configuration tags 7 2 6 Overall_Quality_Thresholds The SMOS L2 SSS processor estima
35. ange 1 256 description Minimum number of measurement to start the retrieval gt 5 lt nMin gt lt ewiteh foam lisit ceue iailse ceseription Comouce toan Coverage ancl contribution true switch foam 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 2011 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual IDoc SO MA ARG GS 0021 Issue 2 Rev 17 Date 22 June 2011 Page 59 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 doubl
36. are User Date 22 June 2011 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 ECMWF 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 latent heat flux Must be unique accumulated since start of f
37. cessor 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 of Iterconf Tag container of the four configurations Iterative_Conf Iterative scheme config
38. del 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 0 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 polarisation frame as well as at the antenna polarisation frame with a vector of four floating numbers Tb 0 H or X polarisation i
39. ditable true the counter number is replaced A version 1 1 0 with the value of the attribute see o 7 config 1 b EA category root left corner example o 7 category system C category NOBP FOM 1 A appender stdout A list enabled disabled A name NOBP FOM 1 A priority trace 3 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 C cateqory NOBP FOM 7 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 is 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 editablt 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 Value 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 Value Select File Edit XML File gt If the value is editable and the tag is
40. e 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 Llc 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 selec
41. e 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 aj of 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 2011 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual IDoc SO MA ARG GS 0021 Issue 2 Rev 17 Date 22 June 2011 Page 60 xmledit false true false If this at
42. e table below are under the Data Block L2 OS Configuration Parameters Thresholds tags Switch af Boolean true or false Only measurements 7 from alias free FOV are selected if true LEE value from which measurement becomes outlier RFI std Standard deviation value above which i measurements are considered at risk of RFI contamination LEE a suspected of RFI contamination LEZLLEN 7 ud ELEM noise to flag a grid point Minimum of measurements flagged for polarised fe galactic noise to flag a grid point fener Io below this threshold lead to the discarding of i measurements contaminated by erroneous galactic noise Pp Pp a E Pp fe 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 SS n 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 DORT Kelvin Tg low wind Upper limit for low wind speed Tg medium SSS Boundary between low SSS and medium SSS Tg_medium_SST Boundary between low SST and medium SST Tg_medium_wind Boundary between low wind and medium wind All rights reserved ARGANS ACRI st 2009 2010 2011 ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Process
43. ed 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 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 grou
44. elector New code lines are case 4 ws measurementHandle gridpoint geophyParamValue configHandle 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 SMOS L2 OS SO MA ARG GS E e KA OT Prototype Processor mae sie Tue LOCEAN SA CETP f ACRI Software User Date 22 June 2011 Page 57 ARGANS IFREMER Manual 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 is 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 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 co
45. 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 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 MOS ROOT smos GUI SSScorellib gdal install Abstraction Library amp Java MOS ROOT smos GUI 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 MOS ROOT smos GUI SSScorelbin 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
46. er HDFS or text files The user must be aware 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 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 17 e i LOCE ETP ARGANS ACRE UE Software User Date 22 June 2011 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 s BP PRP 3 2 2 BP PRP 3 1 7 Eripe EN Rd BP PRP 3 5 1 BPPRP318 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 21 BP PRP 7 2 2 BP PRP 8 1 BP PRP 8 2 BP PRP 1211 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 Po
47. etrieved 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 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 2 model 2 from All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOS L2 OS IDoc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP Prototype Processor pue dus ae IFREMER Software Use
48. gress Breakpoint GUI hdfview i Breakpoint i 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 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 ACRI st O 2009 2010 2011 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 17 LOCEAN ETP ARGANS Pe p a dn Software User Date 22 June 2011 ST IFREMER 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 queu
49. he 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 inverse wave height parameter 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 ACRI st 2009 2010 2011 SMOS L2 OS IDoc SO MA ARG G
50. idden Switches 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 hemas HW Identifier Unique identifier of the hardware involved in the processing nnnn where n are digits or characters List of Hosts List of Input Sc Tag end hemas List of Output Schemas Repeated 4 times for UDP DAP UDP report and DAP report Product Type schema Veron List of Output Tag end Schemas All rights reserved ARGANS ACRI st O 2009 2010 2011 MOS I2 ICM CSIC SMOSL2OS poc So MA ARG GS 0021 LOGAN UU E I E M IFREMER ee setae Manual Page 52 Description Latitude lower limit for area selection Longitude lower limit for area selection Latitude upper limit for area selection Longitude upper limit for area selection P 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 7 Description of tags of the private configuration file All rights reserved ARGANS ACRI st 2009 2010 2011 SMOS L2 OS poc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 53 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE The SMOS GUI contains global parameters that can be configured
51. ight calculated by xi eta Version 2 12 to version 2 13 SO MA ARG GS 0021 Tablel1 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 2124 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 2009 2010 2011 is nl ON Table 3 Table 5 Table 7 51 48 Table5 ACRE SMOS L2 OS poc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 LOCEAN SA CETP Software User Date 22 June 2011 IFREMER Manual Page 6 8 Corrected description of configuration selection tag 1 4 Removed unreferenced AD s Version 2 16 to version 2 17 SO MA ARG GS 0021 7 2 3 Table 3 Added RFI std RFI nsig amp Tg num RFI max Tg num outliers max Tg num outliers max added in row above JCD comment 5a RFI nsig JCD comment 5b 3 4 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 EN See Appendix of FAT minutes for JCD comments referenced above EE
52. ile 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 Lic file with be present in the L2 products Defining a short list of grid points is useful when breakpoint reports are activated and the processor is fast to produce small
53. int button Other 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 HDFview 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 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 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 Clos
54. l 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 SMOS L2 OS Prototype Processor Software User Manual ICM CSIC LOCEAN SA CETP IFREMER IDoc SO MA ARG GS 0021 Issue 2 Rev 17 Date 22 June 2011 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 Geophy Param ind SP Index of the surface pressure parameter
55. le Edit xmL File Edit as TXT File job Order Conf 1 Config 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 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 17 e 3 LOCE ETP ARGANS ACRI UE Software User Date 22 June 2011 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 M EF I nilrelzin Ins Enter searched string AUX CNFOSO O File Edit nter searched string comme EETA PSS a V Input 16 l Next Close aLocation H http 213 170 46 150 smos schemas I V File Ty Search for previous occurencd AUX CNFOSD xmins xsi H http Wwww w3 org 2001 XMLSchema ir
56. meter 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 std 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 O 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 oe Software User Date 22 June 2011 Manual Tag Description Note deltaP Variation of the 1 retrieved parameter to compute derivative deltaP Variation of the 2 r
57. meter guess prior Use First guess for the 7 retrieved parameter guess prior Use First guess for the 8 retrieved parameter guess prior Use First guess for the 9 retrieved parameter guess prior Use First guess for the 10 retrieved If true first guess is taken as equal to the prior if false processor uses first guess LUTs for initialisation All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOSL20OS Doc SO MA ARG GS 0021 ee Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP IFREMER Software User Date 22 June 2011 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 geophysical parameter along with the indices All tags in the table below are under the Data Block L2 OS
58. n K All rights reserved ARGANS ACRI st 2009 2010 2011 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 17 LOCEAN ETP ARGANS Exe SM als Software User Date 22 June 2011 ST IFREMER Manual Page 56 Tb 1 V or Y polarisation in K Tb 2 2 Re Tuy or 2 Re Txy Tb 3 2 Im Tuv 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 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 s
59. n glint Tm Max GN Error Limit of acceptable galactic background error Tm_medium_sun_glint Boundary between low sun glint and medium sun glint Tm out of range Limit for TB out of range detection 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 Table 3 Description of the tags with the thresholds 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 All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 Manual T LOCEAN SA CETP IFREMER Page 48 Frequency of SMOS radiometer Temperature in K at 0 Celsius degree epsilonInf High frequency limit value of relative dielectric constant EpsilonO Permitivity of free space Po Fae omea mea er SSCS Acceleration of free fall Po Omega_sun Apparent solid angle of the Sun at 1 4 Ghz seen from Earth Faraday Constan U parameter of the cardioid model B parameter of the cardioid model TB_gal_mean Sky irradiance of galactic noise model 0 Table 4 Description of the tags with the physical co
60. n 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 The left panel is dedicated to the whole XML hierarchy from the top to the bottom Three different icons are used o c3 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 SMOS L2 OS a A ICM CSIC iDoc SO MA ARG GS 0021 R LOCEAN S A CETP Prototype Processor ssue 2 Rev 17 ARGANS ACRI IFREMER Software User Date 22 June 2011 Manual Page 62 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 is for attribute value is not editable The number between square brackets is a counter used to discriminate tags using the same name Ej Log for SMOS jobtotol in folder user guide cor When the attribute name exists log4c A e
61. nfiguration 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 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 58 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 attributes allow the performance of specific checks on data value entered by the user Example Klisie qut Itertont editelole true cowmt 3 rereana lt nMin type int r
62. nstants Orbit_duration Orbit duration 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 mi Minimum salinity acceptable ooo araso Zeorersemiiviyds dT arasa Fistordersensiviyds dT Tg Acad max Maximum value of valid retrieved Acard Tg Acad 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 SC11 Scale factor for C 1 computation Po SC21 Scale factor for C 2 computation Ps SC22 Scale factor for C 3 computation Po All rights reserved ARGANS ACRI st 2009 2010 2011 MOS L2 OS ICM CSIC S Doc SO MA ARG GS 0021 Loceans
63. ocessor binary max jobs description Maximum number of jobs editable true list 1 2 3 4 5 6 7 8 typez int 1 max jobs refreshing period description Refreshing Period s list 2 5 10 30 type int unitz s 2 refreshing period configuration selection description New job order configuration editable2 false data core v4 configuration selection lt hdfview description HDFView Software location type z file SMOS ROOT smos GUI SSScore bin hdfview hdfview lt hdfview gt 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 2009 2010 2011 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 e AN Prototype Processor Issue 2 Rev 17 ARGANS E Xe MUS Software User Date 22 June 2011 ST IFREMER E Manual age 55 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 successfully see section 3 1 Users who want to modify the processor code will most likely change the brightness temperature mo
64. 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 2011 SMOS L2 OS ir SS meee Prototype Processor mae se i LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 22 June 2011 Manual Page 63 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 complete XML path to the selected tag l Earth Explorer File Data Block 1 filenames 1 iterschemeFile 1 All rights reserved ARGANS ACRI st 2009 2010 2011 SMOSL2OS IDoc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 Manual Page 64 ICM CSI
65. om 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 2011 SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 17 ARGANS ACRI IFREMER Software User Date 22 June 2011 Manual Page 54 A ICM CSIC Description File global conf xml Type XML Path SMOS ROOT properties XML File structure lt xml versionz 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 xml rw api home description xml_rw_api_home editable false gt SMOS_ROOT lt xml_rw_api_home gt LD LIBRARY PATH descriptionz LD LIBRARY PATH editable false gt SMOS_ROOT libpackages memalloc64 SMOS_ROOT libpackages proclogs SMOS_ROOT libp ackages lipp 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 default processor binary description Default Processor Binary Name fpattern L2OSPP_ typez file SMOS ROOT smos GUI SSScore bin L2OSPP 05 00 exe default pr
66. or p Prodi P M IFREMER Software User ate 22 June 20 Manual Page 47 Tg_moonglint_max minimum of measurements flagged for moonglint to flag a grid point Tg num meas valid Threshold of number of valid measurements point flag a grid point as suspected of RFI contamination of ice is suspected to flag a grid point Tg max rainfall Limit of acceptable rain Po Tg lat ice Acard Latitude min for ice detection from Acard model MEE Tg SST ice Acard SST threshold for ice detection from Acard model Po Tg Acard_ice Acard threshold for ice detection EE Tg fara meas min Threshold for 96 of non interpolated n i AUX FARA x measurements Tg swell Threshold 96 above which sea state is classified as i swell dominated otherwise sea state is wind waves dominated Tg old sea Threshold fraction for old waves if omega is E below this threshold waves are old Tg young sea Threshold fraction for young waves if omega is 7 i above this threshold waves are young Tm angle moon Limit of acceptable angle between the specular 7 i direction and the moon direction Tm DT ice Threshold of difference between actual and flat sea m model brightness temperatures above which ice contamination is suspected fm suspect ice true Tm high gal noise High galactic noise boundary Tm gal noise pol High polarized galactic noise boundary Tm high sun glint Boundary between medium sun glint and high sun glint Tm_low_sun_glint Upper limit for no su
67. orecast 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 2009 2010 2011 SMOSL2OS poc SO MA ARG GS 0021 eo Prototype Processor LoctANSAcEre e Processor ete IFREMER Manual Page 46 Tag Description Note Geophy_Param Geophy_Param ind_STR 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 Geophy Param List of definitions 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 needed by the processor All tags in th
68. ps of LINUX operating system are used All rights reserved ARGANS ACRI st O 2009 2010 2011 Software User Date 22 June 2011 Page 14 ARGANS IFREMER SMOS L2 OS SO MA ARG GS E te a Prototype Processor mae sisi M TN LOCEAN SA CETP ACRI 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 HDFview HDFview is needed to visualize breakpoint report files Installation of the software is detailed
69. r ate une Manual Page 40 ine Description Noo 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 true or false 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 First 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 para
70. t ES smos OPERATION Version 2 R1 1 Core Processor V2 3 Application Job Management Job Execution Graphics nul Folders A iE Jobs i 7 Job Folder Management 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 2009 2010 2011 SMOSL20OS Doc SO MA ARG GS 0021 a CS TES Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP ARGANS ACRI ERENER Software User Date 22 June 2011 E Manual Page D eee nie an at el r Folder list Job Utilities S NE Job list SENSE Job Execution onfigure CLEAN J 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 2011 SMOSL2OS j poc SO MA ARG GS 0021 Prototype Processor ssue 2 Rev 17 Software User Date 22 June 2011 Manual Page 20 ICM CSIC LOCEAN SA CETP IFREMER This panel gives access to the following functions
71. ted 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 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor ssue 2 Rev 17 LOCEAN SA CETP IFREMER Software User Date 22 June 2011 Manual Page 32 Job Execution RUN NOW SCHEDULE amp 17 22 06 22 2006 H 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 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 prototype OPERATION
72. tes 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 BLAN iow sss classified as low SSS 2 Meise S classified as low SSS Tg Qual Low SST Below this threshold grid points are 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 EE All rights reserved ARGANS ACRI st 2009 2010 2011 SMOS L2 OS SO MA ARG GS EE te KA OT Prototype Processor mae E Tue LOCEAN SA CETP ACRI ARGANS Software User Date 22 June 2011 IFREMER Page 50 Manual Tag OO elasiied as low WS E Tg Qual High WS Above this threshold grid points are classified as low WS Table 6 Description of the overall quality threshold tags 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 i e AUX_ATMOS B amp Tag finder Enter searched string AUX_ATMOS Previous Next Close Clicking enter or Next button will expand the xml tree of the job order f
73. 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 B Job Name Folder Launch Date Run Time s I 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 5 2 Finished 6 2 9 Graphical software 3SMOS OPERATION Version 2 R1 1 Core Processor V3 Application Job Management Job Execution Graphics T pa aiat HDFView software YOS 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 2009 2010 2011 MOS L2 ICM CSIC SMOSL2OS Doc so MA ARG GS 0021 Gt Prototype Processor Issue 2 Rev 17 w LOCEAN SA CETP ARGANS Exe Software User Date 22 June 2011 ST IFREMER E Manual age 35 2 Global contiguration Panel File Edit 7 gconf A editable true editable H true P SMOS_ROOT 1 D xml rw api home 1 description HDFView Software location b LD LIBRARY PATH 1 D default job name 1 fil gt default processor binary 1 type us P max jobs 1 P refreshing period 1 Value mostrubuntu SMOS L20S smos_GUL_S P configuration selection 1 V hdfview 1 A descrip
74. through the internal XML editor tool see image below SMOS prototype OPERATION Version 1 R1 Application Job Management Job Execution Graphics Help Global configuration wat E Exit ae 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 Non editable variable When a new job is created files fr
75. tion HDFView Software location A type file jrepath 1 a pcm gconf hdfview 1 Global configuration panel setting HDFview binary location All rights reserved ARGANS ACRI st 2009 2010 2011 MOS L2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 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 algorithm see R D 1 This document is aimed at giving the user key information on the pro
76. to select the destination of the exported file A process is launched that creates a unique file named as the folder with the 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 a Successful export of the directory in the file j users fr SMOS test tar gz All rights reserved ARGANS ACRI st O 2009 2010 2011 SMOSL2OS poc SO MA ARG GS 0021 E Kz ee Prototype Processor Issue 2 Rev 17 LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 22 June 2011 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 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 1 New Job pane Job name SMOS job2 Author Creation date 06 November 2008 12 23 17
77. tribute 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 ible 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 SSSocore 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 SSSocore inputs Xmledit attribute example lt iterSchemeFile type file xmledit true data TDS inputs SM TI lt iterSchemeFile gt EST AUX ITCO All rights reserved ARGANS ACRI st O 2009 2010 2011 EF 20070101T000000 20781231T235959 0000002 SMOSL20OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 17 Software User Date 22 June 2011 Page 61 ICM CSIC LOCEAN SA CETP IFREMER Manual File Edit v Data_Block 1 z A editable true editable H true A type xml
78. uration 1 4 All rights reserved ARGANS ACRI st 2009 2010 2011 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC E Proolye Povesor lac 2Rer T IFREMER Manual Tag Description Note nRetrievedParam Number of retrieved parameters to 10 retrievedParamId 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 5 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 retrieved parameter Absolute error of prior for 1 retrieved parameter

SO-MA-ARG-GS-0021 Issue: 2 Revision: 17 Date: 22

Contents

Download Pdf Manuals

Related Search

Related Contents