Workspace Management

📘

A workspace is an isolated space that is tied to a specific billing account. Users within a team can create, manage, and segregate their computer vision projects within that workspace using their personal account. All resource usage and quotas for these projects in the workspace are deducted according to the plan that the linked billing account has signed up for. Learn more about Workspaces.

get_info

Retrieves details about the current workspace given by the provided secret key, such as the workspace name, workspace owner, and workspace tier.

Arguments

None

Return

Workspace object containing the relevant workspace information with the following structure:

Workspace(
    id="ws_1c8aab980f174b0296c7e35e88665b13",
    name="Raighne's Workspace",
    owner="user_6323fea23e292439f31c58cd",
    tier="Developer",
    create_date=1701927649302
)
AttributeTypeDescription
idstrUnique ID of the current workspace.
namestrName of the current workspace. You can directly modify this on Nexus by clicking on the Settings button on the top right of the Workspace Dashboard.
ownerstrUnique user ID of the workspace owner. This is tied to the email used to sign up for the Nexus account.
tierstrCurrent workspace tier that determines access to advanced features and increased resource quotas. To enjoy these benefits, check out how to Upgrade Your Plan.
create_dateintUNIX timestamp of workspace creation date.

Examples

Retrieve information about the workspace tied to the secret key 01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2.

from datature.nexus import Client

SECRET_KEY = "01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2"
client = Client(SECRET_KEY)
client.get_info()

list_projects

List all existing projects created under the workspace given by the provided secret key .

Arguments

None

Return

A list of Project objects containing the project information with the following structure:

[Project(
    id="proj_9004a21df7b040ace4674c4879603fe8",
    name="Cats",
    workspace_id="ws_1c8aab980f174b0296c7e35e88665b13",
    type="ObjectDetection",
    create_date=1701927649302,
    localization="MULTI",
    tags=["cat faces"],
    groups=["main", "cats"],
    statistic=Statistic(
        tags_count=[TagsCountItem(name="cat faces", count=0)],
        total_assets=28,
        annotated_assets=0,
        total_annotations=0
    )
)]
AttributeTypeDescription
idstrUnique ID of the project.
namestrName of the project. You can modify this by calling the function project.update({"name": "YOUR_NEW_PROJECT_NAME"}), or you can directly modify this on Nexus by clicking on the Settings tab on the left sidebar of the Project Dashboard.
workspace_idstrUnique ID of the current workspace that this project is in.
typestrType of project. This can be one of ObjectDetection, InstanceSegmentation, Classification, or Keypoint depending on the type selected during project creation on Nexus.
create_dateintUNIX timestamp of project creation date.
localizationstrRegion(s) for data localization. Defaults to MULTI for multi-region.
tagslist[str]List of tag names in the project.
groupslist[strList of asset group names in the project.
statisticStatistic objectContains project statistics for the following categories:
- tags_count: List of TagCountItem objects representing tag counts for each tag in the project.
- total_assets: Total number of assets in the project.
- annotated_assets: Total number of annotated assets in the project.
- total_annotations: Total number of annotations in the project.

Examples

Retrieve information about all existing projects under the workspace tied to the secret key 01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2.

from datature.nexus import Client

SECRET_KEY = "01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2"
client = Client(SECRET_KEY)
client.list_projects()

Iterate through the list of projects and retrieve each project's information one by one:

from datature.nexus import Client

SECRET_KEY = "01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2"
client = Client(SECRET_KEY)
projects = client.list_projects()

for project in projects:
  	project.get_info()

get_project

Retrieve a specific project's information based on the project key, such as the project type, asset groups, tags, and

Arguments

NameTypeDescription
project_idstrThe ID of the project. This can be retrieved via two methods:
1. Navigate to the Integrations tab on the left sidebar of your project page, then copy the project key and prepend proj_ to it.
2. Extract the ID from the URL in your address bar (https://nexus.datature.io/project/YOUR_PROJECT_ID) and prepend proj_ to it.

Return

Project object containing the relevant project information with the following structure:

Project(
    id="proj_9004a21df7b040ace4674c4879603fe8",
    name="Cats",
    workspace_id="ws_1c8aab980f174b0296c7e35e88665b13",
    type="ObjectDetection",
    create_date=1701927649302,
    localization="MULTI",
    tags=["cat faces"],
    groups=["main", "cats"],
    statistic=Statistic(
        tags_count=[TagsCountItem(name="cat faces", count=0)],
        total_assets=28,
        annotated_assets=0,
        total_annotations=0
    )
)
AttributeTypeDescription
idstrUnique ID of the project.
namestrName of the project. You can modify this by calling the function project.update({"name": "YOUR_NEW_PROJECT_NAME"}), or you can directly modify this on Nexus by clicking on the Settings tab on the left sidebar of the Project Dashboard.
workspace_idstrUnique ID of the current workspace that this project is in.
typestrType of project. This can be one of ObjectDetection, InstanceSegmentation, Classification, or Keypoint depending on the type selected during project creation on Nexus.
create_dateintUNIX timestamp of project creation date.
localizationstrRegion(s) for data localization. Defaults to MULTI for multi-region.
tagslist[str]List of tag names in the project.
groupslist[strList of asset group names in the project.
statisticStatistic objectContains project statistics for the following categories:
- tags_count: List of TagCountItem objects representing tag counts for each tag in the project.
- total_assets: Total number of assets in the project.
- annotated_assets: Total number of annotated assets in the project.
- total_annotations: Total number of annotations in the project.

Examples

Retrieve project information from the project with project key 9004a21df7b040ace4674c4879603fe8

from datature.nexus import Client

SECRET_KEY = "01048a3572a00dec13a6ca204fa78c0c4c216475c2ca80cb618114d26783d5a2"
PROJECT_ID = "proj_9004a21df7b040ace4674c4879603fe8"
client = Client(SECRET_KEY)
project = client.get_project(PROJECT_ID)
project.get_info()