Skip to main content

Python wrapper for ImageJ

Project description

# Python client for ImageJ

[`imagej.py`](https://github.com/imagej/imagej.py) provides a set of wrapper
functions for integration between imagej and python. It also provides a
high-level entry point `imagej.IJ` for invoking `imagej-server` APIs.

## Requirements:

default:
- pyjnius
- imglib2-imglyb

Refer to Pyjnius installation guide for installing
[Pyjnius](http://pyjnius.readthedocs.io/en/latest/installation.html).

For imglib2-imglyb installation, you can simply use `conda install -c
hanslovsky imglib2-imglyb` Other infomation regarding imglyb can be found in
imglyb [git repo](https://github.com/hanslovsky/imglib2-imglyb).

imagej_server:
- requests
- Pillow

Use `pip install -r server_requirements.txt` to install requirements for server.

`Pillow` is required for the imagej.server module's `IJ.show()` function.
In addition, `display` or `xv` needs to exist in your system to view the image.

## Usage

```python
# Spin up ImageJ.
import imagej
ij = imagej.init('/Applications/Fiji.app')

# Import an image with scikit-image.
import skimage
from skimage import io
# NB: Blood vessel image from: https://www.fi.edu/heart/blood-vessels
img = io.imread('https://www.fi.edu/sites/fi.live.franklinds.webair.com/files/styles/featured_large/public/General_EduRes_Heart_BloodVessels_0.jpg')
import numpy as np
img = np.mean(img, axis=2)

# Invoke ImageJ's Frangi vesselness op.
vessels = np.zeros(img.shape, dtype=img.dtype)
ij.op().filter().frangiVesselness(imglyb.to_imglib(vessels), imglyb.to_imglib(img), [1, 1], 20)
```

For imagej-server, there is a short usage example
[here](https://github.com/kkangle/imagej.py/tree/master/imagej/server).


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for imagej, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size imagej-0.2.0-py2.py3-none-any.whl (6.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size imagej-0.2.0.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page