Skip to content

Commit ecd8d5e

Browse files
committed
Flesh out the OMERO page
* Summarize the available options. * Add the new GReD/MICA tools (https://forum.image.sc/t/65586).
1 parent 1e1dd44 commit ecd8d5e

File tree

1 file changed

+46
-4
lines changed

1 file changed

+46
-4
lines changed

_pages/software/omero.md

Lines changed: 46 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,52 @@ website: https://www.openmicroscopy.org/info/omero
1515

1616
OMERO is client-server software for visualization, management and analysis of biological microscope images.
1717

18-
## Publications
18+
## Interacting with OMERO from ImageJ
1919

20-
{% include citation %}
20+
There are several different ImageJ-based tools for working with data from an OMERO database:
21+
22+
### OMERO plugin for Fiji/ImageJ
23+
24+
The [OME project](https://openmicroscopy.org/) has developed the **OMERO plugin for Fiji/ImageJ**. Read about it at:
25+
26+
{% include link-banner url="https://omero-guides.readthedocs.io/en/latest/fiji/docs/" %}
27+
28+
For versions of OMERO prior to 5.5, OME's plugin for ImageJ was known as **OMERO.insight-ij**.
29+
30+
### ImageJ-OMERO
31+
32+
The [ImageJ2 team](/people) has developed [ImageJ-OMERO](https://github.com/imagej/imagej-omero), a SciJava-based library for bidirectional interoperability between [ImageJ2](/software/imagej2) and OMERO, with plugins to upload and download images, tables, and regions of interest to and from OMERO, and support for running ImageJ scripts on the OMERO server side.
33+
34+
{% include notice icon="warning" content="Unfortunately, ImageJ-OMERO has not yet been updated to work with OMERO 5.5 and newer. This work is in progress; follow [imagej/imagej-omero#107](https://github.com/imagej/imagej-omero/pull/107) for details." %}
35+
36+
### GReD/MICA plugins
37+
38+
The [GReD](https://www.gred-clermont.fr/) research center and [Microscopie Imagerie Côtes d'Azur](https://univ-cotedazur.fr/mica) have collaboratively developed some tools for interacting with OMERO from ImageJ:
2139

22-
## See also
40+
1. [omero\_batch-plugin](https://github.com/GReD-Clermont/omero_batch-plugin): a plugin to batch process images from OMERO with a script or macro
41+
2. [omero\_macro-extensions](https://github.com/GReD-Clermont/omero_macro-extensions): a plugin to interface with OMERO directly from macros through macro-extensions
42+
3. [simple-omero-client](https://github.com/GReD-Clermont/simple-omero-client): a wrapper library which can be called from scripts in Fiji, but can mostly be used in Maven projects to wrap calls to the underlying [OMERO Java Gateway](https://github.com/ome/omero-gateway-java) (API available [here](https://api.igred.fr/simple-omero-client/))
2343

24-
- The [ImageJ-OMERO](https://github.com/imagej/imagej-omero) project for bidirectional interoperability between ImageJ and OMERO.
44+
The omero\_batch-plugin plugin gives users a GUI to help them process images from OMERO or a local folder (with bio-formats) with a script of their choosing, and save results locally or on OMERO.
45+
46+
![batch-omero-plugin dialog](https://aws1.discourse-cdn.com/business4/uploads/imagej/optimized/3X/e/f/ef69a367bcccb225e2428a38600d71d77eee2ee4_2_1380x872.gif){:width="600px"}
47+
48+
The omero\_macro-extensions plugin adds new [macro](/scripting/macro) functions to access data on OMERO directly from macros. For example:
49+
50+
```javascript
51+
run("OMERO Extensions");
52+
Ext.connectToOMERO(host, port, username, password);
53+
images = Ext.list("images", "dataset", dataset_id);
54+
image_ids = split(images,",");
55+
imageplusID = Ext.getImage(image_ids[0]);
56+
```
57+
58+
The simple-omero-client is a [Maven](/develop/maven) library, on which the omero\_batch-plugin and omero\_macro-extensions are built. It is therefore required to run these. However, once installed in Fiji, its API then becomes available for modern scripts.
59+
60+
Instructions for the plugins installation are on their respective release page, and their READMEs should describe how to use them, although this could be improved.
61+
62+
See the [publication preprint](https://f1000research.com/articles/11-392/v1) for further details.
63+
64+
## Publications
65+
66+
{% include citation %}

0 commit comments

Comments
 (0)