newton-api-client 1.2.2

Python api client - https://api.objectways.com/docs

Newton API client

This is python package to call all API from (https://api.objectways.com/docs)

Import package and create a client

"api_url" is and optional parameter for private installs

from pprint import pprint
from objectways import newton

client = newton.Newton(api_url="YOUR_API_URL",api_key="YOUR_API_KEY")

1. Task

1.1. Add new task

body = {
  "project_id": "449354de1168469a8229f605",
  "file_name": "document.pdf",
  "file_type": "application/pdf",
  "source": "s3://examples/pdfs/document.pdf"
}

pprint(client.add_task(body))

1.2. Add bulk tasks

body = {
  "project_id": "cd1a965e334a9a63e2f17932",
  "task_list": [
    {
      "source": "s3://examples/pdfs/document.pdf",
      "annotations": "s3://examples/pdfs/annotation.json"
    },
    {
      "source": "s3://examples/pdfs/document2.pdf"
    },
    {
      "source": "s3://examples/pdfs/document3.pdf",
      "annotations": {
        "tags": [
          {
            "page": 1,
            "range": [
              192,
              198
            ],
            "text": "Oxford",
            "id": 1,
            "type": "NAME"
          }
        ]
      }
    }
  ]
}

pprint(client.add_bulk_tasks(body))

1.3. Add labels to task

body = {
  "annotations": "s3://examples/pdfs/annotation.json"
}

pprint(client.add_labels_to_task(task_id=task_id,body=body))

1.4. Add task file

data = client.add_task_file(
    project_id="449354de1168469a8229f605", 
    file_path="examples/pdfs/document.pdf",
    mime_type="application/pdf",
    annotations=None
)

pprint(data)

1.5. Get Task by task_id

• To Find all annotations for the task use optional trail = True

data = client.get_task(
    task_id="449354de1168469a8229f605", 
    trail = True 
)

pprint(data)

1.6. Delete Task by task_id

data = client.delete_task(
    task_id="449354de1168469a8229f605"
)

pprint(data)

1.7. Get tasks by filters

• Find all the tasks by task_id, file_name, file_type
• trail parameter is deprecated
• If all of task_id, file_name, file_type are None, it will return all possible tasks

tasks = client.get_tasks(
    project_id="449354de1168469a8229f605", 
    task_id="449354de1168469a8229f605-0",
    file_name=None,
    file_type=None,
    //trail = False (deprecated)
)

pprint(tasks)

1.8. Export Tasks by project_id

response = client.export_tasks(
    project_id="449354de1168469a8229f605", 
)

pprint(response)

1.9. Get Bounding box coordinates for Words for a task

• Get Bounding Box coordinates of all pages in a document
• Optionally pass "page" number to restrict by the page

response = client.get_word_boxes(
    task_id="449354de1168469a8229f605",
    page = 1 
)

pprint(response)

1.10. Get deep link for task

response = client.get_task_deep_link(
    task_id="449354de1168469a8229f605" 
 )

pprint(response)

1.11. Set deep link for task

response = client.create_task_deep_link(
    task_id="449354de1168469a8229f605", 
    user_name="johndoe",
    user_email="[e-mail]",
    role="Annotator",
    expire_in=5,
    return_url=https://yourdomain.com
)

pprint(response)

1.12. Get url for task

response = client.get_task_url(
    task_id="449354de1168469a8229f605",
    role="annotator"|"reviewer"
 )

pprint(response)

2. Project

2.1. Create a new project

body = {
  "project_name": "TestProject",
  "project_type": "NER",
  "enable_text_mode_option": True,
  "disable_quality_audit": True,
  ...
}
# check API docs for the full body: https://api.objectways.com/docs/#/projects/upload_project

pprint(client.create_project(body))

2.2. Get project by project_id

response = client.get_project(
    project_id="449354de1168469a8229f605", 
)

2.3. Update project

body = {
  "project_name": "TestProject",
  "project_type": "NER",
  "enable_text_mode_option": True,
  "disable_quality_audit": True,
  ...
}
response = client.update_project(
    project_id="449354de1168469a8229f605",
    body=body 
)

2.4. Delete project

response = client.delete_project(
    project_id="449354de1168469a8229f605",
)

2.5. Get projects by Filters

• Find all the projects by project_id, project_name or active
• If all of project_id, project_name, active are None, it will return all possible projects

response = client.get_projects(
    project_id="449354de1168469a8229f605", 
    project_name=None, 
    active=None
)

2.6. Export project Tasks

response = client.export_project_tasks(
    project_id="449354de1168469a8229f605", 
    export_note="This is test export via API"
)

2.7. List Project Exports

response = client.list_project_exports(
    project_id="449354de1168469a8229f605", 
)

2.8. Download Project Exports

response = client.download_project_export(
    export_id="449354de1168469a8229f605", 
)

3. Team Management

3.1. Add member to the team

member = client.add_team_member(
    project_id="449354de1168469a8229f605", 
    email="[e-mail]", 
    role="annotator|reviewer|supervisor"
)

3.2. Get project team members

team = client.get_project_team_members(
    project_id="449354de1168469a8229f605", 
)

3.3. Remove member from the project team

team = client.remove_project_team_member(
    project_id="449354de1168469a8229f605",
    email="[e-mail]" 
)

4. Dataset Management

4.1. Create a new Dataset

body = {
  "dataset_name": "Test Dataset",
  "dataset_description": "This is a test Dataset",
  "dataset_type": "Image",
  "item_format": "image/tiff",
  "meta_data": {
    "key": "value"
  },
  "s3IntermediateUrl": "s3://test-dataset/intermediate",
  "aws_credentials_enabled": true,
  "aws_credentials": {
    "awsKey": "...",
    "awsSecret": "...",
    "awsRegion": "us-east-1",
    "awsType": "key"
  }
}
# check API docs for the full body:http://54.83.23.220:8089/docs/#/datasets/upload_dataset

pprint(client.create_dataset(body))

4.2. Get dataset by dataset_id

response = client.get_dataset(
    dataset_id="449354de1168469a8229f605", 
)

4.3. Update dataset

body = {
  "dataset_name": "Test Dataset",
  "dataset_description": "This is a test Dataset",
  "dataset_type": "Image",
  "item_format": "image/tiff",
  "meta_data": {
    "key": "value"
  },
  "s3IntermediateUrl": "s3://mybucket/test-dataset/intermediate",
  "aws_credentials_enabled": true,
  "aws_credentials": {
    "awsKey": "xxxxx",
    "awsSecret": "xxx",
    "awsRegion": "us-east-1",
    "awsType": "key"
  }
}
response = client.update_dataset(
    dataset_id="449354de1168469a8229f605",
    body=body 
)

4.4. List datasets by Filters

• Find all the datasets by dataset_id, dataset_name or active
• If all of dataset_id, dataset_name, active are None, it will return all possible datasets

response = client.list_datasets(
    dataset_id="449354de1168469a8229f605", 
    dataset_name=None, 
    active=None
)

4.5. Delete dataset by dataset_id

response = client.delete_dataset(
    dataset_id="449354de1168469a8229f605", 
)

4.6. Export Dataset (by project_id optional)

response = client.export_dataset(
    dataset_id="449354de1168469a8229f605", 
    export_note="This is test export via API",
    project_id="449354de1168469a8229f606"
)

4.7. List Dataset Exports

response = client.list_dataset_exports(
    dataset_id="449354de1168469a8229f605", 
)

4.8. Download Dataset Export

response = client.download_dataset_export(
    export_id="449354de1168469a8229f605", 
)

4.9. Create a new Dataset Item

body = {
  "dataset_id": "208eb554d3fa1e161b2c6a44",
  "dataset_items": [
    {
      "meta_data": {
        "batch": "10",
        "test": "cell"
      },
      "source": "s3://mybucket/test-dataset/file1.tiff"
    },
    {
      "meta_data": {
        "batch": "1",
        "test": "cell"
      },
      "source": "s3://mybucket/test-dataset/file2.tiff"
    } 
    ....
    ....
  ]
}
# check API docs for the full body:https://adl.objectways.com/docs/#/datasets/upload_dataset

pprint(client.create_dataset_item(body))

4.10. Get dataset_item by item_id

response = client.get_dataset_item(
    item_id="449354de1168469a8229f605" 
)

4.11. Delete dataset_item by item_id

response = client.delete_dataset_item(
    item_id="449354de1168469a8229f605" 
)

4.12. List dataset items by Filters

• Find all the dataset items by dataset_id, dataset_version
• If dataset_version is None, it will return all possible dataset items for all versions

projects = client.list_dataset_items(
    dataset_id="449354de1168469a8229f605", 
    dataset_version=3 
)