| # # # Distribution Statement A. Approved for public release. Distribution unlimited.
 | # # #
 | # # # Author:
 | # # # Naval Research Laboratory, Marine Meteorology Division
 | # # #
 | # # # This program is free software: you can redistribute it and/or modify it under
 | # # # the terms of the NRLMMD License included with this program. This program is
 | # # # distributed WITHOUT ANY WARRANTY; without even the implied warranty of
 | # # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the included license
 | # # # for more details. If you did not receive the license, for more information see:
 | # # # https://github.com/U-S-NRL-Marine-Meteorology-Division/

Version 1.4.5 (2022-03-18)
**************************

v1.4.5: 2022-03-18, --compare_paths to --compare_path, add --output_file_list_fname, add GEOIPS_COPYRIGHT_ABBREVIATED

Breaking Interface Changes
==========================

Command line argument updates
-----------------------------

* Replaced --compare_paths with --compare_path in command line arguments

    * pass command_line_args to set_comparison_path - if "compare_path" is set in command_line_args,
        use that instead of individual compare_paths within output config
    * Eventually add support for "compare_paths_override" which will allow setting a different
        compare_path for each output_type via command line (dictionary based) - but for now all or nothing

Major New Functionality
=======================

Testing Utilities
-----------------

* Added compare_output_file_list.sh utility, for comparing a list of files with existence on disk (simpler
    output comparison test than actually comparing the contents of each output product).

Command line arguments
----------------------

* Add --output_file_list_fname to command line args, support in config-based and single-source procflows

    * Allows specifying full path to file to store output filenames from current - quickly update
        output file lists for comparison purposes.

* Add support for "filename_format_kwargs" command line option as well as "filename_formats_kwargs" output config.

Sectors
-------

* New TC Templates

    * 2km 512x512
    * 2km 800x800

Product display
---------------

* **base_paths.py**: Add GEOIPS_COPYRIGHT_ABBREVIATED, for use in product titles.

Improvements
============

* **compare_outputs.py**: Add gzip_product functionality

    * Ensure if we gunzip a product during output comparisons, after we run the comparison we re-zip the file.
        Clean up after ourselves, and leave things the way we found them.

* **unprojected_image.py**: Update so default for unprojected_image is NO savefigs_kwargs
    (empty dictionary, which means masked background, rather than default black background)

setup_geoips.sh
---------------

* Remove dependence on git v2.19.1 - cd to directories rather than using git -C
* Explicitly use setup scripts in the following order:

    * setup_<package>.sh install_<package>
    * setup.sh install
    * setup.py (uses pip install)

* If plugin exists in $GEOIPS BASEDIR/installed_geoips_plugins.txt, do not attempt to reinstall

    * Allows initializing installed_geoips_plugins at the beginning of system installation to avoid
        massive reinstallations of common geoips plugin dependencies.

Documentation Updates
=====================

* Formatting changes

    * correct spacing for code blocks and bullets
    * Remove level 4 header from "Available modules" and "Example outputs" in available functionality

* modis from 600 to 200 width
* Updated AMSU-A, AMSU-B, MHS comments for accuracy (MHS == AMSU-B, AMSU-A separate.
    Still using "amsu-b" only in geoips)

Bug fixes
=========

* **bdeck_parser.py**: Remove shell statement - raised error was dropping to shell during testing.

* **memusg.py** utility: Wrap import psutil in try/except so we don't fail if not installed

* **compare_outputs.py**: In test repo auto-generated update scripts, print gunzip before copy,
    and gzip after copy for files that must be gzipped before comparisons.

* **single_source and config_based**: Add newline to the end of "output_file_list", otherwise skipped during shell loop