============================================
Nagg version 1.5.0 released on 2013-04-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.3.0
=================================================
    Configuration
    -------------
    - None
    
    Features
    --------
    - The -l <example file> option was added in version 1.4.0, and version 1.5.0
      extends it to detect from <example file> (1) that no geolocation should be
      processed (equivalent to "-g no"), (2) that only geolocation should be 
      processed (equivalent to no "-t products" and "-g <geoproduct>"), or (3) 
      that data product and geolocation product granules should be put in 
      separate output files (equivalent to "-S"). (LK 2012/03/01)

    - For three pairs of geolocation products that are related by terrain 
      correction (GATRO/GCRIO, GIMGO/GITCO, and GMODO/GMTCO) nagg version 1.5.0
      will allow packaging data products for which one product in the pair is 
      the designated geolocation product in the JPSS control book tables with 
      either product in the pair.  The geolocation product ID to be packaged may
      now be specified in the nagg command by -g <geoproduct id> along with 
      -t <data products>.  nagg 1.5.0 will also package any data product having 
      a designated geolocation product in one of these pairs with any other data
      product having a designated geolocation product in the same pair. 
      (LK 2013/03/01)

    Bug Fixes
    ---------
    - The inclusion of "-g no in the nagg command "nagg -t <products> -g no 
      <input files>" skipped all checking of compatibility of products and 
      geolocation products.  While incorrect this did provide a workaround 
      for packaging with products related by terrain corrected geolocation 
      until the extended compatibility for terrain corrected geolocation
      feature was added in this version. (LK 2013/02/17)

    Limits
    ------
    - See nagg.docx (html, pdf) in the same directory for proposed functionality.
    Current release has the following limitations: 
       * Like (--like) option retrieve two properties (number of granules and
         types contained) from the example file. Note that it does not
	 retrieve properties such as geolocation product used, packaged or
	 unpackaged, origin and domain. It also does not support geolocation
	 product only aggregation since it does not retrieve geolocation
	 product properties.
       * 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
=================
    None