############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.3 Release Notes # # 15 Nov 2018 # # # ############################################################################## 1. Package contents ------------------- NWP SAF software is normally made available to registered users via the "software downloads" section of the NWP SAF web site (linked from the top bar of http://nwp-saf.eumetsat.int or https://www.nwpsaf.eu/site/). AAPP updates are available in two forms: (i) as an incremental update, for users who are updating an existing installation, or (ii) as a full release. The incremental update comprises the following files: (sizes in bytes): RELEASE_NOTE_AAPP_8_3.txt 12835 This release note AAPP_update_8_3.tgz 816279 Changed source code files The full release comprises: AAPP_8.3.tgz 11502584 Source code and data files 2. Main Changes --------------- - Add support for Metop-C (calibration data files, MAIA, etc.) - Add VIIRS cluster analysis when mapping VIIRS to CrIS. This was a request from the International TOVS Study Conference. - Provisional support for FY-3D, based on a pre-operational sample of global data. Not yet tested with direct broadcast data. Documentation update (see the AAPP "Documentation" web page): NWPSAF-MF-UD-011 - VIIRS to CrIS mapping. Information about the cluster analysis has been added. Test case update (see the AAPP "Download" page https://www.nwpsaf.eu/site/software/aapp/download/): viirs_to_cris.tgz - new script viirs_to_cris_withMAIA4_and_clusters.sh MAIA data file update (see the AAPP "Download" page): AAPP_MAIA4_thresholds_v8.tgz - addition of Metop-C thresholds. Note: The CrIS clusters output is to an hdf5 file (see test case). The intention is that the information on the mapped VIIRS radiances will eventually be included in the CrIS BUFR files (full spectral resolution version), as the BUFR sequence already has slots allocated. This functionality will be added in AAPP v8.4. 3. Installation --------------- 3.1 Updating an existing AAPP installation ------------------------------------------ To update an existing installation: a. Copy the update release tgz file 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_8.3.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8.3.tgz | tar -xmf - c. Go to the AAPP_8 top directory and type make and optionally "make install", if you have a separate installation directory. d. If you want to run MAIA, you should download and unpack the updated thresholds file (see section 2). 3.2 Creating a new installation ------------------------------- If you are creating a new installation, the sequence is: (1) unpack the full 8.3 release (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 run MAIA, you should download and unpack the necessary data files that are linked from the AAPP downloads web page (https://www.nwpsaf.eu/site/software/aapp/download/). 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 linked from the AAPP downloads web page. 4. License ---------- To use this software, users need to have registered for AAPP v8 with the NWP SAF (http://nwp-saf.eumetsat.int), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ Version control information is stored in a AAPP_version.txt file in the top directory ($AAPP_PREFIX). It is generated automatically at the release preparation stage. AAPP_version.txt contains: 8.3 Last Changed Rev: 600 Last Changed Date: 2018-11-13 09:13:41 +0000 (Tue, 13 Nov 2018) 6. Detailed list of changes from v8.2 (r588) to v8.3 (r600) ----------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M configure Update for recent versions of perl. Add NASA TLEs in ATOVS_ENV8 (uncomment if you want to use them). Add M03. M AAPP/src/navigation/bin/get_tle.ksh Remove unwanted carriage returns from NASA TLEs. M AAPP/src/calibration/libmhscl/mhs_clparams.dat NOAA-19 MHS channel 3 space view counts gross limit raised from 28000 to 32000. M AAPP/src/calibration/libavhrcl/avh_lbc.F Correct a comment M AAPP/src/preproc/libatovpp/ppapcp.F M AAPP/src/preproc/libatovpp/pphapcp.F Don't set scat or crosby flags in level 1d for Metop-B with failed AMSU 15 M AAPP/src/navigation/libnavtool/stations.txt Add rothera M AAPP/src/tools/bin/aapp_encodebufr_1c.F For BUFR encoding of level 1D CrIS/ATMS, revert to data category 3, sub-categories 40 and 30, for continuity with existing level 1D applications. No change to level 1C encoding. M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_cris.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_crisfsr.F Add missing allocate statements M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_atms.F Skip any scans that do not have valid scan time, in order to ensure that BUFR Section 1 is always valid M AAPP/src/tools_eccodes/bin/eccodes_encodebufr_1c.ksh export ECCODES_BUFR_SET_TO_MISSING_IF_OUT_OF_RANGE=1 M AAPP/src/tools_eccodes/bin/eccodes_decodebufr_1c.F Set skipExtraKeyAttributes for improved decoding speed with ecCodes v2.9.0 onwards. No effect with earlier versions. M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_iasi.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_pciasi.F Add out-of-range checking for quality flags M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_mwri.F Minimum surface height -400m M AAPP/include/mwts2_sdr.h A AAPP/include/mwri2_sdr.h M AAPP/src/preproc/libatovpp/map_mwhs2_to_mwts2.F M AAPP/src/preproc/libatovpp/map_mwts2_to_mwhs2.F M AAPP/src/tools/libaapphdf5/Makefile M AAPP/src/tools/libaapphdf5/mwhs2_sdr_out.F M AAPP/src/tools/libaapphdf5/mwhs2_sdr_read.c M AAPP/src/tools/libaapphdf5/mwhs_channels.dat M AAPP/src/tools/libaapphdf5/mwri_channels.dat M AAPP/src/tools/libaapphdf5/mwri_sdr_out.F M AAPP/src/tools/libaapphdf5/mwri_sdr_read.c M AAPP/src/tools/libaapphdf5/mwts2_sdr.intf.c-F M AAPP/src/tools/libaapphdf5/mwts2_sdr_out.F M AAPP/src/tools/libaapphdf5/mwts2_sdr_read.c M AAPP/src/tools/libaapphdf5/mwts_channels.dat A AAPP/src/tools/libaapphdf5/mwri2_sdr.intf.c-F A AAPP/src/tools/libaapphdf5/mwri2_sdr_out.F A AAPP/src/tools/libaapphdf5/mwri2_sdr_read.c M AAPP/src/tools/bin/Makefile A AAPP/src/tools/bin/mwri2_sdr.c M AAPP/src/tools/bin/mwri_sdr.ksh Updates for FY-3D (provisional). For MWRI, the number of spots in the HDF file has increased from 254 to 266. For consistency with the other FY-3 satellites, the extra spots are discarded in the l1c. M AAPP/src/calibration/libamsuacl/amsua_clparams.dat M AAPP/src/calibration/libavhrcl/avhcal.txt M AAPP/src/calibration/libmhscl/mhs_clparams.dat M AAPP/src/preproc/libatovin/fdf.dat M AAPP/src/tools/libsatid/satid.txt M AAPP/src/maia4/libmaia4/maia_SST.F90 Add Metop-C M AAPP/Makefile A AAPP/include/Nuees.h A AAPP/include/NueesParam.h A AAPP/include/cluster.interface A AAPP/include/clusters.h M AAPP/include/cris1c.h A AAPP/include/fortran-lock.h A AAPP/include/lapack-lite.h A AAPP/include/misc-complex.h M AAPP/src/maia4/bin/Makefile M AAPP/src/maia4/bin/viirs_to_cris.F90 M AAPP/src/maia4/bin/viirs_to_cris.ksh M AAPP/src/maia4/libaapp_viirs/aapp_hdf_mod.F90 M AAPP/src/maia4/libmapviirscris/map_viirs_adjacency_mod.F90 M AAPP/src/maia4/libmapviirscris/map_viirs_cris_def.F90 M AAPP/src/maia4/libmapviirscris/map_viirs_cris_mod.F90 M AAPP/src/maia4/libmapviirscris/mapping_viirs_cris.fdf M AAPP/src/preproc/libatovpp/cris1c1d.F A AAPP/src/preproc/libclusters A AAPP/src/preproc/libclusters/Makefile A AAPP/src/preproc/libclusters/NueesDynamiques.c A AAPP/src/preproc/libclusters/clusters.c A AAPP/src/preproc/liblapack-lite A AAPP/src/preproc/liblapack-lite/Makefile A AAPP/src/preproc/liblapack-lite/daxpy.F A AAPP/src/preproc/liblapack-lite/dbdsqr.F A AAPP/src/preproc/liblapack-lite/dcopy.F A AAPP/src/preproc/liblapack-lite/ddot.F A AAPP/src/preproc/liblapack-lite/dgebak.F A AAPP/src/preproc/liblapack-lite/dgebal.F A AAPP/src/preproc/liblapack-lite/dgebd2.F A AAPP/src/preproc/liblapack-lite/dgebrd.F A AAPP/src/preproc/liblapack-lite/dgeev.F A AAPP/src/preproc/liblapack-lite/dgehd2.F A AAPP/src/preproc/liblapack-lite/dgehrd.F A AAPP/src/preproc/liblapack-lite/dgelq2.F A AAPP/src/preproc/liblapack-lite/dgelqf.F A AAPP/src/preproc/liblapack-lite/dgelss.F A AAPP/src/preproc/liblapack-lite/dgemm.F A AAPP/src/preproc/liblapack-lite/dgemv.F A AAPP/src/preproc/liblapack-lite/dgeqr2.F A AAPP/src/preproc/liblapack-lite/dgeqrf.F A AAPP/src/preproc/liblapack-lite/dger.F A AAPP/src/preproc/liblapack-lite/dhseqr.F A AAPP/src/preproc/liblapack-lite/dlabad.F A AAPP/src/preproc/liblapack-lite/dlabrd.F A AAPP/src/preproc/liblapack-lite/dlacpy.F A AAPP/src/preproc/liblapack-lite/dladiv.F A AAPP/src/preproc/liblapack-lite/dlahqr.F A AAPP/src/preproc/liblapack-lite/dlahrd.F A AAPP/src/preproc/liblapack-lite/dlaln2.F A AAPP/src/preproc/liblapack-lite/dlamch.F A AAPP/src/preproc/liblapack-lite/dlange.F A AAPP/src/preproc/liblapack-lite/dlanhs.F A AAPP/src/preproc/liblapack-lite/dlanv2.F A AAPP/src/preproc/liblapack-lite/dlapy2.F A AAPP/src/preproc/liblapack-lite/dlarf.F A AAPP/src/preproc/liblapack-lite/dlarfb.F A AAPP/src/preproc/liblapack-lite/dlarfg.F A AAPP/src/preproc/liblapack-lite/dlarft.F A AAPP/src/preproc/liblapack-lite/dlarfx.F A AAPP/src/preproc/liblapack-lite/dlartg.F A AAPP/src/preproc/liblapack-lite/dlas2.F A AAPP/src/preproc/liblapack-lite/dlascl.F A AAPP/src/preproc/liblapack-lite/dlaset.F A AAPP/src/preproc/liblapack-lite/dlasq1.F A AAPP/src/preproc/liblapack-lite/dlasq2.F A AAPP/src/preproc/liblapack-lite/dlasq3.F A AAPP/src/preproc/liblapack-lite/dlasq4.F A AAPP/src/preproc/liblapack-lite/dlasq5.F A AAPP/src/preproc/liblapack-lite/dlasq6.F A AAPP/src/preproc/liblapack-lite/dlasr.F A AAPP/src/preproc/liblapack-lite/dlasrt.F A AAPP/src/preproc/liblapack-lite/dlassq.F A AAPP/src/preproc/liblapack-lite/dlasv2.F A AAPP/src/preproc/liblapack-lite/dnrm2.F A AAPP/src/preproc/liblapack-lite/dorg2r.F A AAPP/src/preproc/liblapack-lite/dorgbr.F A AAPP/src/preproc/liblapack-lite/dorghr.F A AAPP/src/preproc/liblapack-lite/dorgl2.F A AAPP/src/preproc/liblapack-lite/dorglq.F A AAPP/src/preproc/liblapack-lite/dorgqr.F A AAPP/src/preproc/liblapack-lite/dorm2r.F A AAPP/src/preproc/liblapack-lite/dormbr.F A AAPP/src/preproc/liblapack-lite/dorml2.F A AAPP/src/preproc/liblapack-lite/dormlq.F A AAPP/src/preproc/liblapack-lite/dormqr.F A AAPP/src/preproc/liblapack-lite/drot.F A AAPP/src/preproc/liblapack-lite/drscl.F A AAPP/src/preproc/liblapack-lite/dscal.F A AAPP/src/preproc/liblapack-lite/dswap.F A AAPP/src/preproc/liblapack-lite/dtrevc.F A AAPP/src/preproc/liblapack-lite/dtrmm.F A AAPP/src/preproc/liblapack-lite/dtrmv.F A AAPP/src/preproc/liblapack-lite/idamax.F A AAPP/src/preproc/liblapack-lite/ieeeck.F A AAPP/src/preproc/liblapack-lite/ilaenv.F A AAPP/src/preproc/liblapack-lite/lapack-lite.c A AAPP/src/preproc/liblapack-lite/lapack-lite.c-F A AAPP/src/preproc/liblapack-lite/lsame.F A AAPP/src/preproc/liblapack-lite/xerbla.F M iasi-tools/src/bin/Makefile A iasi-tools/src/bin/convert_iasi1c_hdf5.c A iasi-tools/src/bin/convert_iasi1c_hdf5.ksh M iasi-tools/src/libeps_iasil1c_9.0/eps_iasil1c_9.0.c M metop-tools/src/bin/eps_avhrrl1b-main.c M metop-tools/src/libeps_common/eps_buffer.c M metop-tools/src/libeps_common/eps_grh.c VIIRS-CrIS cluster analysis