Project 2. Select an object in the image

In this project, Tolokers will select image areas that contain a traffic sign. Use the results from project 1 as source images.

  1. Create a project
  2. Create a pool
  3. Prepare and upload tasks
  4. Get the results

Create a project

In the interface:
  1. Choose a template:

    1. Click Create project.
    2. Select the Object recognition & detection template.
    3. Click Choose solution.
  2. Provide general information:

    1. In Name to show Tolokers, enter Outline traffic signs in the image.
    2. In Description for Tolokers, enter Draw a box around all traffic signs in the image.
    3. Optionally add a Private comment.
  3. Edit the task interface in the editor you selected:

    Template Builder
    HTML/CSS/JS editor
    1. You can use it for this project with pre-configured validation and task layout.

      The Toloker won't be able to submit a response without selecting an area in an image.

      For more information about the template and its settings, see Object selection in an image in the Template Builder Help.

    2. To see the input and output data fields, click Show specifications in the Data specification section.

      • Input data field: image — A link to an image.

      • Output data field: result — The field that will contain the information about the labeled image after it is uploaded.
    1. In Task interface, leave the HTML block unchanged.

    2. Edit the CSS block:

      1. Set up the area selection tools. This template uses Editor for image area selection. It features rectangle and polygon tools (by default).

        To set up rectangle selection, replace the code in the CSS block with the following:
        .image-annotation-editor__shape-polygon {
        display: none;
        }
        Copied to clipboard
      2. Enter the code to adjust the interface height to the image size:

        .image-annotation-editor__annotation-layer {
        height: max-content;
        }
        Copied to clipboard
      3. (optional) You can ask Tolokers to enter an annotation for the selected area or select one from a list. To do this, add an interface element in the JS block. For example, a text field or drop-down list.

        Learn more about annotation.

    3. Click the Preview task button to view the task.

      Note. The project preview shows one task with standard data. You can define the number of tasks to show on the page later.
    4. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

    5. Exit preview mode. In the lower-left corner, click ExitExit . If there were errors when testing, check the code blocks that you entered.

  4. Save the changes.

  5. Write instructions for Tolokers:

    Instruction text:
    Click and draw a rectangle around all traffic signs in the image.
    Tip.

    If you want to add a task examples in the instruction, complete it yourself in the preview mode. Take screenshots, upload them to photo hosting or cloud storage and insert image links in the instructions by clicking the button on the toolbar.

    Click Finish.

Create a pool

A pool is a set of paid tasks sent out for completion at the same time.

  1. Open the project page Outline the traffic signs in the image.

  2. Click the Add a pool button.

  3. Specify the Pool name.

  4. Optionally add a Private comment. This information is available only to you.

  5. Filter Tolokers in the Tolokers section of the Audience block:

    1. Click Add filter.

    2. Add the Region by phone number and Languages filters and select Tolokers from Russia, Ukraine, Kazakhstan, and Belarus who indicated in their profiles that they know Russian.

    3. Add a new skill. Click Add skill.

    4. In the window that opens, enter Area selection in the Title field.

    5. Click Add.

    Tasks in pools will automatically be available in the web version of Toloka and the mobile app. If you want to change the default settings and limit the visibility of the task for any of the versions, add the Client filter and select the desired value: Toloka web version or Toloka for mobile.

  6. (optional) In the Speed/quality balance section, specify the desired quality level. Improving quality may reduce the speed of task completion because the pool will be available to fewer Tolokers. Learn more in the Speed/quality balance section.

  7. In the Price block, find the Price per task suite field and specify the price. For example, 0.01.

    What is a task suite?

    A task suite can contain one or several tasks that are shown on the same page. If the tasks are simple, you can add 10-20 tasks per suite. Don't make task suites too long because it slows down loading speed for Tolokers.

    Tolokers get paid for completing the entire task suite.

    The number of tasks per suite is set when uploading tasks.

    What is a fair price for a task suite?

    The general rule of pricing is the more time the Toloker spends to complete the task, the higher the price is.

    You can register in Toloka as a Toloker and find out how much other requesters pay for tasks.

  8. Quality control rules allow you to filter out careless Tolokers. In the Quality control block, set the rules for the pool:

    1. Turn on the Assignment review option.

      What is non-automatic acceptance (assignment review)?

      The non-automatic acceptance option allows you to review completed assignments before accepting them and paying for them. If the Toloker didn't follow instructions, you can reject the assignment. The maximum allowed period for the review is set in the Deadline field.

      In the Review period in days field, specify the number of days for checking the task.

    2. Add the following quality control rules:
      • Recompletion of rejected assignments — sends the tasks you rejected to other Tolokers according to the specified rules.

        1. Click Add a quality control rule.

        2. Find the Rules block in the list and select Processing rejected and accepted assignments.

        3. Set a rule for a rejected task: if assignment becomes rejected, then extend overlap by 1. Turn on the Open pool if closed option.

          This means that the rejected task will be returned to the pool and shown to another Toloker.

      • Submitted responses — allows you to limit the number of pool tasks available for the Toloker per day.

        1. Click Add a quality control rule.

        2. Find Rules block in the list and choose Submitted responses.

        3. Set a rule for the completed task: if submitted assignments ≥ 1, then assign skill value Area selection equal to 1.

          These parameters allow you to mark the Toloker who completed at least one task in the pool.

          Tip.

          If the Area selection skill isn't displayed in the list, save the pool and reopen it for editing.

      • Fast responses —Filters out Tolokers who respond too quickly.

        1. Click Add a quality control rule.

        2. Find the Rules block in the list and choose Fast responses.

        3. In the Recent tasks suites to use field, enter the number of recent task suites submitted by the Toloker. For example, 5.
        4. In the Minimum time per task suite field, enter the time in seconds. For example, 20.
        5. Set a rule for a fast response: if the number of fast responses ≥ 1, then ban on requester for 10 days. In the Reason field, enter Fast responses.

          This means that a user who completes a task suite in less than 20 seconds will be suspended for 10 days and won't be able to access your tasks.

      • Results of assignment review — restricts the pool access for Tolokers who often make mistakes.

        1. Click Add a quality control rule.

        2. Find the Rules block in the list and choose Results of assignment review.

        3. Set a rule for rejected tasks: if total reviewed responses ≥ 3 and rejected responses (%) > 35, then ban on requester for 15 days.

          This means that if 35% or more of a Toloker's responses are rejected, the Toloker is banned and can't access your tasks for 15 days. The rule takes effect after 3 responses of the Toloker are reviewed.

    Control tasks and majority vote aren't used for this project type, since the area markup provided by the Tolokers must match (which is almost impossible). Learn more in Quality control.

    Note.

    You can copy quality control settings from another pool. To do this, in the Tolokers section of the Audience block, click copy them from another pool.

  9. In the Task overlap section, find the The number of Tolokers to complete every task field and set the overlap, which is the number of Tolokers to complete the same task. For image area selection tasks, it is usually 1.

  10. In the Additional settings block, specify Time per task suite. The time should be long enough to read the instructions and wait for task data to load. For example, 1200 seconds.
  11. Click Create a pool.

Prepare and upload tasks

  1. Prepare a file with tasks.

    1. In the text or spreadsheet editor, open the file that you received after aggregating the results in project 1.

    2. Choose images appropriate for the current project (the OK value).

      Tip. You can use the awk commands to outline images on Linux and MacOS devices:
      awk 'BEGIN {OFS = FS = "\t";} $2=/OK/ {print $1}' <aggregated_res>.tsv > <filtered_res>.tsv
      Copied to clipboard
    3. Copy the column with the selected links to a new sheet or document.

    4. Name it INPUT:image. If you want to set a different name, rename the column in the source file with the results, too.

    5. Save the file.

  2. Upload the tasks file:

    1. Click Upload. In the window that opens, configure the file upload settings.

    2. Choose Set manually.

    3. In the Tasks per suite field, specify 1.

    4. Click Upload.

    5. In the window that opens, choose the tasks file you want to upload and click Open.

    6. In the window that opens, check the number of tasks and click Add.

  3. Click to start the pool.

    Attention.

    The tasks will be completed by real Tolokers in Toloka. Recheck your project setup before you start the pool.

Get the results

  1. On the pool page, click Download results. In the window that opens:

    1. In Status leave only the Submitted option enabled.

    2. In Columns leave only the assignment ID option enabled.

    3. Disable the Separate assignments with empty row option.

    4. Click Download results.

  2. Use the results file in project 3.

What's next