Human Protocol SDK


A subpackage for calculating Inter Rater Agreement measures for annotated data.
This module contains methods that estimate the agreement between annotatorsin a data labelling project. Its role is to provide easy access to means of estimating data quality for developers of Reputation and Recording Oracles.

Getting Started

This module is an optional extra of the HUMAN Protocol SDK. In order to use it, run the following command:
pip install human_protocol_sdk[agreement]

A simple example

The main functionality of the module is provided by a single function called agreement. Suppose we have a very small annotation, where 3 annotators label 4 different images. The goal is to find find if an image contain a cat or not, so they label them either cat or not.
After processing, the data might look look like that:
from numpy import nan
annotations = [
['cat', 'not', 'cat'],
['cat', 'cat', 'cat'],
['not', 'not', 'not'],
['cat', nan, 'not'],
Each row contains the annotations for a single item and each column contains the annotations of an individual annotator. We call this format ‘annotation’ format, which is the default format expected by the agreement function and all measures implemented in this package.
Our data contains a missing value, indicated by the nan entry. Annotator 2 did not provide an annotation for item 4. All missing values must be marked in this way.
So, we can simply plug our annotations into the function.
agreement_report = agreement(annotations, measure="fleiss_kappa")
# {
# 'results': {
# 'measure': 'fleiss_kappa',
# 'score': 0.3950000000000001,
# 'ci': None,
# 'confidence_level': None
# },
# 'config': {
# 'measure': 'fleiss_kappa',
# 'labels': array(['cat', 'not'], dtype='<U3'),
# 'data': array([['cat', 'not', 'cat'],
# ['cat', 'cat', 'cat'],
# ['not', 'not', 'not'],
# ['cat', 'nan', 'not']], dtype='<U3'),
# 'bootstrap_method': None,
# 'bootstrap_kwargs': None,
# 'measure_kwargs': {}
# }
# }
We receive an agreement report. It is simply a dictionary, containing two keys: ‘results’ and ‘config’. The results dictionary contain the actual scores, while config contains the exact set of parameters that produced this output.
Given that Fleiss’ Kappa is ranging from -1 to 1, this is an acceptable yet suboptimal score.
For more information on the capabilities of this module and its functionalities, read the agreement function page.


Last modified 1mo ago