Metadata-Version: 1.2
Name: hiproc
Version: 0.7.0
Summary: A library to help process HiRISE EDRs with ISIS.
Home-page: https://github.com/rbeyer/hiproc
Author: attr:hiproc.__version__
Author-email: rbeyer@seti.org
License: UNKNOWN
Description: ======
        hiproc
        ======
        
        .. image:: https://readthedocs.org/projects/hiproc/badge/?version=latest
                :target: https://hiproc.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://img.shields.io/pypi/v/hiproc.svg
                :target: https://pypi.python.org/pypi/hiproc
                :alt: PyPI version
        
        .. image:: https://anaconda.org/conda-forge/hiproc/badges/version.svg
                :target: https://anaconda.org/conda-forge/hiproc
                :alt: Conda version
        
        
        A library to help process HiRISE EDRs with ISIS.
        
        
        * Free software: Apache 2 License
        
        .. * Documentation: https://hiproc.readthedocs.io.
        .. * `PlanetaryPy`_ Affiliate Package (someday).
        
        
        Features
        --------
        
        * TODO: Complete testing against Perl Pipelines.
        
        
        External Dependencies
        ---------------------
        These programs use as much 'vanilla' Python 3 as possible.
        
        However, it does depend on the following:
        
        - pvl library (https://pvl.readthedocs.io)
        - kalasiris library (https://kalasiris.readthedocs.io)
        - gdal
        - numpy
        - scipy
        - matplotlib
        
        
        Warning !
        ---------
        
        The algorithms based on the HiRISE Processing Pipelines were emulated
        and tested locally, but the results of each pipeline **have not**
        been tested directly against the results of the HiRISE Processing
        Pipelines, and this warning will remain until I have done so.  As
        a result, I would not particularly 'trust' anything produced by
        these programs at this time, and consider these algorithms a
        work-in-progress.
        
        These programs have been tested against their upstream Perl counterparts:
        
        - EDR_Stats: Verified!
            Really just runs ``hi2isis`` so no surprise here.
        
        - HiCal: Verified.
            Upstream is undergoing change, needs to be re-verified once upstream
            settles down.
        
        - HiStitch: not verified
        - HiccdStitch: not verified
        - HiColorInit: not verified
        - HiJitReg: not verified
        - HiSlither: not verified
        - HiColorNorm: not verified
        - HiBeautify: not verified
        - HiPrecisionInit: not verified
        - HiNoProj: not verified
        - HiJACK: not verified
        
        Documentation
        -------------
        Full `documentation for hiproc is available <https://hiproc.readthedocs.io/en/latest/>`_,
        including information on the processing flow of the various available programs, and
        each program is self-documenting via their `-h` argument.
        
        Due to the interaction with ISIS and GDAL, please read the installation instructions
        carefully.
        
        Contributing
        ------------
        
        Feedback, issues, and contributions are always gratefully welcomed. See the
        contributing guide for details on how to help and setup a development
        environment.
        
        
        Naming
        ------
        
        The ISIS software has a number of processing or "proc" programs
        (`mocproc`, `thmproc`, etc.) that are meant to be run to process
        raw images to higher-level, more usable versions.  Naming this
        library `hiproc` is an echo to that. There is a `hiproc` program
        that is available after installation that provides a streamlined
        one-stop-program, but this package provides a great deal more.
        
        
        .. _PlanetaryPy: https://github.com/planetarypy
        
        =========
        Changelog
        =========
        
        All notable changes to this project will be documented in this file.
        
        The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_,
        and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`_.
        
        When updating this file, please add an entry for your change under
        Unreleased_ and one of the following headings:
        
        - Added - for new features.
        - Changed - for changes in existing functionality.
        - Deprecated - for soon-to-be removed features.
        - Removed - for now removed features.
        - Fixed - for any bug fixes.
        - Security - in case of vulnerabilities.
        
        If the heading does not yet exist under Unreleased_, then add it
        as a 3rd level heading, underlined with pluses (see examples below).
        
        When preparing for a public release add a new 2nd level heading,
        underlined with dashes under Unreleased_ with the version number
        and the release date, in year-month-day format (see examples below).
        
        
        Unreleased
        ----------
        
        0.7.0 (2021-06-15)
        ------------------
        
        Added
        +++++
        - Improved documentation
        - environment.yml for conda development
        - Added Python-based multiprocessing capabilities
          to EDR_Stats, HiCal, and hiproc.
        
        Changed
        +++++++
        - Incorporated changes from upstream to HiCal to make bitflip and lisfix settings
          on by default.
        
        Fixed
        +++++
        - resolve_jitter output header lines properly commented, now doesn't bomb HiJACK's run
          of hijitter.
        - now, additionally supporting ISIS 4.1.1 through 5.0.0
        - Upstream addressed a bug in analyze_cubenorm_stats() that we had noticed,
          so now fixed here, too.
        - MANIFEST.in did not properly include the "data" directory, so that was a problem.
        
        0.6.1 (2021-03-23)
        ------------------
        
        Added
        +++++
        - lisfix will return a non-zero exit code if it chooses not to fix the input cube.
        
        Changed
        +++++++
        - Updated documentation in various places.
        
        
        0.6.0 (2021-03-18)
        ------------------
        
        Added
        +++++
        - More complete documentation for the programs and their parameters.
        
        Changed
        +++++++
        - Implemented better handling for configuration files so that they
          will get distributed with the package.
        
        
        0.5.0 (2021-03-05)
        ------------------
        
        Added
        +++++
        * lisfix: Added the lisfix module.
        * bitflips: Sometimes the very end of the histogram (although not a formal minima) is the
          appropriate choice, and is now considered.
        * bitflips: Added capability to ignore minor maxima at the ends of the histogram to "roll down"
          to a better solution.
        
        Changed
        +++++++
        * name change of project from pyrise to hiproc.
        * bitflips: Changed the default medstd_limit from 300 to 400 DN.
        
        Fixed
        +++++
        * bitflips: There were a variety of edge cases that resulted in errors.  The appropriate guardrails, handlers,
          and recovery logic has now been added.
        * HiStitch: The equalize and balance parameters cannot both be true.
        
        0.4.0 (2020-09-22)
        ------------------
        * Tremendous amount of re-working in bitflips to improve
          performance.
        * Format cleanup
        
        0.3.0 (2020-05-16)
        ------------------
        * Confirmed that EDR_Stats and HiCal produce identical output cubes.
        
        0.2.0 (2020-05-06)
        ------------------
        * Updated with bit-flip correction.
        
        0.1.0 2020-03-21
        ----------------
        * First shared on GitHub
        
Keywords: HiRISE
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Natural Language :: English
Requires-Python: >=3.6
