QualityApi class reference


All URIs are relative to http://localhost

Method HTTP request Description
create_report POST /api/quality/reports Create a quality report
create_settings_requirements POST /api/quality/settings/requirements Create a quality requirement
create_settings_requirements_bulk POST /api/quality/settings/requirements/bulk Create a hierarchy of quality requirements
destroy_settings_requirements DELETE /api/quality/settings/requirements/{id} Delete a quality requirement
list_conflicts GET /api/quality/conflicts List annotation conflicts in a quality report
list_reports GET /api/quality/reports Method returns a paginated list of quality reports.
list_settings GET /api/quality/settings List quality settings instances
list_settings_requirements GET /api/quality/settings/requirements List quality requirements
partial_update_settings PATCH /api/quality/settings/{id} Update a quality settings instance
partial_update_settings_requirements PATCH /api/quality/settings/requirements/{id} Update a quality requirement
retrieve_report GET /api/quality/reports/{id} Get quality report details
retrieve_report_confusion GET /api/quality/reports/{id}/confusion Download quality report confusion matrices
retrieve_report_data GET /api/quality/reports/{id}/data Get quality report contents
retrieve_report_requirement_confusion GET /api/quality/reports/{id}/confusion/matrix Get a quality report requirement confusion matrix
retrieve_settings GET /api/quality/settings/{id} Get quality settings instance details
retrieve_settings_requirements GET /api/quality/settings/requirements/{id} Get quality requirement details
update_settings PUT /api/quality/settings/{id} Replace a quality settings instance
update_settings_requirements PUT /api/quality/settings/requirements/{id} Replace a quality requirement

create_report

create_report( rq_id=None, quality_report_create_request=None, **kwargs )

Create a quality report

Deprecation warning: Utilizing this endpoint to check the computation status is no longer possible. Consider using common requests API: GET /api/requests/<rq_id>

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    rq_id = "rq_id_example" # str | The report creation request id. Can be specified to check the report creation status.  (optional)
    quality_report_create_request = QualityReportCreateRequest(
        task_id=1,
        project_id=1,
    ) # QualityReportCreateRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.create_report(
            rq_id=rq_id,
            quality_report_create_request=quality_report_create_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.create_report(): %s\n" % e)

Parameters

Name Type Description Notes
rq_id str The report creation request id. Can be specified to check the report creation status. [optional]
quality_report_create_request QualityReportCreateRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityReport, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
201 -
202 A quality report request has been enqueued, the request id is returned. The request status can be checked at this endpoint by passing the rq_id as the query parameter. If the request id is specified, this response means the quality report request is queued or is being processed. -
400 Invalid or failed request, check the response data for details -

create_settings_requirements

create_settings_requirements( quality_requirement_request=None, **kwargs )

Create a quality requirement

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    quality_requirement_request = QualityRequirementRequest(
        settings_id=1,
        name="name_example",
        sort_order=-2147483648,
        filter="filter_example",
        enabled=True,
        annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
        metric=PatchedQualityRequirementRequestMetric(None),
        required_score=0,
        parent_requirement=1,
        iou_threshold=0,
        point_size=0,
        point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
        line_thickness=0,
        match_orientation=True,
        line_orientation_threshold=0,
        match_groups=True,
        group_match_threshold=0,
        check_covered_annotations=True,
        object_visibility_threshold=0,
        panoptic_comparison=True,
        attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
    ) # QualityRequirementRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.create_settings_requirements(
            quality_requirement_request=quality_requirement_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.create_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
quality_requirement_request QualityRequirementRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityRequirement, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
201 -

create_settings_requirements_bulk

create_settings_requirements_bulk( quality_requirement_bulk_create_request, **kwargs )

Create a hierarchy of quality requirements

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    quality_requirement_bulk_create_request = QualityRequirementBulkCreateRequest(
        settings_id=1,
        requirements=[
            QualityRequirementBulkCreateNodeRequest(
                name="name_example",
                sort_order=-2147483648,
                filter="filter_example",
                enabled=True,
                annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
                metric=PatchedQualityRequirementRequestMetric(None),
                required_score=0,
                parent_requirement=1,
                iou_threshold=0,
                point_size=0,
                point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
                line_thickness=0,
                match_orientation=True,
                line_orientation_threshold=0,
                match_groups=True,
                group_match_threshold=0,
                check_covered_annotations=True,
                object_visibility_threshold=0,
                panoptic_comparison=True,
                attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
                children=[
                    QualityRequirementBulkCreateNodeRequest(),
                ],
            ),
        ],
    ) # QualityRequirementBulkCreateRequest | 

    try:
        (data, response) = api_client.quality_api.create_settings_requirements_bulk(
            quality_requirement_bulk_create_request,)
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.create_settings_requirements_bulk(): %s\n" % e)

Parameters

Name Type Description Notes
quality_requirement_bulk_create_request QualityRequirementBulkCreateRequest

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[list[QualityRequirement], urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
201 -

destroy_settings_requirements

destroy_settings_requirements( id, **kwargs )

Delete a quality requirement

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality requirement.

    try:
        api_client.quality_api.destroy_settings_requirements(
            id,)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.destroy_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality requirement.

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[None, urllib3.HTTPResponse].

Returns a tuple with 2 values: (None, raw_response).

This endpoint does not have any return value, so None is always returned as the first value. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

HTTP response details

Status code Description Response headers
204 Requirement deleted -

list_conflicts

list_conflicts( x_organization=None, filter=None, frame=None, job_id=None, org=None, org_id=None, page=None, page_size=None, project_id=None, report_id=None, severity=None, sort=None, task_id=None, type=None, **kwargs )

List annotation conflicts in a quality report

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    x_organization = "X-Organization_example" # str | Organization unique slug (optional)
    filter = "filter_example" # str |  JSON Logic filter. This filter can be used to perform complex filtering by grouping rules.  For example, using such a filter you can get all resources created by you:      - {\"and\":[{\"==\":[{\"var\":\"owner\"},\"<user>\"]}]}  Details about the syntax used can be found at the link: https://jsonlogic.com/   Available filter_fields: ['frame', 'id', 'job_id', 'project_id', 'severity', 'task_id', 'type']. (optional)
    frame = 1 # int | A simple equality filter for the frame field (optional)
    job_id = 1 # int | A simple equality filter for the job_id field (optional)
    org = "org_example" # str | Organization unique slug (optional)
    org_id = 1 # int | Organization identifier (optional)
    page = 1 # int | A page number within the paginated result set. (optional)
    page_size = 1 # int | Number of results to return per page. (optional)
    project_id = 1 # int | A simple equality filter for the project_id field (optional)
    report_id = 1 # int | A simple equality filter for report id (optional)
    severity = "error" # str | A simple equality filter for the severity field (optional) if omitted the server will use the default value of "error"
    sort = "sort_example" # str | Which field to use when ordering the results. Available ordering_fields: ['frame', 'id', 'job_id', 'project_id', 'severity', 'task_id', 'type'] (optional)
    task_id = 1 # int | A simple equality filter for the task_id field (optional)
    type = "missing_annotation" # str | A simple equality filter for the type field (optional)

    try:
        (data, response) = api_client.quality_api.list_conflicts(
            x_organization=x_organization,
            filter=filter,
            frame=frame,
            job_id=job_id,
            org=org,
            org_id=org_id,
            page=page,
            page_size=page_size,
            project_id=project_id,
            report_id=report_id,
            severity=severity,
            sort=sort,
            task_id=task_id,
            type=type,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.list_conflicts(): %s\n" % e)

Parameters

Name Type Description Notes
x_organization str Organization unique slug [optional]
filter str JSON Logic filter. This filter can be used to perform complex filtering by grouping rules. For example, using such a filter you can get all resources created by you: - {"and":[{"==":[{"var":"owner"},""]}]} Details about the syntax used can be found at the link: https://jsonlogic.com/ Available filter_fields: [‘frame’, ‘id’, ‘job_id’, ‘project_id’, ‘severity’, ’task_id’, ’type’]. [optional]
frame int A simple equality filter for the frame field [optional]
job_id int A simple equality filter for the job_id field [optional]
org str Organization unique slug [optional]
org_id int Organization identifier [optional]
page int A page number within the paginated result set. [optional]
page_size int Number of results to return per page. [optional]
project_id int A simple equality filter for the project_id field [optional]
report_id int A simple equality filter for report id [optional]
severity str A simple equality filter for the severity field [optional] if omitted the server will use the default value of “error”
sort str Which field to use when ordering the results. Available ordering_fields: [‘frame’, ‘id’, ‘job_id’, ‘project_id’, ‘severity’, ’task_id’, ’type’] [optional]
task_id int A simple equality filter for the task_id field [optional]
type str A simple equality filter for the type field [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[PaginatedAnnotationConflictList, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

list_reports

list_reports( x_organization=None, filter=None, include_legacy=None, job_id=None, org=None, org_id=None, page=None, page_size=None, parent_id=None, project_id=None, sort=None, target=None, task_id=None, **kwargs )

Method returns a paginated list of quality reports.

Please note that children reports are included by default if the "task_id", "project_id" filters are used. If you want to restrict the list of results to a specific report type, use the "target" parameter. The "parent_id" filter includes all the nested reports recursively. For instance, if the "parent_id" is a project report, all the related task and job reports will be returned. Please note that a report can be reused in several parent reports, but the "parent_id" field in responses will include only the first parent report id. The "parent_id" filter still returns all the relevant nested reports, even though the response "parent_id" values may be different from the requested one.

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    x_organization = "X-Organization_example" # str | Organization unique slug (optional)
    filter = "filter_example" # str |  JSON Logic filter. This filter can be used to perform complex filtering by grouping rules.  For example, using such a filter you can get all resources created by you:      - {\"and\":[{\"==\":[{\"var\":\"owner\"},\"<user>\"]}]}  Details about the syntax used can be found at the link: https://jsonlogic.com/   Available filter_fields: ['created_date', 'gt_last_updated', 'id', 'job_id', 'project_id', 'target_last_updated', 'task_id']. (optional)
    include_legacy = False # bool | Include reports stored in the legacy data format (optional) if omitted the server will use the default value of False
    job_id = 1 # int | A simple equality filter for the job_id field (optional)
    org = "org_example" # str | Organization unique slug (optional)
    org_id = 1 # int | Organization identifier (optional)
    page = 1 # int | A page number within the paginated result set. (optional)
    page_size = 1 # int | Number of results to return per page. (optional)
    parent_id = 1 # int | A simple equality filter for parent id (optional)
    project_id = 1 # int | A simple equality filter for project id (optional)
    sort = "sort_example" # str | Which field to use when ordering the results. Available ordering_fields: ['created_date', 'gt_last_updated', 'id', 'job_id', 'project_id', 'target_last_updated', 'task_id'] (optional)
    target = "job" # str | A simple equality filter for target (optional)
    task_id = 1 # int | A simple equality filter for task id (optional)

    try:
        (data, response) = api_client.quality_api.list_reports(
            x_organization=x_organization,
            filter=filter,
            include_legacy=include_legacy,
            job_id=job_id,
            org=org,
            org_id=org_id,
            page=page,
            page_size=page_size,
            parent_id=parent_id,
            project_id=project_id,
            sort=sort,
            target=target,
            task_id=task_id,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.list_reports(): %s\n" % e)

Parameters

Name Type Description Notes
x_organization str Organization unique slug [optional]
filter str JSON Logic filter. This filter can be used to perform complex filtering by grouping rules. For example, using such a filter you can get all resources created by you: - {"and":[{"==":[{"var":"owner"},""]}]} Details about the syntax used can be found at the link: https://jsonlogic.com/ Available filter_fields: [‘created_date’, ‘gt_last_updated’, ‘id’, ‘job_id’, ‘project_id’, ’target_last_updated’, ’task_id’]. [optional]
include_legacy bool Include reports stored in the legacy data format [optional] if omitted the server will use the default value of False
job_id int A simple equality filter for the job_id field [optional]
org str Organization unique slug [optional]
org_id int Organization identifier [optional]
page int A page number within the paginated result set. [optional]
page_size int Number of results to return per page. [optional]
parent_id int A simple equality filter for parent id [optional]
project_id int A simple equality filter for project id [optional]
sort str Which field to use when ordering the results. Available ordering_fields: [‘created_date’, ‘gt_last_updated’, ‘id’, ‘job_id’, ‘project_id’, ’target_last_updated’, ’task_id’] [optional]
target str A simple equality filter for target [optional]
task_id int A simple equality filter for task id [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[PaginatedQualityReportList, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

list_settings

list_settings( x_organization=None, filter=None, inherit=None, org=None, org_id=None, page=None, page_size=None, parent_type=None, project_id=None, sort=None, task_id=None, **kwargs )

List quality settings instances

Please note that child task settings are included by default if the "project_id" filter is used. If you want to restrict results only to a specific parent type, use the "parent_type" parameter.

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    x_organization = "X-Organization_example" # str | Organization unique slug (optional)
    filter = "filter_example" # str |  JSON Logic filter. This filter can be used to perform complex filtering by grouping rules.  For example, using such a filter you can get all resources created by you:      - {\"and\":[{\"==\":[{\"var\":\"owner\"},\"<user>\"]}]}  Details about the syntax used can be found at the link: https://jsonlogic.com/   Available filter_fields: ['created_date', 'id', 'inherit', 'project_id', 'task_id', 'updated_date']. (optional)
    inherit = True # bool | A simple equality filter for the inherit field (optional)
    org = "org_example" # str | Organization unique slug (optional)
    org_id = 1 # int | Organization identifier (optional)
    page = 1 # int | A page number within the paginated result set. (optional)
    page_size = 1 # int | Number of results to return per page. (optional)
    parent_type = "project" # str | A simple equality filter for parent instance type (optional)
    project_id = 1 # int | A simple equality filter for project id (optional)
    sort = "sort_example" # str | Which field to use when ordering the results. Available ordering_fields: ['created_date', 'id', 'inherit', 'project_id', 'task_id', 'updated_date'] (optional)
    task_id = 1 # int | A simple equality filter for the task_id field (optional)

    try:
        (data, response) = api_client.quality_api.list_settings(
            x_organization=x_organization,
            filter=filter,
            inherit=inherit,
            org=org,
            org_id=org_id,
            page=page,
            page_size=page_size,
            parent_type=parent_type,
            project_id=project_id,
            sort=sort,
            task_id=task_id,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.list_settings(): %s\n" % e)

Parameters

Name Type Description Notes
x_organization str Organization unique slug [optional]
filter str JSON Logic filter. This filter can be used to perform complex filtering by grouping rules. For example, using such a filter you can get all resources created by you: - {"and":[{"==":[{"var":"owner"},""]}]} Details about the syntax used can be found at the link: https://jsonlogic.com/ Available filter_fields: [‘created_date’, ‘id’, ‘inherit’, ‘project_id’, ’task_id’, ‘updated_date’]. [optional]
inherit bool A simple equality filter for the inherit field [optional]
org str Organization unique slug [optional]
org_id int Organization identifier [optional]
page int A page number within the paginated result set. [optional]
page_size int Number of results to return per page. [optional]
parent_type str A simple equality filter for parent instance type [optional]
project_id int A simple equality filter for project id [optional]
sort str Which field to use when ordering the results. Available ordering_fields: [‘created_date’, ‘id’, ‘inherit’, ‘project_id’, ’task_id’, ‘updated_date’] [optional]
task_id int A simple equality filter for the task_id field [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[PaginatedQualitySettingsList, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

list_settings_requirements

list_settings_requirements( x_organization=None, annotation_type=None, enabled=None, filter=None, org=None, org_id=None, page=None, page_size=None, project_id=None, settings_id=None, sort=None, task_id=None, **kwargs )

List quality requirements

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    x_organization = "X-Organization_example" # str | Organization unique slug (optional)
    annotation_type = "tag" # str | A simple equality filter for the annotation_type field (optional)
    enabled = True # bool | A simple equality filter for the enabled field (optional)
    filter = "filter_example" # str |  JSON Logic filter. This filter can be used to perform complex filtering by grouping rules.  For example, using such a filter you can get all resources created by you:      - {\"and\":[{\"==\":[{\"var\":\"owner\"},\"<user>\"]}]}  Details about the syntax used can be found at the link: https://jsonlogic.com/   Available filter_fields: ['annotation_type', 'created_date', 'enabled', 'id', 'project_id', 'settings_id', 'task_id', 'updated_date']. (optional)
    org = "org_example" # str | Organization unique slug (optional)
    org_id = 1 # int | Organization identifier (optional)
    page = 1 # int | A page number within the paginated result set. (optional)
    page_size = 1 # int | Number of results to return per page. (optional)
    project_id = 1 # int | Project id filter (optional)
    settings_id = 1 # int | Settings id filter (optional)
    sort = "sort_example" # str | Which field to use when ordering the results. Available ordering_fields: ['annotation_type', 'created_date', 'enabled', 'id', 'name', 'project_id', 'settings_id', 'sort_order', 'task_id', 'updated_date'] (optional)
    task_id = 1 # int | Task id filter (optional)

    try:
        (data, response) = api_client.quality_api.list_settings_requirements(
            x_organization=x_organization,
            annotation_type=annotation_type,
            enabled=enabled,
            filter=filter,
            org=org,
            org_id=org_id,
            page=page,
            page_size=page_size,
            project_id=project_id,
            settings_id=settings_id,
            sort=sort,
            task_id=task_id,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.list_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
x_organization str Organization unique slug [optional]
annotation_type str A simple equality filter for the annotation_type field [optional]
enabled bool A simple equality filter for the enabled field [optional]
filter str JSON Logic filter. This filter can be used to perform complex filtering by grouping rules. For example, using such a filter you can get all resources created by you: - {"and":[{"==":[{"var":"owner"},""]}]} Details about the syntax used can be found at the link: https://jsonlogic.com/ Available filter_fields: [‘annotation_type’, ‘created_date’, ’enabled’, ‘id’, ‘project_id’, ‘settings_id’, ’task_id’, ‘updated_date’]. [optional]
org str Organization unique slug [optional]
org_id int Organization identifier [optional]
page int A page number within the paginated result set. [optional]
page_size int Number of results to return per page. [optional]
project_id int Project id filter [optional]
settings_id int Settings id filter [optional]
sort str Which field to use when ordering the results. Available ordering_fields: [‘annotation_type’, ‘created_date’, ’enabled’, ‘id’, ’name’, ‘project_id’, ‘settings_id’, ‘sort_order’, ’task_id’, ‘updated_date’] [optional]
task_id int Task id filter [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[PaginatedQualityRequirementListItemList, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

partial_update_settings

partial_update_settings( id, patched_quality_settings_request=None, **kwargs )

Update a quality settings instance

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | An id of a quality settings instance
    patched_quality_settings_request = PatchedQualitySettingsRequest(
        job_filter="job_filter_example",
        inherit=True,
        max_validations_per_job=0,
        requirements=[
            QualityRequirementListItemRequest(
                settings_id=1,
                name="name_example",
                sort_order=-2147483648,
                filter="filter_example",
                enabled=True,
                annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
                metric=PatchedQualityRequirementRequestMetric(None),
                required_score=0,
                parent_requirement=1,
                iou_threshold=0,
                point_size=0,
                point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
                line_thickness=0,
                match_orientation=True,
                line_orientation_threshold=0,
                match_groups=True,
                group_match_threshold=0,
                check_covered_annotations=True,
                object_visibility_threshold=0,
                panoptic_comparison=True,
                attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
            ),
        ],
    ) # PatchedQualitySettingsRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.partial_update_settings(
            id,
            patched_quality_settings_request=patched_quality_settings_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.partial_update_settings(): %s\n" % e)

Parameters

Name Type Description Notes
id int An id of a quality settings instance
patched_quality_settings_request PatchedQualitySettingsRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualitySettings, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

partial_update_settings_requirements

partial_update_settings_requirements( id, patched_quality_requirement_request=None, **kwargs )

Update a quality requirement

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality requirement.
    patched_quality_requirement_request = PatchedQualityRequirementRequest(
        settings_id=1,
        name="name_example",
        sort_order=-2147483648,
        filter="filter_example",
        enabled=True,
        annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
        metric=PatchedQualityRequirementRequestMetric(None),
        required_score=0,
        parent_requirement=1,
        iou_threshold=0,
        point_size=0,
        point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
        line_thickness=0,
        match_orientation=True,
        line_orientation_threshold=0,
        match_groups=True,
        group_match_threshold=0,
        check_covered_annotations=True,
        object_visibility_threshold=0,
        panoptic_comparison=True,
        attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
    ) # PatchedQualityRequirementRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.partial_update_settings_requirements(
            id,
            patched_quality_requirement_request=patched_quality_requirement_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.partial_update_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality requirement.
patched_quality_requirement_request PatchedQualityRequirementRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityRequirement, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

retrieve_report

retrieve_report( id, **kwargs )

Get quality report details

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality report.

    try:
        (data, response) = api_client.quality_api.retrieve_report(
            id,)
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_report(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality report.

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityReport, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

retrieve_report_confusion

retrieve_report_confusion( id, **kwargs )

Download quality report confusion matrices

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality report.

    try:
        (data, response) = api_client.quality_api.retrieve_report_confusion(
            id,)
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_report_confusion(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality report.

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[file_type, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 ZIP archive with per-requirement confusion matrices -

retrieve_report_data

retrieve_report_data( id, format=None, **kwargs )

Get quality report contents

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality report.
    format = "json" # str |  (optional) if omitted the server will use the default value of "json"

    try:
        (data, response) = api_client.quality_api.retrieve_report_data(
            id,
            format=format,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_report_data(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality report.
format str [optional] if omitted the server will use the default value of “json”

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[file_type, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

retrieve_report_requirement_confusion

retrieve_report_requirement_confusion( id, requirement, format=None, **kwargs )

Get a quality report requirement confusion matrix

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality report.
    requirement = 1 # int | Quality requirement id in the report
    format = "json" # str |  (optional) if omitted the server will use the default value of "json"

    try:
        (data, response) = api_client.quality_api.retrieve_report_requirement_confusion(
            id,
            requirement,
            format=format,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_report_requirement_confusion(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality report.
requirement int Quality requirement id in the report
format str [optional] if omitted the server will use the default value of “json”

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityReportConfusionMatrix, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, text/csv

HTTP response details

Status code Description Response headers
200 JSON confusion matrix for the requested quality requirement -
404 Requirement confusion matrix was not found -

retrieve_settings

retrieve_settings( id, **kwargs )

Get quality settings instance details

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | An id of a quality settings instance

    try:
        (data, response) = api_client.quality_api.retrieve_settings(
            id,)
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_settings(): %s\n" % e)

Parameters

Name Type Description Notes
id int An id of a quality settings instance

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualitySettings, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

retrieve_settings_requirements

retrieve_settings_requirements( id, **kwargs )

Get quality requirement details

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality requirement.

    try:
        (data, response) = api_client.quality_api.retrieve_settings_requirements(
            id,)
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.retrieve_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality requirement.

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityRequirement, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

update_settings

update_settings( id, quality_settings_request=None, **kwargs )

Replace a quality settings instance

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | An id of a quality settings instance
    quality_settings_request = QualitySettingsRequest(
        job_filter="job_filter_example",
        inherit=True,
        max_validations_per_job=0,
        requirements=[
            QualityRequirementListItemRequest(
                settings_id=1,
                name="name_example",
                sort_order=-2147483648,
                filter="filter_example",
                enabled=True,
                annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
                metric=PatchedQualityRequirementRequestMetric(None),
                required_score=0,
                parent_requirement=1,
                iou_threshold=0,
                point_size=0,
                point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
                line_thickness=0,
                match_orientation=True,
                line_orientation_threshold=0,
                match_groups=True,
                group_match_threshold=0,
                check_covered_annotations=True,
                object_visibility_threshold=0,
                panoptic_comparison=True,
                attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
            ),
        ],
    ) # QualitySettingsRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.update_settings(
            id,
            quality_settings_request=quality_settings_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.update_settings(): %s\n" % e)

Parameters

Name Type Description Notes
id int An id of a quality settings instance
quality_settings_request QualitySettingsRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualitySettings, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -

update_settings_requirements

update_settings_requirements( id, quality_requirement_request=None, **kwargs )

Replace a quality requirement

Example

from pprint import pprint

from cvat_sdk.api_client import Configuration, ApiClient, exceptions
from cvat_sdk.api_client.models import *

# Set up an API client
# Read Configuration class docs for more info about parameters and authentication methods
configuration = Configuration(
    host = "http://localhost",
    username = 'YOUR_USERNAME',
    password = 'YOUR_PASSWORD',
)

with ApiClient(configuration) as api_client:
    id = 1 # int | A unique integer value identifying this quality requirement.
    quality_requirement_request = QualityRequirementRequest(
        settings_id=1,
        name="name_example",
        sort_order=-2147483648,
        filter="filter_example",
        enabled=True,
        annotation_type=PatchedQualityRequirementRequestAnnotationType(None),
        metric=PatchedQualityRequirementRequestMetric(None),
        required_score=0,
        parent_requirement=1,
        iou_threshold=0,
        point_size=0,
        point_size_base=PatchedQualityRequirementRequestPointSizeBase(None),
        line_thickness=0,
        match_orientation=True,
        line_orientation_threshold=0,
        match_groups=True,
        group_match_threshold=0,
        check_covered_annotations=True,
        object_visibility_threshold=0,
        panoptic_comparison=True,
        attribute_comparison=PatchedQualityRequirementRequestAttributeComparison(None),
    ) # QualityRequirementRequest |  (optional)

    try:
        (data, response) = api_client.quality_api.update_settings_requirements(
            id,
            quality_requirement_request=quality_requirement_request,
        )
        pprint(data)
    except exceptions.ApiException as e:
        print("Exception when calling QualityApi.update_settings_requirements(): %s\n" % e)

Parameters

Name Type Description Notes
id int A unique integer value identifying this quality requirement.
quality_requirement_request QualityRequirementRequest [optional]

There are also optional kwargs that control the function invocation behavior. Read more here.

Returned values

Returned type: Tuple[QualityRequirement, urllib3.HTTPResponse].

Returns a tuple with 2 values: (parsed_response, raw_response).

The first value is a model parsed from the response data. The second value is the raw response, which can be useful to get response parameters, such as status code, headers, or raw response data. Read more about invocation parameters and returned values here.

Authentication

accessTokenAuth, basicAuth, csrfAuth, csrfHeaderAuth, sessionAuth, tokenAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/vnd.cvat+json

HTTP response details

Status code Description Response headers
200 -