TPT Export
Overview
The TPT Export plugin enables you to generate and download comprehensive reports containing essential annotation performance metrics from your project. These reports provide insights into labeling efficiency, review durations, and annotation counts across different stages, helping you evaluate team performance and optimize your annotation workflows.
TPT Export
Plugin Functionality
The TPT Export Plugin calculates and exports detailed time metrics for annotation tasks, providing insights into labeling efficiency and productivity. It offers flexible configuration options for filtering, measurement units, and reporting precision.
Calculates and exports detailed time-based metrics for annotation tasks to analyze labeling performance and productivity.
Allows defining a specific date range to include only tasks completed within the selected period.
Optionally excludes idle durations to ensure time reports reflect only active annotation work.
Supports flexible time units such as seconds, minutes, or hours for clear and consistent reporting.
Accurately measures time spent on nested or hierarchical classifications for comprehensive duration tracking.

Running the TPT Export plugin on your project generates two CSV files: one with the [TPT] extension and another with the [HIST] extension.
[TPT] File
Each row in this file represents an asset and provides a summary report showing the total labeling and review durations, along with the final annotation counts.
[HIST] File
Each row in this file corresponds to a single workflow stage, essentially showing the stage history. The annotation count and duration values indicate the amount of work performed during that specific stage.
The CSV files contains following columns:
Batch
External ID
Task ID
AngoHub URL
Asset's Stage
Number of Pages
Label Stages
Total Label Duration (sec)
Total Idle Label Duration (sec)
Total Blur Label Duration (sec)
Total Label Stage Visits
Last Label Stage
Last Labeler
Review Stages
Total Review Duration (sec)
Total Idle Review Duration (sec)
Total Blur Review Duration (sec)
Total Review Stage Visits
Last Review Stage
Last Reviewer
Number of Annotations
Number of Classifications
Number of Tools
Number of Tool Classifications
Number of Relations
Number of Issues
Batch
External ID
Task ID
AngoHub URL
Asset's Stage
Stage Name
Stage Type
Review Status
Visit Count
Assignee
Time and Duration
Date
Start Time
End Time
Duration
Idle Duration
Blur Duration
Number of Pages
Number of Annotations
Number of Classifications
Number of Tools
Number of Tool Classifications
Number of Relations
Number of Issues
Supported Data Types
Compatible with all data types available in AngoHub.
Supported Annotation Tools
Compatible with all annotation tools available in AngoHub.
Plugin Configuration
From the Stage Filter field, pick the stages containing the tasks you'd like to get the export of. Similarly, from the Batch Filter field, you may select one or more batches the tasks of which will be exported. By default, all tasks are exported from all batches.
If you wish to receive an email when the export is complete, toggle Send Email on.
You may vary a number of settings related to your export from the Config JSON field. Each option is detailed below:
{
"start_date": "2020-12-31",
"end_date": "today",
"extract_idle_duration": false,
"duration_unit": "sec",
"count_nested_classifications": true,
"include_key_frames_only": true,
"verbose": false,
"verbose_frequency": 1000
}"start_date": The starting date for the period over which the performance metrics will be calculated.
Example:
"start_date": "2020-12-31"
"start_date": null
"start_date": "today"
"end_date": The ending date for the period over which the performance metrics will be calculated.
Example:
"end_date": "2020-12-31"
"end_date": null
"end_date": "today"
"extract_idle_duration": A boolean flag that determines whether idle and blur durations are included in the reports.
Example:
"extract_idle_duration": true
"extract_idle_duration": false
"duration_unit": The unit of time for the metrics aggregation. This defines the granularity of the time per task metrics.
Options:
"msec"
"sec"
"min"
"hour"
Example:
"duration_unit": "min"
"count_nested_classifications": Determines whether nested classifications should be counted in the metrics.
Example:
"count_nested_classifications": true
"count_nested_classifications": false
"include_key_frames_only": Specifies whether only key frames should be included in the metrics calculation. (For video assets only)
Example:
"include_key_frames_only": true
"include_key_frames_only": false
"verbose": Controls the verbosity of the output. When enabled, more detailed logs and progress updates will be provided.
Example:
"verbose": true
"verbose": false
"verbose_frequency": Specifies how often verbose logs should be generated, in terms of processed tasks.
Example:
"verbose_frequency": 50
Last updated