============================================
Nagg version 1.6.2-beta released on 2015-04-13.
============================================

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 i386 and x86_64 with gcc 4.1.2, gcc 4.4.7 and icc 15.0.1
Linux 2.6 ppc64 with gcc 4.4.7
Mac OS X Mt. Lion 10.8.5 with clang 5.1 and Mavericks 10.9.5 with clang 6.0

3. New features and bug fixes since Version 1.6.1
=================================================
    Configuration
    -------------
    - None

    Features
    --------
    - Added --onefile command option to produce a single output aggregation for 
	  each product containing all of the granules from the input files. These
	  aggregations may be packaged in a single file or unpackaged in separate
	  files.
	- Added --nofill command option to suppress creation of fill granules when 
	  granules are missing in a time series or when one or more products are 
	  missing for a time slot when multiple products are aggregated.
	- Removed limit for total number of granules processed in a nagg operation.
	  A limit still applies in this beta version for the number of granules that 
	  can be processed from a single input file or set of input files for a 
	  single time period or to be written to a single output file or set of
	  set of output files. This will be removed in the final 1.6.2 release.

    Bug Fixes
    ---------

    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.
       * 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 copies the value of the BeginningOrbitNumber attribute from the
      first granule in an aggregation and the value of the EndingOrbitNumber
      attribute to the attributes in the ..._Aggr dataset for the aggregation.
      If either of those granules are fill granules the value of these 
      attributes may be 0 or a fill value.
    - 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.