Metadata-Version: 2.1
Name: pymecompress
Version: 0.2.1
Summary: Compression for photon-noise limited images which keeps losses within the Poisson noise envelope
Home-page: https://github.com/python-microscopy/pymecompress
Author: David Baddeley
Author-email: david.baddeley@yale.edu
License: BSD
Description: # PYMECompress
        
        Compression for photon-noise limited images which keeps losses within the Poisson noise envelope
        
        PYMECompress consists of three parts: 
        
        - a fork of the Basic Compression Library originally by Marcus Geelnard, 
        modified to include a heavily optimized huffman coder (BCL license is avalable under pymecompress/bcl/doc/manual.pdf and would appear to be BSD compatible)
        
        - a fast, AVX optimized, quantizer to perform "within noise level" quantization of photon-limited images
        
        - a python wrapper of the above. Note that at this point, only huffman coding and quantization are exposed to python
        
        Together they offer a single core throughput of ~500 -600MB/s
        
        
        ## Installation
        
        ### Using conda
        
        Prebuilt binaries of PYMEcompress are available as a conda package (*pymecompress*) on the *david_baddeley* conda channel for python 2.7, 3.6 & 3.7
        
        ### From source
        
        If you don't use conda of want a package for a different python version (or if you want to play with the source) you will have to build from source.
        
        Because we use gcc compiler extensions for avx opcodes, we must use gcc/clang for compilation, regardless of platform.
        
        On OSX / linux, a standard `python setup.py install` or `python setup.py develop` should work.
        
        On Windows, you need to install mingw and run the build step first so that you can pass the compiler flag to `python setup.py build` - i.e. :
        
            python setup.py build --compiler=mingw32
            python setup.py install
        
        
        A suitable environment for building pymecompress using the following conda command `conda create -n <name> python=x.x numpy cython libpython m2w64-toolchain`
            
        ### PIP (experimental)
            
        An experimental pip-installable package is currently in the pypi testing repository. It can be installed using
        `pip install -i https://test.pypi.org/simple pymecompress`
        
        Currently only a source distribution is available, meaning that you will need a build environment (gcc/mingw) set up as
        described for building from source. A shift to pypi proper and wheels to follow shortly.
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
