Skip to content

Labeling Projects

Tongfei Yang edited this page Nov 30, 2024 · 58 revisions

This document is intended to be a living document about the processes for labeling for the FishSense project.

Getting Started

Please log in to Labeler. If you do not yet have an account, please contact your team lead or a Label Studio admin to access the system.

After logging in, you will have a page listing all available labeling projects. Please only label for projects that you have been asked to label. Each project may have specific instructions for what they need to be labeled. The instructions for FishSense are described in the sections below. This section will discuss general Label Studio usage.

After opening a project, please click the blue "Label All Tasks" button. This will provide you with the best labeling experience.

To label, follow these steps:

  1. If there is nothing to label, simply click submit. Otherwise, follow the remaining steps.
  2. Zoom into the image as necessary. Use the zoom/pan controls to the right of the image.
  3. Select the appropriate label for your image.
  4. Select the point or points you wish to label. Your labels appear on the screen and in the bottom right of your display.
  5. When finished, click submit.

Lasers

Navigate to the FishSense Laser in Label Studio.

You will be presented with images containing zero, one, or two lasers. The majority of these images will contain only a single laser. These lasers may be red or green. So that this data can be used for both processing and data analysis, please select the proper label for the laser you are labeling. For example, if you are labeling a red laser, please select "Red Laser" as your label. It is necessary to get the dot as close to the center of the laser as possible. Error in distance measurements are introduced if not properly centered.

Grouper Moon

Step 1: Make sure you already have an account on label studio. If not, refer back to "getting started" section.
Step 2: log in and select the Grouper Moon project. Screenshot 2024-11-27 at 1 31 32 PM

Step 3: Select "Label All Tasks." Screenshot 2024-11-27 at 1 44 58 PM

Step 4: Turn on "Auto-Annotation." Screenshot 2024-11-27 at 4 44 22 PM

Step 5: Start segmentation labeling.
There are three ways of labeling-- using brush, keypoint, or rectangle.

  • Brush Labels
    Click on "Auto-Detect" and choose brush. Then choose "Fish 1" under "Brush Labels."
Screenshot 2024-11-27 at 4 58 27 PM Now you're able to manually draw segmentation mask for fish!
  • Keypoint Labels
    Click on "Auto-Detect" and choose keypoints. Then choose "Fish 3" under "Keypoint Labels."
Screenshot 2024-11-27 at 5 04 11 PM Place keypoints on the target fish. Masks will be generated based on the keypoints. If the mask looks good to you, you can choose accept it. Otherwise, you can either reject the mask or accept it and then use brush to make manual adjustments. Also remember to delete the keypoint labels afterwards.(We only need the segmentation labels!) Screenshot 2024-11-27 at 5 14 10 PM
  • Rectangle Labels
    Click on "Auto-Detect" and choose keypoints. Then choose "Fish 5" under "Rectangle Labels."
Screenshot 2024-11-29 at 7 00 54 PM Draw a bounding box around the target fish. A mask will be generated automatically based on the bounding box. If the mask looks good to you, you can choose accept it. Otherwise, you can either reject the mask or accept it and then use brush to make manual adjustments. Also remember to delete the bounding box labels afterwards.(We only need the segmentation labels!)

Criteria for labeling(important!): Please label all the fish that you can see. You can skip the fish that are too blurry in the image.

Clone this wiki locally