Home

RTTOV v11.3 GUI users` guide

1. Optional environment variables the defaults are usually OK Directory for rttov emissivity and BRDF atlases this should be the directory containing che emis data and brd data directories which hold the atlas datasets NB The HDF5 BRDF and IR emissivity atlas files must be used RTTOV_GUI_EMISS DIR RTTOV_GUI_PREFIX export RTTOV_GUI_EMISS DIR Working directory for rttov gui temporary files RTTOV_GUI_WRK_DIR HOME rttov export RTTOV_GUI_WRK_DIR Default directory for rttov coefficients files RTTOV_GUI_COEFF_DIR RTTOV_GUI_PREFIX rtcoef_rttov1l export RTTOV_GUI_COEFF DIR Default directory for profile files RTTOV_GUI_PROFILE DIR RTTOV_GUI_PREFIX rttov_test profile datasets hdf export RTTOV GUI PROFILE DIR 2 2 Files created by the RTTOV GUI The RTTOV GUI software will create various files in its working directory defined by the RTTOV GUI WRK DIR environment variable rttov by default PF Most of these files are encoded in the HDF5 format It is possible to look at them using the hdfview software for instance Exporting data to text file is also possible using the hSdump command These files are e profile h5 contains the profile and options e surface h5 contains information about the surface and emissivity reflectance used as input and computed by RTTOV o
2. Aerosols 1 cm3 on layers 1f INSO numpy array Insoluble 1f WASO numpy array Water soluble 1 SOOT numpy array Soot L SSAM numpy array Sea salt acc mode L E SSCM numpy array Sea salt coa mode L MINM numpy array Mineral nuc mode 1f MIAM numpy array Mineral acc mode 1f MICM numpy array Mineral coa mode L MITR numpy array Mineral transported 1 SUSO numpy array Sulphated droplets l1f VOLA numpy array OPAC Volcanic ash L VAPO numpy array New Volcanic ash 1 ASDU numpy array Asian dust Clouds g m3 on layers L STCO numpy array Stratus Continental L STMA numpy array Stratus Maritime L Ccucc numpy array Cumulus Continental Clean L CUCP numpy array Cumulus Continental Polluted L CUMA numpy array Cumulus Maritime 1 CIRR numpy array Cirrus 1lf CFRAC numpy array Cloud Fraction should be set if any cloud 1l1f IDG 1 Scheme for Ice water content LEL LSA T Ice cristal shape Skin variables 1 SKIN T self T 1 K L SKIN SURFTYPE 1 O Land 1 Sea 2 sea ice L SKIN WATERTYPE 1 O fresh water l ocean water 1LE SKIN SALINITY 37 SO L SKIN FASTEM numpy array 0 0 0 0 0 5 parameters
3. 25 The EUMETSAT i A Graphical User Interface Doc ID NWPSAF MF UD 010 Satellite Application a NWP S AF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction Move the mouse on a channel and hit P on your keyboard to display the K profile Fig 2 10 2 Icon toolbar Nesasnansnsnsnsnsnaa This icon permits to multiply KProfile values by 10 of input profile only applicable to gaz variables run profile channe Sur arzhur x cms meteo fr mw cm 1 ster sq m K 0 015 pressure hPa pressure hPa T005 0 010 mw cm 1 ster sq m K i L L 0 04 0 03 0 02 0 01 mw cm 1 ster sq m ppmv or kg kg i ag Q 6 a Figure 2 10 2 The K profile window 26 The EUMETSAT 2 A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application Am NWP S AF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction 2 11 Running PC RTTOV Principal Components It is possible to run PC RTTOV For this purpose you have to load a PC coefficient file and select the addpc option in the Option Window Then select Run RTTOV You will be asked to enter the number of Principal Components After the run a new window is displayed the PC SCORES window Fig 2 11 1 S ems meteo OOO Eile Help Y Axis PCSCORES 50 100 X Axis Principal Components O0 S amp B Figure 2 11 1 The PC SCOR
4. Satelite Application NWP S AF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction By clicking the reset button the 1DVAR window is reinitialized the background profile is reinitialized if you a have made some changes on it with the surface window and or the profile window 4 Input Profile file format The input profiles for the RTTOV GUI can be of two different kind formats The native profile format is HDF5 as the Fortran executable GUI command will only read such format The other format is an ASCII format made of Python statements for the required variables The two formats are described below 4 1 HD5 profile file format The HDF5S profile format can store a single profile or a profile dataset such as the ECMWF diverse 83 profile set It also allows RTTOV options to be stored in the same file The HDF5 top level structure is as follows note all groups and datasets are in capital letters PROFILES Group PROFILES 0001 Group First profile PROFILES 0002 Group Optional PROFILES 9999 Group Optional OPTIONS Group Optional The PROFILES 0001 group contains a copy of the RTTOV profile structure see the module src main rttov_type F90 and RTTOV user s guide If the HDF5 file contains several profiles they should be numbered continuously and the group name is made of 4 digits with leading zeros Under the profile number group the variable names are HDF5 dataset
5. 09 18 Numerical Weather Prediction 2 9 Running RTTOV Direct Model and working with the Radiance Frame To run the direct model of RTTOV select Run direct from the RTTOV menu in the main GUI window This will save and overwrite the profile being edited and run the direct model the profile is saved before each run in the RTTOV GUI working directory it does not overwrite the original input profile file If the run is successful a new window appears the radiance window which displays the result of the RTTOV direct model Fig 2 9 1 Radiance Viewer sur arzhur220x cms meteo fr File Help byRun byChannel OnePlot v ret un 01 v Pseudo run v f Channel f Pseudo channel H BT run 01 2 00 amp B MSG 4 SEVIRI chn 01 Y 0 K Wn 15689 097 cm 1 A 0 637 um Figure 2 9 1 Radiance window 18 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Ol ci Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction The charts displayed in the radiance window are e TOTAL Clear cloudy top of atmosphere radiance for given cloud top pressure and fraction mW cm 1 ster sq m e CLEAR Clear sky top of atmosphere radiance channels mW cm 1 ster sq m e BT Brightness temperature equivalent to total radiance Kelvin e BT CLEAR Brightness temperature equivalent to clear radiance Kelvin e REFL Reflectance calcu
6. ASCH files ASCII files are actually python source code files see section 4 ASCII and HDF5 versions of the RTTOV test suite profiles are included in the rttov_test profile datasets py and rttov_test profile datasets hdf directories Update the rttov_gui env environment file according to your installation see next section Run the GUI source rttov gui env rttovgui If you use the emissivity and or BRDF atlases with the GUI then note that you must use the HDF5 versions of the BRDF and IR emissivity atlas files 2 RTTOV GUI User Manual 2 1 Configuration files The rttov_gui env contains mandatory environment variables which are used by RTTOV GUI This file must be customized to your specific installation In most cases this only requires the RTTOV_GUI PREFIX variable to be specified with the absolute path to your RTTOV gui directory Example of rttov_gui env file RTTOV GUI Environment Mandatory variables RTTOV GUI installation directory absolute path to the rttov gui directory e g home user rttovll gui RTTOV_ GUI PREFIX export RTTOV_GUI_ PREFIX PANIES RTTOV GUI _PREFIX SPATH export PATH PYTHONPATH S RTTOV_GUI_PREFIX PYTHONPATH export PYTHONPATH The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction
7. KB 07 30 2015 standard51lew ca ref HA 97 3 KR 07 30 2015 Lz Add Remove Files v is el we Cm p Cem Ca Figure 2 5 1 select a profile select a profile number Figure 2 5 2 choose a profile number The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Ol ci Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction 2 6 Modifying the options The RTTOV options can be modified through the Options editor window Select Options Editor Window from the Windows menu of the main window fig 2 6 1 The RTTOV options which can be modified are part of the option structure of RTTOV described in the RTTOV v11 User Guide Annex O The help menu of the Options editor windows gives you some information Some options are unavailable depending to the loaded coefficient files or the profile content For example the addclouds option can only be checked if you have loaded a cloud coefficient file The addaeros option can also only be checked if an aerosols coefficient file is loaded PC RTTOV options can be modified only if you have loaded a PC RTTOV coefficient file Once you have made your choices you have to save them for the run by clicking the Apply button 10 Doc ID Version Date The EUMETSAT NWPSAF MF UD 010 2 2015 09 18 A Graphical User Interface for RTTOV v11 3 letwork of Satellite App
8. aerosol short name table 23 of users guide Units are as described in RTTOV users guide for profile structure Annex O Pressure temperature and water vapour arrays are mandatory all other RTTOV profile variables are optional they will be set to default values when the profile is read The list of profile variables that can be set by the user is given below with the default values Omitted values default to a clear atmosphere The number of levels and layers are deduced from array sizes Mandatory arrays P hPa T K Q ppmv on levels self P numpy array self T numpy array self O numpy array Optional profile variables Other Gases ppmv on levels self 03 numpy array self CO2 numpy array 37 The EUMETSAT Network of Satellite Application Facilities A Graphical User Interface NWP SAF Numerical Weather Prediction Doc ID Version Date NWPSAF MF UD 010 2 2015 09 18 for RTTOV v11 3 se se se 4 se se se se se se se se se se se se se 4 se se se se se se se se se 4 se se se se se 1 CH4 numpy array 1 co numpy array 1 N20 numpy array
9. the python syntax 28 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction 3 1Dvar functionalities 3 1 Introduction There is a basic 1DVAR retrieval algorithm available with RTTOV GUI It uses the R matrix and B matrix of the NWPSAF 1DVAR retrieval software see https nwpsaf eu deliverables 1dvar index html In order to be independent from this software samples of these matrices are available in the RTTOV GUI directory The basic 1IDVAR algorithm can only be used for the following instruments m mn n airs iasi amsua amsub mhs hirs nu woe atms u ssmis cris The observation error R matrix for iasi metop 2 and iasi metop 1 are identical Only one R matrix for SSMIS is provided In order to have access to the 1Dvar functionalities you have to open a 54 levels profile the background error matrix are only available for 54 levels and load the coefficients for one of the previous listed instrument With these to prerequisites you have access to the Configure 1Dvar command of the 1Dvar menu of the main window see fig 3 1 1 3 2 Running the RTTOV GUI 1DVAR RTTOV GUI IDVAR works with 2 profiles a Background profile Xb and a True profile Xt The Background Profile is opened in the main RTTOV GUI window and can be modified as usual The True Profile is open
10. 38 money A Graphical User Interface DocID NWPSAF MF UD 010 Satelite Application Version NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction Land sea ice 2m and 10m air variables self S2M T self T 1 K self S2M O self O 1 ppmv self S2M P self P 1 hPa self S2M U 0 m s self S2M V 0 m s self S2M WFETC 100000 m Simple cloud self CTP 500 0 hPa self CFRACTION 0 0 0 1 Clear sky is the default Viewing geometry self AZANGLE Q deg self ELEVATION 0 km self LATITUDE 49 738 deg Lannion is 48 750 3 470 self LONGITUDE 3 473 deg Exeter is 50 726 3 476 self SUNAZANGLE 0 deg self SUNZENANGLE 0 deg self ZENANGLE 0 deg self SNOW_FRAC 0 0 1 Magnetic field self BE 0 3 Gauss Ta self COSBK Mislaneous self ID This is my profile self DATE numpy array 2014 04 30 dtype int Year Month Day self TIME numpy array 12 0 0 dtype int Hour Minute Second 39 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application NWP S AF Version 2 for RTTOV v11 3 Dat
11. ES window Note the symmetrical log axis for pcscores range 100 100 is linear If you choose the addradrec option in the option window the result of the RTTOV Run PC is also displayed in the Radiance Window 27 The EUMETSAT Network of Satellite Application m Facilities g A Graphical User Interface DociD NWPSAF MF UD 010 Version 2 Neie sai for RTTOV v11 3 Date 2015 09 18 2 12 Running PC RTTOV K If you choose to run PC RTTOV K two windows are displayed the KPCMatrix Window and the KPC profile window The KPC profile window Fig 2 12 1 allows you to visualize the KPC profiles You can use the sliders in order to modify the plot first curve to be displayed and the number of curves displayed With every K PC run new windows are displayed WO File Edit Help Number of K PC Profiles to show 173 679 122 766 29 2113 1 88335 55 4526 12 9694 22 2689 15 4959 14 2051 skin PC10 3 5559 skin PC11 1 81574 13 4433 3 15412 5 24271 5 2762 13 0363 3 24479 0 964846 2 3842 0 822692 0 0695675 1 65756 0 273779 2 95462 0 133891 i 0 710787 pcscore K 0 571959 3 26996 1 29114 pressure hPa Fig 2 12 1 The K PC profile window 2 13 Colour customisation Matplotlib colours for the different windows can be customised You can modify the rview colors py file as your convenience in respect of
12. The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 ae NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction A Graphical User Interface for RTTOV v11 3 Pascal Brunel Jean Luc Piriou Pascale Roquet J r me Vidot M t o France This documentation was developed within the context of the EUMETSAT Satellite Application Facility on Numerical Weather Prediction NWP SAF under the Cooperation Agreement dated 1 December 2006 between EUMETSAT and the Met Office UK by one or more partners within the NWP SAF The partners in the NWP SAF are the Met Office ECMWF KNMI and M t o France Copyright 2014 EUMETSAT All Rights Reserved Change record Version Date Author changed by 2014 05 21 2014 06 06 J Hocking 2015 09 18 P Roquet Remarks Initial version Minor updates for release Updates for RTTOV11 3 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Ol ci Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction Table of contents HL IMO AUCTIONS 205 ATE E E AER 3 DME Tit ENEO a AE E viele A E E E 3 2 RTTOV GUL User Manual asiaate airea iaeei a aa Aea ikai iaia ieaiai 4 2 1 Configuration TV TES 36s a cis scenes tsi ae anise ste cease end a a Eik E a Smeal Ea EEE Rie en 4 2 2 Files created by the RTTOV Ga gasp censesieeceoeatied nanan eacatsyecensieds wn gec
13. This algorithm works with fixed profile levels 54 e RTTOV computations are made with no cloud nor aerosols nor trace gas just T and Q e All surface variables except Tskin and T2m are fixed for the true profile and equal to those of the background profile e The surface type is forced to sea e all RTTOV calculations are made at nadir Inputs selections When you configure the 1 DVAR the R matrix and B matrix are read in the RTTOV_GUL PREFIX r1 DVAR data directory It is possible to configure the environment variable NWPSAF_1DVAR_ HOME if you want to use another directory but do not change the sub directories names and file formats 1 Open a true profile Xt selected from the database 2 Change the value of the scaling factor fb for the background errors if necessary 3 Change the value of the scaling factor fr for the observation errors if necessary 4 Change the value of the maximum random noise if necessary 5 Click on the RUN 1DVAR button Computations made by RTTOV GUI 1 Compute brightness temperatures Y Xt from Xt made only at the first step 2 Compute and add random noise vector N to Y Xt made only at the first step 3 Compute brightness temperatures Y Xb from Xb 4 Compute jacobian matrix K Xb and transpose KT Xb 5 Apply scaling factor to background errors B gt fb x B applied each step to the original B matrix 6 Apply scaling factor to observation errors R gt fr x R applied each st
14. ace Doc ID AO terse Satelite Application Version NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction usage convert_python2hdf5 py h i INPUTF o OUTPUTF g GROUP v Import ASCII profile to HDF5 for RTTOV GUI optional arguments h help show this help message and exit i INPUTF input file INPUTF input file name o OUTPUTF output file OUTPUTF output file name g GROUP group GROUP internal HDF5 default is PROFILES 0001 v verbos display profile variables It is possible to convert all of the RTTOV test suite profile datasets contained in rttov_test profile datasets to ASCII and HDF5 format quite easily Navigate to the rttov_test profile datasets directory and then run run_convert test2python sh run_convert python2hdf5 sh These scripts create profile datasets py and profile datasets hdf directories within rttov_test containing all of the RTTOV test suite profiles in Python ASCII and HDF5 formats for input to the GUI Note that the second of these two scripts requires the gui rttov directory to be in your PYTHONPATH and rttov_gui_f2py so must be linked in the profile datasets directory 41 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 s Version 2 iC Satetite Applicaton NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction 5 Reporting bugs and limitations Al
15. aconda distribution of python proposed by continuum analytics http continuum io downloads Anaconda already includes numpy matplotlib and h5py and by default is installed on your home directory Add HOME anaconda bin to your PATH export PATH SHOME anaconda bin SPATH You can add this line to your profile or bash_profile or similar Then you just have to install the wxpython package with the conda command which is part of anaconda conda install wxpython The RTTOV GUI is provided as part of the RTTOV package in the gui directory Edit the file build Makefile local to point to your HDFS installations see section 5 of the RTTOV user guide for more information about this Compile RTTOV with the rttov_compile sh script Change to the src directory and type build rttov_compile sh The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 section Version 2 Nel Satellite Appl F ct NWP SAF for RTTOV v11 3 Date 2018 09 18 Numerical Weather Prediction If your python installation is correct the script must see that f2py is present answer y at the question f2py detected do you want to compile the Python wrapper and RTTOV GUI y n Be sure that the HDF5 library used for RTTOV is consistent with that used by h5py The rttov_gui_f2py so symbolic link must point to the rttov_gui_f2py so which is built in the RTTOV lib directory RTTOV GUI needs profile files hdf5 or
16. aset 1 USE_Q2M Dataset 1 DO_LAMBERTIAN Dataset 1 ADDSOLAR Dataset 1 DO_NLTE_CORRECTION Dataset 1 ADDAEROSL Dataset 1 ADDCLOUDS Dataset 1 USER_AER_OPT_PARAM Dataset 1 USER_CLD_OPT_PARAM Dataset 1 CLDSTR_THRESHOLD Dataset 1 CLDSTR_SIMPLE Dataset 1 OZONE_DATA Dataset 1 CO2_DATA Dataset 1 N20_DATA Dataset 1 CO_DATA Dataset 1 CH4_ DATA Dataset 1 FASTEM_VERSION Dataset 1 CLW_DATA Dataset 1 SUPPLY_FOAM_FRACTION _ Dataset 1 ADDINTERP Dataset 1 36 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite App Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction INTERP_MODE Dataset 1 LGRADP Dataset 1 REG_LIMIT_EXTRAP Dataset 1 SPACETOP Dataset 1 4 2 ASCII Text profile file The RTTOV GUI is able to read an ASCII text profile file This kind of file is made of Python statements for the required variables Thus the format should respect the Python language syntax The arrays should be defined as NumPy arrays the scalars can be pure Python scalars or NumPy variables The variable names are the ones described in the RTTOV users guide for the profile structure Annex O capital letters except for e clouds where 2D cloud array is replaced by 1D cloud arrays one for each cloud short name table 22 of users guide e aerosols where 2D aerosols array is replaced by 1D aerosol arrays one for each
17. e 2015 09 18 Numerical Weather Prediction 4 3 How to create an HDF5 profile file from Fortran RTTOV users can create an HDF5 profile file for use in the RTTOV GUI using the RTTOV subroutine RTTOV_HDF_SAVE contained in src hdf rttov_hdf mod F90 This subroutine can write any RTTOV structure to an HDFS5 file For example a main Fortran program that can store a profile dataset and options in the same file would contain the following statements Use hdf5 Use rttov hdf_ mod Type profile_type Pointer profiles gt NULL Type rttov_options opts CALL OPEN HDF TRUE ERR l statements that creates the profiles array l and statements that fills the options opts CALL RTTOV_HDF SAVE ERR PROFILES H5 PROFILES amp CREATE true PROFILES profiles l nprofiles CALL RTTOV_HDF SAVE ERR PROFILES H5 OPTIONS CREATE false amp OPTIONS opts CALL CLOSE HDF ERR 4 4 How to create an HDF5 profile file from ASCII text profile file The ASCII text profile files are Python files A Python script named convert_python2hdf py in the rttov_test profile datasets directory allows the user to convert an ASCII text profile to an HDF5 profile file This script makes use of RTTOV GUI Python software Profile class so cannot be used outside this framework 40 The EUMETSAT A Graphical User Interf
18. ed in the specific 1DVAR window Fig 3 1 1 and cannot be modified If you change the coefficient file with RTTOV GUI the 1DVAR window is reinitialized It is also possible to run the RTTOV GUI 1DVAR basic algorithm without running the whole RTTOV GUI example Spython toontroller ridvarController py P RTTOV_ GUI PROFILE DIR standard54lev_ allgas H5 s RTTOV_GUI_ COEFF DIR rttov7pred54L rtcoef noaa_19 amsua dat The 1DVAR window is initialized in this case with the first profile of RTTOV_GUL PROFILE DIR standard54lev_allgas H5S 29 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application Version 2 one amp NWP SAF for RTTOV v11 3 Date 2015 09 18 File Help 1DVAR basic Algorithm control The first opened profile becomes the background profile You must now select a new profile which will become the true profile warning restriction will be made on RTTOV options geometry and surface see help for details Open a True Profile Assumed Observation Error Scaling x10 10 al 100 Assumed Background Error Scaling x10 10 j 1 100 Noise applied to true BT x10 10 o 100 RUN 1DVAR Reset Fig 3 1 1 The 1Dvar window 30 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction 3 3 Algorithm Description Restrictions e
19. ep to the original R matrix 7 Compute linear 1 DVAR weights W where W B KT K B KT R 1 8 Compute linear 1DVAR retrieved profile Xr Xr Xb W Y Xt N Y Xb The results are displayed in 2 windows A profile window Fig 3 2 1 display the True the Background and the Retrieved profiles a brightness temperature window FIG 3 2 2 display Y Xt Noise Y Xt and Y Xb It is possible to make a maximum of 9 Runs of retrieval 31 The EUMETSAT A Graphical User Interface DocID NWPSAF MF UD 010 Satelite Appicetion Version 2 C NWP SAF for RTTOV v11 3 a is Date 2015 09 18 Numerical Weather Prediction etrieved profite sur arzhur x CMS Meteo fr eee File Help INFO True Profile File Name home pascale pythonworkspace rttov_gui_2 0 Bg Profile File Name nome pascale pythonworkspace rttov_gui_2 0 P Instrument run 1 amsua Satellite run 1 metop1 Channel selection un 1 1 2 3 45 6 7 8 9101112131415 Number of channels run 1 15 Surface Information on Background Profile Tskin 302 00 K Q 2m 24930 00 ppmv T 2m 298 70 K Surface Information on True Profile Tskin 302 00 K Q 2m 24930 00 ppmv T 2m 298 70 K Surface Information on Retrieved Profiles run 1 Tskin 320 70 K Q 2m 24946 68 ppmv T 2m 299 00 K pressure hPa X Axis Channels ROO GB Fig 3 2 2 True BT Background BT 32 ect A Graphical User Interface DociD NWPSAF MF UD 010
20. eparately from the RTTOV GUI with the radr h5 file containing the results of a RTTOV run this file are kept by default in the HOMF rttov directory python rview radianceframe py radr h5 radr2 h5 Interactive navigation The toolbar at the bottom of the radiance window is the standard matplotlib tool bar it allows you to zoom and navigate the figure and save plots as image files 24 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 ee NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction 2 10 Running RTTOV K and working with the K Matrix Frame It is possible to run the K model of RTTOV For this purpose select the RTTOV menu from the main window and then select Run RTTOV K This will save and overwrite the profile and run the K model If the run is successful a new window appears the K Matrix Window which display the result of the RTTOV K Model Fig 2 10 1 With every RTTOV K run a new window is displayed K Matrix Viewer run 2 sur arzhur220x cms meteo fr Eile Help A O e 6 692003 gt 8 WR KP T temperature Q water vapour 0 0015 0 0000 0 0015 0 0030 0 0045 0 0060 0 0075 CH4 CH4 LI LI O000 S9S 9 9Ss0000 MOCOOONSO ONAN 80 160 240 320 400 480 560 640 720 METOP 2 IASI T C 747 P 49 111 072 hPa k 6 64558e 06 mw cm 1 ster sq m K wn 831 500 en Figure 2 10 1 K Matrix window
21. i KP ie i 1 fed a Y Axis Emissivity o oo ck i cna KID 4 6 8 Revert X Axis channels Channel 01 Emissivity in 0 739 out 0 739 Figure 2 8 1 Surface Editor Window The File Menu of the Surface Editor Window allows you to load an atlas or to modify the value of emissivity or reflectance channel by channel Fig 2 8 2 After making changes you must select Apply changes from the File menu The computed emissivity reflectance values appear in red on the right hand panel The input values are in blue If an atlas is loaded the RTTOV model does not compute the emissivity or reflectance values 16 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satellite Application a NWP S AF Version 2 aA for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction Emissivity sur arzhur220x cms meteo fr Eile Help EMIS_IN EMIS_OUT CALCEMIS 0 739449 0 0 0 733020 0 0 0 915271 0 0 0 974937 0 0 0 977781 0 0 aa aa 4 ae 6 0 975466 0 0 8 ees 0 970726 0 0 0 966345 0 0 0 976278 0 0 0 975189 0 0 0 973498 0 0 0 731071 0 0 TTT TTT Figure 2 8 2 Edit Input Emissivity or BRDF Values Tip for check boxes write 1 to check the box and 0 or nothing to un check the box 17 The EUMETSAT or EMEA A Graphical User Interface Doc D NWPSAF MF UD 010 Satellite Application 7 NWP S AF Version 2 ks for RTTOV v11 3 Date 2015
22. ile Tale sisser anaa e a E E RERE E E a ro e E EE 37 4 3 How to create an HDF5 profile file from Fortran ssesssseseseesseeseessessressessrssreserseressersrsssesse 40 4 4 How to create an HDF5 profile file from ASCII text profile file eee eeseeeeesteeeeeteeees 40 5 Rep iting bugs and MAO sic232 et sauassatvanssaiisede eadsstamnetade raar Ka EEr aa EE ENER E Eien 42 The EUMETSAT A Graphical User Interface Doc ID AO tence Satelite Application Version NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction 1 Introduction This document explains how to install and run the graphical user interface of RTTOV This interface allows the user to modify an atmospheric profile run RTTOV for a given instrument to produce the radiances and brightness temperatures and visualize the results instantly 1 1 Installation Using RTTOV GUI requires the following software to be installed python2 7 http www python org download wx python version 2 9 5 http www wxpython org numpy http scipy org Download matplotlib with backend_wxagg http matplotlib org h5py version 2 0 or later http www h5py org HDF5 v1 8 8 or later http www hdfgroup org HDF5 RTTOV v11 3 The GUI also requires the f2py package to interface the Fortran and Python code This is distributed as part of Numpy v1 6 and later An easy way to install python 2 7 and all the python required packages is to use the an
23. l main RTTOV GUI actions are logged in a file named rttovgui log in the RTTOV_GUI_WRK_DIR directory If the user encounters an issue during the RTTOV GUI usage he should exit the program and copy the log file to a new name This log file should be attached to any request to the help desk or forum We encourage the users to share experiences through the RTTOV forum at http www nwpsaf eu forum Restrictions Itis not possible to enter explicit cloud aerosol optical parameters profiles for each channel The RTTOV GUI is not compatible with RTTOV SCATT Known bugs or current limitations For the K calculations only atmospheric gases atmospheric temperature and TSkin variables are displayed 42
24. lated from total radiance N A e REFL CLEAR Reflectance calculated from clear radiance N A It is possible to choose different types of visualisation byChannel For each run view of all charts with all channels values fig 2 9 1 In this view you can select e Run to choose a run needs at least 2 different runs e Pseudo Run To see the difference between two successive runs needs at least 2 different runs fig 2 9 2 byRun For each channel view of all charts with all runs values In this view you can select e Channel to choose a channel e Pseudo Channel for channel combinations OnePlot View of one chart fig 2 9 3 In this view you can select e The parameter TOTAL BT REFL CLEAR choose a chart type e Run to choose a run e Pseudo Run difference between two successive runs e Channel to choose a channel e Pseudo Channel for channel combinations 19 mae A Graphical User Interface ai NWP SAF for RTTOV v11 3 2015 09 18 Numerical Weather Prediction Figure 2 9 2 Radiance window by Channel view 20 ene A Graphical User Interface Dec D NWPSAF MF UD 010 Satelite Application NWP S AF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction ofin byoranne_Oneh BT y f Run v ret mun 0Ol v run_o2 run_Ol vw f Channel f Pseudo channel v H OO SB Figure 2 9 3 Radiance windo
25. lication acilities gt NWP SAF Numerical Weather Prediction OPTIONS sur arzhur220x cms meteo fr Eile Help General configuration options verbose do_checkinput General RT options O addrefrac O switchrad use_q2m O do_lambertian O addsolar O do_nite_correction O addaeros C addclouds cldstr_threshold 1 000 E O ozone_data O co2_data O n20_data O co_data O ch4_data VIS IR only RT options PC RTTOV options O addpe ffun spectrum v ipcbnd fa ipcreg O addradrec MW only RT options 5 fastern_version O supply_foam_fraction O clw_data Interpolation and vertical grid options addinterp 5 Rochon Log lin WF _y nterp_mode spacetop O Igradp reg_limit_extrap rever _ Ay Figure 2 6 1 Option Editor window 11 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application a NWP SAF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction 2 7 Modifying the profile The profile can be modified through the profile editor window Select Profile Editor Window from the Windows menu of the main windows Figure 2 7 1 displays an example of the profile editor window showing the atmospheric gas profiles Figures 2 7 2 and 2 7 3 display examples for aerosol and cloud profiles respectively Aerosol components and cloud types are described in the RTTOV
26. ments For any subsequent run you can select pseudo run such as run 02 minus run 01 or nun 02 versus run 01 to see the spectrum differences see fig 2 9 6 spectrum difference between run 02 with addsolar and run 01 without addsolar You must keep the Radiance Viewer window open between runs in order to compare results from multiple runs Once the Radiance Viewer window has been closed previous results are lost 23 The EUMETSAT i A Graphical User Inte rface Doc ID NWPSAF MF UD 010 Satelite Application z NWP S A F Version 2 for RTTOV v11 3 Date i 2015 09 18 Numerical Weather Prediction adiance Viewer sur arznur x CMS Meteo Tr Eile Help byChannel OnePlot BT h Run v Ref Run v Jrun_o2 minus n 300 BT run 02 minus run 01 290 BT_run_01 K N A i g 3 2 i l 5 E E y 3 a amp N w o N N ke 1000 wavenumber cm 1 ROO eB METOP 2 IASI Figure 2 9 6 Radiance window for hyperspectral instruments difference between 2 runs with and without addsolar Instrument change or channel selection If you change the instrument by loading a new coefficient file or if you select channels with the Select Channels command of the RTTOV menu the active radiance window which displays the results of a previous RTTOV run will be closed by RTTOV GUI Radiance window command line functionality It is also possible to launch the radiance window s
27. n SUNZENANGLE Dataset 1 ELEVATION Dataset 1 S2M Group S2M O Dataset 1 S2M P Dataset 1 S2M Q Dataset 1 S2M T Dataset 1 S2M U Dataset 1 S2M V Dataset 1 S2M WFETC Dataset 1 SKIN Group SKIN FASTEM Dataset 5 SKIN FOAM_FRACTION Dataset 1 SKIN SALINITY Dataset 1 SKIN SURFTYPE Dataset 1 SKIN T Dataset 1 SKIN WATERTYPE Dataset 1 The OPTIONS group contains a copy of the RITOV option structure see the module src main rttov_type F90 and RTTOV user s guide There is only one option structure in the HDF5 file even if several profiles are stored in This OPTIONS group is optional All RTTOV options variables should be present The logical variables are converted to integer datasets where true is converted to 1 and false converted to 0 Note that the RTTOV options substructures are packed all together in the same group Name HDF5 type Dimension APPLY_REG_LIMITS Dataset 1 VERBOSE Dataset 1 DO_CHECKINPUT Dataset 1 35 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application NWP S A F f Version 2 Mtoe Wooher Redon or RTTOV v11 3 Date _ 2015 09 18 ADDPC Dataset 1 ADDRADREC Dataset 1 IPCBND Dataset 1 IPCREG Dataset 1 ADDREFRAC Dataset 1 SWITCHRAD Dat
28. n instrument you want to work with For this purpose you have to pick a coefficient file using the RTTOV menu Load coefficient figure 2 4 1 You must choose a file by clicking on the Choose button An RTTOV coefficient file is always mandatory If you want to work with aerosols you must choose an aerosols coefficient file and if you want to work with clouds you must choose a cloud coefficient file All these files must be compatible i e they must be for the same instrument and contain coefficients for the same channel set Once your choices have been made you can load the coefficient files by clicking on the Load button or by clicking on the File menu and selecting the Load coefficient menu item The EUMETSAT 2 A Graphical User Interface Doc ID NWPSAF MF UD 010 Satellite Appication a NWP S AF Version 2 lt for RTTOV v11 3 Numerical Weather Prediction Date 7 201 5 09 1 8 oefficients Files sur arzhur x cms meteo OON File Help Choose the coefficients file name and load them RTTOV coefficient file rtcoef_msg_4_seviri dat Choose Clear Aerosols coefficient file Choose Clear Clouds coefficient file Choose Clear PC coefficient file Choose Clear Load Apply Drop Figure 2 4 1 choose a coefficient file When the coefficient files are successfully loaded by RTTOV an information window appears figure 2 4 2 The log in the main windo
29. neneanatieeanntedeisntoawdanaiedcs 5 2 3 Starting Me CI aa ct er er r e AE nad RE A rRe ae bash EE E god dna ea REE RS 6 24 Loading RTTOV co fficient MUGS 2 5 5 5 tieren rinonrori aterase ersen ea Sn EEEE EEES EER Ea 1 2 5 Open a Pr fil nsnsenouniesanarn an a R E E NEE E 8 2 6 Modifying the options eseseeeesesseseeessessesseesersseessersessesssesseesorssenseesoessesseesorssevsoessrssensoesseseree 10 2 7 Modifying the profile esasnenen on rE A E R E a a a 12 2 8 Editing the SUIT ACE Ss siessen e a E Ee E E Ee AE PE A Ee A ATES E EEE ai 16 2 9 Running RTTOV Direct Model and working with the Radiance Frame eeeseeeeseeeeeee 18 2 10 Running RTTOV K and working with the K Matrix Frame esseeeeeesesesseesesessseseressrsssesse 25 2 11 Running PC RTTOV Principal Component cccccsseceseeeseeeeceseeceseeseseeeeseeaeeeeenneeeees 27 2 12 R nning PC RTTOV Keeseren n E Ear AEAEE EE ARNEE 28 2 13 Colour c stomisdH OMS ereire ui ees coins eect a a a ee 28 ae f nc onaliti Ss sacarina EE EE EA EEE AN A EEA NR TOE EERENS 29 2 L AMUTOGUCUOIS AE E E ean 29 3 2 Running the RTTOV GUI 1DVAR sesesesesseseseeerseserteststetreesertnetetetnestrenersterneestetnerereereeesteeet 29 3 3 Algorithm Descripti N ssss essei irrsesi itna a EE AEE E ERAR E E 31 4 Input Profile file TOTAL gece soes ined ecsaovten oer iieu eena ease ec E A A R E eaves 33 A AAD S profile Tike Wom sssrin a a Ee pi a T aR E a EEEE 33 4 2 ASGIU Text prof
30. omponents profiles are drawn separately You can modify the profile by hand by clicking in the panel For that select and visualize a component profile on the right panel Click the middle mouse button to modify the profile The closest point on a profile pressure level or layer is moved to the new value The corresponding curve in the left hand panel is also updated In the right hand panel you can also click with the left mouse button and drag a zone to zoom in Click the right button to zoom out Finally apply your changes or save the profile for the next run of RTTOV using the File menu 14 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 ateli Apakan Version 2 NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Prediction Edit menu options Undo undo the last modification of the curve Redo redo the last modification of the curve Insert For aerosols or clouds only clicking in the right hand panel moves or creates a new point Remove For aerosols or clouds only clicking in the right hand panel removes the nearest point sets the nearest layer concentration to zero Edit x axe Change the X axis bounds Add gas Add a gas Remove gas Remove a gas Add aerosol Add an aerosol particle type Remove aerosol Remove an aerosol particle type Add cloud Add a cloud particle type Remove cloud Remove a cloud particle type Replace aerosol by clim Replace all aerosol profiles wi
31. r modified by user e radr h5 contains radiances computed by a run of RTTOV e trs h5 contains transmittances computed by a run of RTTOV e kmat hS contains the K matrix computed by a run of RTTOV K e pc h5 contains the pcscores computed by a run of PC RTTOV The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 tite Application Version 2 C NWP SAF for RTTOV v11 3 Date 201509 18 Numerical Weather Prediction e pckmat h5 contains the K PC matrix computed by a run of PC RTTOV K e tmpFileErr log last RTTOV error log file e tmpFileOut log last RTTOV output log file e rttovgui log RTTOVGUI log file 2 3 Starting the GUI source rttov gui env rttovgui The RTTOV GUI main window is launched see Figure 2 3 1 it allows you to load coefficient files through the RTTOV menu to open a profile through the File menu to modify options profile and surface parameters if necessary through the dedicated windows available through the Windows menu and to run the RTTOV direct model through the RTTOV menu The application log is displayed in this main window The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 mens C NWP SAF for RTTOV v11 3 Paes lt a one Numerical Weather Prediction sur arznur Eile Windows Rttov 1Dvar Help 2015 09 07 13 10 31 Welcome Figure 2 3 1 main window 2 4 Loading RTTOV coefficient files The first step is to choose a
32. s capital letters The skin and s2m sub structures are HDF5 subgroups which contain the variables corresponding to those sub types of the RTTOV profile structure see the table below Name HDF5 type Dimension Comment ID Dataset SCALAR DATE Dataset 3 TIME Dataset 3 NLAYERS Dataset 1 NLEVELS Dataset 1 CTP Dataset 1 33 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application NWP S A F f Version 2 Mtoe Wooher Redon or RTTOV v11 3 Date _ 2015 09 18 CFRACTION Dataset 1 CLOUD Dataset nlayers 6 optional CFRAC Dataset nlayers optional ICEDE Dataset nlayers optional IDG Dataset 1 ISH Dataset 1 CLW optional never used in GUI AEROSOLS Dataset nlayers 13 optional P Dataset nlevels T Dataset nlevels Q Dataset nlevels 03 Dataset nlevels optional CO2 Dataset nlevels optional N20 Dataset nlevels optional CO Dataset nlevels optional CH4 Dataset nlevels optional BE Dataset 1 COSBK Dataset 1 SNOW_FRAC Dataset 1 SOIL_MOISTURE Dataset 1 LATITUDE Dataset 1 LONGITUDE Dataset 1 AZANGLE Dataset 1 ZENANGLE Dataset 1 SUNAZANGLE Dataset 1 34 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 SoeliteAppeation NWP SAF for RTTOV v11 3 Date 20150918 Numerical Weather Predictio
33. th a climatological aerosol selection The user can choose between different types of climatology see fig 2 7 4 Choose climatology Continental clean Continental average Continental polluted Urban Desert Maritime clean Maritime polluted Maritime tropical Arctic Antarctic Y cence ok Figure 2 7 4 Climatology choices for aerosols 15 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 mme NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction 2 8 Editing the surface The Surface Editor Windows allows you to modify the surface parameters of the profile Select the Surface Editor Window menu item from the windows menu of the main window Fig 2 8 1 SURFACE sur arzhur220x cms meteo fr Eile Help lie profile datasets py cldaer10 llev_allgas OO1 Emissivity Surface BRDF DATE 01 01 2014 M S2M parameters AOO 8 TIME 60 00 00 T 298 700 LATITUDE 47 400 Q 24930 00 LONGITUDE 10 927 Cfo o2z29 FE ELEVATION 0 000 P 950 000 AZANGLE 0 000 Ufs oo0 E ZENANGLE 45 000 V 2 000 SUNAZANGLE 179 000 WFETC 100000 0 SUNZENANGLE 40 000 SKIN parameters CFRACTION Jo 600 SURFTYPE fana BE 0 201 WATERTYPE fresh water COSBK o coo T 302 000 f CTP 949 000 SALINITY 35 000 f IDG ou and Lio FOAM_FRACTION fo coo ISH Hexagonal crystals Fastem parameters SNOW_FRAC fo coo E Defaut SOIL_MOISTURE 0 000 ET
34. v11 users guide section 8 6 and in section 8 5 respectively PROFILE EDITOR sur arzhur220x cms meteo fr File Edit Help AEROSOLS Ie mm Q 03 CO2 CH4 CO N20 INSO waso SOOT Temperature K 240 pressure hPa amp g a N n 2 a 160 180 200 220 240 260 280 300 temperature K L 1 0 1 5 ppmv over moist air l ag Q gt cal Figure 2 7 1 Profile Editor window 12 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Application a NWP S AF Version 2 for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction Temperature K 220 240 pressure hPa 10 10 107 number density cm 3 Figure 2 7 2 Profile Editor window with aerosols PROFILE EDITOR sur arzhur220x cms meteo fr File Edit Help Temperature K 220 240 2 3 v wn 2 a 107 layer mean content g m3 Figure 2 7 3 Profile Editor window with clouds 13 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Ol ci Satelite Application Version 2 NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction The left hand panel of the window shows the atmospheric components profiles grouped by type Gases Aerosols and Clouds The Temperature profile is always drawn on the three types of panel On the right hand panel of the window the different c
35. w One Plot view run2 run1 21 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Version 2 Satellite Application Os sae i NWP SAF for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction In the byRun view you may enter your own formula to compute a pseudo channel for example you can compute the difference between two channels or more complicated formula Your formula will then appear in the Pseudo Channel list fig 2 9 4 Radiance Viewer sur arzhur2 20x cms meteo fr Eile Help byRun byChannel OnePict Channel fchn_10 chn_11 chn_10 chn_11 TOTAL formula_01 CLEAR formula 01 27 0 26 5 26 0 25 5 25 0 24 5 24 0 1 BT formula 01 4 BT CLEAR formula 01 1 REFL formula 01 REFL_CLEAR formula 01 E H oO0 eB MSG 4 SEVIRI Figure 2 9 4 Radiance window Compute a pseudo channel 22 The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satelite Appication NWP S AF Version 2 u for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction For high resolution sounders such as IASI AIRS or CrIS a spectrum is displayed when the direct model is run fig 2 9 5 For these instruments the X axis is labelled in wavenumber cm Eile Help byChannel OnePiot BT v run_o1 z Ref Run f Pseudo run H oO0 BB Figure 2 9 5 Radiance window for hyperspectral instru
36. w provides some information from the coefficient files such as the wave numbers and the reference temperatures of the instrument Figure 2 4 2 information window 2 5 Open a Profile The item Open Profile of the File menu of the main window permits you to open a profile stored in HDF5 format figure 2 5 1 If a profile file contains several profiles you will be asked to choose the profile number figure 2 5 2 A selection of HDF5 profiles from the RTTOV test suite can be found in rttov_tests profile datasets hdf The File menu item Open ASCII Profile allows you to read profiles stored in Python formatted ASCII files Section 4 below contains more information about the HDF5 and ASCII profile file formats The EUMETSAT A Graphical User Interface Doc ID NWPSAF MF UD 010 Satellite Application a NWP S AF Version 2 A for RTTOV v11 3 Date 2015 09 18 Numerical Weather Prediction B 4 B pascale pythonworkspace rttov_gui_2 0 PROFILES B aer101lev_allgas H5 204 3 KB 07 30 2015 aer101lev_03 H5 173 9 KB 07 30 2015 cld101lev_allgas H5 184 5 KB 07 30 2015 cld101lev_allgas_seaonly H5 184 5 KB 07 30 2015 cld101lev_o3 H5 154 3 KB 07 30 2015 cldaer101lev_allgas H5 252 4 KB 07 30 2015 cldaer101lev_03 H5 216 9 KB 07 30 2015 div52 H5 1 0MB 07 30 2015 div52_zen10deg H5 1 0MB 07 30 2015 div52_zen30deg H5 1 00MB 07 30 2015 div52_zen50deg H5 1 0 MB 07 30 2015 div83 H5 1 9MB 07 30 2015 standard51lev_co2 H5 97 3

RTTOV v11.3 GUI users` guide

Contents

Download Pdf Manuals

Related Search

Related Contents