Home

Title: SMOS L2 OS Prototype Processor Software User Manual Doc

1. SMOS_ROOT smos_GUI_SSScore folders folder M These directories should be manually cleaned They are not used by the processor but by the GUI All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Manual Page 17 Job workspace 8SMOS_ROOT smos_GUL_SSScorelfolders folderkM SMO S_Job N Input data SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Inputs Results of the run SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Outputs Reference run results SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Outputs_ref Control of processing SMOS_ROOT smos_GUI_SSScore folders folder M SMO S_Job N Control Note The above temporary spaces are not used for the Core processor These spaces are used by the GUI to store shell scripts and files needed to manage the processing In order to run correctly SMOS GUI needs the following hardware and software resources 3 6 1 Hardware and software requirements Hardware and software requirements are detailed in the SMOS L2 OS Prototype Processor Software Release Document SO RN ARG GS 0022 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 ICM CSIC LOCEANS SICETE
2. Prior_error_abs Absolute error of prior for 8 retrieved parameter Prior_error_rel Relative error of prior for 8 retrieved parameter Prior_error_abs Absolute error of prior for 9 retrieved parameter Prior_error_rel Relative error of prior for 9 retrieved parameter Prior_error_abs Absolute error of prior for 10 retrieved parameter Prior_error_rel Relative error of prior for 10 retrieved parameter sig_th_mod Uncertainty of the forward model in H Accounted for in the polarisation at target level cost function and in sig_tv_mod Uncertainty of the forward model in V outlier detection polarisation at target level sig_st3_mod Uncertainty of the forward model Stokes 3 at target level sig_st4_mod Uncertainty of the forward model Stokes 4 at target level KappaDia Factor for multiplying Marquardt diagonal lamdaini Initial value of the Marquardt diagonal amplifier deltasig Increment to standard ratio for convergence deltaChi Cost function variation for convergence All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS IDoc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 u o Software User Date 11 October 2013 Manual Page 40 Tag Description Note fCon Maximum of conditioning factor List_of_Delta_Parameters List of deltaP tags deltaP Variation of the 1
3. The global configuration panel accesses the following parameters SMOS_ROOT At first launch of the GUI this variable is automatically set to the GUI install directory xml rw_api home Non editable variable This variable is based on SMOS_ROOT one and is used to configure processor runs LD_LIBRARY_PATH Non editable variable This variable is based on SMOS_ROOT and is used to configure processor runs Default job name By default a unique name is given to a job created through the processor This name is constituted with this root name and a counter number increasing as jobs are created Default processor binary When several versions are available the creation panel will select this value by default Default processor binary can be modified here max_jobs Several jobs can run at the same time The number entered manually by the user should depend on the computer speed and available amount of RAM memory This option should only be used if the computer has a multi processor structure and has enough RAM memory to run several processing e g 4 Gb x max_jobs Refreshing period This period in seconds is used for updating the job progress information zone Configuration selection Non editable variable When a new job is created files from this directory are copied into the job workspace to be configured and used during the processor run hdfview HDFview software location default is SMOS_ROOT bin hdfview hdfview See HDFview install
4. 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 SMOS_ROOT smos_GUI_SSScorellib gdal_install Abstraction Library amp Java MOS_ROOT smos_GUL_SSScorelgui jars run time libraries SMOS_ROOT smos_GUI_SSScore gui jedit SMOS_ROOT smos_GUI_SSScore gui logs Java runtime environment SMOS_ROOT smos_GUI_SSScore jre1 6 0_01 Configuration files SMOS_ROOT smos_GUI_SSScore properties Images SMOS_ROOT smos_GUI_SSScore gifs User manual this document SMOS_ROOT smos_GUI_SSScore doc Processor Binary executable SMOS_ROOT smos_GUI_SSScore bin HDFview installation SMOS_ROOT smos_GUI_SSScore bin hdfview_install_lin package ux64amd_vm bin Input configuration files SMOS_ROOT smos_GUI_SSScore inputs Processor data and schema SMOS_ROOT smos_GUI_SSScore smos soft link Processor libraries SMOS_ROOT smos_GUI_SSScore libpackages soft link Shell files SMOS_ROOT smos_GUI_SSScore shells Temporary spaces SMOS_ROOT smos_GUI_SSScore tmp and SMOS_ROOT smos_GUI_SSScorelpids Jobs Global workspace SMOS_ROOT smos_GUI_SSScore folders Folders
5. ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 IFREMER Manual Page 41 Tag Description Note 1 model 1 from IPSL LOCEAN 2 model 2 from IFREMER 3 model 3 from ICM CSIC Switch_rough3 Sea surface model 3 selector for Valid if switch_roug coefficients 3 For ICM CSIC only Switch_rough_harmonics If true process higher order roughness Only implemented model harmonics for roughness model 2 IFREMER Switch_err_mode Account for model error if true Switch_store_gal If true galactic noise computed by this model is written to the DAP Switch_card Activate cardioid model instead of flat sea model Switch_ott Index of the OTT used by the processor 0 no OTT 1 AUX_OTTIx_ 2 AUX_OTT2x_ 3 AUX_OTT3x_ with offsets to apply to Llc TB Delta_sn Maximum admissible time between two Valid if measurement to compute Stokes 1 retrievalMode 2 Tg_WS_roughness Wind speed above which roughness contributions are computed Tg_WS_foam Wind speed above which foam contributions are computed List_of_Guess_Datas List of guess_prior tags Set to true or fal s e e guess_prior Use First guess for the 1 retrieved parameter guess_prior Use First guess for the 2 retrieved parameter guess_prior Use First guess for the 3 retrieved parameter guess_prior Use First guess for the
6. ACRL Manual 3 Installations and operation 3 1 Installation of the core processor To install to test and to use the processor from source codes follow the procedure in section 2 1 of the SMOS L2 OS Prototype Processor Software Release Document SO RN ARG GS 0022 3 2 Installation of the GUI The SMOS L2 processor and its GUI are delivered as several compressed archive files along with installation instructions Both software packages are intended to be installed on a Linux 64 bit operating system environment The Red Hat 5 Enterprise operating system is recommended because it is the environment on which the processor and the GUI have been implemented and tested For the installation procedure of the GUI refer to the Prototype Processor Software Release Document SO RN ARG GS 0022 We assume hereafter that the processor and all necessary auxiliary and input data files have already been installed and that an environment variable SMOS_ROOT has been set pointing to the installation directory and that the GUI components have been correctly installed and configured 3 3 Installation of HDFview HDFview is needed to visualize breakpoint report files Installation of the software is detailed in the Prototype Processor Software Release Document SO RN ARG GS 0022 The 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
7. Job Folder Management pull down menu In order to create open manage the jobs the user has to click on the top icon or to select Job Management gt Jobs in the main window pull down menu The following window appears containing all the functions necessary to navigate in the folders to select open create change comment or rename a job Note It is not allowed to create a job if no folder exists All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS _ poc SO MA ARG GS 0021 a EE TOES Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP ARGANS Koi L RENEK Software User Date 11 October 2013 Manual Pages 20 aga CAS Folder list cJob Utilities S NE Job list SENSE Job Execution ontigure CLEAN Job Management Panel b The list of existing jobs is displayed depending on the selected folder The creation date and the status of execution are also written in this list All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 SMOS L2 OS Doe SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Page 21 ICM CSIC LOCEAN SA CETP IFREMER 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 R
8. 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 Note that if the orbit does not intersect the region selected no grid points are available for processing and an error will be reported when the job is started Users may wish to initially select a thin horizontal strip from 180 W to 180E which will usually include some grid points unless the Lic half orbit is incomplete 6 2 7 Job execution Once the configuration phase is over the processor is ready to be launched Two different running modes are available 1 Direct launch 2 Scheduled launch The direct launch mode is used by selecting the Run now option Clicking on the button Launch will run the job gt If no job is already running the job is launched gt Ifa job is already running then the job will be launched only if the maximum number of allowed concurrent jobs is set to an appropriate value e g greater than 1 Otherwise the job will be queued until it is possible to be run The scheduled mode is used when
9. SotwansUser ate 1 October 2014 IFREMER Page Manual see 18 4 The graphical User Interface 4 1 The main windows At launch time as the GUI is loading the next window is displayed a ARGANS Interface components are loading Please wait SMOS Then the main SMOS Interface appears 12 EMOS GUI Version oie Prototype Processor V3 Application Job Management Job Execution Graphics ES Ea 8 sau 4 1 1 User Interface principles SMOS GUI is dedicated to run SMOS Processor All the functions are accessible from the main window menu which is split in 3 main functionalities Application to access the global parameter configuration window and the exit function All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 19 Job Management create or manage folders and jobs configure and run jobs Job Execution launch the job viewers monitor running or scheduled jobs check pas jobs Graphics to access shortcut to HDFview 2 access the user manual this document in PDF format and GUI current version about function 4 1 1 1 Job management ES smos OPERATION Version 2 R1 1 Core Processor V2 3 Application Job Management Job Execution Graphics La Folders pr ia Jobs Y
10. gt ind WS my contribution ws tbRough break To update the processor type the following command in the SMOS_ROOT dev directory make An updated version of the processor executable should be generated although the name of the executable is the same If compilation error occur check the new code consistency and compile again make command 9 5 Testing the code modification All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS SO MA _GS E os Prototype Processor a es io aia LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 11 October 2013 Manual Page 66 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
11. a O oe Frequency of SMOS radiometer Temperature in K at O Celsius degree Tag radi i i rn A Fac_omega_____ Omegafaetor O SSCS e i eion A Orbit duration Orbitduration EA IN A A Omega_sun Apparent solid angle of the Sun at 1 4 Ghz seen from Earth Sky irradiance of galactic noise model 0 Table 4 Description of the tags with the physical constants epsilonInf High frequency limit value of relative dielectric constant 7 2 5 The post processor configuration file Post processing in the frame of the SMOS L2 SSS processor includes the computation of indicators on the quality of the retrieval For such computation thresholds and weights are needed All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Post_processing tags Tg Chi2_P_ max Maximum admissible value for Dg_chi2_P Dg_chi2_P in the UDP is scaled by multiplying by 1000 Tg_Chi2_P_max is not scaled Tg Chi2 P min Minimum admissible value for Dg_chi2_P Dg_chi2_P in the UDP is scaled by multiplying by 1000 Tg_Chi2_P_min is not scaled Tg chi2 Threshold to set the quality flag of the retrieval process Tg sigma max Maximum SSS retrieved sigma acceptable Te SSS max Maximum salinity acceptable Ts SSS min Minimum salinity acceptable oo araso Zeroorder sensitiviy aS aT arasi FirstordersensitiviydS4T Tg Acard max Maximum value of valid retrieved Acard Tg Acard min Minimum value of
12. s model 3 where to call the user s model 4 how to update the processor 5 how to use the user s forward model Before any source code change the user need to make sure that he she has write permission on the source code files under the SMOS_ROOT dev directory 9 2 Insert a new user s model In this tutorial the user s model is very simple It simulates a contribution to the surface brightness temperature in H and V polarisation directions due to roughness effect that is proportional to the wind speed WS TbH TbV 0 1 WS To add this model to the global forward model used by the processor to compute brightness temperatures that are compared to the measurement a new function is created in the SMOS_ROOT dev forward_model forward_model c function The new function is inserted after line 87 include and before the function computeForwardModelContribution is defined The new code lines are int my contribution double ws double my TB 4 my TB O 0 1 ws my TB 1 0 1 ws my TB 2 0 0 my TB 3 0 0 return RETURN CODE SUCCESS The general forward model handles the four Stokes parameters at the surface target polarisation frame as well as at the antenna polarisation frame with a vector of four floating numbers Tb 0 H or X polarisation in K All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Proc
13. C category root o C category system 9 C category NOBP FOM 1 A appender stdout A list enabled disabled A name NOBP FOM 1 A priority trace Ly enabled gt C category BP FOM 2 2 gt C category NOBP FOM 3 gt C category NOBP FOM 4 gt C category NOBP FOM 5 gt 1 category NOBP FOM 7 When the attribute name exists the counter number is replaced with the value of the attribute see left corner example gt The right panel is used to display a tag value along with all its associated attributes The inherited attributes are flagged with a H Note The editable tags are written in blue When editable the value associated to the tag 1s written in green Below the right zone a button band is available and is dependent on the tag attributes gt If the value is not editable then the buttons is changed to lot editable gt If the value is editable and the tag is not of type file the buttons is Update Value gt If the value is editable and the tag is of type file the buttons are Update Value Select File gt If the value is editable and the tag is of type directory the buttons are Update Value Select Directory gt If the value is editable and the tag is of type file and the pointed file is an XML editable file then the buttons become Update alue Select File Edit XML File gt If the value is editable and the tag is o
14. IFREMER Software User Manual IDoc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Date 11 October 2013 Page 44 Tag Description Note 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_Param Geophy_Param ind_tec Index of the Total Electronic Content parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Tp Index of the mean period of wind waves parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind U Index of the wind friction velocity from ECMWE atmospheric model parameter Must be unique The tags name nameLong unit desc origin originld are repeated he
15. R D 4 With this graphical interface the user can among many other functions e Define names of input files and output files All rights reserved ARGANS ACREst 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 ba Prototype Processor Issue 2 Rev 19 LOCE ETP ARGANS hot PERENNE Software User Date 11 October 2013 ST IFREMER Manual Page 14 e Define processor operation mode correction retrieval mode roughness model e Select geophysical parameters to be adjusted during iterative retrieval and its operating mode dual polarisation full polarisation or Stokes 1 e Select a processing latitude longitude window where SSS is retrieved e Select grid points where SSS is retrieved e Sets thresholds for sea ice detection Sun glint contribution and measurement validity control e Activate breakpoints To some extent the configuration interface gives access to LUT and coefficient files see section 2 4 of R D 4 For example coefficients of the roughness model 3 ICM can be modified through this interface 2 3 GUI Processor Operation The operation GUI can start the processor with selected configurations Processor runs can be scheduled queued paused resumed and cancelled Information generated by the processor on standard output stdout or on standard error output stderr is available through this interface The interface monitors processing progress and reports status of past processor run
16. retrieved parameter to compute derivative deltaP Variation of the 2 retrieved parameter to compute derivative deltaP Variation of the 3 retrieved parameter to compute derivative deltaP Variation of the 4 retrieved parameter to compute derivative deltaP Variation of the 5 retrieved parameter to compute derivative deltaP Variation of the 6 retrieved parameter to compute derivative deltaP Variation of the 7 retrieved parameter to compute derivative deltaP Variation of the 8 retrieved parameter to compute derivative deltaP Variation of the 9 retrieved parameter to compute derivative deltaP Variation of the 10 retrieved parameter to compute derivative itMax Maximum number of iteration lamdaMax Maximum of Marquardt diagonal amplifier Tg_num_meas_min Minimum number of measurements to start the retrieval Switch_foam Compute foam coverage of contribution RetrievalMode Select between five retrieval modes 0 full polarisation 1 dual polarisation from dual 2 dual polarisation from full 3 Stokes 1 from dual 4 Stokes 1 from full strategy 1 5 Stokes 1 from full strategy 2 6 Stokes 1 from full strategy 3 Switch_gal Model for galactic noise contribution 0 Model 0 1 Model 1 2 Model 2 Switch_roug Model for sea surface roughness effects 0 None All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS IDoc SO MA ARG GS 0021
17. unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_phi_wsn Index of the azimuth of neutral wind parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Tsea_air Index of the air sea difference parameter temperature Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_UST Index of the friction velocity from ECMWF Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ OMEGA Index of the inverse wave age parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_HS Index of the parameter inverse wave height Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_MSQS Index of the Mean Square Slope of Wave parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_TAU Index of the optical thickness of the atmosphere parameter Must be unique All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC ee LOCEAN SA CETP
18. 2 Rev 19 Date 11 October 2013 Page 73 IDoc SO MA ARG GS 0021 Appendix B Feedback Form The form below is the template of the feedback form The form is aimed at reporting software problems or at requesting changes in the SMOS L2 SSS Prototype Processor The forms shall be sent to smos argans co uk Feedback form Number HHH Contact Name and institution Initiated date Person Level low medium shigh critical Status open pending c losed Type problem coherence potential improvement Completed date Description Report in detail the context from which the feedback emerged Expected improvement Describe improvements expected if the lesson learned from the feedback is applied Recommendations for implementation List documents activities software or data set affected by implementation deemed necessary to obtain the expected improvement Propose solution s and assess workload needed Difficulty of implementation easy normal tricky Reviewed by PM SMOS project date team Workload low medium high hours days Implementation yes no Justification Justify implementation or no implementation All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013
19. file named as the folder with the extension tar gz that is copied into the destination directory selected by the user The following message is displayed when the copy is over x Successful export of the directory in the file users fr SMOS test_ tar gz All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 ed S LOCEAN SA CETP j ARGANS ACRI IFREMER Software User Date 11 October 2013 Manual Page 25 6 JOBS HANDLING A complete run of SMOS prototype will be achieved after a full configuration of the job 6 1 Job creation From the job creation window the button New opens a window in which the user will specify the job name blank characters are allowed but will be replaced by underscores gt the author name optional and appropriate comments optional The processor executable binary can also be changed on this panel Click on Processor Executable button a selection window will be displayed listing every L20SPP_ files contained in the bin directory The user is invited to select the desired binary for the concerned job any location is allowed By default the binary is set in the global configuration window see section 8 Sus E New Job panel Job name SMOS _job2 Author Creation date 06 November 2008 12 23 17 Job status New Processor Executable 1ost ubun
20. meaningful names eg Fg_sc_land Fg_sc_ocean Fg_sc_coast Fg_sc_near_land All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Flag tag Tag Description Note Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Hex bitmask for testing the flag Remaining Llc measurement flag definitions appear here All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP Software User Date 11 October 2013 IFREMER Page 53 Manual 8 Tag Description Note Flag Definition of an L2OS measurement flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS measurement flag definitions appear here List_of_L2OS_measurement_flags List_of_L2OS_control_flags Tag container of the definitions of count L2OS control flags Flag Definition of an L2OS control flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS control flag definitions appear here List_of_L2OS_control_flags List_of_L2OS_science_flags Tag container of the definitions of count L2OS science flags Flag Definition of
21. names to test if any of these flag tests are met the filter is activated and the measurement grid point is rejected Flags the names of which must all be unique are defined in the configuration file as a bitmask to be applied by the processor to each measurement grid point and a test result if the test result value matches the flag is considered to be true This flag filter mechanism allows measurement grid point selection to be managed via the configuration file without the need to recompile the processor This flexibility may be needed for example when there are changes to the Level 1 products or to the measurement grid point selection criteria when agreed by ESL There are 5 different categories of flags each set defining a list of flag names masks amp tests List_of_L1c_measurement_flags applied to Llc measurements List_of_L2OS_measurement_flags applied to L2OS measurement flags List_of_L2OS_control_flags applied to L2OS grid point control flags List_of_L2OS_science_flags applied to L2OS grid point science flags List_of_L2OS_out_of_range_flags applied to L2OS grid point out of range flags For detailed definitions of the L2OS flags see the IODD RD 14 amp the L2 product specification RD 4 For the Llc flags see the L1 product specification RD 11 By specifying multiple bits in the mask and or test result flags defined in the product specification that use several bits eg Fg_sc_land_sea_coastl 2 may be defined with
22. not been found in the bin directory Please correct the problem before going further 1 Check that variable default_processor_binary points on an existing processor in the global configuration panel 2 Check the presence of the binary processor in the bin directory 3 Refer to the Software User Manuel installation instructions Job creation cancelled All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS AR ICM CSIC Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP ARGANS ACRE IFREMER Software User Date 11 October 2013 Manual Page 27 If selected the whole configuration of the selected former job will be copied into the new one instead of the one defined as the default dataset in the global configuration panel see section 8 6 2 Job configuration After the job creation from the job creation window select the newly created job in the proposed list and click on the button Configure in the Job Execution zone The following window appears tates Configuration panel tor job SMOS job2 in Folder fest Folder Job Parameters Name SMOS_job2 Folder Test_Folder Processor version host ubuntu SMOS L20S smos_GUI_SSScore bin L2 OSPP_03_02 exe Origin Job None UL Cteatis e hlosas 4 Input Dataset Break Points Configuration Edit Job Order Edit Break Points List Processing Window Job Execution Selection Entire globe appli
23. paragraph explaining that messages like WARNING The property smos dyn interface x y w h is empty or does not exist can be safely ignored See Appendix of FAT minutes for JCD comments referenced above Version 2 17 to version 2 18 SO MA ARG GS 0021 7 4 Table 7 Deleted Ignore_Pol_Gal_Noise 7 2 3 Table 3 Deleted Switch_af Tg_gal_noise_pol_max Tm_gal_noise_pol Tm_out_of_range Added Switch_OTT_AscDes Switch_GN2_AscDes RFI_c1 RFI_c2 Tg_num_meas_outliers_min Tg_num_meas_RFI_outliers_min Tg_num_RFI_outlier_max Tg_current_RFI_max_X Tg_current_RFI_max_Y Tm_out_of_range_affov Tm_out_of_range_eaffov Tm_out_of_range_stokes3_affov Tm_out_of_range_stokes3_eaffov Tm_out_of_range_stokes4_affov Tm_out_of_range_stokes4_eaffov Ts_snapshot_out_of_range Ts_meas_min Ts_std Ts_std_stokes3 Ts_std_stokes4 7 2 1 Table 1 Corrected definitions of First_guess amp Prior_error_abs rel now Only used if Guess_prior false clarified definition of Guess_prior Added new section Flags amp filters definitions amp new Tables 7 8 amp 9 7 4 Table 7 Renumbered now Table 10 Added list of tables Version 2 18 to version 2 19 SO MA ARG GS 0021 7 2 3 Table 3 Added Switch_iterative_scheme 7 2 7 Table 8 Added OTT_region_filter OTT_snapshot_filter OTT_stats_filter 7 2 8 Table Added new section amp table describing A3TEC configuration 10 7 2 9 Tables A
24. parameter see section 8 3 4 GUI startup The GUI is launched by typing the following commands cd SMOS_ROOT smos_GUI_SSScore launch_smos sh Several error messages of the type WARNING The property smos dyn interface x y w h is empty or does not exist are generated by Java and can be safely ignored At launch time verification is done for the presence of the smos and libpackages soft links described in the Prototype Processor Software Release Document SO RN ARG GS 0022 The following error message is displayed in case one of the links is not present in the GUI installation directory All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ARGANS ICM CSIC IFREMER k LOCEAN SA CETP SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Manual Page 16 Message The following paths have not been found in the directory host ubuntu SMOS L20S smos_gui_dev smos path soft link to the smos products libpackages path soft link to the third party libraries Please correct the problem before going further Refer to the Software User Manual installation instructions Important note The GUI contains environment variables that are set during the first launch of the interface Once the package is installed it is preferable not to move the directory structure to another location but to perform a new install instead
25. text files The user must be aware that break point activation slows down the processing and might generate very large data file It is strongly recommended to limit the processing to 1 to 10 ISEA grid points when break points are in use All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 9 S LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 11 October 2013 Manual Page 31 ay Breakpoint management tor job SMOS Jobe in Folder Test Folder Selected Break Points Available Break Points Break Points utilities BP_PRP_3_1 3 BP_PRP_3_1 1 BP_PRP_3_14 BP_PRP_3_1 2 _Add Break Point BP_PRP_3 1 5 BP_PRP_3 1 6 j BP_PRP_3_2 2 BP_PRP_3_1 7 LEE salle BP_PRP_3_5 1 BPLPRP31 8 0 Save BP_PRP_3 2 1 BP_PRP_3_3 1 Close BP_PRP_3 4 1 BP_PRP_3 4 2 BP_PRP_5 1 BP_PRP_7_1 1 BP_PRP_7_2 1 BP_PRP_7_2 2 BP_PRP_8 1 BP_PRP_8 2 BP_PRP_12 1 Breakpoint management multiple breakpoints can be selected by holding shift or alt key The list of available break points is located in the centre of the panel Upon the users needs and according to the DPM one or several break points are selected from the available list To select multiple breakpoints the User has to hold the shift or the alt key Then the break points can be added to the list of selected break points pushing the A
26. the Schedule option is selected The user is invited to enter the date and time of run in the format hh mm mm dd yyyy All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 33 Job Execution RUN NOW SCHEDULE 17 22 06 22 2006 It is possible to replace numbers in the date zone or by positioning the mouse cursor in the zone to be modified and by clicking on the up down arrow menu by this way numbers will increase one by one Clicking on the button Launch will schedule the job gt If the scheduling date is passed the user will be warned and invited to modify his selection LS x A Warning the schedule time is passed please modify your selection gt Else the job is scheduled When exited or crashed the interface behaves differently according to running or programmed jobs The following situations alone or mixed can be met before crash 1 One or several jobs were running or paused 2 One or several jobs were scheduled 3 One or several jobs were queued When the interface is exited e running jobs are deleted e queued jobs are queued again when interface is launched e scheduled jobs are scheduled again only if scheduling time is not passed 6 2 8 Job monitoring Two monitoring tools are proposed to follow or ana
27. this file refer to section 6 2 2 and 6 2 4 Edit the AUX_CNFOSD F as a text file search for switch_rough occurrence and change the value of the tag Save modifications and process the job All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 67 APPENDIX A XML Editor Tool A XML editor tool The SMOS GUI provides an internal XML editor which is able to edit XML documents of the SMOS L2 OS Processor and display it as a JAVA tree component The purpose of developing and integrating a specific editor is to secure access to data by imposing attributes to the XML tags Moreover data inherit attribute values from their close ancestors to the top of the tree Note No DTD Document Type document definition is allowed This editor behaves accordingly to specific preset attributes We present hereafter the list of predefined attributes and the corresponding effect on the editor Note Any type of attributes may be added to a tag in order to describe the associated data Only specific predefined attributes allow the performance of specific checks on data value entered by the user Example list lrkezComt editelole true count 3 gt rereana lt nMin type int range 1 256 description Minimum number of measurement to start the retrieval gt 5 lt nMin g
28. valid retrieved Acard Tg_sigma Acard max Maximum value of sigma of valid retrieved Acard Generate DAP Boolean If false no OSDAP2 is generated if true OSDAP2 is written SC11 Scale factor for C 1 computation SC21 Scale factor for C 2 computation All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 OS ICM CSIC S Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 u o Software User Date 11 October 2013 Manual Page 51 BG o o sa cir tor compan OOOO OOOO sc Sat factor for 4 computation sca Seale factor for CS computation ses Seale factor for C 6 computation sca Seale factor for computation se Seale factor for C 8 computation sca Seale factor for C computation sor Seale factor for C 10 computation 5052 Seale factor for CU computation ses Seale factor for CUA computation sea Seale factor for C05 computation sess Seale factor for C 16 computation scs Seale factor for C17 computation sea Seale factor for C9 computation sea Seale factor for C 20 computation seas Seale factor for C1 computation soa Seale factor for C22 computation seas Seale factor for C03 computation seas Seale factor for C 24 computation sea Seale factor for 125 computation sea Seale factor for C 26 computation sea Seale factor for C7 computation sco Seale factor for C 28 computation ses Seale factor for
29. 2 ___ 2 13 24032010 buidozt4___ _ __ 2 14 1405 2010 build 0315 2 s 1806 2010 buido3zt 6 ooo 2 16 0712 2010 bwia03 17 o 2 17 2705 2011 build05_00pre FAT 2 17 22062011 PostOS_OOFAT 2 18 30 11 2012 build06_00pre FAT 2 18 2501 2013 PostO6_0OFAT 2 19 1309 2013 build 0610 pre FAT __ 2 19 firio2013 Postos 10FAT Version 1 0 SO L2 SSS ACR 012 to version 1 1 SO L2 SSS ACR 012 04 10 2006 1 4 1 5 and Remove list of reference documents list of applicable documents 1 6 and list of acronyms and add a reference to Software Release Document 2 New section with an general introduction of the prototype processor environment Numbering of existing section 2 3 etc shifts All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 NINININI NININININININININININININININININ MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 3 Page 66 Appendix B New appendix with software problem report change request form Appendix C Formerly Appendix B Updated with new list Is IR of files on DVD Version 1 1 to version 2 0 SO MA ACRI GS 4412 o Document reference name changed Formerly SO L2 SSS ACR 012 A Delete word prototype 6 6 6 6 Table 4 updated according to IODD changes 3 1 Update figure 1 V
30. 213 170 46 150 smos schemas xsi schemaLocation H http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema A xsi schemaLocation http 213 170 46 150 smo e Y L2_OS Configuration Parameters 1 xmins xsi H http www w3 org 2001 XMLSchema ir Y Iterative_Scheme 1 Y List_of_lterconf 1 xmins H http 213 170 46 150 smos schemas A count 4 Y Iterative_Conf 1 Y nRetrievedParam 1 type H text A description number of geophysical A list 0001 0002 0003 0004 0005 000 count H o A type lint 0005 Y List_of_retrived_Parameters 1 A count 10 A type text List of values SSS SST UN10 VN10 tec WSn phi_wsn Y retrievedParamid 1 A description Name of 1st retrieve A list SSS SST UN10 VN10 tec WSr value ll SSS Y retrievedParamid 2 A description Name of 2nd retrieve A list SSS SST UN10 VN10 tec WSr gt description Name of 2nd retrieved parameter Y retrievedParamid 3 A description Name of 3rd retrieve A list SSS SST UN10 VN10 tec WSr UN10 gt retrievedParamid 4 a P retrievedParamta a E L2_OS_Configuration_Parameters 1 Iterative_Scheme 1 List_of_lterconf 1 Iterative_Conf 1 List_of_retrived_Parameters 1 retrievedParamld 2 SMOS GUI XML editor example The above example shows the edition of a XML SMOS configuration file AUX_C
31. 29 computation 5052 Seale factor for 30 computation sess Seale factor for CG1 computation sea Seale factor for C2 computation sess Seale factor for CG3 computation sess Sal factor for G4 computation ses Scale factor for CG9 computation Table 5 Description of the post processor configuration tags 7 2 6 Overall_Quality_Thresholds The SMOS L2 SSS processor estimates the overall quality of the output products Thresholds are needed for that All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Physical_constants tags Tag EA eee S classified as low SSS classified as low SSS Tg Qual _Low_SST Below this threshold grid points are classified as low SST Tg Qual High SST Above this threshold grid points are classified as low SST All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ICM CSIC SMOS L205 boc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor ae a E Eee IFREMER Software User ate ctober Manual Page 52 Tg Qual Low_WS Below this threshold grid points are classified as low WS Tg Qual High WS Above this threshold grid points are classified as low WS Table 6 Description of the overall quality threshold tags 7 2 7 Flags amp filters definitions Measurement and grid point selection is defined in the ATBD and DPM and implemented via a number of filters defined in the configuration file Each filter specifies a number of flag
32. 4 retrieved parameter guess_prior Use First guess for the 5 retrieved parameter guess_prior guess_prior guess_prior Use First guess for the 6 retrieved parameter Use First guess for the 7 retrieved parameter Use First guess for the 8 retrieved parameter If true first guess is taken as equal to the prior if false processor uses first guess from this LUT for initialisation All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS _ poc SO MA ARG GS 0021 KM Se Prototype Processor Issue 2 Rev 19 a BIE Software User Date 11 October 2013 Manual Tag Description Note guess_prior Use First guess for the 9 retrieved parameter guess_prior Use First guess for the 10 retrieved parameter Repeat tags above Repeat tags above Repeat tags above Table 1 Description of the iterative scheme configuration tags 7 2 2 The geophysical parameter definitions The SMOS L2 SSS processor handles a list of geophysical parameters for which a detailed definition in needed Each geophysical parameter is identified by a unique index During the processing whenever the processor needs a geophysical parameter value the index is used to retrieve the value from the list of geophysical parameter values The index is used to store the definition name unit of the parameter as well The geophysical parameter definition file provides the prototy
33. ARG GS 0019 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Manual Page 13 LOCEAN SA CETP IFREMER 2 Overview 2 1 Introduction Although the L2 OS processor can be operated in batch mode the software is released with a Graphical User Interfaces GUI that simplifies its use Figure 1 shows an overview of the processor and its environment Main functionalities of the GUI are e Configuration of the processor with access to all processor configuration files see R D 4 e Management of processor runs scheduler log progress pause stop The GUI gathers all the functionalities sketched by the three boxes in light blue of Figure 1 except for SMOSview visualization of products can be done using SMOSview The breakpoint report files in HDF5 format can by visualized with hdfview which software can be launched from the GUI n z O Level 1 Graphical User Interface Configu ration ms A a Operator GUI Or PFW Operation SMOS view stdout stderr log progress Breakpoint GUI hdfview Breakpoint reports Figure 1 Overview of the SMOS L2 SSS processor files and graphical user interfaces 2 2 GUI configuration functionalities The configuration GUI generates configuration files see section 2 5 of
34. Code A D 1 Level 2 Processor ICD and Operational Constraints SO ID IDR GS 0003 1 5 Reference Documents The complete list of reference documents with issues amp dates is available in the Software Release Document SO RN ARG GS 0019 For readability a list of reference documents titles amp codes is given below Reference Title Code R D 1 SMOS L2 OS Algorithm Theoretical SO TN ARG GS 0007 Baseline Document R D 2 SMOS L2 OS Operational Processor SO TN ARG GS 0011 Computation Resources Requirements R D 3 SMOS L2 OS Detailed Processing Model SO TN ARG GS 0008 R D 4 SMOS Level 2 and Auxiliary Data SO TN IDR GS 0006 Product Specification R D 5 SMOS L2 OS Architectural Design SO DD ARG GS 0017 Document R D 6 SMOS L2 OS Detailed Design Document SO DD ARG GS 0012 R D 7 SMOS L2 OS Software Verification and SO TP ARG GS 0013 Validation Plan Unit Test R D 8 SMOS L2 OS Table Generation SO TN ARG GS 0014 Requirement Document R D 9 SMOS L2 OS Prototype Processor SO MA ARG GS 0021 Software User Manual R D 10 SMOS L2 OS Prototype Processor SO RN ARG GS 0022 Software Release Document R D 11 SMOS Level 1 and Auxiliary Data SO TN IDR GS 0005 Product Specification R D 12 XML Read Write API Software User SO ID IDR GS 0009 Manual R D 13 General Software Library User Manual SO MA IDR GS 1002 R D 14 SMOS
35. L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 EAN SA CETP Date 11 October 201 IFREMER Software User ate 11 October 2013 Manual Page 22 Folder list Folder management panel Folder Utilities Test Folder 04 February 2008 18 10 35 3 jobs NEW CLOSE L This panel gives access to the following functions Zone Name Function Folder Utilities New Create a new folder Rename Rename the selected folder Modify Allow adding or modifying the folder author and the folder comment Info Display all folder information Delete Delete the selected folder Export Make a compressed archive file with the whole folder tree structure Close Close the panel 4 1 2 Exiting SMOS GUI In order to quit the SMOS GUI the user must select the Exit item in the Application pull down menu AU rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 P Pr Pa a Pr dde sor rae gt se ale bi LOCEAN SA CETP yp ssue 2 Rev Software User Date 11 October 2013 IFREMER Page 23 Manual Global configuration Ne Exit Application pull down menu Warning All running jobs will be deleted at exit time Details on interface behaviour regarding programmed jobs is given in section 6 2 7 4 1 3 Version From the main window the pull down menu gt About provides the main references of SMOS GUI click anywhere in t
36. L2 OS Input Output Data SO TN ARG GS 0009 Definition R D 15 SMOS L2 OS Architectural Design Same as R D 6 Document Detailed Design Document is available in electronic version only The DDD is a web site dedicated to the documentation of the Operational Processor All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 IDoc SO MA ARG GS 0021 SMOS L2 OS P Protot e Processor ra gt n LOCEAN SA CETP yp ssue 2 Rev IFREMER Software User Date 11 October 2013 Page 12 Manual Reference Title Code R D 16 SMOS L2 OS Algorithm Validation Plan SO TP ARG GS 0015 R D 17 SMOS L2 OS Algorithm Validation Test SO TR ARG GS 0016 Procedure Report R D 18 SMOS L2 OS Parameter Data List SO TN ARG GS 0010 R D 19 Earth Explorer Mission CFI Software EE MA DMS GS 0003 Explorer_Lib Software User Manual R D 20 SMOS L2 OS Operational Processor SO MA ARG GS 0018 Software User Manual R D 21 SMOS L2 OS Prototype Processor SO RN ARG GS 0022 Software Release Document R D 22 Earth Explorer Mission CFI Software CS MA DMS GS 0001 Mission Conventions document R D 25 Software Verification and Validation Plan SO TP ARG GS 0025 Acceptance Test R D 26 Software Verification and Validation Plan SO L2 SSS ACR 0009 System Test 1 6 Abbreviations The list of acronyms is available in the Software Release Document SO RN
37. MPL_JOBORD_0004 xsd gt Orderld 1 gt Conf 1 gt List_of_Procs 1 gt List_of_Constants_Files 1 The job order file lists all input and output file names of the processor 6 2 3 Edit private configuration file Access to the private configuration file is via the job order file Use the find string feature to search the CNF_L2OS chain Job Parameters Enter searched string CNF_L20S Name Lalclor j E Previous Next Close File Edit A fpattern CNF_L20S_ Ta A btedit true z xsi schemaLocation H http 213 170 46 150 smos schemas H A type ffile mledit true 5010 1TO0U0007 xmins xsi H http www w3 org 2001 XMLSchema ir Y Start 1 xmins H http 213 170 46 150 smos schemas 2006 04 19 185548 972 Y Stop 1 editable true 2006 04 19 194948 972 Y List_of_Procs 1 A count 1 count H 1 Y Proc 1 i Y Task_Name 1 El description Private configuration project SMOS nme SSS_L2_proto dev L20S__01_00 exe F Y Task_Version 1 01_00 fpattern CNF_L20S_ Y Breakpoint 1 Y Enable 1 txtedit true A editable true st A list OFF ON y fil OFF type ile Y List_of_Brk Files 1 A count 0 xmledit true y Y List_of_Inputs 1 y A En En Asse q Select File Edit xmL File Edit as TXT File Uob_
38. NFOSD Tree distinct zones are drawn gt The top menu e File menu This menu accesses the following command o Save To save the modifications o Export in operational format To save the file in operational format that is without any additional tags o Close To close the window e Edit menu This menu accesses the following command o Undo To save the modifications o Find string CTRL F is useful for finding the tag the user is looking for o Collapse to hide the tree structure o Expand all for a quick access to the attributes and values of the whole hierarchy gt The left panel is dedicated to the whole XML hierarchy from the top to the bottom Three different icons are used o a this icon denotes that this tag has one or several sons name is not editable All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 ARGANS EXSM ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Issue 2 Rev 19 Software User Manual Doc SO MA ARG GS 0021 Date 11 October 2013 Page 71 o D no sons are available below this tag The text associated is the tag value editable by default but can be made not editable o A this icon is for attribute value is not editable The number between square brackets is a counter used to discriminate tags using the Same name Log for SMOS_jobtotol in folder user_guide cor 2 c log4c A editable true A version 1 1 0 C config 1 gt
39. 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 O 2009 2010 201 1 2012 2013 SMOS L2 OS aa Es ICM CSIC Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 Date 11 201 ARGANS ACRI IFREMER Software User ane October 2013 Manual age 30 6 2 4 Edit auxiliary configuration file To access this file a procedure identical to the above for the private configuration file must be followed Find string must locate the AUX _CNFOSD F chain note that the correct AUX_CNFOS file type should be selected to match the Llc input file type D dual polarisation F full polarisation Then click on Edit XML file button see annexe A to use the XML editor tool or Edit TXT file oe Tag tinder pa Enter searched string AUX_ENFOSO File Edit nter searched string comme EETA PSS a Y Input 16 l Next Close aLocation H http 213 170 46 150 smos schemas Im V File_Tyl Search for previous occurence AUX_CNFOSD xmins xsi H http www w3 0rg 2001 XMLSchema ir V File_Name_T
40. RG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 5 Section 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_P in UDP 6 2 8 Version 2 6 to version 2 7 SO MA ARG GS 0021 this Removed incorrect Table from missing ind_ tags above 3 6 Added gui jedit amp gui logs to Type GUL corrected typo libpackage s Version 2 7 to version 2 8 SO MA ARG GS 0021 Table 7 Updated CNF_L2OS with List_of_Hosts Updated global_conf xml 3 5 6 2 1 Now only 2 test jobs removed old mire test job 7 2 3 Updated table 3 with clarified descriptions from IODD Version 2 8 to version 2 9 SO MA ARG GS 0021 7 2 1 Change in configuration UST gt Uwav interdependence of geophysical parameters see Algo Val 16 MoM Version 2 9 to version 2 10 SO MA ARG GS 0021 1 2 3 1 Corrected references 40 Table 1 Added Switch_rough_harmonics Switch_store_gal removed Switch_retr Added Tg_fara_meas_min Tm_fara_delta_angle_max Added Generate_DAP Removed Supress_DAP 3 6 Added directory for Outputs_ref 0 7 4 Replaced AD 5 with RD 14 Version 2 10 to version 2 11 SO MA ARG GS 0021 14 3 1 Corrected reference to Prototype Processor Software Release Document Versio
41. SMOS L2 OS _ poc SO MA ARG GS 0021 a ES KM Se Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP A 201 ARGANS ACRI IFREMER Software User Date 11 October 2013 Manual Page 1 Title SMOS L2 OS Prototype Processor Software User Manual Doc code SO MA ARG GS 0021 Issue 2 Revision 19 Date 11 October 2013 Name Function Company Signature Date Prepared SMOS Team Expert Support Laboratories Reviewed P Spurgeon Project manager ARGANS Released S Delwart Project manager ESA All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 2 Change Record Issue Revision Date Description Approval AAA Review 1 II a ie Qualification Review 1 2 10 09 2007 Update for version 2 of the graphical user interface of the L2 OS operational processor 2 1 15 12 2007 Update to version 2 2 of the processor and version 2R1 1 of the GUI 2 2 15022008 V3QR 2 3 06 05 2008 PostV3FAT 2 4 1211 2008 For V4 pre QR 2 5 18 12 2008 Updated RIDs from pre QR 2 6 0202 2009 ForvW4TRR_____ ___ 2 7 0703 2009 Forv4FAT___ ___ 2 8 29062009 PostV4deltaFAT______ ____ 2 9 0408 2009 Post AlgoWal 16 2 10 1109 2009 build 309 2 07 01 2010 buia n ____ 2 12 27012010 buildO31
42. all_test_folder 2008 02 04 15 28 39 0 install_test_folder 2008 02 04 15 28 44 34 IL DELETE PAUSE Each line of the list is dedicated to a job It allows to check the progress of the run through the Run time given in seconds and the Progress given in percentage It is also possible to edit the output log file of any running job and monitor the progression of the computation As shown in the above snapshots the names and availability of the buttons displayed in this window depend and may vary according to the type of job selected e Onarunning job the user can gt Pause then Resume it gt Delete it gt Edit the log file in real time e On a scheduled job it is allowed to gt Queue it equivalent to run it immediately if no other job is already running according to the maximum number of possible concurrent jobs gt Delete it gt View the scheduled run date time scroll or maximize the window to see the last entry in the row All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 ICM CSIC LOCEANISSICETE SotwaneUser Wate 11 Oeteber 2014 IFREMER Page Manual See a 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_ sav
43. an L2OS science flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS science flag definitions appear here List_of_L2OS_science_flags List_of_L2OS_out_of_range_flags Tag container of the definitions of count L2OS out of range flags Flag Definition of an L205 out of range flag Name Name of the flag Must be unique Mask Hex bitmask for extracting the flag Test Hex bitmask for testing the flag Flag Close container Remaining L2OS out of range flag definitions appear here List_of_L2OS_out_of_range_flags Table 7 Description of the flag definition tags The processor selects filters by their unique name which must not be modified Each filter has a description not used by the processor and a list of tests identifying by name each flag to be tested Currently the following filters are defined and used in the processor Filter Name Description Detect_snapshot_out_of_range Filter applied to grid point and measurements before performing snapshot level out of range tests All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Page 54 Manual Dekt Eror outliers Filter applied grid point a
44. ard_grid_point_decision_tree Clear Fg_ctrl_valid for ignored grid points OTT_region_filter Select grid points and measurements for OTT computation generating AUX_DTBXY_ OTT_snapshot_filter Select snapshots for OTT computation generating AUX_DTBXY_ OTT_stats_filter Select measurements for computing filtered statistics Table 8 Names amp descriptions of filters Up to 32 flags may be defined for each filter and the count for each filter must match the number of flags specified as Reject in the list of tests All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Filters tag Description L Filter_ Name of the filter Ea Flag name The tag Reject is repeated here count 1 times All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Tag Description Note List_of_tests Close container Filter Close container Remaining filter definitions appear here List_of_filters Table 9 Description of filter definition tags 7 2 8 A3TEC configuration The SMOS L2 SSS processor can be configured to retrieve TEC from Stokes 3 when computing deltaTBs for the OTT post processor OSCOTT and also when retrieving salinity All tags in the table below are under t
45. ber 2013 IFREMER Page 4 Manual age 46 Tag Description Note ind_PP1D Index of the peak period of 1D spectrum Must be unique of waves parameter 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 Must be unique parameter The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_ZNT Index of the roughness length from Must be unique ECMWE atmospheric surface model The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_Acard Index of the Acard coefficient of Must be unique cardioid model The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_EWSS Index of eastward surface stress Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_NSSS Index of northward surface stress Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param G
46. cscecececeeeceeeceeeceeeceeeceeeceeecececeeeceeeceeeseeeceeeseeeauaesuaeauauauaneuanens 13 2 3 GUI PROCESSOR OPERATION ccococononononononononononononononononononononononononononononnnnnnonnnnnnnnonononnnononononnnnnnnnonononcnnnnnanosa 14 24 BREAKPOINT REPORT cie 14 2 5 BILE MANAGEMEN E caged cudeneasaascaeaenedencaseucensaccuacns 14 3 INSTALLATIONS AND OPERATION ccccccssssssssscccssssscsccescccccsssscscccesccesssccscecceesescsssenecescesssssesenecees 15 3 1 INSTALLATION OF THE CORE PROCESSOR cccceceseceseceseceseceseceseceseseseceseceeeseseseseseeeseesseseseseseseseesseseseusseeseeessss 15 3 2 INSTALLATION OF THE CUL A A A a A a i 15 3 3 INSTALLATION OF HDFEFVIEW ococccccccicicoconiconocinononononononanonononononanonononononononononnnonnnnnnnnnnnonnnonanonnnnnnnnnnnnnnncnaninanss 15 Bed IGUESTARTUP idad act aeevaeueunanstadeatondterte tn 15 3 5 TESTING THE INSTALLATION ads 16 3 0 PREBJORGANIZATION ais 16 4 THE GRAPHICAL USER INTERFACE cssssscsssssssssssccescccscssssceccccsccessssssceccecsessssonccesccsssssssececees 18 A T THE MAIN WINDOWS lt a 18 5 FOLDER HANDLING csscssesseccsccacescessscastescssesssusdcesccssscesoossastessccacesessescessonsseesvasvacsscevascsssessesbocascscosesseseese 24 5 1 CREATE A NEW BOLDER ccccccclacecesncavesecevareciinveycsacitace EEE rE EAEE NE E EAEE Ea e A EAEE E O EA Ee 24 5 2 MANAGE THE CREATED FOLDERS mreana a EEE E AE EE E ESE 24 6 JOBS HANDLING ais sssssissssssasssssessss
47. dd 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 HDF view software 6 2 6 Processing window selection This button allows entering a processing window limits manually or on a world map The following window is displayed All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 ICM CSIC SMOSL2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Page 32 LOCEAN SA CETP IFREMER Manual ZoomIn Zoom Out Reset to Globe Save Selected zone and Close The user is invited to select a rectangular area by dragging the mouse over the map or by entering the latitude longitude numerical values directly in the corresponding boxes Once the zone is selected a click on the button named
48. dded new section amp table describing OTT post processor 11 amp 12 configuration and regions 7 4 Table 13 Table renumbered from 10 to 13 JCD comments 20130929 All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 OS ICM CSIC SMO Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 a oo Software User Date 11 October 2013 Manual Page 7 Section Renumbered sections amp added sections 8 9 amp appendices JCD comments 20130929 7 2 1 Explained that 4 configurations are required 3 for SSS and one for Acard JCD comments 20130929 All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 fa ICM CSIC SMOS L2 OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 ARGANS ACRL IFREMER Software User Date 11 October 2013 Manual Page 8 Table of Content 1 INTRODUCTION ssssicescesseccscsassccscasvecescasccsvactssecssctusessssdesaseacsesavsbsoesensecssseeuccdssesuacsesecesseaseccecvusscosctsvescscease 10 Ved GENERAL dia 10 1 2 GUDE TO THIS DOCUMENT Gi ais 10 1 3 STRUCTURE OF THE DOCUMENT cccccccccccccccccscccecccseecseeceesceeseseseseseeeeceesesesesesesesesesesescsescsesceeseseeseseeeeseeeeeeeses 10 1 4 APPLICABLE DOCUMENTS cicirine iiaiai iaaa a idear 11 1 5 REFERENCE DOCUMENTS ias 11 16 ABBREVIATIONS A N A E A EA E E E 12 2 OVER VIEW AAA E E A 13 Dele INTRODUCTION dataci n 13 2 2 GUI CONFIGURATION FUNCTIONALITIES cccccc
49. e eg when running L2OS just to extract AUX_DTBXY_ true execute false skip A eee oo and descending orbits A eee oo ascending and descending orbits A outlier RFI std Standard deviation value above i 7 measurements are considered at risk of RFI contamination Preis vr reta suspected of RFI contamination RFI cl Coefficient used to adjust measurement 7 radiometric accuracy from the current RFI LUT AUX_DGGRFI RFI c2 Coefficient used to adjust measurement 7 radiometric accuracy from the current RFI LUT AUX_DGGRFI E ie E noise to flag a grid point TASE Io below this threshold lead to the discarding mo measurements contaminated by erroneous galactic noise AAA OOOO Tg_high_ SSS Boundary between medium SSS and high SSS Tg_high_ SST Boundary between medium SST and high SST Tg_high_wind Boundary between medium wind and high wind All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 48 Tg ice concentration Maximum of ice concentration for retrieval execution Tg_low_SSS Upper limit for very low SSS Tg_low_SST Upper limit for very low SST Tg low SST_ice Temperature under which ice could be present 7 7 Kelvin Tg_low_wind Upper limit for low wind speed Tg_medium_SSS Boundary between low SSS and mediu
50. e 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 O OOO 7 2 The main configuration file The main configuration file is referenced with AUX CNFOSD or AUX_CNFOSF in its filename It contains most of the configuration data of the processor Tables in next subsections give details on the file content In these tables items highlighted in yellow are tags With the interface items highlighted in green can be edited and their content is detailed in the next sections 7 2 1 The iterative scheme configuration The iterative scheme configuration includes key information for the iterative scheme e g selection of forward model or maximum number of iterations All the data are repeated 4 times because three SSS retrievals and one Acard retrieval are attempted per grid point All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Iterative _Scheme tags Tag Description No
51. ed RUN NOW LAUNCH Loc EDIT CLOSE Job Configuration Panel k Four zones are displayed 1 Input dataset 2 Break Points Configuration 3 Processing Window 4 Job execution 6 2 1 GUI testing To launch the tests select folder Test Folder in the Job management panel then select one of the two jobs e dual_pol_test_job e full_pol_test_job Click on button Configure in the Job management panel All rights reserved ARGANS ACRE st 2009 2010 201 1 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 S N Prototype Processor Issue 2 Rev 19 ARGANS hot O PAN ME ETE Software User Date 11 October 2013 ST IFREMER Eo Manual age 28 To run the selected test click on button LAUNCH in the Job configuration panel All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS d A ICM CSIC IDoc SO MA ARG GS 0021 wi LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 ARGANS ACRI IFREMER Software User o 11 October 2013 Manual age 29 6 2 2 Edit Job Order This button gives access to the job order file MPL_JOBORD file It opens the XML file through the XML editor tool see annexe A Job order tor job SMOS job2 in Folder Ear File Edit Vv Job_Order A editable false A xmins http 213 170 46 150 smos schemas A xmins xsi http www w3 org 2001 XMLSchema instance A xsi schemaLocation http 213 170 46 150 smos schemas SM_TEST_
52. ed in each job folder A delete button is available to erase the jobs from the list multiple selection is possible The deletion bears only on the list The jobs are not physically erased from the simulator Past Job Control Panel Job Name Folder Launch Date Il Run Time s ji SMOS_job folder_test 2 gt Finished SMOS_job folder_test 2006 06 20 15 49 00 5 Finished SMOS_job1 test 2006 06 21 17 45 42 6 Finished SMOS_job1 test 9 2 Finished 6 2 9 Graphical software S SMOS OPERATION Version 2 R1 1 Core Processor V3 Application Job Management Job Execution Graphics T y gt a HDFView software SILOS The interface presents a shortcut command in order to launch HDFview to edit HDF breakpoint report files The commands are defined through the XML editor of the global configuration panel see section 8 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOSL20S boc SO MA ARG GS 0021 A Prototype Processor Issue 2 Rev 19 LOCEAN ETP ARGANS Ke 1 Neta Software User Date 11 October 2013 ST IFREMER Pave Manual age 36 5 Global configuration Panel File Edit Y gconf A editable true editable H true D SMOS_ROOT 1 D xml_rw_api_home 1 description HDFView Software location gt LD_LIBRARY_PATH 1 D default_job_name 1 fil gt default_processor_binary 1 type us Db max_jobs 1 D refreshing_period 1 Value
53. ename the selected job Modify Allow adding or modifying the job author and the job comment Info Display all job information Delete Delete the selected job Export Make a compressed archive file with the whole job tree structure Close Close the panel Job Execution Configure Allows to configure and run the job if not running Clean This function is used only if the GUI or the computer crashes for any reason human bug while a job is running At recovery time the interface will not be able to modify the status of the running jobs if any that will remain running and when running the configuration of a job cannot be accessed so the job will remain inaccessible forever The only way to enter the configuration again is to clean the status of the job and bring it back to New 4 1 1 2 Folder management Each job is stored in a folder In order to open create and manage the folders the user has to click on the top Icon or to select Folders in the Job Management pull down menu The following window appears containing all the functions necessary to list the existing folders to select create change comment or rename a folder It allows the user to create a new folder where to organize the storage of all the simulations Note The number of jobs contained in each folder is displayed along with the creation date in the folder list zone All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 LOC SMOS
54. eophy_Param ind NSLHF Index of net downward latent heat flux Must be unique accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SSHF Index of net downward sensible heat Must be unique flux accumulated since start of forecast The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_SSR Index of net downward shortwave flux at Must be unique All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS _ poc SO MA ARG GS 0021 TE o Prototype Processor Issue 2 Rev 19 IFREMER Software User Date 11 October 2013 Manual Tag Description Note surface accumulated since start of forecast flux at surface accumulated since start of forecast Table 2 Description of the geophysical parameter definition tags 7 2 3 The thresholds The SMOS L2 SSS processor performs many tests to check the retrieval conditions and to verify the usefulness of the data Often the tests are comparisons between measurements or geophysical parameter values on the one hand and thresholds on the other hand The table below gathers all the thresholds needed by the processor All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Thresholds tags Switch_iterative_scheme Switch for skipping iterative schem
55. essor Issue 2 Rev 19 LOCE ETP ARGANS hot PERENNE Software User Date 11 October 2013 ST IFREMER Manual Page 65 Tb 1 V or Y polarisation in K Tb 2 2 Re Thy or 2 Re Txy Tb 3 2 Im Tyy or 2 Im Txy In the proposed user s model Stokes 3 and 4 parameters are set to zero 9 3 Geophysical parameter retrieval from the data model of the processor User s models are functions of geophysical parameters In this tutorial this is only wind speed A collection of geophysical parameters are available to the users Values at the target including their evolutions if any along the iterative process are retrieved from the processor data model with the following line of code to be inserted in the computeForwardModelContribution routine ws measurementHandle gt gridpoint gt geophyParamValue configHandle gt index gt ind WS The list of geophysical parameters available this way is available in the DDD with the description of the param index structure in the file config_proto h 9 4 Where to call the user s model The computeForwardModelContribution function calls many forward models The user s model is called by this function Since it is a new model for roughness contribution a new case to the selector of roughness models is added to the switch function dealing with switch_roug selector New code lines are case 4 ws measurementHandle gt gridpoint gt geophyParamValue configHandle gt index
56. f type file the pointed file is an XML editable file and the text is editable then the buttons become All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 SMOS L2 OS ky RACK SS o Prototype Processor a ae fad ee LOCEAN SA CETP ARGANS ACRL IFREMER Software User Date 11 October 2013 Manual Page 72 Select File Edit XML File Edit as TXT File Clicking on the button Edit XML File will open a new XML editor with the file pointed to by the tag value Clicking on the button Edit as TXT File will open a simple text editor able to display xml format This editor allows modifying the file and save it When a value is modified the button Update value is enabled The user has to click on this button to update the left panel structure with the newly entered value Then the option Save located on the top menu File is enabled To make the change permanent the user has to click on Save At any moment an undo is possible through the use of the top Edit menu option Undo Note When the Save option is activated all the undo history is lost At the bottom of the window one can see the complete XML path to the selected tag Earth_Explorer_File Data_Block 1 filenames 1 iterSchemeFile 1 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Manual Prototype Processor Issue
57. he Data_Block L2_OS_Configuration_Parameters A3TEC tag TEC OTT Strategy Strategy for extracting TEC from Stokes3 for OTT DTBXY generation 0 use Llc TEC 1 extract for descending orbits only 2 extract for both ascending amp descending orbits TEC Retrieval Strategy Strategy for extracting TEC from Stokes3 for salinity retrievals 0 use Llc TEC 1 extract for descending orbits only 2 extract for both ascending amp descending orbits Earth Radius Radius of the earth nominally 6371 0 SMOS_ altitude Altitude of SMOS nominally 796 0 TEC_altitude Assumed altitude of TEC nominally 400 0 estimation estimation etaMax Upper eta limit for selecting measurements in the A3 FOV for TEC estimation etaMin Lower eta limit for selecting measurements in the A3 FOV for TEC estimation maxdA3 Upper limit for A3TEC measurement selection iTEC Correlation length for TEC estimation by latitude Size of the latitude window for computing A3TEC error C maxd sigOTT Sigma prior for A3TEC OTT estimation S sigTE S sigT ECO napshot_Window_Min Minimum number of snapshots for computing A3TEC std TB in the latitudinal window below which Default_A3Sig is used Default_A3Sig Default A3 sigma used if too few snapshots Table 10 Description of A3TEC configuration tags All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L2 OS boc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Proce
58. he displayed window to close it ARGAN S SMOS processor graphical user interface Version 3 R0 November 05 2008 Prototype Processor V3 SMOS About SMOS GUI interface window Y All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 a Kz e Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP ARGANS ACRI IFREMER Software User Date 11 October 2013 Manual Page 24 5 FOLDER HANDLING In the folder panel all the folders already existing are listed with details on the author the creation date and appropriate comments 5 1 Create a new folder The button New allows to open a window in which the user will specify the folder name blank characters are allowed but will be replaced by underscores the author name optional and appropriate comments optional Note Special characters such as are not allowed in the folder names Da New folder pane Folder name Author Creation date 06 November 2008 12 17 56 Comment J CANCEL Create a new Folder 5 2 Manage the created folders Renaming modifying author or comment and getting folder info are achieved through the use of a panel identical to the one for folder creation The folder export button opens a navigation window that allows the user to select the destination of the exported file A process is launched that creates a unique
59. in a snapshots to trigger writing region to AUX_DTBXY_ Min_Percent_Valid_Snapshots Minimum percentage of valid snapshots to trigger writing region to AUX_DTBXY_ Min_Grid_Points Minimum number of grid points to trigger writing region to AUX_DTBXY_ Min_Percent_Valid_Grid_ Points writing region to AUX_DTBXY_ Minimum percentage of valid grid points to trigger Table 12 Description of region definition tags All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 3 S LOCEAN SA CETP ARGANS Eo E IFREMER Software User Date 11 October 2013 Manual Page 59 7 3 Job order The job order file MPL_JOBORD provides the processor with input and output file names The simplest way to change the name of an input or output file is to find using the FIND STRING button the File Name tag of the file type the user want to modify For example to select a new AUX_ATMOS file push the button FIND STRING and enter the file type 1 e AUX_ATMOS KG Tag finder Enter searched string AUX_ATM os le Previous Next Close na Clicking enter or Next button will expand the xml tree of the job order file highlight and select the File Type tag that has AUX ATMOS for value The tag to be changed is the next File_Name tag further down on the XML tree 7 4 The private config
60. isualization tool is not available in this version of the GUI Update installation instructions Updated file tree description 33 Updated processor and GUI dependencies 6 and 7 Sections swap Job handling comes before configuration description i Section updated for modified job configuration panel 7 Section modified according to the new configuration file Configuration files of the prototype are merged into the AUX_CNFOS2 file New section for the job order file PO a ae GUI configuration file example updated Appendix C Appendix C with list of break points removed List of available break point is given through the break point list of the GUI See section 6 2 3 Version 2 0 to version 2 1 SO MA ACRI GS 4412 17 12 2007 31 Update installation instructions 9 New section tutorial for open prototype modification Version 2 1 to version 2 2 SO MA ACRI GS 4412 2 2 2 3 2 4 Minor updated and clarifications 1 4 1 5 1 6 Update reference to new version of Software Release Document All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 4 o omments ection renamed ew section for operational processor installation 3 2 nstallation procedure updated 3 4 1 3 4 2 inor updates 6 2 5 7 2 1 to 7 2 5 Tables re
61. it of error between targ2SatZenithAngle AUX_FARA x faraday rotation angle Ts_snapshot_out_of_range Maximum proportion of land ice within a snapshot below which all measurements are discarded fm_12_rfi_snapshot_out_of_range set if any have fm_out_of_range set Po nied computing snapshot standard deviations Ts_std Limit for snapshot XX YY standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12_rfi_high_snapshot_std set Ts_std_stokes3 Limit for snapshot Stokes 3 standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12 rfi high _snapshot_std_stokes3 set Ts_std_stokes4 Limit for snapshot Stokes 4 standard deviation of deltaTB radiometric accuracy above which all measurements in snapshot are discarded fm_12 rfi high _snapshot_std_stokes4 set Table 3 Description of the tags with the thresholds 7 2 44 Physical_constants The SMOS L2 SSS processor uses several physical constants that are listed in the table below The user should not change the values of these tags All tags in the table below are under the Data_Block L2_OS_Configuration_Parameters Physical_constants tags All rights reserved ARGANS ACRI st O 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 50
62. ith the software For scientific aspects of the SMOS L2 OS processing see the Algorithm Theoretical Baseline Document R D 1 For inputs and output data including the configuration files see the Input Output Data Description Document R D 4 the SMOS L1 auxiliary data specification format R D 11 For details on the data processing see the Data Processing Model R D 3 For details on the material released along with the processor see R D 10 1 3 Structure of the Document This document is organised to describe the GUI tool use element by element where the identified elements are e Section 2 3 and 4 Operational environment installation resources overview of the main windows e Section 5 Folder handling e Section 6 Jobs handling e Section 7 Configuration files e Section 8 Configuration of the GUI e Section 9 Modification of the open prototype tutorial e Appendix A XML editor tool e Appendix B Feedback form All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Prototype Processor Issue 2 Rev 19 Date 11 October 2013 Page 11 Manual 1 4 Applicable Documents The complete list of reference documents with issues amp dates is available in the Software Release Document SO RN ARG GS 0019 For readability a list of applicable documents titles amp codes is given below Reference Title
63. lyse the job runs SMOS prototype OPERATION Version 1 R1 Application Job Management Job Execution Graphics Help age Job control panel SLDS Past jobs control panel 1 The job control panel 2 the past jobs control panel All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 ARGANS ACRL IFREMER Software User e o October 2013 Manual A ICM CSIC The job control panel is used to monitor alive runs This means that all the running scheduled or queued jobs can be monitored through this functionality When selecting Job Control Panel from the main window pull down menu the following window appears only if containing a job E Job Control Panel ee ee d aa Job Name Folder Launch Date Run Time s Status Progress Process ID test4 install_test_folder 2008 02 04 15 15 19 lo Scheduled 0 1856946237 4 il pevere Paust queve LOG EDIT CLOSE Example of scheduled job E Job Control Panel j j O om Job Name Folder Launch Date Run Time s Status Progress 0 test4 install_test_folder 2008 02 04 15 20 43 5 Ill DELETE PAUSE RUN NOW LOG EDIT CLOSE Example of running job I Job Control Panel am Folder Launch Date i Progress inst
64. m SSS Tg_medium_SST Boundary between low SST and medium SST Boundary between low wind and medium wind A eee of measurements flagged for moonglint to flag a grid point Tg_num_meas_valid Threshold of number of valid measurements Tg_num_meas_outliers_min Minimum number of measurements per polarisation for applying the measurement outlier Minimum number of measurements per polarisation for applying the RFI measurement Tg num RFI max minimum of RFI contaminated measurements to flag a grid point as suspected of RFI contamination Percentage of measurements flagged for possible by RFI outlier detection above which Fm_L2_RFI_ outlier is set Minimum to flag a grid point as likely to be contaminated by X polarisation RFI as indicated by the current RFI LUT AUX_DGGRFI Minimum to flag a grid point as likely to be contaminated by Y polarisation RFI as indicated by the current RFI LUT AUX_DGGRFI of ice is suspected to flag a grid point Tg max rainfall Limit of acceptable rain Threshold for TEC gradient Tg lat ice Acard Latitude min for ice detection from Acard model Tg SST ice Acard SST threshold for ice detection from Acard model Tg Acard_ice Acard threshold for ice detection Tg fara meas min Threshold for of non interpolated o AUX_FARA x measurements Tg_swell Threshold above which sea state is classified as swell dominated otherwise sea state is wind waves dominated Threshold fractio
65. mostrubuntu smos 205 smos_GuL 5 D configuration_selection 1 Y hdfview 1 A description HDFView Software location A tvpe ffile jrepath 1 5 ine vate gconf hdfview 1 Global configuration panel setting HDFview binary location All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 MOS L2 OS ICM CSIC SMOS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Manual Page 37 LOCEAN SA CETP IFREMER 7 CONFIGURATION FILES 7 1 Introduction The SMOS L2 SSS processor handles many files that are either input files or output files Input files are loaded in the processor They include either data or configuration information This section addresses the later group of files listed below Main configuration file which includes o Iterative scheme configuration Geophysical parameter definition Thresholds Physical constants Overall quality thresholds o Post Processor configuration Private configuration file o User selection of grid points o Hidden switches o Selection of schema Job order A technical description of the content of all files handled by the prototype processor is available in R D 4 In this section the configuration parameters are detailed and their role in the processing is addressed It is assumed that the user has a basic knowledge of the MIRAS instrument and of th
66. n 2 11 to version 2 12 SO MA ARG GS 0021 32 Table 7 Added description of Param max distance from boresight calculated by xi eta Version 2 12 to version 2 13 SO MA ARG GS 0021 Table 1 Added Switch_ott Table 3 Added Tg_swell Tg_old_sea Tg_young_sea Version 2 13 to version 2 14 SO MA ARG GS 0021 6 1 8 Updated configuration description now non editable updated example global_conf xml Added reference to OPSUM error codes 2124 Clarified that the GUI does not include SMOSview______ Version 2 14 to version 2 15 SO MA ARG GS 0021 Ee 8 Updated example XML file directories All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 S DD a 48 Table 3 Table 5 Table 7 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 6 Version 2 15 to version 2 16 SO MA ARG GS 0021 30 6 2 6 Added note explaining that selected window may not include any 2 grid points 8 Corrected description of configuration selection tag Removed unreferenced AD s Version 2 16 to version 2 17 SO MA ARG GS 0021 7 2 3 Table 3 Added RFI_std RFI_nsig amp Tg_num_RFI_max Tg_num_outliers_max 7 Tg_num_outliers_max added in row above JCD comment 5a 5 2 3 Table 3 Changed number to value in description of nsig RFI std amp RFL nsig JCD comment 5b 15 3 4 Added
67. n for old waves if omega is A below this threshold waves are old aea o above this threshold waves are young Crm ange moon ATI All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 49 _________ Jizeeton and the moon direction IN Tm DT ice Threshold of difference between actual and flat sea gt model brightness temperatures above which ice contamination is suspected fm_suspect_ice true Tm high gal noise High galactic noise boundary Po Tm_high_sun_glint Boundary between medium sun glint and high sun glint Tm_low_sun_glint Upper limit for no sun glint Po Tm Max GN Error Limit of acceptable galactic background error Po Boundary between low sun glint and medium sun glint XX YY TBs in AFFOV XX YY TBs in EAFFOV Tm out of range stokes3 ea Limit of delta between forward model and Llc ffov Stokes 3 TBs in EAFFOV Tm out of range stokes4 aff Limit of delta between forward model and Llc o Stokes 4 TBs in AFFOV Tm out of range stokes3_aff Limit of delta between forward model and Lic ov Stokes 3 TBs in AFFOV vV Tm out of range stokes4 ea Limit of delta between forward model and Llc ffov Stokes 4 TBs in EAFFOV Tm_sun_limit Limit of acceptable sun glint contribution Tm_fara_delta_angle_max Lim
68. n of the processor List_of_Input_Sc Tag end hemas List_of_Output_ Schemas Repeated 4 times for UDP DAP UDP report and DAP report sema Version List_of_Output_ Tag end Schemas Limits in lat lon of selected area ow Start_Lat Latitude lower limit for area selection Start_Lon Longitude lower limit for area selection End_Lat Latitude upper limit for area selection All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ost Tagend o G ICM CSIC SMOSL20S boc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor pre e m IFREMER Software User ate 11 October 2013 Manual Page 61 Description Longitude upper limit for area selection GridPointID Grid point ID Param Maximum distance calculated from xi eta from boresight for valid measurements scaled by 100 Default value 200 ie complete fov Table 13 Description of tags of the private configuration file All rights reserved ARGANS ACRI st 2009 2010 2011 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 ICM CSIC LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 62 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 ersion 1 R1 Application Job Management Job Execution Graphics Help Global configuration wat e Exit a
69. nd measurements before performing snapshot level outlier tests based on std ra Detect_outliers Filter applied to grid points before performing measurement level outlier tests Detect _RFI_ outliers Filter applied to grid points before performing measurement level RFI outlier tests Detect_measurement_outliers Filter applied to measurements before performing measurement level outlier tests Set_RFI_flag_from_outlier_tests Set Fm_L2_RFI from RFI outlier tests Set_RFI_flag_from_snapshot_tests Set Fm_L2_RFI from RFI snapshot tests Set_sun_flag_from_Llc Set Fm_L1c_sun measurement flag from Llc flag s Set_RFI_flag_from_Llc Set Fm_L1c_RFI measurement flag from Llc flag s Measurement_decision_tree Clear Fm_valid for suspicious measurements Grid_point_decision_tree Clear Fg_ctrl_valid for ignored grid points Poor_quality Set Fg_ctrl_poor_retrieval if retrieval results flagged as suspicious Poor_quality_Acard Set Fg_ctrl_poor_retrieval for Acard if retrieval results flagged as suspicious Poor_geophysical Set Fg_ctrl_poor_geophysical if geophysical conditions may have contaminated retrievals Poor_geophysical_Acard Set Fg_ctrl_poor_geophysical for Acard if geophysical conditions may have contaminated retrievals Dg_user Criteria for Dg_user DAP counter Acard_measurement_decision_tree Clear Fm_valid for suspicious measurements Ac
70. ng Period s list 2 5 10 30 type int unit s gt 2 lt refreshing_period gt lt configuration_selection description New job order configuration editable false gt data_core_v4 lt configuration_selection gt lt hdfview description HDFView Software location type file gt SMOS_ROOT smos_GUI_SSScore bin hdfview hdfview lt hdfview gt lt jrepath description Java Runtime Environment location type file gt SMOS_ROOT smos_GUI_SSScore jre1 6 0_01 lt jrepath gt lt gconf gt 8 1 Error Codes The prototype processor shares the same error codes as the prototype processor for a complete list see the OPSUM R D 23 section 6 The GUI can also return standard Java runtime error codes All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 SMOS L2 OS a ICM CSIC Doc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 ARGANS hot La EE Software User Date 11 October 2013 ST IFREMER o Manual age 64 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
71. of OTT post processor configuration tags ooooonoconocnnonnnoncncnoncnoncnnnnnnnnos 57 Table 12 Description of region definition tags si 58 Table 13 Description of tags of the private configuration filO ooonnnninnnnncnnnnnnncnnocnnornnnnnnnnnoo 61 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 Software User Date 11 October 2013 Page 10 AR GANS IFREMER SMOS L2 OS SO MA _GS E os Prototype Processor a ae io aia LOCEAN SA CETP ACRL Manual 1 Introduction 1 1 General This document is the user manual of the SMOS L2 OS Prototype Processor and its Graphical User Interface GUD Both the prototype processor and the GUI have been developed to be operated on Linux 64 bit platforms They are two independent software packages The processor can be operated from the command line interface provided the configuration of the processor is valid Configuration of the software includes many files switches selectors and parameters 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 w
72. of valid measurements flagged by L2 as RFI above which deltaTBs from AUX_DTBXY_ are ignored AUX_DTBXY_ are ignored AUX_DTBXY_ are ignored AUX_DTBXY_ are ignored All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 LOCEANS SICETE Sonwane Usor Date 11 October 2015 IFREMER Page Manual seer a ei O YY_EAF Stokes4 Max_ AUX_DTBXY_ are ignored AUX_DTBXY_ are ignored Max PA e std ra in AFFOV Stokes4 above which deltaTBs from AUX_DTBXY_ are ignored Se eee ee std ra in EAFFOV Stokes4 above which deltaTBs from AUX_DTBXY_ are ignored Strategy used by OSCOTT to compute OTTs 1 mean 2 gaussian mean nominally 1 OTT_Merge_FP OTT full polarisation merging O no merging l merge long amp short XX YY OTTs 2 merge cross pol Stokes 3 amp 4 OTTs 3 both 1 amp 2 ong short amp Stokes3 4 XX YY OTTs OTT_Validity_Start Strategy for computing OTT amp DTBCUR validity start time 1 first snapshot 2 mean last first snapshot 3 last snapshot 4 validity start of first snapshot orbit OTT interpolation option O nearest neighbour 1 bilinear interpolation Tag container of region definitions see below E Zero oF more regions maybe defined here List_of_regions Ending tag Table 11 Description of OTT post processor configuration tags Tag ipti FOV_StdRa Maximum std ra in EAFFOV YY pol above which deltaTBs fr
73. om AUX_DTBXY_ are ignored AFFOV_StdRa Regions are used by L2OS to extract deltaTB data from Lic products if an orbit intersects a region and meets selection criteria Any number of regions may be defined There are 2 types of regions those used to extract and compute OTTs and general purpose regions defined eg for extracting metrics Tag Description List_of_regions Tag container of region definitions Region Definition of a region Name User name for region ID Unique region ID 9001 OTT ascending diamond region 9002 OTT descending diamond region Type Type of region OTT apply OTT filters REG general purpose region of interest Orbit_Dir Select region only if matching orbit direction A D or don t care Start_Lat Region start latitude End_Lat Region end latitude gt Start_Lat Centre_Long_At_Start_Lat Central longitude at start latitude Centre_Long_At_End_Lat Central longitude at end latitude Long_Width Width of longitude Min_Snapshots Minimum number of snapshots to trigger writing region to AUX_DTBXY_ All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 Manual Page 58 Tag Description Min_Percent_Snapshot_Measurements Minimum percentage of measurements
74. originld are repeated here Geophy_Param Geophy_Param ind_SP Index of the surface pressure parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_UN10 Index of the neutral wind zonal component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_VN10 Index of the neutral wind meridional component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WSwav Index of the wind speed from ECMWF WAM wave model parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WS_U Index of the wind zonal component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WS_V Index of the wind meridional component parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 Software User Date 11 Octo
75. pe 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 DA Description o l Note ind_SSS Index of the Surface Salinity Must be unique in the list parameter of indices Name Name of the geophysical parameter NameLong Long name of the geophysical parameter unit Unit of the geophysical parameter desc Description of the geophysical parameter origin Origin of the geophysical parameter Optional originID Identifier of the origin of the geophysical Not used parameter All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS IDoc SO MA ARG GS 0021 ICM CSIC LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 IFREMER Pape 4 Manual age 43 Tag Description Note ind_SST Index of the Sea Surface Temperature Must be unique parameter The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WS Index of the Wind Speed parameter Must be unique The tags name nameLong unit desc origin originld are repeated here Geophy_Param Geophy_Param ind_WSn Index of the neutral wind parameter speed Must be unique The tags name nameLong
76. procedure in section 3 2 jrepath Java Runtime Environment location All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS Doc SO MA ARG GS 0021 LOCEAN SA CETP Prototype Processor Issue 2 Rev 19 ARGANS ACRI IFREMER Software User pa 11 October 2013 Manual age 63 fa ICM CSIC Description File global_conf xml Type XML Path SMOS_ROOT properties XML File structure lt xml version 1 0 encoding ISO 8859 1 standalone no gt lt gconf gt lt SMOS_ROOT type dir description SMOS ROOT INSTALL DIRECTORY gt home username L20S smos_GUI_SSScore lt SMOS_ROOT gt lt xml_rw_api_home description xml_rw_api_home editable false gt SMOS_ROOT lt xml_rw_api_home gt lt LD_LIBRARY_PATH description LD_LIBRARY_PATH editable false gt SMOS_ROOT libpackages memalloc64 SMOS_ROOT libpackages proclogs SMOS_ROOT libp ackages l1pp external_libs lib64 SMOS_ROOT libpackages xml_rw_api_linux64 projects bin lt LD_LIBRARY_PATH gt lt default_job_name description Default Job Name gt SMOS_job lt default_job_name gt lt default_processor_binary description Default Processor Binary Name fpattern L2OSPP_ type file gt SMOS_ROOT smos_GUI_SSScore bin L2OSPP_06_10 exe lt default_processor_binary gt lt max_jobs description Maximum number of jobs editable true list 1 2 3 4 5 6 7 8 type int gt 1 lt max_jobs gt lt refreshing_period description Refreshi
77. re 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 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS ICM CSIC LOCEAN SA CETP IFREMER Software User Manual IDoc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Date 11 October 2013 Page 45 Tag Description Note The tags name nameLong unit desc origin originld are repeated here 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
78. re that the data has the imposed type list none Any list of To impose a list of list 1 3 5 8 values comma admissible values separated No check is performed in this mode range none Two 2 values To impose a range range separated by alof admissible 2 35 15 45 comma values The following check is performed Vmin lt V lt Vmax fpattern none Any string chain When type is set to fpattern CONF _ file this attribute allows restricting Search will bear on the the file search to list of files matching the elements containing search condition the entered string CONF_ chain Multiple chains comma separated can be provided fextent EEF Any string chain By convention all fextent DBL the definition files are of extension EEF After the file selection the extension is subtracted from the name Tf the type is file the data must be a text string A selection button is added to the panel in order to select the file from the disk If not specified a default type is imposed to double when range attribute is used All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual IDoc SO MA ARG GS 0021 Issue 2 Rev 19 Date 11 October 2013 Page 69 xmledit false true false If this attribute is set to true an edit button i
79. retrieved parameter First_guess First guess for 9 retrieved parameter First guess for 10 retrieved parameter First_guess Prior_error_abs Absolute error of prior for 1 retrieved Only used if p y parameter Guess_prior false 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 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 LOCEAN SA CETP SMOS L2 OS Doc SO MA ARG GS 0021 ICM CSIC Prototype Processor Issue 2 Rev 19 IFREMER Software User Date 11 October 2013 Manual Tag Description Prior_error_rel Relative error of prior for 3 retrieved parameter Prior_error_abs Absolute error of prior for 4 retrieved parameter Prior_error_rel Relative error of prior for 4 retrieved parameter Prior_error_abs Absolute error of prior for 5 retrieved parameter Prior_error_rel Relative error of prior for 5 retrieved parameter Prior_error_abs Absolute error of prior for 6 retrieved parameter Prior_error_rel Relative error of prior for 6 retrieved parameter Prior_error_abs Absolute error of prior for 7 retrieved parameter Prior_error_rel Relative error of prior for 7 retrieved parameter
80. s 2 4 Breakpoint report GUI The breakpoint report GUI is either a text editor or HDFview if the breakpoint reports are in text or HDF5 format Any prototype processor modification induces breakpoint report modification and therefore an update of the breakpoint report GUI The data GUI shall be updated whenever one of the data products it deals with is modified During SMOS life it is anticipated that processor modifications will be more frequent than product format modifications Therefore it is expected that the breakpoint reports files will change frequently with regard to their content add or remove variables The viewer does not require any modification to give access to the data in the reports if the content of the breakpoint report file is modified 2 5 File management The processor uses and produces several files Some of them are reused for many processor runs and or shared by many users Sharing input files reduces data volumes but has some limitation For instance 1f an input file is modified while the file is used as input to the current computations the prototype processor may produce unexpected results For file sharing between users standard access rights by users and groups of LINUX operating system are used All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 Software User Date 11 October 2013 Page 15 AR GANS IFREMER SMOS L2 OS SO MA _GS E os Prototype Processor a ses io aia LOCEAN SA CETP i
81. s added to the interface allowing to open a new XML editor loading the file pointed on see example below xmledit true txtedit false true false If this attribute is set to true an edit button is added to the interface allowing opening a new text editor loading the file pointed to txtedit true description none Any string chain Tag description description tag description unit none All units poss 1ble Unit description unit d1 listdir none be scanned Any directory to If present create a list of all available subdirectories contained in the tag value listdir SMOS_ROOT smos_GUI_SSScore inputs listfiles none be scanned Any directory to If present create a list of all available files contained in the tag value listfiles SMOS_ROOT smos_GUI_SSScore inputs Xmledit attribute example lt iterSchemeFile type file xmledit true gt data TDS inputs SM_ TI lt iterSchemeFile gt EST _AUX_ITCO EF 20070101T000000 20781231T235959 0000002 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2OS___ poe SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 Software User Date 11 October 2013 ICM CSIC LOCEAN SA CETP IFREMER Page 70 Manual File Edit v Data_Block 1 z A editable true editable H true A type xml A xmins http
82. sissssssesessasassissoscnsssvazanesss sscasesoasseaseaseseassesssaseesassvsasasassisoasssnesssasasesesesees 25 Gell UJOBSCREATION see cence fos ede A A in eco 25 6 2 JOB CONFIGURATION 0 diia 27 7 CONFIGURATION FILES sisescsssssccidsescesescessscacessosucesesdscscsoccetscsaneseassecesesecesses aces coovessesssccscocoov essessscssesens 37 Fell INTRODUCTION dios 37 7 2 THE MAIN CONFIGURATION FILE cccccccecscecscecececececsceceeecsesceeeceescueeceesceeaceeeceeececscueuceeueueusueueueusueuaueueuenenenens 37 TS MOB ORDER ERA E EE A E css 59 7 4 THE PRIVATE CONFIGURATION FILE coccccccccncncncnnnonononononononononononononononononononnnnnnnonononononononononononnnononononononininenos 59 8 CONFIGURATION OF THE GRAPHICAL USER INTERFACE sssssesessessoosoessessoseosoesseesoseseesesese 62 8 1 ERROR CODES ad 63 9 MODIFICATION OF THE L20S OPEN PROTOTYPE TUTORIAL sccccccssossssscssccssssssscerecees 64 9 1 INTRODUCTI N Si iia 64 9 2 INSERTA NEW USERS MODEL da E iiie 64 9 3 GEOPHYSICAL PARAMETER RETRIEVAL FROM THE DATA MODEL OF THE PROCESSOR ccccccccccccncncncncnininnnnonon 65 9 4 WHERE TO CALL THE USER S MODEL ccoccccncnonononononononononononononononnnonnnonononononnnnnnnnnnnnnnnnnnnonononnnnnnnnnnnononeneneninnnos 65 9 5 TESTING THE CODE MODIFICATION ccccccccncccncnnnnnnnonononononononononononnnnnnnononononnnnnnnnnonnnononononononononononononononineneninenes 65 APPENDIX A XML EDITOR TOOL csscscsscsssccseccscsosesssosscescso
83. sossceccnssssccsosecsscsabscsvecesecoucsassssecnseces sossessconceesse 67 APPENDIX B FEEDBACK FORM ciccsscssccssesosscsssssossessssssetececsensessssondscsesendesessedsovessonsesesoondssoscsvseconssssseescesses 73 All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 Software User Date 11 October 2013 Page 9 SMOS L2 OS SO MA ARG GS e os Prototype Processor a ae io aia LOCEAN SA CETP ACRI AR GANS IFREMER Manual List of Tables Table 1 Description of the iterative scheme configuration tags oooooooccccoocccnoncnononcnonananonnncnnnns 42 Table 2 Description of the geophysical parameter definition tags ooococoncnoncnnonnonnnnonnnnnncnnnos 47 Table 3 Description of the tags with the thresholds ooooconnnnnncnnnnnnnoconononocnnnocnnnrncnonccncnnnnoo 49 Table 4 Description of the tags with the physical CONStantS ooooococnnococnonccconnnccnoncconanaconnncnnnns 50 Table 5 Description of the post processor configuration tags cooocconooccconocccnoncnononcnonancnonnncnnnno 51 Table 6 Description of the overall quality threshold tags ooonoocccnnococnonccconncccnoncconnncconnncnnnns 52 Table 7 Description of the flag definition tags ici es 53 Table 8 Names amp descriptions of filters uc ia 54 Table 9 Description of filter definition tags camisa id aida 55 Table 10 Description of A3TEC configuration taBS ococnoocccnoncccnoncncnnnncnnoncccnnncncnnncncnnncnonaneninns 55 Table 11 Description
84. ss tepmeratures of Lic file are patched with brighness rement temperatures computed for outlier detection Gaussian noise is added to brightness temperaturetures according to either radiometric All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L2 OS boc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 LOCEAN SA CETP IFREMER Software User Date 11 October 2013 Manual Page 60 Description Ps uncertainty or Stddev see below if Stddev gt 0 OverWritePrior Prior after bias correction in AGDP module are patched with random values with gaussian probability distribution function with mean prior and standard deviation uncertainty on prior icUncertainty Seed of the random number generator with gaussian probability distribution function Seed is random if tag value is negative Mean bias to be added to brightness temperatures when patched Standard deviation of noise to be added to brightnes temperature when they are patched Radiometric uncertainty of Llc product is used in stddev lt 0 api Host_Name Host name for the Processors are installed as identified by PDPC Core It is a logical name with DNS not an IP direction HW_Identifier Unique identifier of the hardware involved in the processing nnnn where n are digits or characters List_of_Input_Sc hemas Repeated variable number of times Product_Type Product type name Version of schema to be used with the versio
85. ssor Issue 2 Rev 19 Software User Date 11 October 2013 IFREMER Manual Page 56 7 2 9 OTT post processor configuration The SMOS L2 SSS processor can be configured to extract deltaTBs from Llc products and write them to AUX_DTBXY_ which is read by the OTT post processor to compute AUX_OTTxF D All tags in the table below are under the Data_ Block L2_OS_Configuration_Parameters OTTPP tag ee sc of SSS reference for computing deltaTBs 0 climatology 7 AUX_SSS__ 1 retrieved SSS1 7 7 direction AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored L1 ADF Errors Max Percent Maximum of valid snapshots flagged by L1 with ADF errors above which deltaTBs from AUX_DTBXY_ are ignored L1_Calibration_Errors_Max_Percent Maximum of valid snapshots flagged by L1 with calibration errors above which deltaTBs from AUX_DTBXY_ are ignored ee of valid snapshots flagged by L2 with TBs out of range above which deltaTBs from AUX_DTBXY_ are ignored deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored AUX_DTBXY_ are ignored deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored which deltaTBs from AUX_DTBXY_ are ignored A cc of valid measurements flagged by L1 as RFI above which deltaTBs from AUX_DTBXY_ are ignored pe eee
86. t lt swltea foam ligt true talga deserlprion Comaurte toan Coverage ancl contribution gt true lt switch_foam gt In the above example the variable nMin has the type int and can be edited inherited from the ancestor list_of IterConf It is editable which means that the value can be changed through the GUI XML editor The value is 5 and any modification can only be ranged between 1 and 256 Beyond this range or if the value is not a integer number the user is warned with a specific message The attributes description is displayed in the editor and is considered only as static information Predefined Attributes The list of predefined attributes is given below Please note 1 that this list is extendable for specific checks Please contact ARGANS for integration 2 by default all the data are editable and of type text 3 all attributes and values are written in lowercase All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 ICM CSIC LOCEAN SA CETP IFREMER SMOS L2 OS Prototype Processor Software User Manual IDoc SO MA ARG GS 0021 Issue 2 Rev 19 Date 11 October 2013 Page 68 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 ensu
87. te List_of_Iterconf Tag container of the four configurations All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 SMOS L2 OS _ poc SO MA ARG GS 0021 Prototype Processor Issue 2 Rev 19 ICM CSIC LOCEAN SA CETP IFREMER Software User Par 11 October 2013 Manual Tag Description Note nRetrievedParam Number of retrieved parameters retrievedParamld Name of 1 retrieved parameter SSS retrievedParamld Name of 2 retrieved parameter SST retrievedParamld Name of 3 retrieved parameter UN1O retrievedParamld Name of 4 retrieved parameter VN1O retrievedParamld Name of 5 retrieved parameter tec retrievedParamld Name of 6 retrieved parameter WSn retrievedParamld Name of 7 retrieved parameter phi_wsn retrievedParamld Name of 8 retrieved parameter HS retrievedParamld Name of 9 retrieved parameter MSQS retrievedParamld Name of 10 retrieved parameter Sree Uwav 3 1 ate First_guess First guess for 1 retrieved parameter Only used 1f First_guess First guess for 2 retrieved parameter Guess_prior false First_guess First guess for 3 retrieved parameter First_guess First guess for 4 retrieved parameter First_guess First guess for SU retrieved parameter First_guess First guess for 6 retrieved parameter First_guess First guess for 7 retrieved parameter First_guess First guess for 8
88. tu SMOS L20S smos_GUI_SSScore bin L2OSPP_03_02 exe Origin Job O Comment ok cancel The option Origin job is provided in order for the user to be able to base the new job on a former one In order to use this option it is necessary to click on the check box aside the Select button which is then enabled By clicking on the Select button the following panel is displayed which allows to select a job in a specific folder see next image All rights reserved ARGANS ACRI st O 2009 2010 2011 2012 2013 y ICM CSIC SMOS L2 OS Doc SO MA ARG GS 0021 a Sl OCEAN SA CETP Prototype Processor Issue 2 Rev 19 ARGANS Eo IFREMER Software User Date 11 October 2013 Manual Page 26 New Job panel Job name SMOS_job5 Author Creation date 31 January 2008 17 28 00 Job status New Processor Executable mount users fr smos_gui_Core_v2 0 bin Origin Job IK Origin Job selection panel Comment Folder list Job list CANCEL Note It is important to ensure that the job selected as origin is compatible with the processor version used for the new job In case the default processor binary cannot be found in the bin directory of the GUL the following message is displayed along with possible recovery action to undertake Job management panel Folder list testl Job list Job Execution The default processor binary has
89. uration file The private configuration file CNF_L2OS is used to define system parameters This file is in XML ASCII format Complete definition of the file name along with header and Data_Block tag fields are provided in the section 2 5 4 of the IODD R D 14 The role of the private configuration file is to define 1 State of so called hidden switches that allows special operation modes of the prototype processor 2 Versions of schemas to be used with input and output products 3 Processing window 4 List of grid points to be processed Items 1 3 and 4 are key configuration parameters for open prototype users If the number of grid points of the list of selected grid points set with the count attribute of the tag List_of_grid_points is not zero it means that the processor will consider only the grid points with identifier listed in the list of grid point If such list is defined it takes precedence to the processing window which is ignored The L2 OS UDP and DAP product will contain only the grid point processed whereas in the case of a full or window processing all grid points of the Lic file with be present in the L2 products Defining a short list of grid points is useful when breakpoint reports are activated and the processor is fast to produce small L2 products Processing window can be defined using the GUI List of grid point can be set up by editing the private configuration file as a text file OverWriteMeasu Brightne
90. vised for consistency with the interface Appendix 3 6 1 3 2 Check on processor soft links to products and libraries presence on GUI startup added with error message 3 2 6 2 7 6 2 8 4 1 11 4 1 2 efer to section 6 2 7 for the behavior of the GUI when closed 6 1 Clarification on copies of configurable files Tutorial updated Page Section gt 310 Q A ALO IZ mia lt O 4 2 Oo N N et Q lt O 4 E O 5 N W A Nn O 4 gt Q ye Q We aN IN N All Update of the L2OS processor version to be 2 3 Minor updates Version 2 3 to version 2 4 SO MA ARG GS 0021 12 11 2008 all Reformatted header footer amp title pages for ARGANS i Table 3 Added Tg_gal_noise_pol_max Tg_WS_gal Tm_gal_noise_pol eee Tg_Acard_max Tg _Acard_min Tg_sigma_Acard_max lt O 4 2 O N P e O lt O 4 2 O N U A Nn 4 gt ye Q Q WN o p Replaced references to IODD with Product Specs corrected Red Hat 4 to 5 replaced obsolete A D 2 with A D 5 pre QR RID jcd 151 Added doc ID to change record pre QR RID jcd 152 pre QR RID jcd 153 files pre QR RID jcd 157 all A Description of input files clarified pre QR RID jcd 159 Type prong corrected pre QR RID jcd 162 libraries pre QR RID jcd 155 jcd 160 amp 161 All rights reserved ARGANS ACRI st 2009 2010 201 1 2012 2013 MOS L2 ICM CSIC SMOS L20S boc SO MA A
91. ype 1 Stem List_of_File Names 1 xmins H http 213 170 46 150 smos schemas A count 1 Y Input File 1 editable true V File_Name 1 E AANA lt lt gt gt 22222 A description Definitions of geoStem parameters Configuration d A editable true count H 1 A fextent EEF A fpattern AUX_CNFOSD description Definitions of geoStem parameters Ci A btedit true A type lfile A xmledit true fextent EEF x men Inputs 1ESI_AVA_UNFOSD_ 2UUU LU 11 UUDU 4 Y State 1 fpattern AUX_CNFOSD Non Alternative Y List_of_Time_Intervals 1 p count 1 txtedit true Y Time_Interval 1 Y Start 1 type file 2006 04 19 185548 972 AAA Y Stop 1 E 2006 04 19 194948 972 meni tus s V File_Name 1 i X le T Inputs SM TEST AUX CNFOSD eae SET Select File Edit XML File Edit as TXT File J Uob_Order List_of_Procs 1 Proc 1 List_of_Inputs 1 Input 16 List_of_File_Names 1 Input_File 1 File_Name 1 File Edit Y Earth_Explorer_File A editable true gt Earth_Explorer_Header 1 gt Data_Block 1 All configuration parameters are listed in section 7 6 2 5 Edit Break Points list This button gives access to the break points management panel It allows activating break points defined in the DPM R D 3 Break points are places in the processing where some of the local variables are copied in a file for detailed investigation Data storage format is either HDF5 or

Title: SMOS L2 OS Prototype Processor Software User Manual Doc

Contents

Download Pdf Manuals

Related Search

Related Contents