############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.11 Release Notes # # 26 Nov 2015 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_11.txt 11204 This release note AAPP_update_7_11.tgz 157048 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.10. Alternatively, a full version of 7.11 is also available on the AAPP ftp site. 2. Main Changes --------------- - Additional l1c to hdf5 convertors. - For AMSU, MHS, HIRS, compute NEDT as part of atovin, and add "-N" option in aapp_encodebufr_1c to encode this information. - AMSU-A calibration update (NOAA-18). - Correction to the FY-3 BUFR sequence. - Support NOAA-9 and NOAA-10 AVHRR. - Bug fixes and portability fixes. Note: The routine encoding of NEDT for ATOVS is planned by EUMETSAT, but coordination is still needed to ensure that the AAPP solution is consistent with EUMETSAT's. There may be future changes to AAPP in this regard. 3. Installation --------------- 3.1 Updating an existing AAPP installation ------------------------------------------ To update an existing installation, the procedure is similar to that normally used, but note the additional step in step c to remove certain *.c files that are missed by the "make clean" step. 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_11.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_11.tgz | tar -xmf - c. Go to the AAPP_7 top directory and type cd AAPP; make clean_obj; cd .. #Remove any .c files that match a .c-F and are missed by the "make clean" #Assume working in ksh, bash or sh. for file in AAPP/src/tools/libaapphdf5/*.c-F; do rm -f ${file%-F}; done make and optionally "make install" if you have a separate installation directory. 3.2 Creating a new installation ------------------------------- 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, 7.11 (as in steps a-b above), OR (easier) (1) unpack the full 7.11 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" 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 ftp server. 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_11.tgz) corresponds to Subversion Revision 470 in the AAPP repository held at the Met Office. 6. Detailed list of changes from v7.10 (r449) to v7.11 (r470) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Lower the gross limits for NOAA-18 AMSU channels 5 and 8 Relax earth pointing tolerance for NOAA-18 AMSU-A1-1. M AAPP/src/calibration/libmhscl/mhs_iwttmp.F Change t=float(ICHAR()) to t=ICHAR() for portability M AAPP/src/calibration/libmhscl/mhs_avg.F Comment out diagnostics, for portability M AAPP/src/calibration/libavhrcl/avhcal.txt Add NOAA-9 and NOAA-10 AVHRR calibration information M AAPP/src/preproc/libatovpp/ppaind.F For MetOp-A do not set Aqc(bit0) if channel 8 missing (the channel is degrading) M AAPP/src/preproc/libatovpp/ppatms1.F Reduce ATMS BoxSize, used for surface type and elevation. The new value is more realistic. M AAPP/src/preproc/libatovpp/ppcristhin.F Bug fix: CrIS thinning modes 2 and 3 were not working properly M AAPP/src/tools/bin/Makefile M AAPP/src/tools/bin/convert_to_hdf5.ksh A AAPP/src/tools/bin/atms1c_to_hdf5.c A AAPP/src/tools/bin/cris1c_to_hdf5.c A AAPP/src/tools/bin/mwhs21c_to_hdf5.c A AAPP/src/tools/bin/mwts21c_to_hdf5.c A AAPP/src/tools/bin/iras1c_to_hdf5.c M AAPP/src/tools/libaapphdf5/Makefile M AAPP/src/tools/libaapphdf5/mwhs2_sdr_out.F M AAPP/src/tools/libaapphdf5/iras_sdr_out.F A AAPP/src/tools/libaapphdf5/atms1c_read.c-F A AAPP/src/tools/libaapphdf5/atms1c_read_f.F A AAPP/src/tools/libaapphdf5/atms1c_to_hdf5_write.c A AAPP/src/tools/libaapphdf5/cris1c_read.c-F A AAPP/src/tools/libaapphdf5/cris1c_read_f.F A AAPP/src/tools/libaapphdf5/cris1c_to_hdf5_write.c A AAPP/src/tools/libaapphdf5/mwhs21c_read.c A AAPP/src/tools/libaapphdf5/mwhs21c_read_f.F A AAPP/src/tools/libaapphdf5/mwhs21c_to_hdf5_write.c A AAPP/src/tools/libaapphdf5/mwts21c_read.c A AAPP/src/tools/libaapphdf5/mwts21c_read_f.F A AAPP/src/tools/libaapphdf5/mwts21c_to_hdf5_write.c A AAPP/src/tools/libaapphdf5/iras1c_read.c A AAPP/src/tools/libaapphdf5/iras1c_read_f.F A AAPP/src/tools/libaapphdf5/iras1c_to_hdf5_write.c M AAPP/include/mwhs21c.h A AAPP/include/atms1c_c.h A AAPP/include/cris1c_c.h A AAPP/include/mwhs21c_c.h A AAPP/include/mwts21c_c.h A AAPP/include/iras1c_c.h HDF5 converters for ATMS, CrIS, MWTS2, MWHS2 and IRAS. Called by the "convert_to_hdf5" script. They produce hdf5 files similar to those generated by the other AAPP convertors, i.e. the content is the same as the corresponding l1c file. Useful if you don't have access to the official NOAA or CMA SDR files (e.g. if your input files are BUFR). M AAPP/src/tools/libaapphdf5/ama1c_read.c-F M AAPP/src/tools/libaapphdf5/ama1c_read_f.F M AAPP/src/tools/libaapphdf5/ama1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/amb1c_read.c-F M AAPP/src/tools/libaapphdf5/amb1c_read_f.F M AAPP/src/tools/libaapphdf5/amb1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrs1c_read.c-F M AAPP/src/tools/libaapphdf5/hrs1c_read_f.F M AAPP/src/tools/libaapphdf5/hrs1c_to_hdf5_write.c M AAPP/include/ama1c_c.h M AAPP/include/amb1c_c.h M AAPP/include/hrs1c_c.h Add NEDT to the hdf5 output for AMSU, MHS and HIRS. M AAPP/src/tools/libaapphdf5/hrp1b_read_f.F M AAPP/src/tools/libaapphdf5/hrp1b_to_hdf5_write.c Add calvis and calir information to the hdf5 output for AVHRR (was missing). M AAPP/src/tools/libaapphdf5/iasi1c_read_f.F M AAPP/src/tools/libaapphdf5/iasipc_read_f.F Replace bad IASI latitude/longitude by missing value in l1c/lpc format (needed for DBNet monitoring) M AAPP/src/tools/libaapphdf5/mwhs2_sdr_out.F M AAPP/src/tools/libaapphdf5/iras_sdr_out.F M AAPP/src/tools/libaapphdf5/cris_sdr_out.F M AAPP/src/tools/libaapphdf5/atms_sdr_out.F Updates to SDR decoders: Correct the values of mwhs21c_h_instrument (19) and iras1c_h_enddatady Correct cris1c_h_startw and cris1c_h_endw; set cris1c_satxyz (was zero). Set atms1c_h_vnantennacorr to missing (was zero). M AAPP/src/tools/libaapphdf5/amb1c_read_f.F M AAPP/src/tools/libaapphdf5/avh1b_to_hdf5_f.F M AAPP/src/tools/libaapphdf5/hrs1c_read_f.F Add missing Id property (file identification in comment line) M AAPP/src/tools/libsatid/satid.txt Adjust Metop-B AVHRR misalignment angles and scan step, for consistency with Metop ground segment. Also change sign of Metop-A yaw angle. Update NOAA-9 and NOAA-10 mission end dates. M AAPP/src/maia3/bin/avhrrin.F Fix problem with scnlinbit for descending passes (bit 15=1) M AAPP/src/maia4/libmapviirscris/map_viirs_adjacency_mod.F90 Portability fix: pgf90 compiler gave an error when MYCOSLAT was a parameter array. Change it to a variable. M AAPP/src/maia4/libmaia4/maia_Cal_LeRoux.F90 Bug fix if diffsat=180 M AAPP/src/maia4/libmaia4/maia_Fill_Input.F90 Bug fix in the missing data control M AAPP/include/ama1c.h M AAPP/include/amb1c.h M AAPP/include/hrs1c.h M AAPP/include/inastore.h M AAPP/include/inbstore.h M AAPP/include/inhstore.h M AAPP/src/preproc/bin/atovin.F M AAPP/src/preproc/bin/atovin_antcorr.F M AAPP/src/preproc/libatovin/Makefile M AAPP/src/preproc/libatovin/inaget.F M AAPP/src/preproc/libatovin/inbget.F A AAPP/src/preproc/libatovin/inaget_nedt.F M AAPP/src/preproc/libatovin/inamsa.F M AAPP/src/preproc/libatovin/inamsb.F M AAPP/src/preproc/libatovin/inhirs.F A AAPP/src/preproc/libatovin/inaprc_nedt.F M AAPP/src/preproc/libatovin/inhget.F A AAPP/src/preproc/libatovin/inhget_nedt.F M AAPP/src/preproc/libatovin/inmhsget.F A AAPP/src/preproc/libatovin/inmhsget_nedt.F A AAPP/src/preproc/libatovin/inmhsprc_nedt.F In atovin, compute NEDT for AMSU-A, MHS and HIRS and store the result in l1c (in spare word slots of the format). Allow for difference between NESDIS and AAPP azimuth angles. M AAPP/src/tools/bin/aapp_encodebufr_1c.F M AAPP/src/tools/bin/aapp_encodebufr_1c.ksh M AAPP/src/tools/libaappbufr/aapp_get_1c_amsua.F M AAPP/src/tools/libaappbufr/aapp_get_1c_amsub.F M AAPP/src/tools/libaappbufr/aapp_get_1c_hirs.F M AAPP/src/tools/libaappbufr/aapp_get_1c_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1c_amsua.F M AAPP/src/tools/libaappbufr/aapp_put_1c_amsub.F M AAPP/src/tools/libaappbufr/aapp_put_1c_hirs.F Add an option to encode AMSU-A, MHS and HIRS NEDTs into BUFR, using back-references at the end of the existing BUFR sequence. Use the "-N" flag in aapp_encodebufr_1c to invoke this option. In aapp_encodebufr_1c.F, correct Timeoffset for MWHS2, MWTS2, MWRI, used when environment variable USE_OB_TIME=Y. Correct iras1c_h_instrument (16 -> 17) in aapp_get_1c_iras.F. M AAPP/src/tools/libaappbufr/define_mwts_mwhs.F M AAPP/src/tools/libaappbufr/aapp_get_1c_mwts.F M AAPP/src/tools/libaappbufr/aapp_get_1c_mwhs.F These should have been included in AAPP v7.7 but were omitted by mistake. The consequence is that FY-3 BUFR products generated prior to AAPP v7.11 have an inconsistent surface type: the descriptor should be 008012 (0=land, 1=sea, 2=coast), but although the codes had been changed the descriptor number remained at 013030, which had been in use prior to v7.7.