Skip to main content

Omero Integration

Omero Integration

Arkitekt can be deployed to work with Omero, a popular open source image management platform. Through this integration you can easily create workflows that interact with Omero, for example to upload images to Omero or to download images from Omero.

note

This integration is currently in beta and provides a limited set of features. We are working on expanding the integration to cover more of the Omero API. If you have any feedback or requests, please let us know.

Setting up the Omero integration

To use the Omero integration, you need to use a Arkitekt instance that has the Omero integration enabled. Arkitekt deployments, that use Konstruktor can enable the Omero integration by choosing the full channel which includes the Omero integration.

warning

In this beta, we highly recommend to use the dedicated Omero setup, and the full deployment, also includes an OMERO instance. This is the easiest way to get started with the Omero integration and as Omero integration is still in beta and might not work with all Omero instances. If you want to connect to an existing Omero instance, please make sure that you are using a recent version of Omero (>= 5.6.0) and that your Omero instance is accessible from the Arkitekt deployment.

To understand more about the design of our OMERO integration visit our design documentation

Connecting to Omero

Utilizing the OMERO integration is straightforward: you can still use the full featureset of your OMERO deployment (like the OMERO.web interface) but also use the Arkitekt platform to interact with your OMERO data.

One such integration is included in Orkestrator, which , If your deployment supports OMERO, will automatically create a new pane in the sidebar, that allows you to connect to an existing OMERO instance.

On first setup, you will need to provide your username and password, to connect to your OMERO instance. By default username root and password omero are already setup, but of course you can and should use your user credentials. Afterwards your Arkitekt account is associated with your OMERO account and all your data is accessible from Arkitekt.

On Integrating a Remote Server

If you are seeking to use a remote OMERO instance, you can change the OMERO server when you are setting up the connection in the Advanced tab. Please be aware that the port and host need to be accessible from the Arkitekt deployment, not from your local machine.

Once you have connected to an Omero instance, you can use the full featureset of the Arkitekt platfrom with your Omero data. You can explore your data, create workflows that interact with your data and interconvert your data between mikro and Omero.

Interfacing with OMERO Server through the Orkestrator Webinterface. Data is linked between the two services.
On Uploading data to Omero

While we are working on supporting direct uploads to the OMERO instance through orkestrator, the underlying API of OMERO is hard to wrap reliably, so we are currently working on a workaround to upload data to OMERO. Just like OMERO.web, you have to use OMERO importer to upload data to OMERO and then you can use Arkitekt to interact with the data

Runing a workflow with Omero data

Fully integrated within the Arkitekt Platform, you can now run workflows that interact with your Omero data. This includes workflows that download data from Omero, process it and upload it back to Omero. Creating workflows that interact with Omero is as easy as creating workflows that interact with any other data source.

An example batch workflow run through Orkestrator with direct display of OMERO data in the Run View
info

In this current beta, we focused on integrating OMERO as a data source and target for workflows. While we are working on integrating more of the OMERO ecoyste, we currently do not plan to establish OMERO as a data backbone for Arkitekt, as it is not really optimized for high throughput data processing and streaming data. If you are interested in using OMERO as a data backbone for your Arkitekt instance, please let us know.

Exploring Data after

Of course as soon as the data is uploaded, you can explore it in the Omero web interface and in the Arkitekt isntance. We use the underlying infrastructure of Omero so everything is always in sync.

Exploring the generated Data just like Before