{ "info": { "author": "Tom Doel", "author_email": "t.doel@ucl.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: Healthcare Industry", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Image Recognition", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Scientific/Engineering :: Medical Science Apps.", "Topic :: Scientific/Engineering :: Visualization" ], "description": "ImageSplit\n==========\n\n.. image:: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/raw/master/giftsurg-icon.png\n :height: 128px\n :width: 128px\n :target: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit\n\n\n.. image:: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/badges/master/build.svg\n :target: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/commits/master\n :alt: GitLab-CI test status\n\n.. image:: https://travis-ci.org/gift-surg/ImageSplit.svg?branch=master\n :target: https://travis-ci.org/gift-surg/ImageSplit\n :alt: Travis test status\n\n.. image:: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/badges/master/coverage.svg\n :target: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/commits/master\n :alt: Test coverage\n\n.. image:: https://readthedocs.org/projects/imagesplit/badge/?version=latest\n :target: http://imagesplit.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\nImageSplit is a utility for splitting very large image volumes into slices or multiple overlapping sub-volumes, and for recombining sub-volumes into a one or more volumes. ImageSplit can also convert the underlying data types.\n\nImageSplit is designed to prioritise low memory usage over performance, so that large volumes can be easily processed with limited memory resources.\n\nAuthor: Tom Doel\n\nImageSplit was developed as part of the `GIFT-Surg`_ project, at the `Translational Imaging Group (TIG)`_ in the `Centre for Medical Image Computing (CMIC)`_ at `University College London (UCL)`_.\n\n\nInstalling\n~~~~~~~~~~\n\n::\n\n pip install imagesplit\n\nNotes:\n * We recommend you use pip to install ImageSplit.\n * Ensure you have Python 2.7 or 3.5 or later installed\n * (especially for macOS users): we suggest you do not modify the system installation of Python 2.7. Instead install a separate version of Python for development purposes (for example, using Homebrew), or use `virtualenv` to create a python virtual environment which you can safely modify without affecting the system installation.\n * If you have Python 2 and Python 3 insatlled, `pip2` may map to Python 2 and `pip3` may map to Python 3. This will depend on your installation\n * If you get permission errors when using `pip`, you may be trying to modify the system Python installation. This is not recommended. Instead install a local version of Python for development, or use a virtual environment (`virtualenv`).\n\n\nExample usage\n~~~~~~~~~~~~~\n\nPlease see detailed usage below.\n\nHere is an example which splits files:\n\n::\n\n imagesplit --input input_data/image.vge --out output_data/split_image -s c --format tiff -z --rescale -50 350 --type uchar\n\n\n\nThis command will:\n * split the volume file with header `input_data/image.vge`\n * into coronal slices (`-s c`)\n * saving them in the `output_data` folder with the filenames `split_image_0000.tiff`, `split_image_0001.tiff` etc\n * The file format is tiff (`--format tiff`)\n * with default compression (`-z`)\n * and data type unsigned char (`--type uchar`)\n * The data will be normalised (rescaled) between minimum and maximum values `-50` and `350` (`--rescale -50 350`)\n\nHere is an example which combines files which are derived from files produced by a previous splitting:\n\n::\n\n imagesplit --input input_data/split_mask.mhd --out output_data/combined_image --format mhd --descriptor output_data/split_image__info.imagesplit\n\nThis command will:\n * Combine multiple images in the folder `input_data/split_mask_*.mhd` into a single output file output_data/combined_image.mhd\n * The splitting of the input files is determined from the descriptor file `output_data/split_image__info.imagesplit` generated by a previous splitting command\n * If you are recombining the files that were originally split, you don't need to specify `--input`. If however you are combining files that are not the ones that were originally split, but which are derived from those, then specify `--input` will modify the filenames in the descriptor to match the input files.\n For example, if you split an image file into multiple subimages, and then compute a mask from each subimage, you can use the original descriptor file to assemble the masks into a combined mask volume. The descriptor is the one from the splitting, but the input filename points to the mask files to combine. The descriptor file will be loaded but the filenames modified to match the mask filenames.\n\n\nDetailed Usage\n~~~~~~~~~~~~~~\n\n::\n\n imagesplit.py [-h] -i INPUT [-o OUT] [-l OVERLAP] [-m MAX [MAX ...]] [-x STARTINDEX] [-t TYPE] [-f FORMAT] [-r [RESCALE [RESCALE ...]]] [-z [COMPRESS]] [-s SLICE] [-a AXIS [AXIS ...]] [-d DESCRIPTOR] [--test]\n\n\n:warning: ImageSplit will overwrite existing output files. Make sure you have your images backed up before you use this utility, to prevent accidental data loss.\n\n\n\nArguments:\n\n\nInput and output filenames:\n\n -i INPUT, --input INPUT Name of input file, or filename prefix for a set of files. If you are combining multiple files using a descriptor, with filenames of the form `*_0001.mhd`, be sure to omit the `*_0001` from the input filename, as it will be appended automatically.\n\n -o OUT, --out OUT Name of output file, or filename prefix if more than one file is output\n\n -x STARTINDEX, --startindex STARTINDEX\n Start index for filename suffix when loading or saving\n a sequence of files\n\n -d DESCRIPTOR\n Specifies that the input files should be assembled using the file DESCRIPTOR as a guide. The DESCRIPTOR file (.imagesplit) is generated from a previous splitting, and stores file offsets which allow you to assemble subvolumes back into a volume.\n The filenames in the DESCRIPTOR file will be overridden by the specified INPUT file name.\n This allows you to combine files according to a template generated from a different file splitting.\n\nSpecify how to split the image:\n\n -l OVERLAP, --overlap OVERLAP\n Number of voxels to overlap between output images. If\n not specified, output images will not overlap\n\n -m MAX, --max MAX\n Maximum number of voxels in each dimension in each\n output file. MAX can be a scalar or vector corresponding\n to each image dimension. The file will be optimally\n split such that each file output dimension is less\n than or equal to this maximum.\n\n\nSpecify file format, data type, and whether data should be rescaled (normalised):\n\n -t TYPE, --type TYPE Output data type (default: same as input file datatype)\n\n -f FORMAT, --format FORMAT Output file format such as mhd, tiff (default: same as input file format)\n\n -r RESCALE, --rescale RESCALE\n Rescale image between the specified min and max\n values. If no RESCALE values are specified, use the volume limits.\n\n -z COMPRESS, --compress COMPRESS\n Enables compression (default if -Z not specified: no compression). Valid\n values depend on the output file format. -z with no\n COMPRESS argument will choose a suitable compression for\n this file format. For TIFF files, the default is Adboe\n deflat and other valid values are those supported by PIL.\n\n\nSpecify output orientation:\n\n -s SLICE, --slice SLICE\n Divide image into slices along the specified axis.\n Choose 1, 2, 3 etc to select an axis relative to the\n current image orientation, or c, s, a to select an\n absolute orientation.This argument cannot be used with --axis, --max or --overlap.\n\n -a AXIS, --axis AXIS\n Axis ordering (default 1 2 3). Specifies the global\n axis corresponding to each dimension in the image\n file. The first value is the global axis represented\n by the first dimension in the file, and so on. One\n value for each dimension, dimensions are numbered\n 1,2,3,... and a negative value means that axis is\n flipped. This cannot be used with --slice\n\n\n\nHelp and testing:\n\n --test If set, no writing will be performed to the output files\n -h, --help Show this help message and exit\n\n\nContributing\n^^^^^^^^^^^^\n\nPlease see the `contributing guidelines`_.\n\n\nUseful links\n^^^^^^^^^^^^\n\n`Source code repository`_\n`Documentation`_\n\n\nLicensing and copyright\n-----------------------\n\nCopyright 2017-2018 University College London.\nImageSplit is released under the BSD-3 licence. Please see the `license file`_ for details.\n\n\nAcknowledgements\n----------------\n\nSupported by `Wellcome`_ and `EPSRC`_.\n\n\n.. _`Wellcome EPSRC Centre for Interventional and Surgical Sciences`: http://www.ucl.ac.uk/weiss\n.. _`source code repository`: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit\n.. _`Documentation`: https://imagesplit.readthedocs.io\n.. _`University College London (UCL)`: http://www.ucl.ac.uk/\n.. _`Translational Imaging Group (TIG)`: http://cmictig.cs.ucl.ac.uk/\n.. _`Centre for Medical Image Computing (CMIC)`: http://cmic.cs.ucl.ac.uk\n.. _`Wellcome`: https://wellcome.ac.uk/\n.. _`GIFT-Surg`: https://www.gift-surg.ac.uk\n.. _`EPSRC`: https://www.epsrc.ac.uk/\n.. _`contributing guidelines`: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/blob/master/CONTRIBUTING.rst\n.. _`license file`: https://cmiclab.cs.ucl.ac.uk/GIFT-Surg/ImageSplit/blob/master/LICENSE\n\n\n\n\n\n\n\n\n\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/gift-surg/ImageSplit", "keywords": "image file formats", "license": "BSD license", "maintainer": "", "maintainer_email": "", "name": "ImageSplit", "package_url": "https://pypi.org/project/ImageSplit/", "platform": "", "project_url": "https://pypi.org/project/ImageSplit/", "project_urls": { "Homepage": "https://github.com/gift-surg/ImageSplit" }, "release_url": "https://pypi.org/project/ImageSplit/0.3.1/", "requires_dist": [ "numpy (>=1.11)", "pillow", "six (>=1.10)" ], "requires_python": "", "summary": "Utility for splitting large image files into slices or chunks", "version": "0.3.1" }, "last_serial": 4049584, "releases": { "0.1.3": [ { "comment_text": "", "digests": { "md5": "190b80f5fbe7297cee6b0febfe87a30e", "sha256": "cdae045c07f20c5a2a3e5788e3c51fc02cda3741396717644812a3c56e612840" }, "downloads": -1, "filename": "ImageSplit-0.1.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "190b80f5fbe7297cee6b0febfe87a30e", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 38792, "upload_time": "2018-02-16T14:47:21", "url": "https://files.pythonhosted.org/packages/7b/50/9aacf82a6f850ba92ecf9563ee953dc298e8cdf43bb1ef73828020fb9adc/ImageSplit-0.1.3-py2.py3-none-any.whl" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "4fbd46d206fff0e1a5f0a8d9794200df", "sha256": "671deaca0a2d50d7c7b3c49f234d242138f571e00473218cc5b7c9df26480808" }, "downloads": -1, "filename": "ImageSplit-0.1.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "4fbd46d206fff0e1a5f0a8d9794200df", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 38793, "upload_time": "2018-02-16T16:58:20", "url": "https://files.pythonhosted.org/packages/42/7e/14663487cfaa110ac6f41148ff1c7d9ba80c8ef03248a50ec98e08f6fa0d/ImageSplit-0.1.4-py2.py3-none-any.whl" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "be78d90c4fb53db2506faa9f33c2b7f0", "sha256": "4b863c8709f96e74a31473a4380b88f8792301c924fb15e659ac823fc3ecc65a" }, "downloads": -1, "filename": "ImageSplit-0.1.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "be78d90c4fb53db2506faa9f33c2b7f0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 38793, "upload_time": "2018-02-16T17:20:37", "url": "https://files.pythonhosted.org/packages/02/2c/cf66b3a890a5588803ed70dd3d36b7f7a09fa5d480b275323ae0af90d462/ImageSplit-0.1.5-py2.py3-none-any.whl" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "d66edd19288aae51d1dc81909825cd70", "sha256": "fa77c3d65887266269f872e8b896cf2f89c1c155baa86e0cfec29072f2cc002f" }, "downloads": -1, "filename": "ImageSplit-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d66edd19288aae51d1dc81909825cd70", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 40297, "upload_time": "2018-02-20T16:36:44", "url": "https://files.pythonhosted.org/packages/9a/9b/cd2d85e17722726bdb8b4b4416d8e7c91c23a536dd94760d15a382591f52/ImageSplit-0.1.6-py2.py3-none-any.whl" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "471fe03c5ba2f66ef254b8900a2ff504", "sha256": "34bcbe503c7fd96a59640c5bd19efdeca144ba3e6a512c92096135063eb307e5" }, "downloads": -1, "filename": "ImageSplit-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "471fe03c5ba2f66ef254b8900a2ff504", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 40876, "upload_time": "2018-02-28T11:35:41", "url": "https://files.pythonhosted.org/packages/23/46/08f99defe613a9083ffda3171ab513ac99bc54d17ac33b903340f2a29ecd/ImageSplit-0.2.0-py2.py3-none-any.whl" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "9a08c2d61e52ab944ae865195698fd6b", "sha256": "f44f2820f34b98b8c3dfbb3af097b4d7a8dd072f7caef66f78f0a1fd24832a7f" }, "downloads": -1, "filename": "ImageSplit-0.2.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9a08c2d61e52ab944ae865195698fd6b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 36338, "upload_time": "2018-05-04T16:16:58", "url": "https://files.pythonhosted.org/packages/7b/71/a4f9d223f6196ea3b77163df4e045be612b109653e512d2039911556a3f8/ImageSplit-0.2.3-py2.py3-none-any.whl" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "0059534a5537f7d48cd8540b3ab096c7", "sha256": "9fc3ce777c4212fb9d0c4a5338fe710aad4341c110bc1f2eb77f88ab82a64925" }, "downloads": -1, "filename": "ImageSplit-0.2.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0059534a5537f7d48cd8540b3ab096c7", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 41183, "upload_time": "2018-06-18T11:36:11", "url": "https://files.pythonhosted.org/packages/b1/cd/2479327628f539fa9d6f33011d73e0347a4391e8ed71ac375e3878fcf0f0/ImageSplit-0.2.4-py2.py3-none-any.whl" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "df823d0c90feb6d387fcd8534d707be9", "sha256": "0f57c4ccd0136b68e9504c437bd8a0b1f2edf5d1504773d8189dce85f3332acf" }, "downloads": -1, "filename": "ImageSplit-0.2.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "df823d0c90feb6d387fcd8534d707be9", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 41183, "upload_time": "2018-06-18T16:36:22", "url": "https://files.pythonhosted.org/packages/12/ca/23a161c251c0702a74e6d0913ba9b546c28796e1322713429f88cadde706/ImageSplit-0.2.5-py2.py3-none-any.whl" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "0b8eef46ed61a80981f763ac5bd38426", "sha256": "40651cfeaf116aab536a81c5114ac99709bd70f413b6030ec07db91057b8bbf2" }, "downloads": -1, "filename": "ImageSplit-0.3.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0b8eef46ed61a80981f763ac5bd38426", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 46955, "upload_time": "2018-07-08T13:30:15", "url": "https://files.pythonhosted.org/packages/f4/90/b0e3d527efaf841dd3bdcb6f9b2f50dc9a9de1911facc349e5509f4becff/ImageSplit-0.3.0-py2.py3-none-any.whl" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "5c51c501e34d26eff228673c7ede6d4f", "sha256": "97d97a4d8fb4228d0b1b1eeeb04eabae400724baa8695ff38459dcf1a55fc2e4" }, "downloads": -1, "filename": "ImageSplit-0.3.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5c51c501e34d26eff228673c7ede6d4f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 46950, "upload_time": "2018-07-11T04:12:41", "url": "https://files.pythonhosted.org/packages/74/2a/7b8cc5e8d9f8ce52752612fbd569003839c77a39217a797689fe0a021b3b/ImageSplit-0.3.1-py2.py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5c51c501e34d26eff228673c7ede6d4f", "sha256": "97d97a4d8fb4228d0b1b1eeeb04eabae400724baa8695ff38459dcf1a55fc2e4" }, "downloads": -1, "filename": "ImageSplit-0.3.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5c51c501e34d26eff228673c7ede6d4f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 46950, "upload_time": "2018-07-11T04:12:41", "url": "https://files.pythonhosted.org/packages/74/2a/7b8cc5e8d9f8ce52752612fbd569003839c77a39217a797689fe0a021b3b/ImageSplit-0.3.1-py2.py3-none-any.whl" } ] }