<commit_before>========================
imread: Read Image Files
========================

Simple module with a small number of functions:

imread
    Reads an image file
imread_multi
    Reads an image file with multiple images. Currently, TIFF and STK (a TIFF
    sub-based format) support this function.
imsave
    Writes an image file

Example (which uses `mahotas <http://luispedro.org/software/mahotas>`__ for
Gaussian filtering)::


    from imread import imread, imsave
    from mahotas import gaussian_filter
    lena = imread('lena.jpeg')

    lena = gaussian_filter(lena.astype(float), 4.)
    imsave('lena-filtered.jpeg', lena)


This grew out of frustration at current image loading solutions in Python, in
either my packages [mahotas] or packages from others [scikits.image, for
example].

The relationship with numpy is very contained and this could be easily
repurposed to load images in other frameworks, even other programming
languages.


Dependencies
~~~~~~~~~~~~

To install on debian/ubuntu::

    sudo apt-get install libpng12-dev libtiff4-dev libwebp-dev

To install on Mac::

    sudo port install libpng tiff webp

Bug Reports
~~~~~~~~~~~

Please report any bugs either on github or by email to <EMAIL>

If you are not sure of whether this is the correct behaviour, you can discuss
this on the
`pythonvision mailing list <https://groups.google.com/forum/?fromgroups#!forum/pythonvision>`__

If at all possible, include a small image as a test case.<commit_msg>DOC Link to online docs<commit_after>========================
imread: Read Image Files
========================

Simple module with a small number of functions:

imread
    Reads an image file
imread_multi
    Reads an image file with multiple images. Currently, TIFF and STK (a TIFF
    sub-based format) support this function.
imsave
    Writes an image file

Example (which uses `mahotas <http://luispedro.org/software/mahotas>`__ for
Gaussian filtering)::


    from imread import imread, imsave
    from mahotas import gaussian_filter
    lena = imread('lena.jpeg')

    lena = gaussian_filter(lena.astype(float), 4.)
    imsave('lena-filtered.jpeg', lena)


This grew out of frustration at current image loading solutions in Python, in
either my packages [mahotas] or packages from others [scikits.image, for
example].

The relationship with numpy is very contained and this could be easily
repurposed to load images in other frameworks, even other programming
languages.

`Online documentation <http://packages.python.org/imread/>`__

Dependencies
~~~~~~~~~~~~

To install on debian/ubuntu::

    sudo apt-get install libpng12-dev libtiff4-dev libwebp-dev

To install on Mac::

    sudo port install libpng tiff webp

Bug Reports
~~~~~~~~~~~

Please report any bugs either on github or by email to <EMAIL>

If you are not sure of whether this is the correct behaviour, you can discuss
this on the
`pythonvision mailing list <https://groups.google.com/forum/?fromgroups#!forum/pythonvision>`__

If at all possible, include a small image as a test case.
{'fraction_non_alphanumeric': 0.10676741130091984, 'fraction_numerical': 0.002628120893561104, 'mean_word_length': 4.342105263157895, 'pattern_counts': {'":': 0, '<': 10, '<?xml version=': 0, '>': 10, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4953242', 'n_tokens_mistral': 917, 'n_tokens_neox': 838, 'n_words': 370}