############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.10 Release Notes # # 12 June 2015 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_10.txt 7991 This release note AAPP_update_7_10.tgz 121405 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.9. Alternatively, a full version of 7.10 is also available on the AAPP ftp site. The following user documents have been updated on the AAPP web site http://www.nwpsaf.eu/deliverables/aapp/index.html :- NWPSAF-MF-UD-002_Software.pdf Software Description NWPSAF-MF-UD-003_Formats.pdf Data formats NWPSAF-MF-UD-011_viirs-cris-mapping.pdf VIIRS-CrIS mapping description (new) 2. Main Changes --------------- - Addition of VIIRS to CrIS mapping. - Update to the CrIS SDR reader to get surface height and type. - Bug fix in Metop AHRPT processing. - Bug fixes in MAIA4. - Correct typos in the hdf5 encoders. 3. Installation --------------- To update an existing AAPP installation, the procedure is: a. Copy the 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_10.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_10.tgz | tar -xmf - c. Go to the AAPP_7 top directory and type make and optionally "make install" if you have a separate installation directory. If you are creating a new installation, the sequence is either: (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 (as in steps a-b above), OR (1) unpack the full 7.10 release available from the ftp server 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" If you want to test the VIIRS to CrIS mapping, there is a new test case on the AAPP ftp server, called viirs_to_cris.tgz. Also, we have found that on some installations the MAIA4 fails when used with recent GFS forecast files. Upgrading to the latest verison of GRIB_API (from ECMWF) solves the problem. 4. License ---------- To use this software, users need to have registered for AAPP v7 with the NWP SAF (www.nwpsaf.eu), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ The source package (AAPP_update_7_10.tgz) corresponds to Subversion Revision 449 in the AAPP repository held at the Met Office. 6. Detailed list of changes from v7.9 (r438) to v7.10 (r449) ----------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/maia4/libmaia4/maia_Read_Prev.F90 Re-instate test for HASNT_LIBGRIB_API (accidentally removed from v7.9). M metop-tools/src/libmetop_common/common-main.c Bug fix for sequence number wrap-around. Mainly affects AVHRR: some passes were not processed in full. M AAPP/include/cris_sdr.h M AAPP/src/tools/bin/Makefile M AAPP/src/tools/bin/cris_sdr.c M AAPP/src/tools/bin/cris_sdr.ksh M AAPP/src/tools/libaapphdf5/cris_sdr_out.F Increase CRIS_GRANULES from 15 to 20. Get the surface height and type from AAPP data files. M AAPP/src/tools/libaapphdf5/ama1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/ama1d_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/amb1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/amb1d_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/avh1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrp1b_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrs1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrs1d_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/iasi1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/iasi1d_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/iasipc_to_hdf5_write.c Correct typo: "azimuth" was mis-spelt "azimith" in names of output datasets. M AAPP/src/decommutation/bin/Makefile A AAPP/src/decommutation/bin/unpack_timestep_hrpt.F A AAPP/src/decommutation/bin/unpack_timestep_hrpt.ksh Tool to unpack Timestep HRPT files (based on unpack_noaa_hrpt.F) M AAPP/include/mwhs1c.h M AAPP/src/preproc/bin/Makefile A AAPP/src/preproc/bin/mwhs_beamwidth.F A AAPP/src/preproc/bin/mwhs_beamwidth.ksh M AAPP/src/preproc/libatovpp/Makefile M AAPP/src/preproc/libatovpp/modify_beamwidth.F A AAPP/src/preproc/libatovpp/mwhs_beamwidth.dat New spot averaging utility for MWHS (on FY-3B satellite). Works in the same was as mwhs2_beamwidth for FY-3C. Extend modify_beamwidth to allow averaging equivalent to an even number of spots: the BT of a spot is replaced by a weighted mean of the neighbouring spots (e.g. when the averaging number is 2 then the weights for the adjacent spots in that line are 0.25, 0.5, 0.25). When an odd number of spots is specified, boxcar weighting is used (as before). M AAPP/include/satid.h Increase maxsatid from 30 to 40, for future use. M AAPP/src/navigation/bin/antcnft.F Increase satmax from 5 to 10. (This tool identifies the acquisition conflicts for a single antenna system). M AAPP/src/maia4/bin/maia_Viirs.F90 M AAPP/src/maia4/libmaia4/maia_Analyse_Field.F90 M AAPP/src/maia4/libmaia4/maia_Box_GetTopo.F90 M AAPP/src/maia4/libmaia4/maia_Fill_Input.F90 M AAPP/src/maia4/libmaia4/maia_GetPrev.F90 M AAPP/src/maia4/libmaia4/maia_ValMin.F90 M AAPP/src/maia4/libmaia4/mod_maia_types.F90 M AAPP/src/maia4/libmaia4/maia.F90 M AAPP/src/maia4/libmaia4/mk_voisinage.F90 M AAPP/src/maia4/libmaia4/maia_Read_GribApi.F90 M AAPP/src/maia4/libmaia4/maia_VerifMissing_fields.F90 M AAPP/src/maia4/libmaia4IO/maia_IO_Viirs_h5.F90 MAIA4 bug fixes: mk_voisinage.F90: on some systems, maia_Viirs.exe failed on incomplete granules (last or first granule of a pass). maia.F90: comment out call to maia_Cloud_Phase. maia_Read_GribApi.F90: core dump after grib change (new levels in arpege gribs). maia_VerifMissing_fields.F90: missing mandatory field for twilight. maia_IO_Viirs_h5.F90: inconsistency between code and documentation CloudMask bit 5-6. maia_Viirs.F90 and maia_Fill_Input.F90: bug fix data with bad QF1 quality flag mod_maia_types.F90: add new members in some fields maia_IO_Viirs_h5.F90: bug fix dataset fov_qual maia_Analyse_Field.F90 and maia_Box_GetTopo.F90: fix granule over longitude 180 maia_ValMin.F90: add new subroutine to compute lonmin/lonmax maia_GetPrev.F90: bug fix if debug mode M AAPP/Makefile M AAPP/src/maia4/bin/Makefile A AAPP/src/maia4/bin/viirs_to_cris.F90 A AAPP/src/maia4/bin/viirs_to_cris.ksh A AAPP/src/maia4/libmapviirscris/Makefile A AAPP/src/maia4/libmapviirscris/map_viirs_adjacency_def.F90 A AAPP/src/maia4/libmapviirscris/map_viirs_adjacency_mod.F90 A AAPP/src/maia4/libmapviirscris/map_viirs_cris_def.F90 A AAPP/src/maia4/libmapviirscris/map_viirs_cris_mod.F90 A AAPP/src/maia4/libmapviirscris/mapping_viirs_cris.fdf M AAPP/src/preproc/libatovpp/Makefile A AAPP/src/preproc/libatovpp/cris1c1d.F VIIRS to CrIS mapping. See new document NWPSAF-MF-UD-011 "VIIRS-CrIS mapping".