############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 6.12 Release Notes # # 24 February 2010 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): Required files: RELEASE_NOTE_AAPP_6_12.txt 16560 This release note AAPP_version_6_12.tgz 55028867 AAPP source code and data Optional file: AAPP_MAIA3_data.tgz 135320236 Data files for MAIA3 Optional file in the directory "test_cases_2010" on the AAPP ftp site: metopa_20100128.tgz 241202003 MetOp test case Documents: INSTGUID.tgz 49700 Updated AAPP Installation Guide (html files) NWPSAF-MO-UD-022_IASIPCs.pdf 173696 Document NWPSAF-MO-UD-022: "IASI Principal Components in AAPP: User Manual" AAPP version 6.12 is released as a complete package: it does not rely on versions 6.1 to 6.11. 2. Main Changes --------------- - Routine updates for MetOp, NOAA-15, NOAA-16 and NOAA-17. - Support for new format libraries associated with "Day 2" OPS-LRS. - Support new BUFR sequences 3-40-007 and 3-40-008 to be used with IASI global data and EARS-IASI respectively. - To support IASI Principal Components compression, for use in the EARS-IASI system and for users of the EARS-IASI data. - Support TOVS/ATOVS data archived at ECMWF. - New MAIA package to generate a full-resolution AVHRR cloud mask: see "MAIA AVHRR Cloud Mask and Classification" by L. Lavanant, www.meteorologie.eu.org/ici/maia/maia3.pdf The MetOp test case provides various scripts for exercising the new and existing routines. 3. Installation --------------- a. Copy the .tgz files to a suitable directory on your computer (referred to below as [dir]. Then cd to the location where you wish to install AAPP. b. Unpack AAPP_6_12.tgz using the command tar -xvmzf [dir]AAPP_6_12.tgz or if your system does not support the "-z" option in tar, use gunzip -c [dir]AAPP_6_12.tgz | tar -xmf - A top directory called AAPP_6.12 is created. You may re-name this if you wish (it was previously called AAPP_6). c. If you intend to run the IASI principal components code, please see the manual NWPSAF-MO-UD-022_IASIPCs.pdf before building AAPP. d. Go to the AAPP top directory and run "configure" e. Type "make" (and optionally "make install") f. If you wish to use the new BUFR sequences for IASI, you will need the BUFR tables B0000000000000014000.TXT and D0000000000000014000.TXT, which are available as part of ECMWF BUFRDC release 000382. They are also included in the MetOp test case package. If you are using an earlier version of the ECMWF library you should store these BUFR files in your $BUFR_TABLES directory. g. If you wish to run the MAIA3 package then cd to the AAPP top directory (or the installation directory, if you are using one) and unpack the MAIA3 data package tar -xvmzf [dir]AAPP_MAIA3_data.tgz You may also need to make some changes to your ATOVS_ENV6 file (see Installation Guide). Important note to Fortran 77 users and HP-UX users ================================================== MAIA3 uses Fortran 90 routines. If you are using a Fortran 77 compiler (e.g. f77, g77, pgf77 or xlf) then the "make" command will not attempt to compile MAIA3 (see top-level Makefile, which calls the script "fortran_compatibility"). But you can still run the other parts of AAPP. If you subsequently decide to move to a Fortran 90 compiler then you can re-generate the makefiles by typing "perl Makefile.PL". MAIA3 compilation is also disabled for HP-UX systems, since the HP f90 compiler has some features that are incompatible with MAIA3 as currently delivered. If you wish to build MAIA3 using the HP f90 compiler, please contact the NWP SAF Helpdesk for more information. Note on the IASI eigenvector files ================================== IASI eigenvector files, as supplied by EUMETSAT, are included in directory AAPP/src/preproc/libatovpp. To avoid problems with some versions of "tar" the file names have been shortened, but the full file names are used when "make" installs them into the AAPP/data/preproc directory. 4. License ---------- To use this software, users need to have registered for AAPP v6 with the NWP SAF (www.nwpsaf.org), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ The source package (AAPP_6_12.tgz) corresponds to Subversion Revision 207 in the AAPP repository held at the Met Office. 6. Detailed list of changes, rev 170 to 207 --------------------------- Key: M=Modified, A=Added, D=Deleted General ======= M configure Add NOAA-19. Change default orbital elements to tle (user can modify ATOVS_ENV6 if required). Add comments on usage with HDF5 libraries. M config/g77 Change optimisation from -O5 to -O2 (-O5 gave problems for a user recently in avhrcl). M config/Solaris Add optimisation flag -O. Calibration =========== M AAPP/src/calibration/libamsuacl/amsua_clparams.dat M AAPP/src/calibration/libamsubcl/amsub_clparams.dat M AAPP/src/calibration/libamsuacl/ama_cal.F M AAPP/src/calibration/libamsubcl/amb_cal.F M AAPP/src/calibration/libmhscl/mhs_cal.F Increase antenna tolerance for NOAA-16 AMSU-A1 Lower gross limits for MetOp AMSU-A channel 7 Lower gross limits for NOAA-15 AMSU-B channels 18-20 Use linear calibration if the quadratic coef overflows in the 1B M AAPP/src/calibration/libmsucl/m_tgtmp.F M AAPP/src/calibration/libmsucl/m_gfcounts.F Correct syntax error in diagnostic statements Preprocessing ============= M AAPP/include/inparms.h M AAPP/src/preproc/libatovin/fdf.dat Correct NOAA-12 WMO ID in fdf.dat and add entries for NOAA-11 and NOAA-10 M AAPP/src/preproc/libatovin/inbprc.F M AAPP/src/preproc/libatovpp/ppbind.F Do not reject data for AMSU-B channels 3-5. These channels have failed for NOAA-17 and are degrading for NOAA-15 and 16. M AAPP/src/preproc/libatovpp/ppaind.F For MetOp-A do not reject data if AMSU channel 7 missing. Navigation ========== M AAPP/src/navigation/libtbus/tb_dc.F M AAPP/src/navigation/libtbus/clkerr_dc.F Ignore blank lines in the TBUS message Tools ===== M AAPP/src/tools/libaappbufr/aapp_get_1c.F M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/bin/aapp_encodebufr_1c.F M AAPP/src/tools/bin/aapp_decodebufr_1c.F M AAPP/src/tools/bin/aapp_decodebufr_1c.ksh Add MSU. Allow user to specify a particular WMO_SATID and/or INSTRUMENT, via environment variables, in case the input file contains more than one. Various mods to work with ECMWF archived TOVS and ATOVS data. Accommodate new IASI formats. M AAPP/src/tools/bin/avh_get_vis_coefs.ksh Allow for NOAA AVHRR visible calibration files with either 15 or 7 fields M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh Correct typo log -> log_info MetOp tools =========== M metop-tools/src/bin/convert_avh1b.c Add return value 0, for portability. Modifications for EARS-IASI =========================== A AAPP/include/iasipc.h M AAPP/include/ppparms.h M AAPP/include/iasi1c.h M AAPP/include/ppifdata.h M AAPP/include/ppistore.h M AAPP/include/iasi1d.h Increase number of channels to 366, number of PCs to 290. A AAPP/src/preproc/libatov/ioipc.F M AAPP/src/preproc/libatov/Makefile A AAPP/src/preproc/libatovpp/ppipcind.F A AAPP/src/preproc/libatovpp/ppipcinh.F M AAPP/src/preproc/libatovpp/ppproc1.F M AAPP/src/preproc/libatovpp/ppiinh.F M AAPP/src/preproc/libatovpp/ppispectra.F M AAPP/src/preproc/libatovpp/pplut.F M AAPP/src/preproc/libatovpp/ppifdf.F A AAPP/src/preproc/libatovpp/ppipc1d.F M AAPP/src/preproc/libatovpp/ppsetup.F M AAPP/src/preproc/libatovpp/ppicloud.F M AAPP/src/preproc/libatovpp/Makefile A AAPP/src/preproc/libatovpp/ppipcthin.F M AAPP/src/preproc/libatovpp/iasi_eigenvectors_spec.dat A AAPP/src/preproc/libatovpp/ppipcget.F A AAPP/src/preproc/libatovpp/ppipcouth.F A AAPP/src/preproc/libatovpp/IASI_314.fdf M AAPP/src/preproc/libatovpp/IASI.fdf A AAPP/src/preproc/libatovpp/iasi_generate_pcs.F M AAPP/src/preproc/libatovpp/ppin.F A AAPP/src/preproc/libatovpp/iasi_generate_rrad.F M AAPP/src/preproc/libatovpp/ppuser.F M AAPP/src/preproc/libatovpp/pptime.F M AAPP/src/preproc/libatovpp/ppi1d.F M AAPP/src/preproc/libatovpp/ppfinish.F A AAPP/src/preproc/libatovpp/IASI_EV1_xx_M02_20100113000102Z A AAPP/src/preproc/libatovpp/IASI_EV1_xx_M02_20100113000102Z.loc A AAPP/src/preproc/libatovpp/IASI_EV2_xx_M02_20100113000102Z A AAPP/src/preproc/libatovpp/IASI_EV2_xx_M02_20100113000102Z.loc A AAPP/src/preproc/libatovpp/IASI_EV3_xx_M02_20100113000102Z A AAPP/src/preproc/libatovpp/IASI_EV3_xx_M02_20100113000102Z.loc A AAPP/src/preproc/bin/iasi_1c_to_pc.F A AAPP/src/preproc/bin/iasi_1c_to_pc.ksh M AAPP/src/preproc/bin/iasi_eigenvectors.F M AAPP/src/preproc/bin/iasi_eigenvectors.ksh M AAPP/src/preproc/bin/atovpp.F M AAPP/src/preproc/bin/atovpp.ksh A AAPP/src/preproc/bin/iasi_ev_readhdf5.c A AAPP/src/preproc/bin/iasi_reconstruct.ksh A AAPP/src/preproc/bin/iasi_reconstruct.F M AAPP/src/preproc/bin/Makefile Add IASI PC capability, including reading the EUMETSAT eigenvectors in HDF5 format, generating reconstructed radiances, new "PC" format, read/write BUFR files, etc. HDF5 tools ========== A AAPP/src/tools/libaapphdf5 A AAPP/src/tools/libaapphdf5/avh1b_to_hdf5_f.F A AAPP/src/tools/libaapphdf5/avh1b_to_hdf5_write.c A AAPP/src/tools/libaapphdf5/Makefile A AAPP/src/tools/libaapphdf5/avh1b_to_hdf5_intf.c-F A AAPP/src/tools/bin/avh1b_to_hdf5.c A AAPP/src/tools/bin/avh1b_to_hdf5.ksh M AAPP/src/tools/bin/Makefile M AAPP/Makefile AVHRR 1b to HDF5 convertor (prototype) metop-tools =========== M metop-tools/include/eps_types.h M metop-tools/include/eps_buffer.h M metop-tools/src/libeps_common/eps_buffer.c M metop-tools/Makefile Accommodate new format libraries from EUMETSAT iasi-tools ========== A iasi-tools/include/cnes_iasi_brd_1.7.h A iasi-tools/include/cnes_iasi_grd_1.7.h A iasi-tools/include/eps_iasil1c_9.0.h A iasi-tools/src/libcnes_iasi_brd_1.7 A iasi-tools/src/libcnes_iasi_brd_1.7/cnes_iasi_brd_1.7.xml A iasi-tools/src/libcnes_iasi_brd_1.7/cnes_iasi_brd_1.7.c A iasi-tools/src/libcnes_iasi_brd_1.7/Makefile A iasi-tools/src/libcnes_iasi_grd_1.7 A iasi-tools/src/libcnes_iasi_grd_1.7/cnes_iasi_grd_1.7.c A iasi-tools/src/libcnes_iasi_grd_1.7/Makefile A iasi-tools/src/libcnes_iasi_grd_1.7/cnes_iasi_grd_1.7.xml M iasi-tools/src/bin/cnes_iasi_brd-swapb.c A iasi-tools/src/bin/convert_iasi1c_9.0.c M iasi-tools/src/bin/cnes_iasi_grd-swapb.c A iasi-tools/src/bin/compare-iasi-pfs1c_9.0.c M iasi-tools/src/bin/convert_iasi1c.ksh M iasi-tools/src/bin/cnes_iasi_brd-print.c M iasi-tools/src/bin/cnes_iasi_grd-print.c M iasi-tools/src/bin/Makefile A iasi-tools/src/libeps_iasil1c_9.0 A iasi-tools/src/libeps_iasil1c_9.0/eps_iasil1c_9.0.xml A iasi-tools/src/libeps_iasil1c_9.0/convert_iasi1c_9.0.intf.c-F A iasi-tools/src/libeps_iasil1c_9.0/convert_iasi1c_9.0.F A iasi-tools/src/libeps_iasil1c_9.0/eps_iasil1c_9.0.c A iasi-tools/src/libeps_iasil1c_9.0/Makefile M iasi-tools/src/libeps_iasil1c_6.6/convert_iasi1c.F M iasi-tools/Makefile New format libraries from EUMETSAT Modifications associated with MAIA3 =================================== A AAPP/include/avh1c_F90.h A AAPP/include/avhrrin.h A AAPP/include/avh1c.h M AAPP/Makefile.inc A AAPP/module A AAPP/src/maia3 A AAPP/src/maia3/libmaia3_tools A AAPP/src/maia3/libmaia3_tools/avh1bhdp.F A AAPP/src/maia3/libmaia3_tools/mod_display.F90 A AAPP/src/maia3/libmaia3_tools/avh1chdp.F A AAPP/src/maia3/libmaia3_tools/ioavh1c1d.F A AAPP/src/maia3/libmaia3_tools/Makefile A AAPP/src/maia3/libmaia3_tools/avh1bdtp.F A AAPP/src/maia3/libmaia3_tools/mod_maia3in.F90 A AAPP/src/maia3/libmaia3_tools/ioavh1b.F A AAPP/src/maia3/libmaia3_tools/locl1b_2full.F90 A AAPP/src/maia3/libmaia3_tools/avh1cdtp.F A AAPP/src/maia3/libmaia3 A AAPP/src/maia3/libmaia3/valseuil_land.F90 A AAPP/src/maia3/libmaia3/maia_setup.F90 A AAPP/src/maia3/libmaia3/mod_dbg.F90 A AAPP/src/maia3/libmaia3/mod_setup.F90 A AAPP/src/maia3/libmaia3/mod_atlas.F90 A AAPP/src/maia3/libmaia3/mod_infobox.F90 A AAPP/src/maia3/libmaia3/maia.F90 A AAPP/src/maia3/libmaia3/landsea.F90 A AAPP/src/maia3/libmaia3/valseuil_ct.F90 A AAPP/src/maia3/libmaia3/lec_previ_grib.F90 A AAPP/src/maia3/libmaia3/lec_tabvis.F90 A AAPP/src/maia3/libmaia3/intplog.F90 A AAPP/src/maia3/libmaia3/simulatmos_vis.F90 A AAPP/src/maia3/libmaia3/Makefile A AAPP/src/maia3/libmaia3/maia_init.F90 A AAPP/src/maia3/libmaia3/ct_night.F90 A AAPP/src/maia3/libmaia3/lec_noise.F90 A AAPP/src/maia3/libmaia3/valseuil_maxt4.F90 A AAPP/src/maia3/libmaia3/roujean.F90 A AAPP/src/maia3/libmaia3/lec_previ.F90 A AAPP/src/maia3/libmaia3/albter.F90 A AAPP/src/maia3/libmaia3/maia_twvc.F90 A AAPP/src/maia3/libmaia3/valseuil_maxa1.F90 A AAPP/src/maia3/libmaia3/lec_previ_ascii.F90 A AAPP/src/maia3/libmaia3/lec_clim_alb.F90 A AAPP/src/maia3/libmaia3/test_snow.F90 A AAPP/src/maia3/libmaia3/testcd.F90 A AAPP/src/maia3/libmaia3/indwat.F90 A AAPP/src/maia3/libmaia3/valseuil_reset.F90 A AAPP/src/maia3/libmaia3/lec_clim_cwv.F90 A AAPP/src/maia3/libmaia3/testcg.F90 A AAPP/src/maia3/libmaia3/rnad_2rmes.F90 A AAPP/src/maia3/libmaia3/lec_clim_sst.F90 A AAPP/src/maia3/libmaia3/testcn.F90 A AAPP/src/maia3/libmaia3/ct_day.F90 A AAPP/src/maia3/libmaia3/ffresnel.F90 A AAPP/src/maia3/libmaia3/valseuil_opaq.F90 A AAPP/src/maia3/libmaia3/mod_forecast.F90 A AAPP/src/maia3/libmaia3/testsd.F90 A AAPP/src/maia3/libmaia3/mod_maia.F90 A AAPP/src/maia3/libmaia3/testct.F90 A AAPP/src/maia3/libmaia3/testsg.F90 A AAPP/src/maia3/libmaia3/threshold_pix.F90 A AAPP/src/maia3/libmaia3/glint.F90 A AAPP/src/maia3/libmaia3/hutorm.F90 A AAPP/src/maia3/libmaia3/testsn.F90 A AAPP/src/maia3/libmaia3/iniseuil.F90 A AAPP/src/maia3/libmaia3/tempsurfm.F90 A AAPP/src/maia3/libmaia3/cox_munk.F90 A AAPP/src/maia3/libmaia3/testst.F90 A AAPP/src/maia3/libmaia3/tempsurft.F90 A AAPP/src/maia3/libmaia3/masque.F90 A AAPP/src/maia3/libmaia3/testld.F90 A AAPP/src/maia3/libmaia3/test_ice.F90 A AAPP/src/maia3/libmaia3/albmer.F90 A AAPP/src/maia3/libmaia3/local_box.F90 A AAPP/src/maia3/libmaia3/albsnow.F90 A AAPP/src/maia3/libmaia3/mod_reclopt.F90 A AAPP/src/maia3/libmaia3/local_box_V0.F90 A AAPP/src/maia3/libmaia3/testln.F90 A AAPP/src/maia3/libmaia3/cornoir.F90 A AAPP/src/maia3/libmaia3/intsecw.F90 A AAPP/src/maia3/libmaia3/valseuil_sea.F90 A AAPP/src/maia3/libmaia3/leroux.F90 A AAPP/src/maia3/libmaia3/testlt.F90 A AAPP/src/maia3/libmaia3/ct_dawn.F90 A AAPP/src/maia3/libmaia3/clim_temps.F90 A AAPP/src/maia3/bin A AAPP/src/maia3/bin/MAIA3_RUN.ksh A AAPP/src/maia3/bin/display_avh1d.F90 A AAPP/src/maia3/bin/maia3_env.ksh A AAPP/src/maia3/bin/maia3_main.F90 A AAPP/src/maia3/bin/maia3_date.ksh A AAPP/src/maia3/bin/display_avh1d.ksh A AAPP/src/maia3/bin/Makefile A AAPP/src/maia3/bin/avhrrin.ksh A AAPP/src/maia3/bin/avhrrin.F A AAPP/src/maia3/bin/maia3.ksh M AAPP/Makefile M configure A f77_compatibility M metop-tools/Makefile M iasi-tools/Makefile M Makefile.inc M Makefile.PL M Makefile