Annotate Data and Filter using Annotations¶
There are several ways to add annotations to objects in OMERO. Here, addition and filtering of annotations using OMERO.web is described. You can add annotations using the OMERO.web interface to any object(s) that you can select in the left-hand-side tree or central pane, this means
- We will show:
How to annotate Images, Datasets and Projects with:
- Key-Value Pairs
- File Attachments
How to filter thumbnails in the central pane of OMERO.web for:
- Key-Value Pairs
- The data used are from the siRNAi-HeLa folder.
- The tags and ratings were added manually, then propagated for all users on the OMERO.server using the script copy_tags_ratings.py.
- The Key-Value Pairs were added to the images in the siRNAi-HeLa Dataset for all users using the script key_value_pairs.py.
Open a browser and enter the provided URL
Connect using the provided credentials
First, we will add Tags to indicate Metaphase stages of these cells.
- Select one or more Images in the siRNAi-HeLa Dataset of cells which appear to be in metaphase.
- Choose the Tag harmonica in the right-hand
Generaltab and click
[ + ]to launch the Tag dialog.
- Choose the existing
Metaphasetag from the list of Tags (to filter, type above the list).
>to move it to the right column, then click
Let us now add Key-Value Pairs
Select an Image from the Dataset and in the right-hand pane in
Generaltab, click the harmonica Key-Value Pairs.
The Key-Value Pairs allow you to add lab-book-like additional metadata for the Image. These Key-Value Pairs are also specifically searchable. See Search for Data.
For adding of File Attachments:
Select one or more objects in the left-hand side tree, such as
Attachmentsharmonica in the right-hand pane.
Click the plus button.
You can attach any type of file using this function. If you select a file from your local filesystem using the
Browsebutton, the feature will upload that file to the OMERO.server and save it there. The content of
CSVand plain text files is also searchable in OMERO.
Remove a File Attachment.
Find the File Attachment you have just added.
Click on the
minussign to the right of it.
The removal action just unlinks the File Attachment from the selected object(s). The File Attachment is not deleted from the server. If deletion is needed, click in the workflow above on the
crossicon instead of the
You can also add Comments and Rating to selected objects - follow analogous steps to the ones descirbed above for Tags, Key-Value pairs and File Attachments.
Filter using annotations
Images can also be filtered by Name, Tag, Key-Value pairs or Rating in the centre pane, using the
Add filterchooser above the thumbnails.
For example, choose
Tagand then select
Metaphasefrom the list of Tags to show the images we tagged earlier.
Or choose to filter by Key-Values. You can then filter by a particular Key. If you select a Key where all the values are numbers, you can filter for those that are greater than, less than or equal to a threshold value.
Review the filtered Images, choose a favourite Image and under the
Ratingssection in the right-hand pane, click on the 5th star to add a rating of 5
Now we can remove the filtering by Tag and instead filter by Rating of 5 to show only our favourite images.