Metadata-Version: 2.1
Name: tiling
Version: 0.1.2
Summary: Minimalistic set of image reader agnostic tools to easily iterate over large images
Home-page: https://github.com/vfdev-5/ImageTilingUtils
Author: vfdev-5
Author-email: vfdev.5@gmail.com
License: MIT
Description: [![Build Status](https://travis-ci.org/vfdev-5/ImageTilingUtils.svg?branch=master)](https://travis-ci.org/vfdev-5/ImageTilingUtils)
        [![Coverage Status](https://coveralls.io/repos/github/vfdev-5/ImageTilingUtils/badge.svg?branch=master)](https://coveralls.io/github/vfdev-5/ImageTilingUtils?branch=master)
        [![Documentation Status](https://readthedocs.org/projects/imagetilingutils/badge/?version=latest)](http://imagetilingutils.readthedocs.io/en/latest/?badge=latest)
        
        # Image Tiling Utils
        Minimalistic set of image reader agnostic tools to easily iterate over large images
        
        **Example 1**
        
        Let's iterate over a large image with overlapping and extracting always the 
        same size tiles (in pixels).  Let's assume the data access is provided with an example function
        ```python
        def read_data(x, y, width, height, out_width=None, out_height=None):
            out_width = width if out_width is None else out_width
            out_height = height if out_height is None else out_height    
            img.read(x, y, width, height, out_width, out_height)
        ``` 
        Thus, overlapping tiles can be extracted as  
        ```python
        from tiling import ConstStrideTiles
        
        
        tiles = ConstStrideTiles(image_size=(500, 500), tile_size=(256, 256), 
                                 stride=(100, 100))
                               
        print("Number of tiles: %i" % len(tiles))
        for extent, out_size in tiles:
            x, y, width, height = extent
            data = read_data(x, y, width, height, 
                             out_width=out_size[0], 
                             out_height=out_size[1])
            print("data.shape: {}".format(data.shape))
            
        # Access a tile:
        i = len(tiles) // 2 
        extent, out_size  = tiles[i]
        ```
        
        ![example_tiles](examples/example_tiles.png)
        
        
        ## Installation:
        
        #### from pip
        ```bash
        pip install tiling
        ```
        
        #### from sources
        Package installation is very simple
        ```bash
        pip install git+https://github.com/vfdev-5/ImageTilingUtils.git
        ```
        
        ## Examples 
        
        For more practical examples, see this [notebook](examples/example_const_stride_tiling.ipynb)
        
Platform: UNKNOWN
Provides-Extra: tests
