Home

SMOS L2 OS Prototype Processor Software User Manual

1. m File Edit Enter searched string comme ar a V Input 16 Next Close http 213 170 46 150 smos schemas s v File Ty Search for previous occurenc AUX CNFOSD xmins xsi H http Www w3 org 2001 XMLSchema ir 7 File Name Type 1 Stem V 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 A description Definitions of geoStem parameters Configuration c A editable true count H i A fextent EEF A fpattern AUX_CNFOSD f description Definitions of geoStem parameters Ct A txtedit true A type ffile f A xmledit true fextent EEF Inputs 01T000000 1 7 State 1 fpattern AUX_CNFOSD Non Alternative Ts Y Li f Ti ecu nl NER 1 txtedit trua 7 Time Interval 1 7 Start 1 type file 2006 04 19 185548 972 L S M V Stop 1 2006 04 19 194948 972 parece true I V File Name 1 E Inputs SM TEST AUX CNFOSD 20050101T000000 n Select File Edit XML File edit as TXT File 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 k Pa aAa A A E File Edit 7 Earth Explorer File A editable true gt Earth_Explorer_Header 1 gt Data_Block 1 All configuration parameters are liste
2. All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 438 eS Tuc A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 53 Description File global conf xml Type XML Path SMOS_ROOT properties XML File structure xml version 1 0 encodingz ISO 8859 1 standalone no gt gconf gt lt SMOS_ROOT type dir description SMOS ROOT INSTALL DIRECTORY gt mount users L20S smos_gui_Core lt SMOS_ROOT gt lt xml_rw_api_home description xml_rw_api_home editable false gt SMOS_ROOT lt xml_rw_api_home gt lt LD_LIBRARY_PATH description LD_LIBRARY_PATH editable false gt SMOS_ ROOTylibpackages memalloc64 SMOS ROOT libpackages proclogs SMOS ROOT libpackages I1pp external_libs lib64 SMOS ROOT libpack ages xml rw api linux64 projects bin LD LIBRARY PATH default job name description Default Job Name SMOS job default job name default processor binary description Default Processor Binary Name fpattern L2OSPP type file gt mount users L20S smos_gui_Core_v3 8 bin L2OSPP_03_08 exe lt default_processor_binary gt max jobs description Maximimum number of jobs editable true list 1 2 type int gt 1 max jobs refreshing period description Refreshing Period s list 2 2 5 10 30 type int unit s gt 2 refreshing period configuration selection description Selection of the running configuration
3. listdir none Any directory to be scanned If present create a list of all available subdirectories contained in the tag value listdir SMOS ROOT smos GUI SSSocore inputs listfiles none Any directory to be scanned 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 iterSchemeFil dit tru Ws data TDS inputs SM TEST AUX I7 lt iterSchemeFile gt type file xml All rights reserved ARGANS ACRI st 2009 TCOEF_20070101T000000_20781231T235959_0000002 SMOS L2 OS E ICM CSIC b S LOCEAN SA CETP Sof U ARGANS ACRI IFREMER oftware User Manual Editor overview Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 9 Date 4 August 2009 Page 60 Mputs SM a AUX GNEGSD A A 000000 OULD i 6 trom job SMOS A a Folder fest Folder File Edit 7 Data Block 1 A editable true A type xml A xmins http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema A xsi schemaLocation http 213 170 46 150 smo 7 L2 OS Configuration Parameters 1 gt editable H xsi schemaLocation H true http 213 170 46 150 smos schemas http www w3 org 2001 XMLSchema ir V Iterative Scheme 1 7 List of Iterconf 1 xmins H A count 4 7 Iterative_Conf 1
4. 2 24 42 2 2 4 Minor updated and clarifications Section renamed New section for operational processor installation Installation procedure updated 3 4 i e 4 2 d updates 6 2 5 Generation of the list of grid points is clarified 7 2 1 to 7 2 5 Tables revised for consistency with the interface E Appendix 3 E added with processor error codes Check on processor binary presence added with error message Check on processor soft links to products and libraries presence on GUI startup added with error message GUI installation procedure migrated to Open prototype SRD ples 2 a e 2 8 Figures updated T ples New section addressing the private configuration file l 4 1 1 1 Clean function clarified l All rights reserved ARGANS ACRI st 2009 LOCEAN SA CETP i IFREMER Software User Date 4 August 2009 SMOSL2OS locso MA ARG GS 0021 es me I Prototype Processor ssue 2 Rev 9 Manual Page 5 ARGANS Page Section Comments 1 4 1 2 Refer to section 6 2 7 for the behavior of the GUI when closed 6 1 Clarification on copies of configurable files 9 Tutorial updated Version 2 2 to version 2 3 SO MA ACRI GS 4412 All Update of the L2OS processor version to be 2 3 vemm 2 3 to version 2 4 ar ae MA ARG GS 0021 12 11 2008 all Reformatted header footer amp title pages for ARGANS 7 z 1 area redefined Changed references from AUX_CNFOS
5. Doc SO MA ARG GS 0021 a Tuo A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User ps 4 August 2009 Manual Page 45 Tag Description Note Geophy_Param Geophy_Param ind_Acard Index of the Acard coefficient of cardioid model Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_EWSS Index of eastward surface accumulated since start of forecast stress Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind NSSS Index of northward surface accumulated since start of forecast stress Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind NSLHF Index of net downward latent heat flux accumulated since start of forecast Must be unique The tags name nameLong unit desc origin originId are repeated here Geophy Param Geophy Param ind SSHF Index of net downward sensible heat flux accumulated since start of forecast Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind SSR Index of net downward shortwave flux at surface accumulated since start of forecast Must be unique The tags name nameLong unit desc origin
6. i icwicsic SMOS L2 OS oc SO MA ARG GS 0021 Ss IB LOCEAN SA CETP Prototype Processor Issue 2 Rev 9 ARGANS ACRI IFREMER Software User Date 4 August 2009 Manual Page Title SMOS L2 OS Prototype Processor Software User Manual Doc code SO MA ARG GS 0021 Issue 2 Revision 9 Date 4 August 2009 Name Function Company Signature Date Prepared SMOS Team Expert Support Laboratories Reviewed P Spurgeon Project manager ARGANS Approved S Lavender Quality control ARGANS Released N Wright Project manager ESA All rights reserved ARGANS ACRI st 2009 4 _ IcMsIC SMOS L208 oc SO MA ARG GS 0021 es LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User E j August 2009 Manual age External Distribution Name Quantity N WRIGHT ESA ESRIN 1 S DELWART ESA ESTEC 1 J C DEBRUYN ESA ESTEC 1 Internal Distribution Name Quantity Expert Support Laboratories 3 ACRI st 1 J L Vergely 1 S Lavender 1 P Spurgeon 1 All rights reserved ARGANS ACRI st 2009 LOCEAN SA CETP IFREMER ICM CSIC SMOSL2OS pocs0 MA AROG GS 0021 ET eS Prototype Processor ssue 2 Rev 9 Software User Date 4 August 2009 ARGANS Manual Page 3 Change Record Issue Revision Date Description Approval 1 0 30 06 2006 First version for Qualification Review 1 1 1 24 09 2006 Update after comments form Qualification Review 1
7. 7 nRetrievedParam 1 type H text A description number of geophysical A list 0001 0002 0003 0004 0005 00C count H 10 description Name of 2nd retrieved parameter List of values SSS SST UN10 VN10 tec WSn phi wsn Value SST LT http 213 170 46 150 smos schemas A type int H 0005 V List of retrived Parameters 1 A count 10 A type text 7 retrievedParamld 1 A description2 Name of 1st retrieve A list SSS SST UN10 VN10 tec WSr SSS 7 retrievedParamld 2 A description Name of 2nd retrieve A list SSS SST UN10 VN10 tec WSr 7 retrievedParamld 3 A description Name of 3rd retrieve A list SSS SST UN10 VN10 tec WSr UN10 gt retrievedParamld 4 EL ievedParamld 5 1 I a Update Value L2_OS_Configuration_Parameters 1 Iterative_Scheme 1 l List of Iterconf 1 terative Conf 1 List of retrived Parameters 1 retrievedParamld 2 SMOS GUI XML editor example The above example shows the edition of a XML SMOS configuration file AUX_CNFOSD Tree distinct zones are drawn gt The top menu e File menu This menu accesses the following command o Save To save the modifications o Export in operational format To save the file in operational format that is without any additional tags o Close To close the window e Edit menu This menu accesses the following command o Undo To save the modifica
8. All rights reserved ARGANS ACRI st 2009 SMOS L2 OS oc SO MA ARG GS 0021 ET TE A Prototype Processor Issue 2 Rev 9 ARGANS IFREMER Software User Due 4 August 2009 Manual Page 40 Tag Description Note 3 2 model 3 from ICM CSIC Switch rough3 Sea surface model 3 selector for coefficients Valid if switch roug 3 For ICM CSIC only Switch retr Not used Switch err mode Account for model error if true Switch card Activate cardioid model instead of flat sea model Delta sn Maximum admissible time between two measurement to compute Stokes 1 Valid if retrievalMode 2 Tg WS roughness Wind speed above which roughness contributions are computed Tg WS foam guess prior Wind speed above which foam contributions are computed Use First guess for the 1 retrieved If true first guess is taken as equal to the prior if false processor uses first guess LUTs for initialisation 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 parameter guess prior Use First guess for the 7 retrieved parameter guess prior Use First guess for the 8 re
9. 2 0 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 15 02 2008 V3 QR 2 4 12 11 2008 For V4 pre QR LL Tier ope D 6 02 02 2009 For V4 TRR 8 29 06 2009 Post V4 delta FAT ee ee NINN NIN NIN TY Page Section Comments 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 2 New section with an general introduction of the prototype processor environment Numbering of existing section 2 3 etc shifts 6 2 Table 1 Updated according to IODD changes Table 2 updated according to IODD changes 6 4 Table 3 updated according to IODD changes Table 4 updated according to IODD changes 6 6 Table 5 updated according to IODD changes Updated section Figures Updated figures Updated section 8 2 6 New section on access to visualization tools Appendix B New appendix with software problem report change request form 1 Appendix C Formerly Appendix B Updated with new list Is CIR of files on DVD All rights reserved ARGANS ACRI st 2009 LOCEAN SA CETP IFREMER Software User Date 4 August 2009 Page 4 SMOSL2OS lp so MA ARG GS 0021 ET eS IN
10. 1 fi gt default processor binary 1 type ue P max jobs 1 D refreshing period 1 Value mostubuntu SMOS L20S smos_GUI_S gt configuration selection 1 V hdfview 1 A description HDFView Software location A type tfile jrepath 1 _ 43 update value Select File gconf hdfview 1 Global configuration panel setting HDFview binary location All rights reserved ARGANS ACRI st 2009 LOCEAN SA CETP IFREMER Software User Date 4 August 2009 Page 36 SMOSL2OS D scso MA ARG GS 0021 ag I Prototype Processor Issue 2 Rev 9 ARGANS Manual 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 th
11. 3 6 Added gui jedit amp gui logs to Type GUI corrected typo libpackage s Version 2 7 2 7 to version 2 8 to version 2 8 S O MA ARG GS 0021 DT Updated CNF_L2OS with List of Hosts NCC ONE INIM e global conf xml 35 624 5 2 1 Now Now only 2 test jobs removed old mire testjob si 2 test jobs removed old mire test job All rights reserved ARGANS ACRI st 2009 ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 es eS LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 6 Pages Section Comments 7 2 3 Updated table 3 with clarified descriptions from IODD Version 2 8 to version 2 9 SO MA ARG GS 0021 Change in configuration UST gt Uwav interdependence of geophysical parameters see AlgoVal 16 MoM All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 ag I Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 7 Table of Content 1 INTRODUCTION Proc cC EES 9 11 GENERAL NR Q 9 1 2 GUIDE TO THIS DOCUMENT 433 eetiee cec teeeeteee tete eere deve ee ce eret eee eec eee teet pe Le E EE EE ER REED 9 1 3 STRUCTURE OF THE DOCUMENT erre reete nene ee cete ere vere re Pee te ete ee bere ee sese ere acea eee Eee er IEEE 9 14 JAPPEICA
12. 98 9032 9 9 9 YA Rs JE Toot JI 30 a The user is invited to select a rectangular area by dragging the mouse over the map or by entering the latitude longitude numerical values directly in the corresponding boxes Once the zone is selected a click on the button named Save selected zone and Close 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 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 selected The user i
13. CETP Prototype Processor Issue 2 Rev 9 e ARGANS IFREMER Software User Date 4 August 2009 Manual Page 62 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 Earth Explorer Filel Data Block 1 filenames 1 iterschemeFile 1 All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 63 Appendix B Feedback Form The form below is the template of the feedback form The form is aimed at reporting software problems or at requesting changes in the SMOS L2 SSS Prototype Processor The forms shall be sent to smos argans co uk Feedback form Number HHH Contact Name and institution Initiate
14. Ending tag List of Grid Poi Number of grid point to be processed Tags below repeated Npl nts times Npl given by count attribute GridPointID Grid point ID List of Grid Poi Ending tag nts List of Params Number of general purpose parameters Tags below repeated Np times Np given by count attribute Placeholder field default value 0 Param Placeholder field general purpose parameters default value 0 if List of Params 0 List of Params Ending tag Table 7 Description of tags of the private configuration file All rights reserved ARGANS ACRI st 2009 ARGANS E ICM CSIC SMOSL2OS pocsO MA AROG GS 0021 US LOCEAN SA CETP Prototype Processor Issue 2 Rev 9 IFREMER Software User Date 4 August 2009 Page 52 Manual 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE The SMOS GUI contains global parameters that can be configured through the internal XML editor tool see image below SMOS prototype OPERATION Version 1 R1 Application Job Management Job Execution Graphics Help Global configuration weet ge Exit IOS 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 var
15. NOBP FOM 4 gt C category NOBP FOM 5 gt C category NOBP FOM 71 gt The right panel is used to display a tag value along with all its associated attributes The inherited attributes are flagged with a H Note The editable tags are written in blue When editable the value associated to the tag 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 Not editablt gt Ifthe value is editable and the tag is not of type file the buttons is Update Value gt Ifthe value is editable and the tag is of type file the buttons are Update Value Select File gt Ifthe value is editable and the tag is of type directory the buttons are Update Value Select Directory 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 of type file the pointed file is an XML editable file and the text is editable then the buttons become Edit as TXT File TEFEREEUTER Select File Edit XML File Clicking on the button Edit XML File will open a new XML editor with the file pointed to by the tag value All rights reserved ARGANS ACRI st 2009 ICM CSIC SMOS L2 OS poc so MA ARG GS 0021 LOCEAN SA
16. SST threshold for ice detection from Acard model Tm_angle_moon Limit of acceptable angle between the specular direction and the moon direction Tm DT ice Tm high gal noise Tm gal noise pol Threshold of difference between actual and flat sea model brightness temperatures above which ice contamination is suspected fm suspect ice true High galactic noise boundary High polarized galactic noise boundary All rights reserved ARGANS ACRI st 2009 SMOS L2OS poc so MA ARG GS 0021 E eS I e Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP ARGANS cn Software User Date 4 August 2009 Manual Page 47 Tag Description Note Tm high sun glint Boundary between medium sun glint and high sun glint Tm_low_sun_glint Upper limit for no sun 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 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 Tag Descript
17. The main windows At launch time as the GUI is loading the next window is displayed p e Amd amu ARGANS Interface components are loading Please wait Co SMOS Then the main SMOS Interface appears 4 SMOS GUT Version 3 0 Prototype Processor V3 Application Job Management Job Execution Graphics Lu Ba 9 status 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 Job Management create or manage folders and jobs configure and run jobs All rights reserved ARGANS ACRI st 2009 SMOSL20S DM AM Prototype Processor mane RU PEOR E LOCEAN SA CETP E ARGANS IFREMER Software User Date 4 August 2009 Manual Page 18 Job Execution launch the job viewers monitor running or scheduled jobs check pas jobs Graphics to access shortcut to HDFview access the user manual this document in PDF format and GUI current version about function 4 1 1 1 Job management SMOS OPERATION Version 2 R1 1 Core Processor V2 3 Application Job Management Job Execution Graphics Folders pr F Jobs Job Folder Management pull down menu In order to create open manage the jobs the user has to click on the top icon Es or t
18. according to the DPM one or several break points are selected from the available list To select multiple breakpoints the User has to hold the shift or the alt key Then the break points can be added to the list of selected break points pushing the Add Break Point button 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 2009 SMOSL2OS poc SO MA ARG GS 0021 c ICM CSIC R amp Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP ARGANS EXe1 Software User Date 4 August 2009 ST IFREMER Manual Page 31 B Processing Window SEIECHOnN
19. eee dee e pe OE EE eee Ue Eee EQ dee VPE CEN Ee Eee 14 Seb XGULSPIARIUPNZSAERGeNxeR enn Mee EI IM Ie sey cea una eie E EE LEE 14 3 5 TESTING THE INSTALLATION esce cetero eerte epe a EE eere tree e OU 15 3 6 TREE ORGANIZATION eeeeeeeememenenenenenesesesesesesese ese e ese se sese esesesesesesesesese sese sesesese esses ese etes eset ases etes eset eee 15 4 THE GRAPHICAL USER INTERFACE eee e eee eerte nenne ettet tana sese eese teta sese see eese snas ses e eee een sena 17 4 1 THE MAIN WINDOWS cceeeeeeehhh hehehe nene he nni nini nisi pe sn pasa nnns ern ides nni seen nier eren ertet rere rere r tree ener erint rere r ener enean 17 5 iem ERI BNL CO 23 5 1 CRBEATEANEWETOELDEBR ncs E MEE EE EEUU 23 5 2 MANAGE THE CREATED FOLDERS eere een nen ne nnnn nnn nnn nnn n n nnn n n n e n a n p ense nn uen Eeee Esene nenene eenen 23 6 BIOUNRNIESIMUB C 24 6 1 JOBGCREATION 5 eceececteticeteeeceeseteecee eee eee E a aa beet reet eee erede eb een C FERE En CE EP eo Uere ERES Coe CE ER VERTES CE EP EE e ERU 24 6 2 JOB CONFIGURATION eiecti tree esee s eie tern ek en E N entier eientue tele nE a a ue e eene e tues 26 7 CONFIGURATION FILES 36 7 1 INIRODUCHON omur E E E ETE CEP PLEEE E CEEE E EERUT 36 7 2 THEMAIN CONFIGURATION FILE eee enn n n nnn nnn nnn nnn nnn nnn a ena a e ana a a n e e a a a e e e e n enean aeneae
20. 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 EP 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 If 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 2009 T ICM CSIC boo LOCEAN SA CETP ARGANS IFREMER SMOS L2 OS Prototype Processor Software User Manual iDoc SO MA ARG GS 0021 Issue 2 Rev 9 Date 4 August 2009 Page 59 xmledit false true false If this attribute is set to true an edit button is added to the interface allowing to open a new XML editor loading the file pointed on see example below xmledit true txtedit false true false If this attribute is set to true an edit button is added to the interface allowing opening a new text editor loading the file pointed to txtedit true description none Any string chain Tag description description tag description unit none All units possible Unit description unit d
21. listdir L2OS smos gui Core v3 8 inputs data core v4 configuration selection hdfview description HDFView Software location type file L2O0S smos gui Core v3 8 bin hdfview hdfview hdfview jrepath description Java Runtime Environment location type file gt L2OS smos gui Core v3 8 jre1 6 0_01 lt jrepath gt lt gconf gt All rights reserved ARGANS ACRI st 2009 T SMOS L2 OS poc SO MA ARG GS 0021 E ICM CSIC P P Te LOCEAN SA CETP rototype Processor Issue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Page 54 Manual 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 model at the surface This tutorial explain 1 how to insert user s model in the source code 2 how to retrieve geophysical parameters to feed the user s model 3 where to call the user s model 4 how to update the processor 5 how to use the user s forward model Before any source code change the user need to make sure that he she has write permission on the source code files under the SMOS ROOT dev directory 9 2 Insert a new user s model In this tutorial the user s model is very simple It simulates a contribution to the
22. 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_GUIL_SSScore gifs User manual this document SMOS_ROOT smos_GUI_SSScore doc Processo Binary executable SMOS_ROOT smos_GUI_SSScore bin r HDFview installation MOS ROOT smos GUI SSScorelbin hdfview install lin package ux64amd vm bin Input configuration files SMOS ROOT smos GUI SSScorelinputs Processor data and schema SMOS_ROOT smos_GUI_SSScore smos soft link Processor libraries SMOS ROOT smos GUI SSScorellibpackages soft link Shell files S8MOS ROOT smos GUI SSScorelshells Temporary spaces SMOS ROOT smos GUI SSScoreltmp and SMOS_ROOT smos_GUI_SSScore pids Jobs Global workspace S
23. of Procs 1 count 1 count H 1 v Proc 1 i Vv Task Name 1 i description Private configuration Iproject SMOS nme SSS L2 proto dev L2OS 01 00 exe i 7 Task Version 1 01 00 Dl fpattern CNF_L20S_ V Breakpoint 1 7 Enable 1 txtedit true A editable true os A list OFF ON y file OFF Type V List of Brk Files 1 A count 0 xmledit true 7 List of Inputs 1 X m ieena 1 Select File Edit xm 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 SMOSL2OS poc SO MA ARG GS 0021 F ICM CSIC es amp N SA Prototype Processor Issue 2 Rev 9 ARGANS Ee aae e E Software User Date 4 August 2009 ST IFREMER Page 29 Manual 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
24. originId are repeated here Geophy Param Geophy Param ind STR Index of net downward thermal radiative flux at surface accumulated since start of forecast Must be unique 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 All rights reserved ARGANS ACRI st 2009 ARGANS SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP bue2Re 9 IFREMER oitware User g Manual Page 46 below gathers all the thresholds needed by the processor All tags in the table below are under the Data Block L2 OS Configuration Parameters Thresholds tags Tag Switch af nsig Tg gal noise max Tg gal noise pol max Tg WS gal Tg high SSS Tg high SST Tg high wind Tg ice concentration Tg low SSS Tg low SST Tg low SST ice Tg low wind Tg medium SSS Tg medium SST Tg medium wind Tg moonglint max Tg num meas valid Tg num outliers max Tg suspect ice Tg Sunglint max Tg max rainfall Description from alias free FOV are selected if
25. 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 in K Tb 1 V or Y polarisation in K All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 E LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 P ARGANS IFREMER Software User Date 4 August 2009 Manual Page 55 Tb 2 2 Re Tyy or 2 Re Txy Tb 3 2 Im Tuy 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 para
26. true an outlier noise to flag a grid point polarised galactic noise to flag a grid point measurements contaminated by erroneous galactic noise wind execution Upper limit for very low SSS Upper limit for very low SST Kelvin Upper limit for low wind speed Boundary between low SST and medium SST wind moonglint to flag a grid point Threshold of number of valid measurements point presence of ice is suspected to flag a grid point Limit of acceptable rain Boolean true or false Only measurements Sigma number from which measurement becomes Minimum of measurements flagged for galactic Minimum of measurements flagged for WS below this threshold lead to the discarding of Boundary between medium SSS and high SSS Boundary between medium SST and high SST Boundary between medium wind and high Maximum of ice concentration for retrieval Temperature under which ice could be present Boundary between low SSS and medium SSS Boundary between low wind and medium minimum of measurements flagged for minimum of outlier measurements to flag a grid Percentage of measurements above which minimum of measurements flagged for sunglint Note Tg_TEC_gradient Tg_lat_ice_Acard Tg_SST_ice_Acard Tg_Acard_ice Threshold for TEC gradient Acard threshold for ice detection Latitude min for ice detection from Acard model
27. 2 to AUX_CNFOSD F pe graphics amp images from latest GUI version AUTE Added List of Params me 3 Added Tg gal noise pol max Tg WS gal Tm gal noise pol pna Acard max Tg Acard min Tg sigma Acard max Version NN 4 to version n 5 SO MA ARG GS 0021 Replaced references to IODD with Product Specs corrected Red Hat 4 to 5 replaced obsolete A D 2 with A D 5 pre QR RID jcd 151 this 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 6 1 oe SSS database with configuration amp auxiliary data files pre QR RID jcd 157 7 1 Description of input files clarified pre QR RID jcd 159 7 4 Type prong corrected pre QR RID jcd 162 3 6 Noted Geospatial Data Abstraction Library amp Java run time libraries pre QR RID jcd 155 Table 2 Corrected from IODD added missing ind tags pre QR RID jcd 160 amp 161 8 Expanded datasets to set of auxiliary data files pre QR RID jcd 163 6 2 8 Reference to the __gsl__ file added V4 pre QR minutes action 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_Pin UDP 6 2 8 Explained how to view the scheduled run date time Version 2 6 to version 2 7 SO MA ARG GS 0021 this Removed incorrect Table 1 from missing ind_ tags above
28. ANS IFREMER Software User Date 4 August 2009 Manual Page 39 Tag Description Note parameter to compute derivative deltaP Variation of the 2 retrieved parameter to compute derivative deltaP Variation of the 3 retrieved parameter to compute derivative deltaP Variation of the 4 retrieved parameter to compute derivative deltaP Variation of the 5 retrieved parameter to compute derivative deltaP Variation of the 6 retrieved parameter to compute derivative deltaP Variation of the 7 retrieved parameter to compute derivative deltaP Variation of the 8 retrieved parameter to compute derivative deltaP Variation of the 9 retrieved parameter to compute derivative deltaP Variation of the 10 retrieved parameter to compute derivative itMax Maximum number of iteration lamdaMax Maximum of Marquardt diagonal amplifier Tg num meas min Minimum number of measurements to start the retrieval Switch foam Compute foam coverage of contribution RetrievalMode Select between five retrieval modes 0 full polarisation 1 dual polarisation from dual 2 dual polarisation from full 3 Stokes 1 from dual 4 Stokes 1 from full strategy 1 5 Stokes 1 from full strategy 2 6 Stokes 1 from full strategy 3 Switch_gal Model for galactic noise contribution 0 Model 0 1 Model 1 2 Model 2 Switch_roug Model for sea surface roughness 0 None effects 1 model 1 from IPSL LOCEAN 2 model 2 from IFREMER
29. BEEDOCUMENTS eee cete er tette Ere eme cent ce EE RM Ee EM DEED E EM EE 10 1 5 REFERENCE DOCUMENTS ccccccccccccsccesccesccesesesesesescscsesesesesssesesesesesesceesesescsesesssssesessscsusessscssssssssesssessseuesevees 10 1 6 ABBREVIATIONS eet beer ep dk esee epe ies ade aa E oer cie aet 11 2 OVER VIEW P 12 2 1 INTRODUCTION 4 eb be debebat aa eee dbeten ie pedes eee kates ae oe tu ei destbeke 12 2 2 GUI CONFIGURATION FUNCTIONALITIES eene nnn n nnn nennen nnne n nnn nnn nnn nnn ene nne s e e a e a nasa nana papae 12 2 3 GUT PROCESSOR OPERATION inin rete ere FEe CERE EEUEE ERE EEOC EROR CENE EBECEBOL ERES TEQL ERE CEE Et ed ERE ERE EE FEE FEES R EE CER ER TO 13 p DATE CINE TES 13 2 5 BREAKPOINT REPORT GUI eeeeeeeeeeeeeeeeene een nen nene nn nnn nnn nn nnn n anu e esu e a e a n aen n e e n e enne n nap apap aua 13 2 6 FILE MANAGEMENT ninnan eienn ae a a a E a EEEa E E a a Eaa E ENSS 13 3 INSTALLATIONS AND OPERATION ccccccssssssscsscccsssscscsscccccsssscscecccccessssssceccccsesssscscececccssessssececees 14 3 1 INSTALLATION OF THE CORE PROCESSOR eeeee eee eme ene nenenenetesesesesese sese ese ese ese etes e ese eset eset esee eset essen 14 3 2 INSTAELATION OE THE GUI e ee tere oe pe cave oet bes ev des eae voe ey caus eoe bes iue eles eue bes ue cos eue ies ues 14 3 39 INSTAELATION OE HDEYVIEW ieecceet ceeteeeseteteee eee dee e cte coe tege edeve a Q e teer
30. ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 P ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 34 list multiple selection is possible The deletion bears only on the list The jobs are not physically erased from the simulator B Past Job Control Panel Job Name Folder Launch Date Run Time s SMOS job folder test 2006 06 20 15 26 45 5 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 2006 06 22 17 22 00 6 Finished 6 2 9 Graphical software ES SMOS OPERATION Version 2 R1 1 Core Processor V3 Application Job Management Job Execution Graphics T pn ape HDFView software 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 SMOS L2 OS oc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP 4 Angi ARGANS Fe IU Software User Date 4 August 2009 Manual Page 35 Global contiguration Panel File Edit 7 gconf A editable true editable H true P SMOS ROOT 1 b xml rw api home 1 description HDFView Software location b LD_LIBRARY_PATH 1 D default job name
31. L 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 dbabewe ox docui exeo Erbe Celine S ste cse Ce lt nMin type int range 1 256 description Minimum number of measurement to start the retrieval gt 5 lt nMin gt switch foam list true false description Compute foam coverage and 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
32. MOS B Tag finder Enter searched string AUX_ATMOS Previous Clicking enter or Next button will expand the xml tree of the job order file highlight and select the File Type tag that has AUX ATMOS for value The tag to be changed is the next File Name tag further down on the XML tree 7 4 The private configuration file The private configuration file CNF_L2OS is used to define system parameters This file is in XML ASCII format Complete definition of the file name along with header and Data Block tag fields are provided in A D 5 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 All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 Xl LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGANS IFREMER Software User Date 4 August 2009 Manual Page 50 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 take
33. MOS_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 LOCEAN SA CETP i IFREMER Software User Date 4 August 2009 Page 16 SMOSL2OS D scso MA ARG GS 0021 ag I Prototype Processor Issue 2 Rev 9 ARGANS Manual Job workspace SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Input data SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Inputs Results of the run MOS ROOT smos GUI SSScorelfolders folder M SMO S_Job N Outputs Control of processing SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Control Note The above temporary spaces are not used for the Core processor These spaces are used by the GUI to store shell scripts and files needed to manage the processing In order to run correctly SMOS GUI needs the following hardware and software resources 3 6 1 Hardware and software requirements Hardware and software requirements are detailed in the SMOS L2 OS Prototype Processor Software Release Document SO RN ARG GS 0022 All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 a eS Tcr A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 17 4 The graphical User Interface 4 1
34. N S SMOS processor graphical user interface Version 3 R0 November 05 2008 Prototype Processor V3 T SMOS About SMOS GUI interface window All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 5e AN ICM CSIC Ss amp Prototype Processor Issue 2 Rev 9 ACRI LOCPAN OAN EIE Software User Date 4 August 2009 ARGANS L IFREMER Page 23 Manual 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 I New folder panel Folder name Author Creation date 06 November 2008 12 17 56 Comment CANCEL Create a new Folder 5 2 Manage the created folders Renaming modifying author or comment and getting folder info are achieved through the use of a panel identical to the one for folder creation The folder export button opens a navigation window that allows the user to select the destination of the exported file A process is launched that creates a unique file named as the folder with the ext
35. RI st 2009 E ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 P ARGANS IFREMER Software User Date 4 August 2009 Manual Page 56 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 configuration file AUX_CNFOSD F so that the switch rough selector is set to 4 as a new model is added To edit this file refer to section 6 2 2 and 6 2 4 Edit the AUX CNFOSDPFF 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 SMOS L2 OS iDoc SO MA ARG GS 0021 3 eS Tcr A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 57 APPENDIX A XML Editor Tool A XM
36. ailed 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 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 2009 e ARGANS SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC eS LOCEAN SA CETP Prototype Processor p ps 9 IFREMER Software User ate 4 August 2009 Manual Page 15 Message k 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 libbackages path soft link to the third party libraries Please correct the problem before going further Refer to the Software User Manual installation instructions Important note The GUI contains environment variables that are set during the first launch of the interface Once the package is installed it is preferable not to move the directory structure to another
37. aram 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 PP1ID 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 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 parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ZNT Index of the roughness length from ECMWE atmospheric surface model Must be unique The tags name nameLong unit desc origin originld are repeated here All rights reserved ARGANS ACRI st 2009 SMOS L2 OS
38. arameter NameLong Long name of the geophysical parameter unit Unit of the geophysical parameter desc Description of the geophysical parameter origin Origin of the geophysical parameter Optional originID Identifier of the origin of the geophysical Not used parameter ind_SST Index of the Sea Surface Temperature Must be unique parameter The d name nameLong unit desc origin originld are repeated here ind WS Index of the Wind Speed parameter Must be unique The name nameLong unit desc origin originld are repeated here ind_WSn Index of the neutral wind speed Must be unique parameter The tags name nameLong unit desc origin originld are repeated here ind phi wsn Index of the azimuth of neutral wind Must be unique parameter The tags name nameLong unit desc origin originld are repeated here All rights reserved ARGANS ACRI st 2009 SMOS L2 OS Doc SO MA ARG GS 0021 ET Tuo A Prototype Processor Issue 2 Rev 9 ARGANS IFREMER Software User Dae 4 August 2009 Manual Page 42 Tag Description Note Geophy Param Geophy Param ind Tsea air Index of the air sea temperature difference parameter 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 des
39. are User Date 4 August 2009 Manual Page 48 Tg sigma max Maximum SSS retrieved sigma acceptable Tg SSS min Minimum salinity acceptable dT dS 0 Zero order sensitivity dS dT dT dS 1 First order sensitivity d dT Tg Acard min Minimum value of valid retrieved Acard Tg sigma Acard max Maximum value of sigma of valid retrieved Acard scu SC21 Scale factor for C 2 computation SC22 Scale factor for C 3 computation SC23 Scale factor for C 4 computation Scu SC25 Scale factor for C 6 computation SC26 Scale factor for C 7 computation SC27 Scale factor for C 8 computation scs SC31 Scale factor for C 10 computation SC32 Scale factor for C 11 computation SC33 Scale factor for C 14 computation Scu SC35 Scale factor for C 16 computation SC36 Scale factor for C 17 computation SC41 Scale factor for C 19 computation sce SC43 Scale factor for C 21 computation SC44 Scale factor for C 22 computation SC45 Scale factor for C 23 computation scis SC47 Scale factor for C 25 computation SC48 Scale factor for C 26 computation SC49 Scale factor for C 27 computation SC50 SC51 Scale factor for C 29 computation SC52 Scale factor for C 30 computation SC53 Scale factor for C 31 computation SC54 SC55 Scale factor for C 33 computation SC56 Scale factor for C 34 computation SC57 Scale factor for C 35 computation Table 5 Description of the post processor configur
40. ation tags All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 49 7 2 6 Overall_Quality_Thresholds The SMOS L2 SSS processor estimates the overall quality of the output products Thresholds are needed for that All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Physical_constants tags Tag Description Note Tg_Qual_Low_SSS Below this threshold grid points are classified as low SSS Above this threshold grid points are classified as low SSS Below this threshold grid points are classified as low SST Above this threshold grid points are classified as low SST Below this threshold grid points are classified as low WS Above this threshold grid points are classified as low WS Table 6 Description of the overall quality threshold tags Tg_Qual_High_SSS Tg Qual Low SST Tg Qual High SST Tg Qual Low WS Tg Qual High WS 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_AT
41. c 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 ind TatmEq Index of the equivalent atmospheric temperature parameter Must be unique 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 Pa
42. cessor All rights reserved ARGANS ACRI st 2009 M RU Software User Date 4 August 2009 Page 11 SMOSL2OS o so MA ARG Gs 0021 ag IE Prototype Processor Issue 2 Rev 9 ARGANS Manual Reference Title Code R D 8 SMOS L2 OS Table Generation SO TN ARG GS 0014 Requirement Document R D 9 SMOS L2 OS Prototype Processor SO MA ARG GS 0021 Software User Manual R D 10 SMOS L2 OS Prototype Processor SO RN ARG GS 0022 Software Release Document R D 11 SMOS Level 1 and Auxiliary Data Product SO TN IDR GS 0005 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 SMOSL2 OS Input Output Data SO TN ARG GS 0009 Definition R D 15 SMOSL2 OS Architectural Design Same as R D 6 Document R D 16 SMOS L2 OS Algorithm Validation Plan SO TP ARG GS 0015 R D 17 SMOS L2 OS Algorithm Validation Test SO TR ARG GS 0016 Procedure Report R D 18 SMOS L2 OS Parameter Data List SO TN ARG GS 0010 R D 19 Earth Explorer Mission CFI Software EE MA DMS GS 0003 Explorer Lib Software User Manual R D 20 SMOS L2 OS Operational Processor SO MA ARG GS 0018 Software User Manual R D 21 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 Missi
43. d date Person Level low mediumshigh critical Status open pending closed Type problem coherence potential improvement Completed date Description Report in detail the context from which the feedback emerged Expected improvement Describe improvements expected if the lesson learned from the feedback is applied Recommendations for implementation List documents activities software or data set affected by implementation deemed necessary to obtain the expected improvement Propose solution s and assess workload needed Difficulty of implementation easy normal tricky Reviewed by 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
44. d in section 7 6 2 5 Edit Break Points list This button gives access to the break points management panel It allows activating break points defined in the DPM R D 3 Break points are places in the processing where some of the local variables are copied in a file for detailed investigation Data storage format is either 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 2009 SMOSL2OS e Prototype Processor de P oo LOCEAN SA CETP yp ssue 2 Rev d E ARGANS eis IFREMER Software User Date 4 August 2009 Manual Page 30 Breakpoint management tor joo oMOs jobe in Folder fest Polder us Selected Break Points Available Break Points Break Points utilities BP PRP 3 1 3 BP PRP 3 1 31 BP_PRP_3_14 BP_PRP_3_1 2 BP_PRP_3_1 5 BP_PRP_3_1 6 BP_PRP_3_2 2 BP_PRP_3_1 7 BP_PRP_3_5 1 BP PRP 3 1 8 Save BP_PRP_3_2 1 BP_PRP_3_4 1 BP_PRP_3_4 2 BP_PRP_5 1 BP_PRP_1_2 BP_PRP_7_1 1 BP_PRP_7_2 1 BP_PRP_7_2 2 BP_PRP_8 1 BP_PRP_8 2 BP_PRP_12 1 Breakpoint management multiple breakpoints can be selected by holding shift or alt l key The list of available break points is located in the centre of the panel Upon the users needs and
45. e OPERATION ersion 1 R1 Application Job Management Job Execution Graphics Help s ap T E ai ui Job control panel Past jobs control panel 1 The job control panel 2 the past jobs control panel 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 All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 ICM CSIC e G Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP Sof U Pale d Ausost 2008 ARGANS Es IEREMER oftware User g Page 33 Manual Job Control Panel Job Name Folder Launch Date Run Time s Status Progress test4 install test folder 2008 02 04 15 15 19 Scheduled 0 1856946237 4 il gt DELETE PAUSE LOG EDIT CLOSE Example of scheduled job B amp Job Control Panel m 2 2m 7 nom Job Name Folder Launch Date Run Time s Status Progress test4 install_test_folder 2008 02 04 15 20 43 5 Running id 0 II DELETE PAUSE RUN NOW LOG EDIT CLOSE Example of running job E Job Control Panel LEE EEE a oo at Job Name Folder La
46. e 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 2009 LOCEAN SA CETP i IFREMER Software User Date 4 August 2009 Page 26 SMOSL2OS D scso MA ARG GS 0021 ag I Prototype Processor Issue 2 Rev 9 ARGANS Manual 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 GUI comes with a subset of the SSS configuration amp auxiliary data files containing all the EEF files XML format and the Job Order These files can be edited and modified by the user through the GUI XML editor tool in order to set their own configurations To keep a stable reference files are copied into the job Inputs directory at creation time All other files are defined through the job order as these are binary files they are not duplicated into the job workspace Reference names of the files copied by the Graphical User Interface are AUX ATMOS AUX CNFOSD AUX CNFOSF AUX FLTSEA AUX RGHNS3 MPL ORBSCT CNF L2OS 6 2 Job configuration After the job creation from the job creation window select
47. e 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 processor configuration Format of the files is not addressed here all configuration files are in XML and header structures defined for files of an Earth Explorer mission are out of the scope of this document All XML tags documented in the next sections are under the Data Block tag Descriptions given below are also available in the Graphical User Interface Tags that contain only other tags sons are in yellow The tag name is repeated after the last tag contained by the father O00 0 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 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_B
48. ee Prototype Processor ssue 2 Rev 9 ARGANS Manual Version 1 1 to version 2 0 SO MA ACRI GS 4412 Document reference name changed Formerly SO L2 SSS ACR 012 All Delete word prototype 1 4 1 5 1 6 Update reference to new version of Software Release 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 gt Updated file tree description Updated processor and GUI dependencies 6 en 7 Sections swap Job handling comes before configuration description N e Section updated for modified job configuration panel 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 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 3 1 Update installation instructions 9 New section tutorial for open prototype modification Oo ie Configuration file description updated Version 2 1 to version 2 2 SO MA ACRI GS 4412 ha 624 Update of the break point interface Configuration file edition updated 1 2 Clarification Correct references 2 1 Correct references Figure 2 1 updated
49. ension tar gz that is copied into the destination directory selected by the user The following message is displayed when the copy is over LT x Successful export of the directory in the file iusers fr SMOS test tar gz All rights reserved ARGANS ACRI st 2009 SMOSL2OS e Prototype Processor de p oe LOCEAN SA CETP yp ssue 2 Rev aay ER ARGANS EXSM t 2 IEREMER Software User Date 4 August 2009 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 New Job pane Job name SMOS job2 Author Creation date 06 November 2008 12 23 17 Job status New Processor Executable iost ubuntu SMOS L205 smos GUI SSScore bin L20SPP 03 02 exe Origi
50. iable is based on SMOS_ROOT one 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 A list of set of auxiliary data files is provided here This list must correspond to files located in the SMOS_ROOT Inputs directory Each set of auxiliary data files should contain all files necessary to run the SMOS prototype processor When a new job is created all the files from the selected set of auxiliary data files are copied into the job workspace to be configured and used during the processor run see section 6 1 hdfview HDFview software location default is SMOS ROOT bin hdfview hdfview See HDFview install procedure in section 3 2 jrepath Java Runtime Environment location
51. ion Note Freq sms Frequency of SMOS radiometer CS TO Temperature in K at 0 Celsius degree epsilonInf High frequency limit value of relative dielectric constant EpsilonO Permitivity of free space Fac omega Omega factor g Acceleration of free fall Orbit duration Orbit duration Omega sun Apparent solid angle of the Sun at 1 4 Ghz seen from Earth Cst far Faraday Constant Ucard U parameter of the cardioid model Bcard 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 constants 7 2 5 The post processor configuration file Post processing in the frame of the SMOS L2 SSS processor includes the computation of indicators on the quality of the retrieval For such computation thresholds and weights are needed All tags in the table below are under the Data Block L2 OS Configuration Parameters Post processing tags Tag name Description Note 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 Threshold to set the quality flag of the retrieval Tg Chi2 P min is not scaled All rights reserved ARGANS ACRI st 2009 SMOSL20S DM cM ES Prototype Processor mane RU PEOR E LOCEAN SA CETP i E ARGANS IFREMER Softw
52. irst guess Prior error abs parameter First guess for 10 retrieved Absolute error of prior for 1 retrieved parameter Prior error rel Relative error of prior for 1 retrieved parameter Prior error abs Absolute error of prior for 2 retrieved parameter Prior error rel Relative error of prior for 2 retrieved parameter Prior error abs Absolute error of prior for 3 retrieved parameter Prior error rel Relative error of prior for 3 retrieved parameter Prior error abs Absolute error of prior for 4 retrieved parameter SSS SST UNIO VNI0O tec WSn phi wsn HS MSQS omega Uwav Only used Guess prior true Only used Guess prior true if if All rights reserved ARGANS ACRI st 2009 SMOS L2 OS Doc SO MA ARG GS 0021 P ICM CSIC diae e B Lockansa cere mL EL Nm ARGANS IFREMER va ee E 38 Manual age Tag Description Note 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 erro
53. lete the selected job Export Make a compressed archive file with the whole job tree structure Close Close the panel Job Execution Configure Allows to configure and run the job if not running Clean This function is used only if the GUI or the computer crashes for any reason human bug while a job is running At recovery time the interface will not be able to modify the status of the running jobs if any that will remain running and when running the configuration of a job cannot be accessed so the job will remain inaccessible forever The only way to enter the configuration again is to clean the status of the job and bring it back to New 4 1 1 2 Folder management Each job is stored in a folder In order to open create and manage the folders the user has to click on the top Icon or to select Folders in the Job Management pull down menu The following window appears containing all the functions necessary to list the existing folders to select create change comment or rename a folder It allows the user to create a new folder where to organize the storage of all the simulations Note The number of jobs contained in each folder is displayed along with the creation date in the folder list zone All rights reserved ARGANS ACRI st 2009 a ICM CSIC SMOSL2OS Doc so MA ARG GS 0021 ES LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 E ARGANS IFREMER Software User Date 4 August 2009 Man
54. lock L2_OS_Configuration_Parameters Iterative_Scheme tags Tag Description Note List_of_Iterconf Tag container of the four configurations _ All rights reserved ARGANS ACRI st 2009 E eS ARGANS SMOS L2 OS Manual Page 37 ICM CSIC SO M LOCEAN SA CETP ocn D id Bun IFREMER oc SO MA ARG GS 0021 Number of retrieved parameters First guess retrievedParamId Name of 1 retrieved parameter retrievedParamId Name of 2 retrieved parameter retrievedParamId Name of 3 retrieved parameter retrievedParamId Name of 4 retrieved parameter retrievedParamId Name of 5 retrieved parameter retrievedParamId Name of 6 retrieved parameter retrievedParamId Name of 7 retrieved parameter retrievedParamId Name of 8 retrieved parameter retrievedParamId Name of 9 retrieved parameter retrievedParamId Name of 10 retrieved parameter 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 F
55. meters 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 x measurementHandle gridpoint geophyParamValue configHandle index 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 selector New code lines are case 4 ws 7 measurement Handle gt gridpoint gt geophyParamValue configHandle gt index gt ind_WS my_contribution ws tbRough break To update the processor type the following command in the SMOS_ROOT dev directory make An updated version of the processor executable should be generated although the name of the executable is the same If compilation error occur check the new code consistency and compile again make command 9 5 Testing the code modification All rights reserved ARGANS AC
56. n Job Q 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 2009 4 Icmcsic SMOS L20S Doc SO MA ARG GS 0021 ag LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Manual Date 4 August 2009 Page 25 B New Job panel Job name SMOS_job5 Author Creation date 31 January 2008 17 28 00 Job status New Processor Executable mount users fr smos gui Core v2 0 bin Origin Job IK Origin Job selection panel Comment Folder list Job list CANCEL Note It is important to ensure that the job selected as origin is compatible with the processor version used for the new job In case the default processor binary cannot be found in the bin directory of the GUI the following message is displayed along with possible recovery action to undertake Job management panel Folder list Job Utilities testi Job list Job Execution testi 0 The default processor binary has not been found in the bin directory Pleas
57. neering Software Part 1 ECSS E 40 Part 1b Principles and requirements A D 7 Space Engineering Software Part 2 ECSS E 40 Part 2b Documents Requirements Definition A D 8 DPGS Master ICD SO ID IDR GS 0016 A D 9 XML schema guidelines SO MA IDR GS 0004 A D 10 DPGS schema versioning SO TN IDR GS 0024 A D 11 SMOS DPGS acronyms SO TN IDR GS 0010 A D 12 SMOS L2 Open Prototype Requirements SO RS GMV GS 4401 and Architecture 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 Product SO TN IDR GS 0006 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 Detailed Design Document is available in electronic version only The DDD is a web site dedicated to the documentation of the Operational Pro
58. nene 36 T3 JOBORDER cGGGGsenecwetueestieteudenmu ete estes tere et e t tet ive veu eere PETS 49 7 4 THE PRIVATE CONFIGURATION FILE 0 cccccssessssssessssscseeceeeseeeseseseseeeseseeeseseseeeeuseseeeseeesuaeauaeauaeaeaeauaeaeaeanenees 40 8 CONFIGURATION OF THE GRAPHICAL USER INTERFA CE eere eene enne eee en nenas en 52 9 MODIFICATION OF THE L20S OPEN PROTOTYPE TUTORIAL e ee eeen eene neon noun 54 O T INTRODUCTION 5 nee iter ree ieri hesteue bete de drtuiivetiu tie eite a 54 9 2 INSERT A NEW USER S MODBL eeesteeseeceste a eee pe a ee EE PEUT EE Sedet Eve EEER Ee dE Pet EP Ete EE PUE EER PEE NEUE 54 9 3 GEOPHYSICAL PARAMETER RETRIEVAL FROM THE DATA MODEL OF THE PROCESSOR eene een 55 9 4 WHERE TO CALL THE USER S MODBL eene en n n n n n nn nnnn nnn nn n ann n e unn n a n a a e n na e enne n n pap Eau eee 55 9 5 TESTING THE CODE MODIFICATION eee n n nnn Innen nnn esseer nnn nnn ann a e e usa a a ae e e e p n p up Ene n n pap aua 55 APPENDIX A XML EDITOR TOOL ee esor too rnnt eo reo FFs ko aep rn par Re Fa eee eia ruo too o oa bap EF Eo ta OE aeo boe eP Ua aaro ono 57 All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS IDoc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 E ARGANS IEREMER Software User pue 4 August 2009 Manual Page 8 APPENDIX B FEEDBACK FORM sseseseseseseseseseseseseseseseoeoeoeoe
59. ng between users standard access rights by users and groups of LINUX operating system are used All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 E LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 14 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 4 1 of SO RN ARG GS 0019 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 SMOS L2 OS 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 det
60. o 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 SMOS L2 OS Doc SO MA ARG GS 0021 e ES IE Prototype Processor Issue 2 Rev 9 LOCEAN S A CETP ARGANS EXezi i IFREMER Software User Date 4 August 2009 Manual Page 19 Job management panel m Folder list Job Utilities NE Job list E Job Execution ontigure EAN Job Management Panel 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 ARGANS E j ICM CSIC ie LOCEAN SA CETP IFREMER SMOSL2OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 9 Software User Date 4 August 2009 Page 20 Manual This panel gives access to the following functions Zone Name Function Job Utilities New Create a new job from scratch or based on an existing job Rename Rename the selected job Modify Allow adding or modifying the job author and the job comment Info Display all job information Delete De
61. oeoeoeoeoeoeoeoeoeoecoeoeoeoeosoeoeoeosoeoeoeoeoeosseoeoeoeseoeseoesee 63 All rights reserved ARGANS ACRI st 2009 4 ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 3 eS LOCEAN SA CETp Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 9 1 Introduction 1 1 General This document is the user manual of the SMOS L2 OS Prototype Processor and its Graphical User Interface GUI Both the prototype processor and the GUI have been developed to be operated on Linux 64 bit platforms They are two independent software packages The processor can be operated from the command line interface provided the configuration of the processor is valid Configuration of the software includes many files switches selectors and parameters The GUI helps the user to set up configuration files and to operate the processor The GUI gives access to basic visualization tools for the output products as well 1 2 Guide to this document The user manual of the processor is embedded in the manual for the 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
62. og progress Breakpoint GUI hdfview Breakpoint i reports i 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 e Define processor operation mode correction retrieval mode roughness model All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 E LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 13 e Select geophysical parameters to be adjusted during iterative retrieval and its operating mode dual polarisation full polarisation or Stokes 1 e Select a processing latitude longitude window where SSS is retrieved e Select grid points where SSS is retrieved e Sets thresholds for sea ice detection Sun glint contribution and measurement validity control e Activate breakpoints To some extent the configuration interface gives access to LUT and coefficient files see section 2 4 of R D 4 For example coefficients of the roughness model 3 ICM can be modified through this interface 2 3 GUI Processor Operation The operation GUI can start the processor with selected configurations Processor runs can be scheduled queued pau
63. on Conventions document R D 25 X 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 E ICM CSIC SMOSL2OS IDoc SO MA ARG GS 0021 ES LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 E ARGANS IFREMER Software User Date 4 August 2009 Manual Page 12 2 Overview 2 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 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 Graphical User Interface Configu ration LX Data Operator GUI Analysis Or PFW Product Operation SMOSview stdout stderr l
64. r rel Relative error of prior for 7 retrieved parameter Prior error abs Absolute error of prior for 8 retrieved parameter Prior error rel Relative error of prior for 8 retrieved parameter Prior error abs Absolute error of prior for 9 retrieved parameter Prior error rel Relative error of prior for 9 retrieved parameter Prior error abs Absolute error of prior for 10 retrieved parameter Prior error rel Relative error of prior for 10 retrieved parameter sig_th_mod Uncertainty of the forward model in H Accounted for in the polarisation at target level cost function and in sig tv mod Uncertainty of the forward model in V outlier detection polarisation at target level sig st3 mod Uncertainty of the forward model Stokes 3 at target level sig st 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 deltaP tags List_of_Delta_Parameters deltaP Variation of the 1 retrieved All rights reserved ARGANS ACRI st 2009 SMOS L2 OS Doc SO MA ARG GS 0021 ag LO Pca NA Prototype Processor Issue 2 Rev 9 ARG
65. ram All rights reserved ARGANS ACRI st 2009 SMOS L2 OS Doc SO MA ARG GS 0021 ET Tuo A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 43 Tag Description Note 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 model parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind 2mDT Index of the dew point temperature at 2m parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind Cd Index of the drag coefficient with waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated he
66. re Geophy_Param Geophy_Param 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 Must be unique All rights reserved ARGANS ACRI st 2009 SMOS L2 OS Doc SO MA ARG GS 0021 ET Tuc aan Prototype Processor Issue 2 Rev 9 ARGANS IFREMER Software User Dae 4 August 2009 Manual Page 44 Tag Description Note The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind UN10 Index of the neutral wind zonal component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy Param ind VN10 Index of the neutral wind meridional component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy Param Geophy P
67. s invited to enter the date and time of run in the format hh mm mm dd yyyy Job Execution RUN NOW O SCHEDULE amp 17 22 06 22 2006 All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS poc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGAN S IFREMER Software User Date 4 August 2009 Manual Page 32 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 Message E 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 prototyp
68. s 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 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 Tag name Brightness tepmeratures of Llc file are patched with brighness 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 OverWriteMeasu rement 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 OverWritePior rescaleRadiometr Obsolete icUncertainty Seed Seed of the random number generator with gaussian probability distribution function Seed is random if tag value is negative Mean 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 0 bypass xml rw Input da
69. sed 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 Data GUI SMOS products can be visualized using SMOSview 2 5 Breakpoint report GUI The breakpoint report GUI is either a text editor of 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 6 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 shari
70. see the Input Output Data Description Document R D 4 the SMOS L1 auxiliary data specification format R D 13 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 11 13 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 2009 SMOS L2 OS iDoc SO MA ARG GS 0021 EE eS Tcr A Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 10 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 SMOS L2 OP Operational Constraints SO TN GMV GS 4402 A D 2 obsolete A D 3 PDPC CORE Generic IPF Interface SO ID IDR GS 1001 Control Document A D 4 Earth Explorer File Format Standards PE TN ESA GS 0001 A D 5 Level 2 Processor ICD and Operational SO ID IDR GS 0003 Constraints A D 6 Space Engi
71. ta reading is faster with this option api Supress DAP Do not generate DAP or DAP report Ignore AGDP Do not process AUX_AGDP Do not process polarised galactic noise ie ignore LUT tQQ 00 amp LUT tUU 00 in AUX GAL2OS Ignore Pol Gal Noise Host name for the Processors are installed as identified by PDPC Core It is a logical name with DNS not an IP direction Host Name HW Identifier Unique identifier of the hardware involved in the processing nnnn where n are digits or characters All rights reserved ARGANS ACRI st 2009 E ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 Vl LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 e ARGANS IFREMER Software User Date 4 August 2009 Manual Page 51 Tag name Description Product Type Product type name Schema Version Version of schema to be used with the version of the processor MEE Schema Tag end List of Input Sc Tag end hemas List of Output Schemas Schema Repeated 4 times for UDP DAP UDP report and DAP report Product Type Schema Version Schema Tag end List of Output Tag end Schemas Processing wind Limits in lat lon of selected area ow Start_Lat Latitude lower limit for area selection Start_Lon Longitude lower limit for area selection End Lat Latitude upper limit for area selection End_Lon Longitude upper limit for area selection Processing_wind
72. the newly created job in the proposed list and click on the button Configure in the Job Execution zone The following window appears All rights reserved ARGANS ACRI st 2009 SMOSL2OS o so MA ARG Gs 0021 ICM CSIC Prototype Processor Issue 2 Rev 9 Software User Date 4 August 2009 Manual Page 27 LOCEAN SA CETP IFREMER us Configuration pene TO JOD SMOSJODZ Th Folder meemi Job Parameters Name SMOS_job2 Folder Test_Folder Processor version host ubuntu SM OS L2 OS smos GUI SSScore bin L2 OSPP 03 02 exe Origin Job None toto h Leases Input Dataset Break Points Configuration Edit Job Order Edit Break Points List Processing Window Job Execution Entire globe applied RUN NOW Job Configuration Panel 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 To run the selected test click on button LAUNCH in the Job configuration panel All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 ag ES E Prototype Processor ssue 2 Rev 9 LOCEAN S A CETP Date AA 2009 ARGANS ACRI IFREMER Sof
73. 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 2009 SMOS L2 OS IDoc SO MA ARG GS 0021 ag I Prototype Processor Issue 2 Rev 9 LOCEAN SA CETP f ARGANS IFREMER Software User Date 4 August 2009 Manual Page 58 Attribute Default Admissible Purpose Example Value values editable true true false Allow to edit the editable true next tags data type text text double Impose a type to the type double float int file next tags data A dir check is done to ensure that the data has the imposed type list none Any list of To impose a list of list2 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 fpatternzZ CONF file this attribute allows restricting Search will bear on the the
74. tions Find string CTRL F is useful for finding the tag the user is looking for o 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 7 3 this icon denotes that this tag has one or several sons name is not editable e D no sons are available below this tag The text associated is the tag value editable by default but can be made not editable All rights reserved ARGANS ACRI st 2009 SMOSL2OS poc SO MA ARG GS 0021 lt a ICM CSIC Ss Les Prototype Processor ssue 2 Rev 9 LOCEAN SA CETP Sof U Iste Aneu D608 ARGANS Eis5 IFREMER oftware User g Page 61 Manual o 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 c log4c A editable true the counter number is replaced A version 1 1 0 with the value of the attribute see C config 1 L EA category root left corner example o C category system C category NOBP FOM 1 A appender stdout A list enabled disabled A name NOBP FOM 1 A priority trace 3 enabled C category BP FOM 2 2 gt C category NOBP FOM 3 gt C category
75. trieved parameter guess prior Use First guess for the 9 retrieved parameter guess prior Use First guess for the 10 retrieved parameter I Repeat tags above All rights reserved ARGANS ACRI st 2009 B es icwicsic SMOS L2 OS oc SO MA ARG GS 0021 a me LOCEAN SA CETP Prototype Processor Issue 2 Rev 9 IFREMER Software User Date 4 August 2009 Manual age 41 ARGANS 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_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 p
76. tware User ate 4 August Page 28 Manual 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 Jos order tor job 5MO5S39DZ in Folder test Folder File Edit v Job Order A editable false A xmins http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema instance A xsi schemaLocation http 213 170 46 150 smos schemas SM TEST MPL JOBORD 0004 xsd P Orderld 1 gt Conf 1 gt List of Procs 1 D 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 L20OS chain Job Parameters Tag finder Name Enter searched string CNF_L20s Cale ES B Previous Next Close File Edit j A fpattern CNF_L20S_ a Ta zj xsi schemaLocation H http 213 170 46 150 smos schemas XX CNF 120 xmins xsi H http www w3 org 2001 XMLSchema ir 7 Sensing Time 1 v start fil LJ xmins H http 213 170 46 150 smos schemas 2006 04 19 185548 972 7 Stop 1 editable true 2006 04 19 194948 972 7 List
77. ual Page 21 Folder management pane BS Folder list Folder Utilities Test_Folder 04 February 2008 18 10 35 3 jobs new crose 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 2009 r ICM CSIC SMOSL2OS Doc SO MA ARG GS 0021 ss eS LOCEAN SA CETP Prototype Processor ssue 2 Rev 9 ARGANS IFREMER Software User Date 4 August 2009 Manual Page 22 a SMOS OPERATION Version 2 R1 1 Core Processor V2 3 Application Job Management Job Execution Graphics Global configuration Q Exit Application pull down menu Warning All running jobs will be deleted at exit time Details on interface behaviour regarding programmed jobs is given in section 6 2 7 4 1 3 Version From the main window the pull down menu About provides the main references of SMOS GUI click anywhere in the displayed window to close it e m d ARGA
78. unch Date Run Time s Status Progress Proc test4 install_test_folder 2008 02 04 15 28 39 0 Queued 0 377969797 test3 install test folder 2008 02 04 15 28 44 34 Running 0 116347658 il I D gt DELETE pause RUNNOW LOG EDIT CLOSE POR Example of queued job Each line of the list is dedicated to a job It allows to check the progress of the run through the Run time given in seconds and the Progress given in percentage It is also possible to edit the output log file of any running job and monitor the progression of the computation As shown in the above snapshots the names and availability of the buttons displayed in this window depend and may vary according to the type of job selected e On a running job the user can Pause then Resume it Delete it gt Edit the log file in real time e Ona 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 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 the All rights reserved ARGANS ACRI st 2009 E

SMOS L2 OS Prototype Processor Software User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents