🔧 RESEARCHER MANUAL

SwipeLab Researcher Guide

A complete reference for creating tasks, managing recipient groups, monitoring classification progress, and exporting high-quality labeled datasets.

No sections match your search.
1

Getting Started

Welcome to the SwipeLab Researcher Guide. This section covers how to log in to the dashboard and navigate the main interface.

Researcher Account

Researchers are STARDBI users so they do not need to register separately. Researchers can simply log in using their existing STARDBI account credentials.

Navigation Overview

Top bar:

  • 🎮 Play — switch to labeling mode
  • 🚪 Logout

Bottom bar:

  • 🏠 Home
  • 📋 Tasks
  • 📊 Analytics
  • ⚙️ Settings
Researcher Navigation

In the Home screen, quick access buttons are available for:

  • 📋 Tasks
  • Add Task
  • 🌿 Taxonomy
  • 🖼️ Gold Images
  • Add Gold Image
  • 👥 Recipients List
Researcher Home
2

Creating a New Task

Tasks are the core unit of work in SwipeLab. By pressing Add Task on the Home screen, you can create a new task. Follow the steps below to set up your task.

Step 1 — Choose a Task Name

Enter a clear, descriptive name for your task. This name will be visible to volunteers and helps identify the task in your dashboard.

Task name

Step 2 — Add a Description

Write a brief description of the task. This helps volunteers understand the context and goal of the classification they are performing.

Task description

Step 3 — Select Species & Upload Reference Images

Select one or more species for the task. For each species selected, you must upload at least one reference image. These reference images help volunteers understand what they are classifying.

  • You can select multiple species in a single task.
  • Each species requires at least one reference image to be uploaded.
Task species

Step 4 — Choose Recipients

Decide who can participate in your task:

  • 🌐 Public — the task is open to all volunteers on the platform.
  • 🔒 Restricted — only volunteers in your selected recipient groups can access the task.
Task recipients

Step 5 — Confirm and Create Task

Review all the details you have entered. Once you are satisfied, press Create Task to publish it. The task will immediately become available to the selected recipients.

Task create
3

Monitoring Task Progress

The Tasks screen is your central hub for managing all tasks you have created or co-manage. Press the Tasks button from the bottom navigation bar to access it.

Managing Your Tasks

The task list displays all your active, paused, and archived tasks at a glance. From here you can take quick actions on any task without opening it:

  • ▶️ Activate — make the task live and visible to the selected recipients.
  • ⏸️ Pause — temporarily suspend volunteer access while preserving all existing classifications.
  • 📦 Archive — close a completed task and move it to the archive for record-keeping.
  • ✏️ Edit — modify the task name, description, species, or recipient settings at any time.
Task List

Viewing Task Details

Select any task from the list to open its full detail view. Here you can monitor real-time progress, review classification statistics, and get a breakdown of volunteer activity for that specific task.

Task Detail
4

Managing Recipient Groups

Recipient groups allow you to control which volunteers have access to a restricted task. All groups created by researchers are listed in the Recipients List, accessible from the Home screen. Groups are used when creating or editing a task with Restricted visibility.

Recipients List Overview

The Recipients List shows all groups you have created. Each group can be assigned to one or more restricted tasks, ensuring that only the intended volunteers can participate.

Task Task Recipients

Creating a New Group

To create a new recipient group, tap the Add button from the Recipients List screen. Give the group a name and add the volunteers or sub-groups you want to include. Once created, the group will be available to select when setting up restricted tasks.

New List

Managing Group Members

Select any group from the Recipients List to open its member view. From here you can review who is in the group and make changes:

  • Assign users or sub-groups — add individual volunteers or entire groups to this recipient group.
  • 🗑️ Remove members — remove a volunteer from the group without affecting their account or other group memberships.
List Details
5

Taxonomy

The Taxonomy screen lets you browse and search all species available in the SwipeLab database. It serves as a quick starting point for creating tasks — instead of manually entering species names, you can find and select them directly from the taxonomy catalogue.

Use the search bar to find species by name. You can select multiple species at once and then immediately create a task pre-populated with your selection — saving time compared to building a task from scratch.

Taxonomy
6

Analytics

Content coming soon.

7

Exporting Labeled Data

Once a task reaches sufficient coverage, export the labeled dataset in CSV or JSON format for use in ML training pipelines.

Content coming soon.

8

Uploading & Managing Gold Images

Gold Images are special reference images used to validate and measure volunteer credibility. SwipeLab periodically shows these images to volunteers and compares their answers to the known correct answer — helping ensure labeling quality across all tasks.

Viewing & Managing Gold Images

The Gold Images gallery gives you a full overview of all validation images currently in the system. From here you can review each image and remove any that are no longer needed.

  • 📋 View all gold images — browse the complete list of validation images, with species labels and difficulty ratings.
  • 🗑️ Delete images — remove a gold image if it is outdated, incorrect, or no longer relevant to your tasks.
Gold Images gallery

Adding a Gold Image

To add a new gold image, press Add Gold Image from the Home screen. Gold images are used to test volunteer credibility — they are shown during labeling sessions and scored against the known correct answer.

Step 1 — Upload the image

Provide the image either by uploading a file from your device or by pasting a direct image URL. Once the image is successfully loaded, a green "Ready" indicator will appear, confirming the image is valid and ready to use.

Add Gold Image

Step 2 — Select the species

Choose the species this image represents. This is the species the volunteer will be asked to identify when they encounter this gold image during a labeling session.

Gold Species Selection

Step 3 — Mark the correct answer

Indicate whether the image correctly represents the selected species or not. This becomes the ground-truth answer that volunteer responses will be scored against.

  • Yes — the image is a valid example of the selected species.
  • No — the image does not represent the selected species (useful for testing negative recognition).

Step 4 — Set the difficulty

Assign a difficulty level to the gold image. Difficulty affects how much weight the image carries when calculating a volunteer's credibility score — harder images that are answered correctly contribute more.

Gold Query
9

Credibility Scores

SwipeLab's credibility system scores each volunteer based on consensus agreement and accuracy against gold images. High-credibility users' classifications carry more weight.

Content coming soon.