Observations Gallery

The observations gallery allows verification and classification to be done upon many observations at once which can speed the process of quality analysis in a scientific workflow.

Overview

The observations gallery is a list of observations by project folder, or within a single media. An observation can include a single localization or many over time, so the image shown to represent the observation is the first localization in the observation. The grid shows observation cards which contains images and information. The image is a graphic of the boxed region, rather than the entire frame. You can, however, jump to a frame directly using the links below the observation's graphic. Other important information that can be gleaned from the card information is whether this was created by a human, or an algorithm. Additionally, items created by an algorithm, but then altered by a human will be noted.

Page Tools

The other tools on this page allow for filtering and sorting, quick search, verifying, deleting and classifying in bulk, and exporting the observations shown or selected to a CSV format. This tutorial goes into more detail on these actions below.

Filtering

The filter dialog can be opened by clicking the word "Filters" with the funnel icon next to it. This is in the top left of the observations gallery. The dialog's available conditions are grouped in sections. This dialog is used on different areas of the site, while only certain sections appear for observations as they are relevant.

To apply a filter:

1. Expand a grouped section

2. Choose a Category

3. Select a modifier

4. Select or add a value

5. Press the plus sign (+) at the end of row to add the condition

6. The Apply button will should the count of conditions added

7. Clicking Apply closes the dialog and shows the filtered results

Here is an exampled filtering on the algorithm creation type. This user wants to see algorithm created observations only:

Once applied and shown, you can see the user interface "pill" describing the applied condition "creation == algorithm-create". The pull has an "x" which can be used to remove the filter from this view. Note: Using export at this time will preserve the filtered results, which can be handy in some situations.

Sorting

You can sort observations by modified date, or created date. There is an arrow to denote ascending and descending order. The observations gallery by default is in modified date from newest to oldest.

Quick Search

There is an open input field with the prompt "Label contains". If a user clicks into this and types something, the search will take place refining the results. This quick search is the same as using a filter for "Label starts with."

Verifying

Verification in portal is a way to "check off" at the observation level that the observation has been verified by an expert, or a user in some sort of review workflow. This can be used by the user in a filtering situation for export from this view, or to find media in the Video & Image management tab. Another place where you will see verification is on the media card. The % of verified to unverified is shown as an indication of progress.

In this gallery you can verify a single observation with the click of a button, or use the selection tool to verify in bulk.

Deleting

In the observation gallery you can select and delete observations in bulk. The method is the same as verifying or classifying in that you can select all visible from the page using "Select All" or by clicking individual items.

Classification

In the observation gallery you can select and classify observations in bulk. The method is the same as verifying or deleting in that you can select all visible from the page using "Select All" or by clicking individual items.

The classification dialog shows the current Label summary for the selected observations and includes an autocomplete input to add the taxonomic label.

Export to CSV

Exporting Observations can be done in several locations on the site, including this gallery. The file exported contains many rows of details and associated metadata (include extra rows, see more on Related Data) which can be helpful to researchers and operations managers using this tool. The data is compiled via rest calls from the browser, and the download begins immediately. Note: The references in the file will link back to the portal, which is different from the FathomNet Database Export tool which involves the creation of a publicly accessible image for the frame, or image where the localization occurs.

Permissions

Last, it is important to note that this gallery and its features, like the entirety of Portal are subject to the privacy of the project , and the individual user role which you are assigned.