{ "info": { "author": "Curtis Rueden, Leon Yang, Yang Liu, Michael Pinkert", "author_email": "ctrueden@wisc.edu", "bugtrack_url": null, "classifiers": [], "description": "# Python wrapper for ImageJ\n\n[`pyimagej`](https://github.com/imagej/pyimagej) provides a set of\nwrapper functions for integration between ImageJ and Python.\n\nIt also provides a high-level entry point `imagej.IJ` for invoking\n[ImageJ Server](https://github.com/imagej/imagej-server) APIs;\nsee \"ImageJ Server\" below for details.\n\n## Requirements\n\nInstall dependencies using `conda env create -f environment.yml`.\n\nSee also:\n\n* [scyjava](https://github.com/scijava/scyjava)\n* [imglyb](https://github.com/imglib/imglyb)\n\n## Usage\n\n### Creating the ImageJ gateway\n\n#### Newest available version\n\nIf you want to launch the newest available release version of ImageJ:\n\n```python\nimport imagej\nij = imagej.init()\n```\n\nThis invocation will automatically download and cache the newest release of\n[net.imagej:imagej](http://maven.imagej.net/#nexus-search;gav~net.imagej~imagej~~~).\n\n#### With graphical capabilities\n\nIf you want to have support for the graphical user interface:\n\n```python\nimport imagej\nij = imagej.init(headless=False)\nij.ui().showUI()\n```\n\nNote there are issues with Java AWT via Python on macOS; see\n[this article](https://github.com/imglib/imglyb#awt-through-pyjnius-on-osx)\nfor a workaround.\n\n#### Including ImageJ 1.x support\n\nBy default, the ImageJ gateway will not include the\n[legacy layer](https://imagej.net/Legacy) for backwards compatibility with\n[ImageJ 1.x](https://imagej.net/ImageJ1).\nYou can enable the legacy layer as follows:\n\n```python\nimport imagej\nij = imagej.init('net.imagej:imagej+net.imagej:imagej-legacy')\n```\n\n#### Including Fiji plugins\n\nBy default, the ImageJ gateway will include base ImageJ2 functionality only,\nwithout additional plugins such as those that ship with the\n[Fiji](https://fiji.sc/) distribution of ImageJ.\n\nYou can create an ImageJ gateway including Fiji plugins as follows:\n\n```python\nimport imagej\nij = imagej.init('sc.fiji:fiji')\n```\n\n#### From a local installation\n\nIf you have an installation of [ImageJ2](https://imagej.net/ImageJ2)\nsuch as [Fiji](https://fiji.sc/), you can wrap an ImageJ gateway around it:\n\n```python\nimport imagej\nij = imagej.init('/Applications/Fiji.app')\n```\n\nReplace `/Applications/Fiji.app` with the actual location of your installation.\n\n### Using the ImageJ gateway\n\nOnce you have your ImageJ gateway, you can start using it. Here is an example:\n\n```python\n# Import an image with scikit-image.\nimport skimage\nfrom skimage import io\n# NB: Blood vessel image from: https://www.fi.edu/heart/blood-vessels\nimg = io.imread('https://www.fi.edu/sites/fi.live.franklinds.webair.com/files/styles/featured_large/public/General_EduRes_Heart_BloodVessels_0.jpg')\nimport numpy as np\nimg = np.mean(img, axis=2)\n\n# Invoke ImageJ's Frangi vesselness op.\nvessels = np.zeros(img.shape, dtype=img.dtype)\nij.op().filter().frangiVesselness(ij.py.to_java(vessels), ij.py.to_java(img), [1, 1], 20)\n```\n\nSee also `test/test_imagej.py` for other examples of usage.\n\n\n# ImageJ Server\n\n## Requirements\n\nThe imagej.server module has its own requirements:\n\n* `requests` is required to communicate with the ImageJ server.\n* `pillow` is required for the `imagej.server.IJ.show()` function.\n In addition, `display` or `xv` must be available to view the image.\n\n## Usage\n\nThere is a short usage example\n[here](https://github.com/imagej/imagej.py/blob/master/imagej/server/usage.py).\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/imagej/pyimagej", "keywords": "", "license": "Apache 2.0", "maintainer": "", "maintainer_email": "", "name": "pyimagej", "package_url": "https://pypi.org/project/pyimagej/", "platform": "any", "project_url": "https://pypi.org/project/pyimagej/", "project_urls": { "Homepage": "https://github.com/imagej/pyimagej" }, "release_url": "https://pypi.org/project/pyimagej/0.4.0/", "requires_dist": [ "imglyb", "matplotlib", "numpy", "pyjnius", "scyjava", "pillow", "requests" ], "requires_python": "", "summary": "Python wrapper for ImageJ", "version": "0.4.0" }, "last_serial": 4554482, "releases": { "0.4.0": [ { "comment_text": "", "digests": { "md5": "c3020b50891314c957d92b152192f58c", "sha256": "11472afef43d61046c83a3aad318a1430bc11876e88044a288954fdafa8dbd29" }, "downloads": -1, "filename": "pyimagej-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c3020b50891314c957d92b152192f58c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7342, "upload_time": "2018-12-03T06:06:46", "url": "https://files.pythonhosted.org/packages/c9/de/ea24d0e71c00b9f66be7063c3e2a8c1d3c8b787ba768f31b6aab7f5d50c5/pyimagej-0.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9ea8bab1a8d059df4837f0e1646a1802", "sha256": "523dd9a9a52639e786fc8639a028131ddcbdfacf7f89609f1df96b7dd784f61c" }, "downloads": -1, "filename": "pyimagej-0.4.0.tar.gz", "has_sig": false, "md5_digest": "9ea8bab1a8d059df4837f0e1646a1802", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7710, "upload_time": "2018-12-03T06:06:48", "url": "https://files.pythonhosted.org/packages/68/a4/d22ea494423f7a4c7ca99b31ea7f1007b9f6bd4e9221c04a67a0373dbc58/pyimagej-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c3020b50891314c957d92b152192f58c", "sha256": "11472afef43d61046c83a3aad318a1430bc11876e88044a288954fdafa8dbd29" }, "downloads": -1, "filename": "pyimagej-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c3020b50891314c957d92b152192f58c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7342, "upload_time": "2018-12-03T06:06:46", "url": "https://files.pythonhosted.org/packages/c9/de/ea24d0e71c00b9f66be7063c3e2a8c1d3c8b787ba768f31b6aab7f5d50c5/pyimagej-0.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9ea8bab1a8d059df4837f0e1646a1802", "sha256": "523dd9a9a52639e786fc8639a028131ddcbdfacf7f89609f1df96b7dd784f61c" }, "downloads": -1, "filename": "pyimagej-0.4.0.tar.gz", "has_sig": false, "md5_digest": "9ea8bab1a8d059df4837f0e1646a1802", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7710, "upload_time": "2018-12-03T06:06:48", "url": "https://files.pythonhosted.org/packages/68/a4/d22ea494423f7a4c7ca99b31ea7f1007b9f6bd4e9221c04a67a0373dbc58/pyimagej-0.4.0.tar.gz" } ] }