automatic import of python-indexed-gzip-fileobj-fork-epicfaace

1 files changed, 959 insertions, 0 deletions

diff --git a/python-indexed-gzip-fileobj-fork-epicfaace.spec b/python-indexed-gzip-fileobj-fork-epicfaace.spec
new file mode 100644
index 0000000..f238c30
--- /dev/null
+++ b/python-indexed-gzip-fileobj-fork-epicfaace.spec
@@ -0,0 +1,959 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-indexed-gzip-fileobj-fork-epicfaace
+Version:	1.5.4
+Release:	1
+Summary:	Fast random access of gzip files in Python
+License:	zlib
+URL:		https://github.com/pauldmccarthy/indexed_gzip_fileobj_fork_epicfaace
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/4f/95/87e51a4e1391fc798afc71d322df46866147402208b757ca6a42801a399b/indexed_gzip_fileobj_fork_epicfaace-1.5.4.tar.gz
+
+
+%description
+# indexed_gzip_fileobj_fork_epicfaace
+
+
+[![PyPi version](https://img.shields.io/pypi/v/indexed_gzip_fileobj_fork_epicfaace.svg)](https://pypi.python.org/pypi/indexed_gzip_fileobj_fork_epicfaace/) [![Anaconda version](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/badges/version.svg)](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/)![Test status](https://github.com/pauldmccarthy/indexed_gzip_fileobj_fork_epicfaace/workflows/master.yaml/badge.svg)
+
+
+ *Fast random access of gzip files in Python*
+
+
+ * [Overview](#overview)
+ * [Installation](#installation)
+ * [Usage](#usage)
+ * [Using with `nibabel`](#using-with-nibabel)
+ * [Index import/export](#index-import-export)
+ * [Write support](#write-support)
+ * [Performance](#performance)
+ * [Acknowledgements](#acknowledgements)
+ * [License](#license)
+
+
+## Overview
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is a Python extension which aims to provide a
+drop-in replacement for the built-in Python `gzip.GzipFile` class, the
+`IndexedGzipFile`.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was written to allow fast random access of compressed
+[NIFTI](http://nifti.nimh.nih.gov/) image files (for which GZIP is the
+de-facto compression standard), but will work with any GZIP file.
+`indexed_gzip_fileobj_fork_epicfaace` is easy to use with `nibabel` (http://nipy.org/nibabel/).
+
+
+The standard `gzip.GzipFile` class exposes a random access-like interface (via
+its `seek` and `read` methods), but every time you seek to a new point in the
+uncompressed data stream, the `GzipFile` instance has to start decompressing
+from the beginning of the file, until it reaches the requested location.
+
+
+An `IndexedGzipFile` instance gets around this performance limitation by
+building an index, which contains *seek points*, mappings between
+corresponding locations in the compressed and uncompressed data streams. Each
+seek point is accompanied by a chunk (32KB) of uncompressed data which is used
+to initialise the decompression algorithm, allowing us to start reading from
+any seek point. If the index is built with a seek point spacing of 1MB, we
+only have to decompress (on average) 512KB of data to read from any location
+in the file.
+
+
+## Intended use
+
+
+You may find `indexed_gzip_fileobj_fork_epicfaace` useful if you need to read from large GZIP files.
+A major advantage of `indexed_gzip_fileobj_fork_epicfaace` is that it will work with any GZIP file.
+However, if you have control over the creation of your GZIP files, you may
+wish to consider some alternatives:
+
+ * [`mgzip`](https://github.com/vinlyx/mgzip/) provides an accelerated
+   GZIP compression and decompression library.
+ * Compression formats other than GZIP, such as `bzip2` and `xz`, have better
+   support for random access.
+
+
+## Installation
+
+
+`indexed_gzip_fileobj_fork_epicfaace` is available on [PyPi](https://pypi.python.org/pypi) - to
+install, simply type:
+```sh
+pip install indexed_gzip_fileobj_fork_epicfaace
+```
+
+
+You can also install `indexed_gzip_fileobj_fork_epicfaace` from conda-forge:
+
+```sh
+conda install -c conda-forge indexed_gzip_fileobj_fork_epicfaace
+```
+
+To compile `indexed_gzip_fileobj_fork_epicfaace`, make sure you have [cython](http://cython.org/)
+installed (and `numpy` if you want to compile the tests), and then run:
+```sh
+python setup.py develop
+```
+
+
+To run the tests, type the following; you will need `numpy`, `nibabel`,
+`pytest`, `pytest-cov`, and `coverage` installed:
+
+```sh
+python -m indexed_gzip_fileobj_fork_epicfaace.tests
+```
+
+## Usage
+
+
+You can use the `indexed_gzip_fileobj_fork_epicfaace` module directly:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# You can create an IndexedGzipFile instance
+# by specifying a file name, or an open file
+# handle. For the latter use, the file handle
+# must be opened in read-only binary mode.
+# Write support is currently non-existent.
+myfile = igzip.IndexedGzipFile('big_file.gz')
+
+some_offset_into_uncompressed_data = 234195
+
+# The index will be automatically
+# built on-demand when seeking or
+# reading.
+myfile.seek(some_offset_into_uncompressed_data)
+data = myfile.read(1048576)
+```
+
+
+## Using with `nibabel`
+
+
+You can use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel`. `nibabel` >= 2.3.0 will
+automatically use `indexed_gzip_fileobj_fork_epicfaace` if it is present:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz')
+```
+
+
+If you are using `nibabel` 2.2.x, you need to explicitly set the `keep_file_open`
+flag:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz', keep_file_open='auto')
+```
+
+
+To use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel` 2.1.0 or older, you need to do a little
+more work:
+
+
+```python
+import nibabel      as nib
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Here we are using 4MB spacing between
+# seek points, and using a larger read
+# buffer (than the default size of 16KB).
+fobj = igzip.IndexedGzipFile(
+    filename='big_image.nii.gz',
+    spacing=4194304,
+    readbuf_size=131072)
+
+# Create a nibabel image using
+# the existing file handle.
+fmap = nib.Nifti1Image.make_file_map()
+fmap['image'].fileobj = fobj
+image = nib.Nifti1Image.from_file_map(fmap)
+
+# Use the image ArrayProxy to access the
+# data - the index will automatically be
+# built as data is accessed.
+vol3 = image.dataobj[:, :, :, 3]
+```
+
+
+## Index import/export
+
+
+If you have a large file, you may wish to pre-generate the index once, and
+save it out to an index file:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Load the file, pre-generate the
+# index, and save it out to disk.
+fobj = igzip.IndexedGzipFile('big_file.gz')
+fobj.build_full_index()
+fobj.export_index('big_file.gzidx')
+```
+
+
+The next time you open the same file, you can load in the index:
+
+
+```python
+import indexed_gip as igzip
+fobj = igzip.IndexedGzipFile('big_file.gz', index_file='big_file.gzidx')
+```
+
+
+## Write support
+
+
+`indexed_gzip_fileobj_fork_epicfaace` does not currently have any support for writing. Currently if you
+wish to write to a file, you will need to save the file by alternate means (e.g.
+via `gzip` or `nibabel`), and then re-create a new `IndexedGzipFile` instance.
+For example:
+
+
+```python
+
+import nibabel as nib
+
+# Load the entire image into memory
+image = nib.load('big_image.nii.gz')
+data = image.get_data()
+
+# Make changes to the data
+data[:, :, :, 5] *= 100
+
+# Save the image using nibabel
+nib.save(data, 'big_image.nii.gz')
+
+# Re-load the image
+image = nib.load('big_image.nii.gz')
+```
+
+
+## Performance
+
+
+A small [test script](indexed_gzip_fileobj_fork_epicfaace/tests/benchmark.py) is included with
+`indexed_gzip_fileobj_fork_epicfaace`; this script compares the performance of the `IndexedGzipFile`
+class with the `gzip.GzipFile` class. This script does the following:
+
+  1. Generates a test file.
+
+  2. Generates a specified number of seek locations, uniformly spaced
+     throughout the test file.
+
+  3. Randomly shuffles these locations
+
+  4. Seeks to each location, and reads a chunk of data from the file.
+
+
+This plot shows the results of this test for a few compresed files of varying
+sizes, with 500 seeks:
+
+
+![Indexed gzip performance](./performance.png)
+
+
+## Acknowledgements
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is based upon the `zran.c` example (written by Mark
+Alder) which ships with the [zlib](http://www.zlib.net/) source code.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was originally inspired by Zalan Rajna's (@zrajna)
+[zindex](https://github.com/zrajna/zindex) project:
+
+    Z. Rajna, A. Keskinarkaus, V. Kiviniemi and T. Seppanen
+    "Speeding up the file access of large compressed NIfTI neuroimaging data"
+    Engineering in Medicine and Biology Society (EMBC), 2015 37th Annual
+    International Conference of the IEEE, Milan, 2015, pp. 654-657.
+
+    https://sourceforge.net/projects/libznzwithzindex/
+
+
+Initial work on `indexed_gzip_fileobj_fork_epicfaace` took place at
+[Brainhack](http://www.brainhack.org/) Paris, at the Institut Pasteur,
+24th-26th February 2016, with the support of the
+[FMRIB Centre](https://www.ndcn.ox.ac.uk/divisions/fmrib/), at the
+University of Oxford, UK.
+
+
+Many thanks to the following contributors (listed chronologically):
+
+ - Zalan Rajna (@zrajna): bug fixes (#2)
+ - Martin Craig (@mcraig-ibme): porting `indexed_gzip_fileobj_fork_epicfaace` to Windows (#3)
+ - Chris Markiewicz (@effigies): Option to drop file handles (#6)
+ - Omer Ozarslan (@ozars): Index import/export (#8)
+ - @DarioDaF: Windows overflow bug (#30)
+ - Sławomir Zborowski (@szborows): `seek_points` method (#35), README fixes
+   (#34)
+
+
+## License
+
+
+`indexed_gzip_fileobj_fork_epicfaace` inherits the [zlib](http://www.zlib.net) license, available for
+perusal in the [LICENSE](LICENSE) file.
+
+
+
+%package -n python3-indexed-gzip-fileobj-fork-epicfaace
+Summary:	Fast random access of gzip files in Python
+Provides:	python-indexed-gzip-fileobj-fork-epicfaace
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+BuildRequires:	python3-cffi
+BuildRequires:	gcc
+BuildRequires:	gdb
+%description -n python3-indexed-gzip-fileobj-fork-epicfaace
+# indexed_gzip_fileobj_fork_epicfaace
+
+
+[![PyPi version](https://img.shields.io/pypi/v/indexed_gzip_fileobj_fork_epicfaace.svg)](https://pypi.python.org/pypi/indexed_gzip_fileobj_fork_epicfaace/) [![Anaconda version](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/badges/version.svg)](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/)![Test status](https://github.com/pauldmccarthy/indexed_gzip_fileobj_fork_epicfaace/workflows/master.yaml/badge.svg)
+
+
+ *Fast random access of gzip files in Python*
+
+
+ * [Overview](#overview)
+ * [Installation](#installation)
+ * [Usage](#usage)
+ * [Using with `nibabel`](#using-with-nibabel)
+ * [Index import/export](#index-import-export)
+ * [Write support](#write-support)
+ * [Performance](#performance)
+ * [Acknowledgements](#acknowledgements)
+ * [License](#license)
+
+
+## Overview
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is a Python extension which aims to provide a
+drop-in replacement for the built-in Python `gzip.GzipFile` class, the
+`IndexedGzipFile`.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was written to allow fast random access of compressed
+[NIFTI](http://nifti.nimh.nih.gov/) image files (for which GZIP is the
+de-facto compression standard), but will work with any GZIP file.
+`indexed_gzip_fileobj_fork_epicfaace` is easy to use with `nibabel` (http://nipy.org/nibabel/).
+
+
+The standard `gzip.GzipFile` class exposes a random access-like interface (via
+its `seek` and `read` methods), but every time you seek to a new point in the
+uncompressed data stream, the `GzipFile` instance has to start decompressing
+from the beginning of the file, until it reaches the requested location.
+
+
+An `IndexedGzipFile` instance gets around this performance limitation by
+building an index, which contains *seek points*, mappings between
+corresponding locations in the compressed and uncompressed data streams. Each
+seek point is accompanied by a chunk (32KB) of uncompressed data which is used
+to initialise the decompression algorithm, allowing us to start reading from
+any seek point. If the index is built with a seek point spacing of 1MB, we
+only have to decompress (on average) 512KB of data to read from any location
+in the file.
+
+
+## Intended use
+
+
+You may find `indexed_gzip_fileobj_fork_epicfaace` useful if you need to read from large GZIP files.
+A major advantage of `indexed_gzip_fileobj_fork_epicfaace` is that it will work with any GZIP file.
+However, if you have control over the creation of your GZIP files, you may
+wish to consider some alternatives:
+
+ * [`mgzip`](https://github.com/vinlyx/mgzip/) provides an accelerated
+   GZIP compression and decompression library.
+ * Compression formats other than GZIP, such as `bzip2` and `xz`, have better
+   support for random access.
+
+
+## Installation
+
+
+`indexed_gzip_fileobj_fork_epicfaace` is available on [PyPi](https://pypi.python.org/pypi) - to
+install, simply type:
+```sh
+pip install indexed_gzip_fileobj_fork_epicfaace
+```
+
+
+You can also install `indexed_gzip_fileobj_fork_epicfaace` from conda-forge:
+
+```sh
+conda install -c conda-forge indexed_gzip_fileobj_fork_epicfaace
+```
+
+To compile `indexed_gzip_fileobj_fork_epicfaace`, make sure you have [cython](http://cython.org/)
+installed (and `numpy` if you want to compile the tests), and then run:
+```sh
+python setup.py develop
+```
+
+
+To run the tests, type the following; you will need `numpy`, `nibabel`,
+`pytest`, `pytest-cov`, and `coverage` installed:
+
+```sh
+python -m indexed_gzip_fileobj_fork_epicfaace.tests
+```
+
+## Usage
+
+
+You can use the `indexed_gzip_fileobj_fork_epicfaace` module directly:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# You can create an IndexedGzipFile instance
+# by specifying a file name, or an open file
+# handle. For the latter use, the file handle
+# must be opened in read-only binary mode.
+# Write support is currently non-existent.
+myfile = igzip.IndexedGzipFile('big_file.gz')
+
+some_offset_into_uncompressed_data = 234195
+
+# The index will be automatically
+# built on-demand when seeking or
+# reading.
+myfile.seek(some_offset_into_uncompressed_data)
+data = myfile.read(1048576)
+```
+
+
+## Using with `nibabel`
+
+
+You can use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel`. `nibabel` >= 2.3.0 will
+automatically use `indexed_gzip_fileobj_fork_epicfaace` if it is present:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz')
+```
+
+
+If you are using `nibabel` 2.2.x, you need to explicitly set the `keep_file_open`
+flag:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz', keep_file_open='auto')
+```
+
+
+To use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel` 2.1.0 or older, you need to do a little
+more work:
+
+
+```python
+import nibabel      as nib
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Here we are using 4MB spacing between
+# seek points, and using a larger read
+# buffer (than the default size of 16KB).
+fobj = igzip.IndexedGzipFile(
+    filename='big_image.nii.gz',
+    spacing=4194304,
+    readbuf_size=131072)
+
+# Create a nibabel image using
+# the existing file handle.
+fmap = nib.Nifti1Image.make_file_map()
+fmap['image'].fileobj = fobj
+image = nib.Nifti1Image.from_file_map(fmap)
+
+# Use the image ArrayProxy to access the
+# data - the index will automatically be
+# built as data is accessed.
+vol3 = image.dataobj[:, :, :, 3]
+```
+
+
+## Index import/export
+
+
+If you have a large file, you may wish to pre-generate the index once, and
+save it out to an index file:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Load the file, pre-generate the
+# index, and save it out to disk.
+fobj = igzip.IndexedGzipFile('big_file.gz')
+fobj.build_full_index()
+fobj.export_index('big_file.gzidx')
+```
+
+
+The next time you open the same file, you can load in the index:
+
+
+```python
+import indexed_gip as igzip
+fobj = igzip.IndexedGzipFile('big_file.gz', index_file='big_file.gzidx')
+```
+
+
+## Write support
+
+
+`indexed_gzip_fileobj_fork_epicfaace` does not currently have any support for writing. Currently if you
+wish to write to a file, you will need to save the file by alternate means (e.g.
+via `gzip` or `nibabel`), and then re-create a new `IndexedGzipFile` instance.
+For example:
+
+
+```python
+
+import nibabel as nib
+
+# Load the entire image into memory
+image = nib.load('big_image.nii.gz')
+data = image.get_data()
+
+# Make changes to the data
+data[:, :, :, 5] *= 100
+
+# Save the image using nibabel
+nib.save(data, 'big_image.nii.gz')
+
+# Re-load the image
+image = nib.load('big_image.nii.gz')
+```
+
+
+## Performance
+
+
+A small [test script](indexed_gzip_fileobj_fork_epicfaace/tests/benchmark.py) is included with
+`indexed_gzip_fileobj_fork_epicfaace`; this script compares the performance of the `IndexedGzipFile`
+class with the `gzip.GzipFile` class. This script does the following:
+
+  1. Generates a test file.
+
+  2. Generates a specified number of seek locations, uniformly spaced
+     throughout the test file.
+
+  3. Randomly shuffles these locations
+
+  4. Seeks to each location, and reads a chunk of data from the file.
+
+
+This plot shows the results of this test for a few compresed files of varying
+sizes, with 500 seeks:
+
+
+![Indexed gzip performance](./performance.png)
+
+
+## Acknowledgements
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is based upon the `zran.c` example (written by Mark
+Alder) which ships with the [zlib](http://www.zlib.net/) source code.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was originally inspired by Zalan Rajna's (@zrajna)
+[zindex](https://github.com/zrajna/zindex) project:
+
+    Z. Rajna, A. Keskinarkaus, V. Kiviniemi and T. Seppanen
+    "Speeding up the file access of large compressed NIfTI neuroimaging data"
+    Engineering in Medicine and Biology Society (EMBC), 2015 37th Annual
+    International Conference of the IEEE, Milan, 2015, pp. 654-657.
+
+    https://sourceforge.net/projects/libznzwithzindex/
+
+
+Initial work on `indexed_gzip_fileobj_fork_epicfaace` took place at
+[Brainhack](http://www.brainhack.org/) Paris, at the Institut Pasteur,
+24th-26th February 2016, with the support of the
+[FMRIB Centre](https://www.ndcn.ox.ac.uk/divisions/fmrib/), at the
+University of Oxford, UK.
+
+
+Many thanks to the following contributors (listed chronologically):
+
+ - Zalan Rajna (@zrajna): bug fixes (#2)
+ - Martin Craig (@mcraig-ibme): porting `indexed_gzip_fileobj_fork_epicfaace` to Windows (#3)
+ - Chris Markiewicz (@effigies): Option to drop file handles (#6)
+ - Omer Ozarslan (@ozars): Index import/export (#8)
+ - @DarioDaF: Windows overflow bug (#30)
+ - Sławomir Zborowski (@szborows): `seek_points` method (#35), README fixes
+   (#34)
+
+
+## License
+
+
+`indexed_gzip_fileobj_fork_epicfaace` inherits the [zlib](http://www.zlib.net) license, available for
+perusal in the [LICENSE](LICENSE) file.
+
+
+
+%package help
+Summary:	Development documents and examples for indexed-gzip-fileobj-fork-epicfaace
+Provides:	python3-indexed-gzip-fileobj-fork-epicfaace-doc
+%description help
+# indexed_gzip_fileobj_fork_epicfaace
+
+
+[![PyPi version](https://img.shields.io/pypi/v/indexed_gzip_fileobj_fork_epicfaace.svg)](https://pypi.python.org/pypi/indexed_gzip_fileobj_fork_epicfaace/) [![Anaconda version](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/badges/version.svg)](https://anaconda.org/conda-forge/indexed_gzip_fileobj_fork_epicfaace/)![Test status](https://github.com/pauldmccarthy/indexed_gzip_fileobj_fork_epicfaace/workflows/master.yaml/badge.svg)
+
+
+ *Fast random access of gzip files in Python*
+
+
+ * [Overview](#overview)
+ * [Installation](#installation)
+ * [Usage](#usage)
+ * [Using with `nibabel`](#using-with-nibabel)
+ * [Index import/export](#index-import-export)
+ * [Write support](#write-support)
+ * [Performance](#performance)
+ * [Acknowledgements](#acknowledgements)
+ * [License](#license)
+
+
+## Overview
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is a Python extension which aims to provide a
+drop-in replacement for the built-in Python `gzip.GzipFile` class, the
+`IndexedGzipFile`.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was written to allow fast random access of compressed
+[NIFTI](http://nifti.nimh.nih.gov/) image files (for which GZIP is the
+de-facto compression standard), but will work with any GZIP file.
+`indexed_gzip_fileobj_fork_epicfaace` is easy to use with `nibabel` (http://nipy.org/nibabel/).
+
+
+The standard `gzip.GzipFile` class exposes a random access-like interface (via
+its `seek` and `read` methods), but every time you seek to a new point in the
+uncompressed data stream, the `GzipFile` instance has to start decompressing
+from the beginning of the file, until it reaches the requested location.
+
+
+An `IndexedGzipFile` instance gets around this performance limitation by
+building an index, which contains *seek points*, mappings between
+corresponding locations in the compressed and uncompressed data streams. Each
+seek point is accompanied by a chunk (32KB) of uncompressed data which is used
+to initialise the decompression algorithm, allowing us to start reading from
+any seek point. If the index is built with a seek point spacing of 1MB, we
+only have to decompress (on average) 512KB of data to read from any location
+in the file.
+
+
+## Intended use
+
+
+You may find `indexed_gzip_fileobj_fork_epicfaace` useful if you need to read from large GZIP files.
+A major advantage of `indexed_gzip_fileobj_fork_epicfaace` is that it will work with any GZIP file.
+However, if you have control over the creation of your GZIP files, you may
+wish to consider some alternatives:
+
+ * [`mgzip`](https://github.com/vinlyx/mgzip/) provides an accelerated
+   GZIP compression and decompression library.
+ * Compression formats other than GZIP, such as `bzip2` and `xz`, have better
+   support for random access.
+
+
+## Installation
+
+
+`indexed_gzip_fileobj_fork_epicfaace` is available on [PyPi](https://pypi.python.org/pypi) - to
+install, simply type:
+```sh
+pip install indexed_gzip_fileobj_fork_epicfaace
+```
+
+
+You can also install `indexed_gzip_fileobj_fork_epicfaace` from conda-forge:
+
+```sh
+conda install -c conda-forge indexed_gzip_fileobj_fork_epicfaace
+```
+
+To compile `indexed_gzip_fileobj_fork_epicfaace`, make sure you have [cython](http://cython.org/)
+installed (and `numpy` if you want to compile the tests), and then run:
+```sh
+python setup.py develop
+```
+
+
+To run the tests, type the following; you will need `numpy`, `nibabel`,
+`pytest`, `pytest-cov`, and `coverage` installed:
+
+```sh
+python -m indexed_gzip_fileobj_fork_epicfaace.tests
+```
+
+## Usage
+
+
+You can use the `indexed_gzip_fileobj_fork_epicfaace` module directly:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# You can create an IndexedGzipFile instance
+# by specifying a file name, or an open file
+# handle. For the latter use, the file handle
+# must be opened in read-only binary mode.
+# Write support is currently non-existent.
+myfile = igzip.IndexedGzipFile('big_file.gz')
+
+some_offset_into_uncompressed_data = 234195
+
+# The index will be automatically
+# built on-demand when seeking or
+# reading.
+myfile.seek(some_offset_into_uncompressed_data)
+data = myfile.read(1048576)
+```
+
+
+## Using with `nibabel`
+
+
+You can use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel`. `nibabel` >= 2.3.0 will
+automatically use `indexed_gzip_fileobj_fork_epicfaace` if it is present:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz')
+```
+
+
+If you are using `nibabel` 2.2.x, you need to explicitly set the `keep_file_open`
+flag:
+
+
+```python
+import nibabel as nib
+
+image = nib.load('big_image.nii.gz', keep_file_open='auto')
+```
+
+
+To use `indexed_gzip_fileobj_fork_epicfaace` with `nibabel` 2.1.0 or older, you need to do a little
+more work:
+
+
+```python
+import nibabel      as nib
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Here we are using 4MB spacing between
+# seek points, and using a larger read
+# buffer (than the default size of 16KB).
+fobj = igzip.IndexedGzipFile(
+    filename='big_image.nii.gz',
+    spacing=4194304,
+    readbuf_size=131072)
+
+# Create a nibabel image using
+# the existing file handle.
+fmap = nib.Nifti1Image.make_file_map()
+fmap['image'].fileobj = fobj
+image = nib.Nifti1Image.from_file_map(fmap)
+
+# Use the image ArrayProxy to access the
+# data - the index will automatically be
+# built as data is accessed.
+vol3 = image.dataobj[:, :, :, 3]
+```
+
+
+## Index import/export
+
+
+If you have a large file, you may wish to pre-generate the index once, and
+save it out to an index file:
+
+
+```python
+import indexed_gzip_fileobj_fork_epicfaace as igzip
+
+# Load the file, pre-generate the
+# index, and save it out to disk.
+fobj = igzip.IndexedGzipFile('big_file.gz')
+fobj.build_full_index()
+fobj.export_index('big_file.gzidx')
+```
+
+
+The next time you open the same file, you can load in the index:
+
+
+```python
+import indexed_gip as igzip
+fobj = igzip.IndexedGzipFile('big_file.gz', index_file='big_file.gzidx')
+```
+
+
+## Write support
+
+
+`indexed_gzip_fileobj_fork_epicfaace` does not currently have any support for writing. Currently if you
+wish to write to a file, you will need to save the file by alternate means (e.g.
+via `gzip` or `nibabel`), and then re-create a new `IndexedGzipFile` instance.
+For example:
+
+
+```python
+
+import nibabel as nib
+
+# Load the entire image into memory
+image = nib.load('big_image.nii.gz')
+data = image.get_data()
+
+# Make changes to the data
+data[:, :, :, 5] *= 100
+
+# Save the image using nibabel
+nib.save(data, 'big_image.nii.gz')
+
+# Re-load the image
+image = nib.load('big_image.nii.gz')
+```
+
+
+## Performance
+
+
+A small [test script](indexed_gzip_fileobj_fork_epicfaace/tests/benchmark.py) is included with
+`indexed_gzip_fileobj_fork_epicfaace`; this script compares the performance of the `IndexedGzipFile`
+class with the `gzip.GzipFile` class. This script does the following:
+
+  1. Generates a test file.
+
+  2. Generates a specified number of seek locations, uniformly spaced
+     throughout the test file.
+
+  3. Randomly shuffles these locations
+
+  4. Seeks to each location, and reads a chunk of data from the file.
+
+
+This plot shows the results of this test for a few compresed files of varying
+sizes, with 500 seeks:
+
+
+![Indexed gzip performance](./performance.png)
+
+
+## Acknowledgements
+
+
+The `indexed_gzip_fileobj_fork_epicfaace` project is based upon the `zran.c` example (written by Mark
+Alder) which ships with the [zlib](http://www.zlib.net/) source code.
+
+
+`indexed_gzip_fileobj_fork_epicfaace` was originally inspired by Zalan Rajna's (@zrajna)
+[zindex](https://github.com/zrajna/zindex) project:
+
+    Z. Rajna, A. Keskinarkaus, V. Kiviniemi and T. Seppanen
+    "Speeding up the file access of large compressed NIfTI neuroimaging data"
+    Engineering in Medicine and Biology Society (EMBC), 2015 37th Annual
+    International Conference of the IEEE, Milan, 2015, pp. 654-657.
+
+    https://sourceforge.net/projects/libznzwithzindex/
+
+
+Initial work on `indexed_gzip_fileobj_fork_epicfaace` took place at
+[Brainhack](http://www.brainhack.org/) Paris, at the Institut Pasteur,
+24th-26th February 2016, with the support of the
+[FMRIB Centre](https://www.ndcn.ox.ac.uk/divisions/fmrib/), at the
+University of Oxford, UK.
+
+
+Many thanks to the following contributors (listed chronologically):
+
+ - Zalan Rajna (@zrajna): bug fixes (#2)
+ - Martin Craig (@mcraig-ibme): porting `indexed_gzip_fileobj_fork_epicfaace` to Windows (#3)
+ - Chris Markiewicz (@effigies): Option to drop file handles (#6)
+ - Omer Ozarslan (@ozars): Index import/export (#8)
+ - @DarioDaF: Windows overflow bug (#30)
+ - Sławomir Zborowski (@szborows): `seek_points` method (#35), README fixes
+   (#34)
+
+
+## License
+
+
+`indexed_gzip_fileobj_fork_epicfaace` inherits the [zlib](http://www.zlib.net) license, available for
+perusal in the [LICENSE](LICENSE) file.
+
+
+
+%prep
+%autosetup -n indexed-gzip-fileobj-fork-epicfaace-1.5.4
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-indexed-gzip-fileobj-fork-epicfaace -f filelist.lst
+%dir %{python3_sitearch}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Mon May 15 2023 Python_Bot <Python_Bot@openeuler.org> - 1.5.4-1
+- Package Spec generated