Project Overview

You want to create a project to classify various organisms based on the Class to which they belong.

To create this project, you must perform the following tasks:

1. List out your project requirements.

2. Identify

   1. Sample input images that you can use for labeling.

3. Configure project metadata.

4. Manage your project input and output fields.

5. Create the workflow that you want to implement in your project.

6. Add users to your project and assign them project roles.

7. Add a dataset to the project.

8. Start labeling input text.

9. View batch status reports.

This document explains how you can perform each of the tasks listed above. Specific sections in this document also contain sample data that you can use to easily create and implement this project in Taskmonk.

Listing Project Requirements

In this project, you want to:

• Classify various organisms based on the class to which they belong.

Sample Input Data

1. You select images of birds and reptiles from Wikipedia to use as input for this project. You paste their URLs into a Microsoft Excel (Excel) sheet under a column labeled ImageURL. The column names must be the same as configured in the project Input Field. The steps for configuration are provided later in the process. You save the Excel sheet as Taxonomy_Input.xlsx on your hard drive.

   

2. You create a classification-scheme spreadsheet to represent the contents of the branch below, sourced from the Tree of Life website. To know more about taxonomy files in Taskmonk, see Understanding Taxonomy Files. You save the Excel sheet as Taxonomy_Birds_Reptiles.xlsx on your hard drive.

   

Download Source File

You can follow the steps listed above to create your Excel sheets; you can also download and use these files in your project:

• Taxonomy_Input.xlsx.zip

• Taxonomy_Birds_reptiles.xlsx.zip.

Configuring Project Metadata

Project Metadata is the first tab that appears when you create a project. The Project Metadata tab enables you to provide basic information, such as the name, process, and project type, associated with your project. You can also upload any documentation that you may want to add to your project.

1. To create the project, click the Create Project floating button on the left side of the Projects page.
   

   

   
   The Project Metadata tab associated with your new project appears.

   

2. Enter Phylogenetic Classification as the Project Name and Taxonomy as the Process.

3. Click Project Type > Text-Based.

4. Select Lookup > Taxonomy.

5. Enable Project Pipeline is False by default, do not change this for the current project.

6. Click Next.
   The Documents sub-tab appears.

7. You can upload documents associated with the project if required. This is an optional step, and you can skip it for now.
   Click Next. The Project Lookup Files sub-tab appears.
   

   

8. Click Choose File, navigate to and select the sample taxonomy file.

9. Click Submit to upload the file into the system.

10. Click Next.

The Task Design tab appears. Use this tab to manage your project input and output fields.

Managing Project Input and Output Fields

Taskmonk uses the project type that you specify to add input and/or output fields to projects as required. You can modify these later. In this instance, you selected Text-Based as the Project Type, and Taskmonk does not add any fields to the Task Design sub-tabs. You can create input fields by providing the input file format and importing the column headers from the same.

Creating Input Field Details

1. Click Browse Input File, navigate to the sample input file and upload it into the system. The following input fields get added:

   • Field Name: ImageURL. Field Type: Text

2. Change the Field Type to Image.
   

   

Creating Output Field Details

1. Click the Output Field tab to display the Output Field UI.

   

2. Click Create Output Field. The Create Output Field modal appears.

   

3. Enter Taxonomy_Name as the Name.

4. Select Taxonomy as the Set Data Type.

5. Select the All Levels check box to indicate that this field must be available to users at all execution levels, such as labeling, quality analysis, and so on.

6. Click Create to save the new output field and return to the Task Design > Output Fields tab.

7. Click Create Output Field again to create the next field. The Create Output Field modal appears.

8. Enter Taxonomy_Path as the Name.

9. Select Taxonomy as the Set Data Type.

10. Select the All Levels check box to indicate that this field must be available to users at all execution levels, such as labeling, quality analysis, and so on.

11. Click Create to save the new output field and return to the Task Design > Output Fields tab.

12. Click Next to move to the next step, Quality Workflows.

Creating Quality Workflows

The Quality Workflow tab enables you to specify how you want to ensure output quality. It also helps you create the execution levels required for your quality workflows. For example, you want to create the following levels for this project:

• Analyst

• QA

• Delivery Lead

1. In this instance, you want to enable a Majority-Vote workflow. Click the Execution Method field and select Majority Vote from the drop-down list that appears.

2. By default, Taskmonk creates the Analyst role for you. Do not make any changes to this.

3. Click the Add Execution Level button on the right side of the page. The Add Execution Level modal appears.

   

4. Enter QA in the Execution Level Name field.

5. You can skip all other fields here. Click Add.
   Taskmonk adds the new execution level, closes the modal, and displays the updated Quality Workflow tab. Repeat the process to add all required execution levels.

   

6. Click Next to move to the next step, User counts and Majority vote.

   1. Set the User counts to 3 if every task has to be allocated to 3 different users. Majority vote 2 indicates that out of 3 users, if at least 2 of them provide the same response, the task completes at level 1. If all 3 users provide different responses, the task moves to level 2.

   2. Consensus Percentage: Percentage of total tasks imported that should be allocated to multiple users. The remaining tasks will follow the Maker-Checker or Maker-Editor model.

Creating Process Logic

Quality Workflow > Process Logic tab allows you to decide the logic based on which datasets are moved from one execution level to the next. For the current project, you want to enable the following rules:

• In case of Majority Vote, do not create any rule from level 1 to level 2. All the tasks which do not have a majority output will automatically flow to level 2.

• 40% of the project datasets move from level 2 to level 3.

To do so:

1. Click the Add Process Logic button on the right-hand side of the page. Add process logic page appears.
   

   

2. Click the From Level drop-down and select L12[QA].

3. Click the To Level drop-down and select L3 [Delivery Lead].

4. Click Add Rule to load the add rule UI.

5. Click Add New Rule. Rule Type drop-down appears.

6. Click the Rule Type drop-down and select PercentageRule.

7. Click the Percentage drop-down and select 40%.

8. Click Submit to save the rule.

   

Managing Users and Roles

You must now add users to your project and assign the execution levels you just created to them.

1. Click the Users tab just above the Quality Workflow tab.
   The Users > Manage Users tab appears.

2. Click the Add button in the top-right section of the tab.
   The Select Users tab appears.

3. Corresponding to each execution level, click the Select Users field and select the desired user from the drop-down list that appears.

   1. The minimum number of users in level 1 should be equal to the User counts set in the workflow

       

      

       

4. Click Add to add the selected users to the project.

5. Close the modal.
   The Manage Users tab reloads to display the updated user details.

Managing Project Datasets

Your project is now configured. Congratulations!

Before you can start labeling, you must upload the input files containing the raw data to be labeled.

1. Click the Datasets tab. The Datasets page appears. Use this page to manage datasets for your project.

2. Taskmonk organizes datasets into batches to simplify management and tracking. To add a new dataset, click Add Batch on the right side of the page. The Add Batch modal appears.

3. Enter Batch 1 as the name for the batch that you want to import in the Add New Batch field. You can ignore the other fields.

   

4. Click Submit. This creates a new batch of data for your project and adds it to the Pending tab of the Datasets page. You can now upload datasets into the batch, as required.

5. To add a dataset to the batch, click the Import button under the Tasks(Import/Export) column. The Import Task modal appears.

6. Click Choose Files, select the sample input file from your computer and click Import.

7. Once the dataset is imported, click Close to exit the modal.

   

Labeling Text Using Taskmonk

Your project is now ready for work.

1. Log in as an Analyst and click the My Tasks icon at the top of the page. The My Tasks page appears.

   

2. Click the Get Tasks button adjacent to the Phylogenetic Classification project. The labeling UI associated with this project appears.

   

   
   You can see the following project details in the labeling UI:

   • Batch Name (Batch 1) in the top-left section of the page.

   • Input fields (Image) on the top half of the page.

   • Output fields, Taxonomy fields on the bottom half of the page.
     
     For detailed information on working with a typical labeling UI, see Labeling Data.

Viewing Batch Status Report

1. Go to the Projects page and click Reports > View for the Phylogenetic Classification project. The Reports page appears.

2. Click on Dataset Progress Reports to view the batch status report. This shows the total number of tasks pending and completed at each level for all batches.

   1. Disagreement score indicates the total number of tasks without a majority at level 1. In other words, the total tasks which moved to level 2.
      

      

Downloadable Sample Files