############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.5 Release Notes # # 16 July 2013 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_5.txt 16296 This release note AAPP_update_7_5.tgz 327472 AAPP source code AAPP_MAIA3_data.tgz 135354920 Data file for MAIA3 (only required if you intend to run MAIA3) AAPP_MAIA4_data.tgz 983813840 Data file for MAIA4 (only required if you intend to run MAIA4) 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, 7.3 and 7.4. The following new or updated documents are available on the AAPP web site http://nwpsaf.eu/web-test/deliverables/aapp/index.html: NWPSAF-MF-UD-002 - Software Description (updated with new section 4.4) NWPSAF-MF-UD-003 - Data Formats (updated with new section 47) NWPSAF-MO-UD-005 - Installation Guide (updated chapters 3 and 4) NWPSAF-MF-UD-009 - MAIA version 4 Scientific User Manual (new) A MAIA4 test case is available on the AAPP ftp server: MAIA4_test_1gran.tgz 1317715743 (This test comprises 1 granule of VIIRS data; tests with 2 or more granules can be provided on request) 2. Main Changes --------------- - Addition of MAIA v4 for generating cloud mask for VIIRS. - Change file names of MAIA v3 data files, for improved portability. - Addition of HDF5 decode and BUFR encode/decode facility for IRAS instrument on FY-3. Update BUFR encoding of ATMS and CrIS. - Updates to Metop-B AMSU and AVHRR calibration files. - Relax check on NOAA-15 AMSU-A1-2 antenna position, due to instrument degradation. - Add optional environment variable BUFR_FIRSTFOV_IASI1C, for use in BUFR encoding of IASI l1c. - Add optional environment variable SKIP_DECOM_CHECK which can be used to reduce the number of discarded AVHRR scans when processing HRPT in granule mode. See section 6 (below) for full details. Although MAIA3 and MAIA4 are similar in their treatment of AVHRR data, they generate different output formats (MAIA4 is hdf5), therefore both versions are kept in AAPP. 3. Installation --------------- To update an existing AAPP installation, without installing the MAIA4/VIIRS tools, 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_5.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_5.tgz | tar -xmf - d. Go to the AAPP_7 top directory and type make If you are not starting from an existing installation, the sequence is (i) unpack AAPP v7.1 and cd to the AAPP top directory, (ii) unpack the update releases 7.2, 7.3, 7.4 and 7.5 (as in steps a-b above), (iii) run "configure" (see chapter 3.4 of the AAPP Installation Guide), (iv) run "make" and optionally "make install". The updated chapter 3 of the AAPP Installation Guide contains some specific recommendations regarding the installation of MAIA4/VIIRS tools: to use them, you would need to link in the Fortran interface to the HDF5 library. This is not required if you just want to run the pre-existing parts of AAPP. 4. License ---------- To use this software, users need to have registered for AAPP v7 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_update_7_5.tgz) corresponds to Subversion Revision 363 in the AAPP repository held at the Met Office. 6. Detailed list of changes from v7.4 (r344) to v7.5 (r363) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted Decommutation ============== M AAPP/src/decommutation/libdecom/hrptdc.F Add optional environment variable SKIP_DECOM_CHECK which can be used when processing granules, rather than full passes. It allows the quality checking at the start of each file to be by-passed, reducing the number of discarded AVHRR scans. Set SKIP_DECOM_CHECK=N before the first granule of a pass (or after the last granule), and =Y otherwise. Calibration =========== M AAPP/src/calibration/libavhrcl/avhcal.txt M AAPP/src/calibration/libavhrcl/avh_ccof.F Correct Metop-B entry in avhcal.txt (sign of space radiance was not being read). This corrects a bias of several K in Metop-B AVHRR channel 4 and 5. Update the comments in the "PURPOSE" section of avh_ccof.F, so that the equations are consistent with Scientific Description document. No change to code. M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Relax tolerance for NOAA-15 AMSU-A1-2 antenna position in earth views to 360 degrees. Relax tolerance for Metop-B AMSU-A1-2 PRT consistency, 0.2 -> 0.3K, to correct a 0.1K local-global discrepancy for channels 3, 4, 5, 8. Note there is an unusually large spread in the PRT readings for this target, which is under investigation by NOAA. M AAPP/src/calibration/libamsuacl/ama_iwttmp.F Bug fix for temperature sensor ID: but no impact on current AMSU-A processing. Navigation ========== M AAPP/src/navigation/bin/get_tle.ksh M configure Change default url for TLEs to use the new space-track site. Can be over-ridden using PAR_NAVIGATION_TLE_URL_DOWNLOAD. Preprocessing ============= M AAPP/src/preproc/libatov/iomwhs1c.F M AAPP/src/preproc/libatov/iomwts1c.F For MWHS/MWTS, correct the test for whether byte swapping is needed. M AAPP/src/preproc/libatovpp/ppatmssurf.F For ATMS, store sea cost if topography is sea. This makes the cost more useful as a cloud indicator. Tools ===== A AAPP/include/iras1c.h A AAPP/include/iras_sdr.h A AAPP/src/tools/libaapphdf5/iras_sdr_out.F A AAPP/src/tools/libaapphdf5/iras_sdr_read.c A AAPP/src/tools/libaapphdf5/iras_sdr.intf.c-F M AAPP/src/tools/libaapphdf5/Makefile A AAPP/src/tools/bin/iras_sdr.c A AAPP/src/tools/bin/iras_sdr.ksh M AAPP/src/tools/bin/Makefile M AAPP/src/preproc/libatov/iomwts1c.F A AAPP/src/preproc/libatov/ioiras1c.F M AAPP/src/preproc/libatov/Makefile Add FY-3 IRAS hdf5 decode M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/libaappbufr/aapp_get_1c.F A AAPP/src/tools/libaappbufr/aapp_get_1c_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwhs.F A AAPP/src/tools/libaappbufr/aapp_put_1c_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1d_cris.F M AAPP/src/tools/libaappbufr/Makefile M AAPP/src/tools/bin/aapp_encodebufr_1c.F M AAPP/src/tools/bin/aapp_encodebufr_1c.ksh M AAPP/src/tools/bin/aapp_decodebufr_1c.ksh Add FY-3 IRAS BUFR encode/decode. Use same sequence as MWTS/MWHS. Correct MWHS instrument I/D in BUFR. Add environment variable BUFR_FIRSTFOV_IASI1C (defaults to 1; set to 0 to replicate EUMETSAT IASI global stream). Correct scaling of surface height in CrIS 1d BUFR encoding. For ATMS and CrIS encoding, use data category 21, sub-category 6 (ATMS) and 5 (CrIS), for consistency with NOAA BUFR products. M AAPP/src/tools/libaappbufr/aapp_put_1d_cris.F Correct scaling of surface height in CrIS 1d BUFR product. M AAPP/src/tools/libsatid/satid.txt Add satid.txt entries for terra, fy3a and fy3b. M metop-tools/src/bin/patch-level0-from-mmam.c Portability fixes: change an[4] -> an[5] and change style of comments to /* */. Remove dependency on local daylight saving time. M iasi-tools/src/libeps_iasil1c_9.0/convert_iasi1c_9.0.intf.c-F M iasi-tools/src/libeps_iasil1c_9.0/eps_iasil1c_9.0.c Ignore ARCHIVE records, which can be found in files from the EUMETSAT data centre. MAIA2.1 and MAIA3 ================= M AAPP/src/preproc/libavh2hirs_maia_2.1/thresholds.dat M AAPP/src/preproc/bin/maia2_env.ksh M AAPP/src/maia3/bin/maia3_env.ksh For portability, change ":" to "_" in names of thresholds files (also requires updated AAPP_MAIA3_data.tgz). MAIA4 ===== M configure M fortran_compatibility M Makefile.PL M AAPP/Makefile M metop-tools/Makefile M iasi-tools/Makefile Modify for maia4. The makefiles now have libraries in alphabetical order, so that dependencies can be allowed for. For xlf compiler, allow F90 routines to be built. A AAPP/src/maia4/libaapp_viirs/viirs_sdr_data_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_mod.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_geo_def.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_aggregate_io.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_granule_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_data_io.F90 A AAPP/src/maia4/libaapp_viirs/Makefile A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_ip_cm_data_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_geo_mem.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_dataproducts_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_geo_def.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_dataproducts_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_data_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_mod.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_aggregate_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_ip_cm_data_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_data_def.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_root_def.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_dataproducts_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_geo_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img.F90 A AAPP/src/maia4/libaapp_viirs/viirs_paste_sdr.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_data_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_header_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_data_mem.F90 A AAPP/src/maia4/libaapp_viirs/aapp_hdf_mod.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_geo_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_header_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_data_mem.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_aggregate_mem.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_granule_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_header_io.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_root_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_sdr_io.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_data_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_maia4_data_io.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_granule_mem.F90 A AAPP/src/maia4/libaapp_viirs/viirs_ip_cm_data_def.F90 A AAPP/src/maia4/libaapp_viirs/viirs_edr_img_geo_mem.F90 A AAPP/src/maia4/libaapp_viirs/jpss_meta_root_io.F90 A AAPP/src/maia4/libmaia4/mod_maia_const.F90 A AAPP/src/maia4/libmaia4/maia_Read_IRThres.F90 A AAPP/src/maia4/libmaia4/maia_CMa_quality.F90 A AAPP/src/maia4/libmaia4/maia_ReflRatio_ToObs.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CT.F90 A AAPP/src/maia4/libmaia4/maia_PixEnv_reset.F90 A AAPP/src/maia4/libmaia4/maia_setup.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_InPix.F90 A AAPP/src/maia4/libmaia4/maia_GetGlint.F90 A AAPP/src/maia4/libmaia4/maia_GetClim.F90 A AAPP/src/maia4/libmaia4/maia_CMa_SD.F90 A AAPP/src/maia4/libmaia4/maia_Cloud_Pressure.F90 A AAPP/src/maia4/libmaia4/Makefile A AAPP/src/maia4/libmaia4/maia_GetThres_CT_max108.F90 A AAPP/src/maia4/libmaia4/maia_CT_day.F90 A AAPP/src/maia4/libmaia4/maia_Cal_Roujean.F90 A AAPP/src/maia4/libmaia4/maia_Read_VISThres.F90 A AAPP/src/maia4/libmaia4/maia_CMa_LT.F90 A AAPP/src/maia4/libmaia4/maia_Cal_Fresnel.F90 A AAPP/src/maia4/libmaia4/maia_SST.F90 A AAPP/src/maia4/libmaia4/maia_Interp_InGrid.F90 A AAPP/src/maia4/libmaia4/maia_Cal_WaterIndex.F90 A AAPP/src/maia4/libmaia4/maia_CMa_ConfClear.F90 A AAPP/src/maia4/libmaia4/maia_Read_Topo.F90 A AAPP/src/maia4/libmaia4/maia_Pr_InfoPix.F90 A AAPP/src/maia4/libmaia4/maia_Cal_LeRoux.F90 A AAPP/src/maia4/libmaia4/maia_Cal_AtmCorrVis.F90 A AAPP/src/maia4/libmaia4/maia_Cal_Texture.F90 A AAPP/src/maia4/libmaia4/maia_CMa_SN.F90 A AAPP/src/maia4/libmaia4/maia.F90 A AAPP/src/maia4/libmaia4/maia_CMa_CG.F90 A AAPP/src/maia4/libmaia4/maia_Fill_Input.F90 A AAPP/src/maia4/libmaia4/maia_Read_Prev.F90 A AAPP/src/maia4/libmaia4/maia_SnowIce_surf.F90 A AAPP/src/maia4/libmaia4/maia_CMa_CD.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CMa_Sea.F90 A AAPP/src/maia4/libmaia4/maia_Fill_Output.F90 A AAPP/src/maia4/libmaia4/maia_Interp_Plog.F90 A AAPP/src/maia4/libmaia4/maia_CMa_LD.F90 A AAPP/src/maia4/libmaia4/maia_CMa_SG.F90 A AAPP/src/maia4/libmaia4/maia_CT_Fl_opaq.F90 A AAPP/src/maia4/libmaia4/maia_Lon_Norm.F90 A AAPP/src/maia4/libmaia4/maia_GetTopo.F90 A AAPP/src/maia4/libmaia4/maia_ValMin.F90 A AAPP/src/maia4/libmaia4/maia_Cloud_Type.F90 A AAPP/src/maia4/libmaia4/maia_Thin_Cirrus.F90 A AAPP/src/maia4/libmaia4/maia_CMa_IceN.F90 A AAPP/src/maia4/libmaia4/maia_ConfTest.F90 A AAPP/src/maia4/libmaia4/maia_Read_Clim.F90 A AAPP/src/maia4/libmaia4/maia_Get_AlbSea.F90 A AAPP/src/maia4/libmaia4/maia_Read_GribApi.F90 A AAPP/src/maia4/libmaia4/maia_ConfTest_2.F90 A AAPP/src/maia4/libmaia4/maia_Analyse_Field.F90 A AAPP/src/maia4/libmaia4/maia_Get_AlbSnow.F90 A AAPP/src/maia4/libmaia4/maia_CMa_texture.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CMa_Land.F90 A AAPP/src/maia4/libmaia4/maia_CMa_IceD.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CMa.F90 A AAPP/src/maia4/libmaia4/maia_Box_reset.F90 A AAPP/src/maia4/libmaia4/maia_CT_night.F90 A AAPP/src/maia4/libmaia4/maia_Interp_InLut.F90 A AAPP/src/maia4/libmaia4/maia_CMa_ST.F90 A AAPP/src/maia4/libmaia4/maia_Cloud_Mask.F90 A AAPP/src/maia4/libmaia4/maia_CMa_LN.F90 A AAPP/src/maia4/libmaia4/maia_CT_dawn.F90 A AAPP/src/maia4/libmaia4/maia_BoxEnv_reset.F90 A AAPP/src/maia4/libmaia4/mod_maia_types.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CT_max06.F90 A AAPP/src/maia4/libmaia4/maia_GetThres_CT_opaq.F90 A AAPP/src/maia4/libmaia4/maia_reset_CMa.F90 A AAPP/src/maia4/libmaia4/maia_Get_AlbLand.F90 A AAPP/src/maia4/libmaia4/maia_Cal_CoxMunk.F90 A AAPP/src/maia4/libmaia4/maia_ValMoy.F90 A AAPP/src/maia4/libmaia4/maia_Cal_Twvc.F90 A AAPP/src/maia4/libmaia4/maia_Thres_reset.F90 A AAPP/src/maia4/libmaia4/maia_GetPrev.F90 A AAPP/src/maia4/libmaia4/maia_Pixel_reset.F90 A AAPP/src/maia4/libmaia4IO/Makefile A AAPP/src/maia4/libmaia4IO/maia_IO_Viirs_h5.F90 A AAPP/src/maia4/libmaia4IO/maia_read_Viirs.F90 A AAPP/src/maia4/bin/maia_env.ksh A AAPP/src/maia4/bin/Makefile A AAPP/src/maia4/bin/maia4.ksh A AAPP/src/maia4/bin/viirs_edr_img.F90 A AAPP/src/maia4/bin/viirs_paste_sdr.F90 A AAPP/src/maia4/bin/maia_Viirs.F90 A AAPP/src/maia4/bin/read_maiaCT.F90 A AAPP/src/maia4/bin/maia_date.ksh A AAPP/src/maia4/bin/MAIA4_RUN.ksh A AAPP/include/aapp_throw.h Add maia4