SYNOPSIS

BIP (Biological Image Processing) is developed by the Modeling and Digital Imaging team of the Institut Jean-Pierre Bourgin-Plant Sciences, INRAE Versailles, France.

BIP is a command-line tool for processing and analyzing (biological) images. Its distinctive feature is to be natively oriented for processing batch images using automated pipelines.

BIP integrates many standard algorithms as well as specific algorithms we have developed in our research projects. Many functionalities are quite generic image processing operators, while others address specific needs typically encountered in bioimage analysis. We initially developed BIP for our own needs and now make it available to a wider audience in the hope it will be useful to others.

FEATURES

DOWNLOAD

Conditions of use

BIP is free software distributed under the GNU General Public License as published by the Free Software Foundation.

Citation

BIP is developed based on the Free-D software libraries. Any publication of results generated using BIP must include the following reference:

Biot E, Crowell E, Burguet J, Höfte H, Vernhettes S, Andrey P (2016). Strategy and software for the statistical spatial analysis of 3D intracellular distribution. Plant Journal, 87, 230-242.

Downloads

Installation

Installation instructions can be found in the manual (see below).

Manual

The detailed manual is available here: BIP manual (PDF).

Gitlab

The BIP Gitlab page will be soon available on the INRAE forge. Stay tuned!

USAGE

This section presents only a brief introduction to BIP usage. Please consult the user manual for detailed information and instructions.

Command-line help

In a terminal, simply type:

bip

This will display a summary of bip usage and the current list of available operators with their options.

Basic usage: one operation/one image

In its most basic usage, bip can be used to apply a given operator to a single image. For example:

bip gaussian-filter 1.0 image.tif

This will create a new image file in the current directory. By default, the name of the output file is built by concatenating the input image filename with the name of the operator (image-gaussian-filter.tif in this example).

Batch processing: one operation/several images

Most operators available in BIP can be applied at once on several images:

bip gaussian-filter 1.0 image1.tif image2.tif image3.tif

Here users will in general heavily rely on shell wildcards. For example, the following command will take as input all the images with "dapi" in their filenames in the "input" directory and will store their Gaussian filtered version in the current directory:

bip gaussian-filter 1.0 ../input/*dapi*.tif

Pipelines: several operations/several images

BIP pipelines have two purposes. First, they simplify and accelerate the design and the application of image processing sequences composed of several steps. Second, they also facilitate tracing the operations that have been applied to images.

Consider the following 3-step sequence: Gaussian filtering -> Otsu's thresholding -> object labelling. Without pipelines, the corresponding sequence of commands to enter into the terminal is:

bip gaussian-filter 1.0 image.tif
bip otsu-thresholding image-gaussian-filter.tif
bip labelling image-gaussian-filter-otsu-thresholding.tif

[note: see below options to avoid increasingly-complex-file-names!]

To run the same sequence using a pipeline, we first create a file (say, process.pipeline) describing the series of operations. The syntax is exactly the same in pipeline files as in command-line calls:

# contents of process.pipeline
gaussian-filter 1.0
otsu-thresholding
labelling

The pipeline can then be run by invoking the pipeline operator:

bip pipeline process.pipeline image.tif

When running a pipeline, the name of the output file is built by concatenating the input image filename with the basename of the pipeline file (image-process.tif in the example).

Pipelines can be applied in batch as any other operator:

bip pipeline process.pipeline ../input/*.tif

Contact

Philippe ANDREY (philippe andrey AT inrae fr).
Eric BIOT (eric biot AT inrae fr).