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.

Source Distribution

imagej-0.2.0.tar.gz (6.4 kB view hashes)

Uploaded Source

Built Distribution

imagej-0.2.0-py2.py3-none-any.whl (6.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page