============================================
Nagg version 1.5.1 released on 2013-05-29.
============================================

1. Introduction
===============

This document describes the NPP Aggregation tool, nagg, and contains
information on platforms tested, changes since last release and any known
problems.

If you have any questions or comments, please send them to:
    help@hdfgroup.org


2. Platforms Tested
===================
Linux 2.6 32bit and 64bits with gcc 4.1.2 and icc 12.1.0


3. New features and bug fixes since Version 1.5.0
=================================================
    Configuration
    -------------
    - None
    
    Features
    --------
    - The list of products has been expannded by addition of 27 Intermediate 
      Products and 1 geolocation product.  5 of these are from JPSS Common
      Data Format Control Book - External Volume I and were previously
      overlooked.  The others are from JPSS Internal Data Format Control Book 
      Volume III - Retained Intermediate Product Formats.

    Bug Fixes
    ---------
    - JPSS-64:  "nagg -h" displays the list of products in a table with
      the DPID for the product, the Product Short Name, the Granule Duration
      for the product, and the GPID for the corresponding geolocation product.
      An explanation has been added at the top of the table explaining that 
      products with the same GPID are compatible.  A three row table with
      pairs of equivalent geolocation products has also been added, with the 
      explanation that products with a GPID in one of those rows are also
      compatible with products having the other GPID in the row.
    - JPSS-65:  Some experimental granules with granule IDs that didn't match
      their N_Beginning_Time_IET attributes were found in the test files.  The
      aggregations produced by nagg for these files were incorrect.  A check 
      has been added to insure that the value of the N_Beginning_Time_IET 
      attribute is not less (earlier) than the previous granule in the list
      sorted by granule IDs.  If an granule is  found that is later by ID but
      earlier by N_Beginning_Time_IET, a warning is displayed and the granule
      is not added to the aggregation.   

    Limits
    ------
    - See nagg.docx (html, pdf) in the same directory for proposed functionality.
    Current release has the following limitations: 
       * Like (--like) option retrieves three properties (number of granules,
         types contained, and geolocation product or external geolocation file
         attribute) from the example file.  Whether the output should be
         packaged or unpackaged is determined from the geolocation
         characteristics of the example file.  Geolocation only aggregation
         is now supported, but origin and domain are determined only from the
         command line options. 
       * Environment variables or command line options for compliance 
         with file naming convention presume valid types and packaging as
	 defined in the "nagg.h" file.
       * Warnings or failures if granule gaps exceed some threshold are not
         supported.
       * Compression on output is not supported.
       * Options to choose repair granule are not supported; for now, the one
         with the latest version is used.
       * Option to replace existing granule with repair granule is not
         supported.  
       * Restrictions on flags and input parameters:
            Directory input is not supported.

      
4. Known problems
=================
    nagg may fail with a segmentation fault if there is insufficient disk
    drive space to hold the output files.  In general the ouput files will 
    require the same amount of disk space as the input files.