############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.14 Release Notes # # 21 Nov 2016 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_14.txt 10366 This release note AAPP_update_7_14.tgz 170933 source code This is an incremental update; users need to have downloaded and unpacked version 7.1 (the initial release of AAPP v7) and updates 7.2 to 7.14. Alternatively, a full version of 7.14 is also available to registered users in the "software downloads" section of the NWP SAF web site http://nwpsaf.eu. 2. Main Changes --------------- - Upgrade VIIRS cloud mask to MAIA v4.3 - AMSU-A calibration updates - New tools, resulting from user requests (see section 6 for details of "latlon_to_swath", "check_3A3B" and "bufr_centre_info.pl") 3. Installation --------------- 3.1 Updating an existing AAPP installation ------------------------------------------ To update an existing installation: a. Copy the update release tgz files to your AAPP top directory (i.e. the directory containing AAPP, metop-tools and iasi-tools) b. Unpack using the command tar -xvmzf AAPP_update_7_14.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_14.tgz | tar -xmf - c. Go to the AAPP_7 top directory and type cd AAPP; make clean_obj; cd .. make and optionally "make install", if you have a separate installation directory. (The "make clean_obj" step allows you to re-generate executables without deleting data). 3.2 Creating a new installation ------------------------------- If you are creating a new installation, the sequence is either: (1) unpack the full 7.14 release (recommended) OR (1a) unpack AAPP v7.1 and cd to the AAPP top directory (1b) unpack the update releases 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 7.10, 7.11, 7.12, 7.13, 7.14 (as in steps a-b above), Then (2) run "configure" (see chapter 3.4 of the AAPP Installation Guide), (3) run "make" (4) If you used the --prefix= option in configure, run "make install" To test a new installation, it is recommended to run some of the AAPP test cases, see Chapter 4 of the AAPP Installation Guide. The test cases are normally available on the AAPP web site at http://nwpsaf.eu/site/software/aapp/download/ 4. License ---------- To use this software, users need to have registered for AAPP v7 with the NWP SAF (http://nwpsaf.eu), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ Version control information is now stored in a AAPP_version.txt file in the top directory ($AAPP_PREFIX). It is generated automatically at the release preparation stage. In the future it is planned to append version information to the generated BUFR files. AAPP_version.txt contains: 7.14 Last Changed Rev: 507 Last Changed Date: 2016-11-18 13:22:35 +0000 (Fri, 18 Nov 2016) 6. Detailed list of changes from v7.13 (r495) to v7.14 (r507) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M Makefile Copy new file AAPP_version.txt when installing M AAPP/src/calibration/libamsuacl/amsua_clparams.dat M AAPP/src/preproc/libatovpp/ppaind.F Allow for failure of Metop-B AMSU channel 15. Update AMSU gross limits for NOAA-18 channel 1, NOAA-19 channels 1 & 7, Metop-A channel 3, Metop-B channel 3. M AAPP/src/tools/bin/aapp_encodebufr_1c.F M AAPP/src/tools/bin/aapp_encodebufr_1c.ksh M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/libaappbufr/aapp_put_1d_hirs.F New environment variable ISUBCENTREID which can be used to store the sub-centre in the data section of BUFR messages, for HIRS1D. Used for DBNet monitoring. M AAPP/src/tools/bin/Makefile A AAPP/src/tools/bin/latlon_to_swath.F A AAPP/src/tools/bin/latlon_to_swath.ksh M AAPP/src/navigation/libnavnoaa/invloc.F Tool to convert a series of lat/lon values from a text file (e.g. coastlines) to swath column/row coordinates. Update invloc so that results are only saved for the next call when the requested point is viewed by the satellite. Usage: latlon_to_swath l1bfile latlonfile A AAPP/src/tools/bin/bufr_centre_info.pl A tool to display the centre and subcentre from Section 1 of a BUFR message. Useful for DBNet data, to identify the reception station. Usage: bufr_centre_info.pl bufrfile A AAPP/src/tools/bin/check_3A3B.ksh A tool to examine the header record of an AVHRR .l1b file and display whether the instrument is set to use channel 3A or 3B (or whether there is a transition). Usage: check_3A3B l1bfile M AAPP/src/calibration/libavhrcl/avh_icon.F Extend the upper limit of channel 3B radiance range from 2 to 3 mW/m^2/sr/cm^-1, approx 330K to 342K. Note that BTs greater than 327.67K are reported negative in AVHRR level 1c/1d (as they are stored as 2-byte signed integers), but you can add 655.36K to make them correct. M AAPP/src/maia3/bin/avhrrin.F Fix array out of bounds error. M AAPP/src/tools/libaapphdf5/avh1c_to_hdf5_write.c Bug fix: the scale attribute of tsurf was wrong. M AAPP/src/maia4/bin/maia_Viirs.F90 M AAPP/src/maia4/libmaia4/Makefile M AAPP/src/maia4/libmaia4/maia.F90 M AAPP/src/maia4/libmaia4/maia_Analyse_Field.F90 A AAPP/src/maia4/libmaia4/maia_BoxEnv_reset.F90 M AAPP/src/maia4/libmaia4/maia_Box_GetTopo.F90 M AAPP/src/maia4/libmaia4/maia_Box_reset.F90 M AAPP/src/maia4/libmaia4/maia_CMa_CD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_CG.F90 M AAPP/src/maia4/libmaia4/maia_CMa_ConfClear.F90 M AAPP/src/maia4/libmaia4/maia_CMa_IceD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LN.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LT.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SG.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SN.F90 M AAPP/src/maia4/libmaia4/maia_CMa_ST.F90 M AAPP/src/maia4/libmaia4/maia_CMa_quality.F90 M AAPP/src/maia4/libmaia4/maia_CMa_texture.F90 M AAPP/src/maia4/libmaia4/maia_CT_Fl_opaq.F90 M AAPP/src/maia4/libmaia4/maia_CT_dawn.F90 M AAPP/src/maia4/libmaia4/maia_CT_day.F90 M AAPP/src/maia4/libmaia4/maia_CT_night.F90 M AAPP/src/maia4/libmaia4/maia_Cal_AtmCorrVis.F90 M AAPP/src/maia4/libmaia4/maia_Cal_CoxMunk.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Fresnel.F90 M AAPP/src/maia4/libmaia4/maia_Cal_LeRoux.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Roujean.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Texture.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Twvc.F90 M AAPP/src/maia4/libmaia4/maia_Cal_WaterIndex.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Mask.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Phase.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Pressure.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Type.F90 M AAPP/src/maia4/libmaia4/maia_ConfTest.F90 M AAPP/src/maia4/libmaia4/maia_Fill_Input.F90 M AAPP/src/maia4/libmaia4/maia_Fill_Output.F90 M AAPP/src/maia4/libmaia4/maia_Flag_Dust.F90 M AAPP/src/maia4/libmaia4/maia_Flag_ThinCirrus.F90 M AAPP/src/maia4/libmaia4/maia_Flag_VolcanAsh.F90 M AAPP/src/maia4/libmaia4/maia_GetClim.F90 M AAPP/src/maia4/libmaia4/maia_GetGlint.F90 M AAPP/src/maia4/libmaia4/maia_GetPrev.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CMa.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CMa_Land.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CMa_Sea.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CT.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CT_max06.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CT_max108.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_CT_opaq.F90 M AAPP/src/maia4/libmaia4/maia_GetThres_InPix.F90 M AAPP/src/maia4/libmaia4/maia_GetTopo.F90 M AAPP/src/maia4/libmaia4/maia_Get_AlbLand.F90 M AAPP/src/maia4/libmaia4/maia_Get_AlbSea.F90 M AAPP/src/maia4/libmaia4/maia_Get_AlbSnow.F90 M AAPP/src/maia4/libmaia4/maia_Inland_Water.F90 M AAPP/src/maia4/libmaia4/maia_Interp_InGrid.F90 M AAPP/src/maia4/libmaia4/maia_Interp_InLut.F90 M AAPP/src/maia4/libmaia4/maia_Interp_Plog.F90 M AAPP/src/maia4/libmaia4/maia_Lon_Norm.F90 M AAPP/src/maia4/libmaia4/maia_PixEnv_reset.F90 M AAPP/src/maia4/libmaia4/maia_Pixel_reset.F90 M AAPP/src/maia4/libmaia4/maia_Pr_InfoPix.F90 M AAPP/src/maia4/libmaia4/maia_Read_Clim.F90 M AAPP/src/maia4/libmaia4/maia_Read_GribApi.F90 M AAPP/src/maia4/libmaia4/maia_Read_IRThres.F90 M AAPP/src/maia4/libmaia4/maia_Read_Prev.F90 M AAPP/src/maia4/libmaia4/maia_Read_PrevConst.F90 M AAPP/src/maia4/libmaia4/maia_Read_Topo.F90 M AAPP/src/maia4/libmaia4/maia_Read_VISThres.F90 M AAPP/src/maia4/libmaia4/maia_ReflRatio_ToObs.F90 M AAPP/src/maia4/libmaia4/maia_SST.F90 M AAPP/src/maia4/libmaia4/maia_SnowIce_surf.F90 M AAPP/src/maia4/libmaia4/maia_Thres_reset.F90 M AAPP/src/maia4/libmaia4/maia_ValMin.F90 M AAPP/src/maia4/libmaia4/maia_ValMoy.F90 M AAPP/src/maia4/libmaia4/maia_VerifMissing_fields.F90 M AAPP/src/maia4/libmaia4/maia_reset_CMa.F90 M AAPP/src/maia4/libmaia4/maia_setup.F90 M AAPP/src/maia4/libmaia4/mk_voisinage.F90 M AAPP/src/maia4/libmaia4/mod_maia_const.F90 M AAPP/src/maia4/libmaia4/mod_maia_types.F90 Update to MAIA v4.3. This new version of maia4 offers improvements and more robustness. Some variables which were computed on the box resolution are now also computed at the pixel resolution. The code of the maia4 library is ready for the future addition of AVHRR processing (currently in maia3).