array-split 0.6.5__zip

array_split-0.6.5/array_split.egg-info/PKG-INFO

@@ -0,0 +1,255 @@
+Metadata-Version: 2.1
+Name: array-split
+Version: 0.6.5
+Summary: The array_split python package is an enhancement to existing numpy.ndarray functions (such as numpy.array_split) which sub-divide a multi-dimensional array into a number of multi-dimensional sub-arrays (slices)
+Author-email: Shane-J-Latham <array.split@gmail.com>, array-split <array.split@gmail.com>
+License: Copyright (C) 2017 The Australian National University.
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of this
+        software and associated documentation files (the "Software"), to deal in the Software
+        without restriction, including without limitation the rights to use, copy, modify, merge,
+        publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
+        to whom the Software is furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all copies or
+        substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+        BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+        DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/array-split/array_split
+Project-URL: Documentation, https://array-split.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/array-split/array_split
+Project-URL: Issues, https://github.com/array-split/array_split/issues
+Keywords: multi-dimensional-array,array,sub-array,tile,tiling,splitting,split,partition,partitioning,scipy,numpy,ndarray,domain-decomposition,array-decomposition
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+
+
+=============
+`array_split`
+=============
+
+.. Start of sphinx doc include.
+.. start long description.
+.. start badges.
+
+.. image:: https://img.shields.io/pypi/v/array_split.svg
+   :target: https://pypi.python.org/pypi/array_split/
+   :alt: array_split python package
+.. image:: https://github.com/array-split/array_split/actions/workflows/python-test.yml/badge.svg
+   :target: https://github.com/array-split/array_split/actions/workflows/python-test.yml
+   :alt: array_split python package
+.. image:: https://readthedocs.org/projects/array-split/badge/?version=stable
+   :target: http://array-split.readthedocs.io/en/stable
+   :alt: Documentation Status
+.. image:: https://coveralls.io/repos/github/array-split/array_split/badge.svg
+   :target: https://coveralls.io/github/array-split/array_split
+   :alt: Coveralls Status
+.. image:: https://img.shields.io/pypi/l/array_split.svg
+   :target: https://pypi.python.org/pypi/array_split/
+   :alt: MIT License
+.. image:: https://img.shields.io/pypi/pyversions/array_split.svg
+   :target: https://pypi.python.org/pypi/array_split/
+   :alt: array_split python package
+.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.889078.svg
+   :target: https://doi.org/10.5281/zenodo.889078
+.. image:: http://joss.theoj.org/papers/10.21105/joss.00373/status.svg
+   :target: http://joss.theoj.org/papers/4b59c7430176ef78c80c6a1100031eb6
+
+.. end badges.
+
+The `array_split <http://array-split.readthedocs.io/en/latest>`_ python package is
+an enhancement to existing
+`numpy.ndarray  <http://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html>`_ functions,
+such as
+`numpy.array_split <http://docs.scipy.org/doc/numpy/reference/generated/numpy.array_split.html>`_,
+`skimage.util.view_as_blocks <http://scikit-image.org/docs/0.13.x/api/skimage.util.html#view-as-blocks>`_
+and
+`skimage.util.view_as_windows <http://scikit-image.org/docs/0.13.x/api/skimage.util.html#view-as-windows>`_,
+which sub-divide a multi-dimensional array into a number of multi-dimensional sub-arrays (slices).
+Example application areas include:
+
+**Parallel Processing**
+   A large (dense) array is partitioned into smaller sub-arrays which can be
+   processed concurrently by multiple processes
+   (`multiprocessing <https://docs.python.org/3/library/multiprocessing.html>`_
+   or `mpi4py <http://pythonhosted.org/mpi4py/>`_) or other memory-limited hardware
+   (e.g. GPGPU using `pyopencl <https://mathema.tician.de/software/pyopencl/>`_,
+   `pycuda <https://mathema.tician.de/software/pycuda/>`_, etc).
+   For GPGPU, it is necessary for sub-array not to exceed the GPU memory and
+   desirable for the sub-array shape to be a multiple of the *work-group*
+   (`OpenCL <https://en.wikipedia.org/wiki/OpenCL>`_)
+   or *thread-block* (`CUDA <https://en.wikipedia.org/wiki/CUDA>`_) size.
+
+**File I/O**
+   A large (dense) array is partitioned into smaller sub-arrays which can be
+   written to individual files
+   (as, for example, a
+   `HDF5 Virtual Dataset <https://support.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesVirtualDatasetDocs.html>`_).
+   It is often desirable for the individual files not to exceed a specified number
+   of (Giga) bytes and, for `HDF5 <https://support.hdfgroup.org/HDF5/>`_, it is desirable
+   to have the individual file sub-array shape a multiple of
+   the `chunk shape <https://support.hdfgroup.org/HDF5/doc1.8/Advanced/Chunking/index.html>`_.
+   Similarly, `out of core <https://en.wikipedia.org/wiki/Out-of-core_algorithm>`_
+   algorithms for large dense arrays often involve processing the entire data-set as
+   a series of *in-core* sub-arrays. Again, it is desirable for the individual sub-array shape
+   to be a multiple of the
+   `chunk shape <https://support.hdfgroup.org/HDF5/doc1.8/Advanced/Chunking/index.html>`_.  
+
+
+The `array_split <http://array-split.readthedocs.io/en/latest>`_ package provides the
+means to partition an array (or array shape) using any of the following criteria:
+
+- Per-axis indices indicating the *cut* positions.
+- Per-axis number of sub-arrays.
+- Total number of sub-arrays (with optional per-axis *number of sections* constraints).
+- Specific sub-array shape.
+- Specification of *halo* (*ghost*) elements for sub-arrays.
+- Arbitrary *start index* for the shape to be partitioned.
+- Maximum number of bytes for a sub-array with constraints:
+
+   - sub-arrays are an even multiple of a specified sub-tile shape
+   - upper limit on the per-axis sub-array shape
+
+
+Quick Start Example
+===================
+
+
+   >>> from array_split import array_split, shape_split
+   >>> import numpy as np
+   >>>
+   >>> ary = np.arange(0, 4*9)
+   >>> 
+   >>> array_split(ary, 4) # 1D split into 4 sections (like numpy.array_split)
+   [array([0, 1, 2, 3, 4, 5, 6, 7, 8]),
+    array([ 9, 10, 11, 12, 13, 14, 15, 16, 17]),
+    array([18, 19, 20, 21, 22, 23, 24, 25, 26]),
+    array([27, 28, 29, 30, 31, 32, 33, 34, 35])]
+   >>> 
+   >>> shape_split(ary.shape, 4) # 1D split into 4 parts, returns slice objects 
+   array([(slice(0, 9, None),), (slice(9, 18, None),), (slice(18, 27, None),), (slice(27, 36, None),)], 
+         dtype=[('0', 'O')])
+   >>> 
+   >>> ary = ary.reshape(4, 9) # Make ary 2D
+   >>> split = shape_split(ary.shape, axis=(2, 3)) # 2D split into 2*3=6 sections
+   >>> split.shape
+   (2, 3)
+   >>> split
+   array([[(slice(0, 2, None), slice(0, 3, None)),
+           (slice(0, 2, None), slice(3, 6, None)),
+           (slice(0, 2, None), slice(6, 9, None))],
+          [(slice(2, 4, None), slice(0, 3, None)),
+           (slice(2, 4, None), slice(3, 6, None)),
+           (slice(2, 4, None), slice(6, 9, None))]], 
+         dtype=[('0', 'O'), ('1', 'O')])
+   >>> sub_arys = [ary[tup] for tup in split.flatten()] # Create sub-array views from slice tuples.
+   >>> sub_arys
+   [array([[ 0,  1,  2], [ 9, 10, 11]]),
+    array([[ 3,  4,  5], [12, 13, 14]]),
+    array([[ 6,  7,  8], [15, 16, 17]]),
+    array([[18, 19, 20], [27, 28, 29]]),
+    array([[21, 22, 23], [30, 31, 32]]),
+    array([[24, 25, 26], [33, 34, 35]])]
+
+
+Latest sphinx documentation (including more examples)
+at http://array-split.readthedocs.io/en/latest/.
+
+.. end long description.
+
+Installation
+============
+
+Using ``pip`` (root access required):
+
+   ``pip install array_split``
+   
+or local user install (no root access required):
+   
+   ``pip install --user array_split``
+
+or local user install from latest github source:
+
+   ``pip install --user git+git://github.com/array-split/array_split.git#egg=array_split``
+
+
+Requirements
+============
+
+Requires `numpy <http://docs.scipy.org/doc/numpy/>`_ version `>= 1.6`,
+python-2 version `>= 2.6` or python-3 version `>= 3.2`.
+
+Testing
+=======
+
+Run tests (unit-tests and doctest module docstring tests) using::
+
+   python -m array_split.tests
+
+or, from the source tree, run::
+
+   python setup.py test
+
+
+Travis CI at:
+
+   https://travis-ci.org/array-split/array_split/
+
+and AppVeyor at:
+
+   https://ci.appveyor.com/project/array-split/array-split
+
+Documentation
+=============
+
+Latest sphinx generated documentation is at:
+
+    http://array-split.readthedocs.io/en/latest
+
+and at github *gh-pages*:
+
+    https://array-split.github.io/array_split/
+
+Sphinx documentation can be built from the source::
+
+   python setup.py build_sphinx
+
+with the HTML generated in ``docs/_build/html``.
+
+
+Latest source code
+==================
+
+Source at github:
+
+   https://github.com/array-split/array_split
+
+
+Bug Reports
+===========
+
+To search for bugs or report them, please use the bug tracker at:
+
+   https://github.com/array-split/array_split/issues
+
+
+Contributing
+============
+
+Check out the `CONTRIBUTING doc <https://github.com/array-split/array_split/blob/dev/CONTRIBUTING.rst>`_.
+
+
+License information
+===================
+
+See the file `LICENSE.txt <https://github.com/array-split/array_split/blob/dev/LICENSE.txt>`_
+for terms & conditions, for usage and a DISCLAIMER OF ALL WARRANTIES.

array_split-0.6.5/array_split.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE.txt
+README.rst
+pyproject.toml
+setup.cfg
+setup.py
+array_split/__init__.py
+array_split/_version.py
+array_split/copyright.txt
+array_split/license.py
+array_split/license.txt
+array_split/logging.py
+array_split/split.py
+array_split/split_plot.py
+array_split/split_test.py
+array_split/tests.py
+array_split/unittest.py
+array_split.egg-info/PKG-INFO
+array_split.egg-info/SOURCES.txt
+array_split.egg-info/dependency_links.txt
+array_split.egg-info/not-zip-safe
+array_split.egg-info/requires.txt
+array_split.egg-info/top_level.txt

array_split-0.6.5/array_split.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

array_split-0.6.5/array_split.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

array_split-0.6.5/array_split.egg-info/requires.txt

@@ -0,0 +1 @@
+numpy>=1.6

array_split-0.6.5/array_split.egg-info/top_level.txt

@@ -0,0 +1 @@
+array_split

array_split-0.6.5/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = [
+  "setuptools>=42",
+  "versioneer[toml]",
+  "numpy>=1.6"
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "array_split"
+dependencies = [
+    "numpy>=1.6",
+]
+dynamic = ["version"]
+
+authors = [
+  { name="Shane-J-Latham", email="array.split@gmail.com" },
+  { name="array-split", email="array.split@gmail.com" },
+]
+
+description = "The array_split python package is an enhancement to existing numpy.ndarray functions (such as numpy.array_split) which sub-divide a multi-dimensional array into a number of multi-dimensional sub-arrays (slices)"
+readme = "README.rst"
+keywords = [
+  "multi-dimensional-array", "array", "sub-array", "tile", "tiling",
+  "splitting", "split", "partition", "partitioning", "scipy", "numpy",
+  "ndarray", "domain-decomposition", "array-decomposition"
+]
+license = { file="LICENSE.txt" }
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/array-split/array_split"
+Documentation = "https://array-split.readthedocs.io/en/latest/"
+Repository = "https://github.com/array-split/array_split"
+Issues = "https://github.com/array-split/array_split/issues"
+
+[tool.versioneer]
+VCS = "git"
+style = "pep440"
+versionfile_source = "array_split/_version.py"
+versionfile_build = "array_split/_version.py"
+tag_prefix = "v"
+parentdir_prefix = "array_split-"

array_split-0.6.5/setup.cfg

@@ -0,0 +1,16 @@
+[build_sphinx]
+source-dir = docs/source
+build-dir = docs/_build
+all_files = 1
+
+[bdist_wheel]
+universal = 1
+
+[flake8]
+ignore = W503,W504
+max-line-length = 100
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

array_split-0.6.5/setup.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python
+from setuptools import setup, find_packages
+import versioneer
+
+
+setup(
+    name="array_split",
+    version=versioneer.get_version(),
+    cmdclass=versioneer.get_cmdclass(),
+    zip_safe=False,
+    packages=find_packages(),
+    package_data={'array_split': ["*.txt"]},
+)
+