Work with ROIs in OMERO.iviewer =============================== In this section, we cover the ability of OMERO.iviewer to work with ROIs, to draw, edit, annotate and evaluate ROIs in the images is shown. In this way, a simple image analysis can be achieved, such as getting the intensity measurements inside the pixels of the ROIs and sizes of the ROIs, such as areas for polygons and lengths for lines and polylines. Description ----------- We will show: - How to inspect the intensities - How to draw ROIs on the image - How to view ROIs associated with different z or t planes - How to use the ``Planes`` tab in OMERO.iviewer to see the spread of ROIs in multi-z, t images - How to create comments on ROIs and enable and disable the ROI popups - How to produce simple analysis results from the ROIs and and export the results locally Resources --------- New features video (ROI popups, ROIs on multi-z or multi-t images) - https://youtu.be/yDW5Sg0I1GU Example image used can be found under Project **omero-training** in Group **Training_Jan_2025** Note: Only some of the images in this dataset are z-stacks, for example - Dataset **siRNAi-HeLa**, image **IN_03.r3d_D3D.dv** Step-by-Step ------------ #. Double-click on an Image thumbnail, or click the ``Full Viewer`` |image1|\ button in the right-hand pane to open an Image in a larger viewer called OMERO.iviewer. It is a Web app developed and released independently from the webclient. The OMERO.web framework can be extended with multiple apps to view data in different ways. #. Click the ``Crosshairs`` icon |image3| at the top-right of the viewer to enable the pixel intensity display for the mouse pointer. Then mouse over the Image to see the pixel intensities for the channels turned on. .. image:: images/Iviewer4.png #. The ``ROIs`` tab |image5|\ includes tools for viewing and drawing ROIs on the Image. These are saved back to the OMERO server. Select the ``arrow tool`` in the right-hand pane |image6| and draw an arrow on the Image, using Click-Move-Click (not drag), pointing to a feature in the Image and save it using the ``Save`` button located in the upper part of the right-hand pane. Draw also a couple of other ROIs on different Z planes. - Dragging on the Image is used for panning the image. - Shift-drag rotates the image (using selection tool) or draws ``freehand`` (polygon, polyline, rectangle and ellipse). |image7| #. Clicking onto the ROIs in the right-hand pane table brings the viewport to the position where the selected ROI is in the middle of it and navigates the viewport to the timepoint the ROI is associated with. .. image:: images/Iviewer8.png #. Select the ``Planes`` tab above the ROI table. .. image:: images/Iviewer9.png #. The ``Planes`` tab gives you an overview of the ROIs distribution over the z or t sections. The boxes in the schema in the ``Planes`` tab represent single z or t planes and are selectable. .. image:: images/Iviewer10.png #. You can select one box, this will navigate to the corresponding plane in the image viewer. Alternatively, select a range of boxes, which will display a projection of the range of the selected planes (in case of multi-z image) in the main viewer. #. Click onto a ROI in the image. A popup will appear. You can write a comment to this ROI directly into the popup. .. image:: images/Iviewer11.png #. The popups can be disabled for all ROIs on the image by clicking onto the cross of one popup and closing it, and re-enabled by using a context menu accessed by right-clicking onto the image. #. You can copy the values in the popup such as area (select and ``Ctrl + C``) and paste them into your local documents. #. Select several ROIs from different z planes. You can select in the table (``Shift+click`` to select a range) but also in the image itself using ``Ctrl+drag`` (``Cmd-drag`` on Mac) to select multiple ROIs. #. Export the Intensities, areas and line lengths into Excel. Select, in the top-left corner ``ROIs > Export (Excel)``. This will export the values from the selected ROIs. #. Note: ROI intensities and coordinates from the whole image or dataset can be exported using the script ``Batch ROI Export``. Draw ROIs on the image as instructed above, go to OMERO.web and select the image or dataset in the left-hand side tree. Find the cog icon above central pane. Then, select the ``Export scripts > Batch ROI Export`` and run the script. .. |image0| image:: images/Iviewer0.png :width: 0.79167in :height: 0.27083in .. |image0b| image:: images/Iviewer0b.png :width: 2.7in :height: 3in .. |image1| image:: images/Iviewer1.png :width: 0.79167in :height: 0.27083in .. |image3| image:: images/Iviewer3.png :width: 0.28125in :height: 0.33333in .. |image4| image:: images/Iviewer4.png :width: 0.34635in :height: 0.32813in .. |image5| image:: images/Iviewer5.png :width: 0.93164in :height: 0.32285in .. |image6| image:: images/Iviewer6.png :width: 0.34635in :height: 0.32813in .. |image7| image:: images/Iviewer7.png :width: 5.5in :height: 4in .. |image12| image:: images/Iviewer12.png :width: 0.46875in :height: 0.28125in .. |image13| image:: images/Iviewer13.png :width: 0.46875in :height: 0.28125in .. |image14| image:: images/Iviewer14.png :width: 0.22917in :height: 0.1875in .. |image15| image:: images/Iviewer15.png :width: 2.91667in :height: 0.29167in