Properties

name Name of this Project

Methods

list_experiments

list_experiments(
   limit: (int|None) = None, offset: (int|None) = None,
   order_by: (list[str]|None) = None
)

Description

Retrieve all experiments of this project

Examples

experiments = my_project.list_experiments()

Arguments

limit (int, optional) : Limit of experiments to retrieve. Defaults to None.
offset (int, optional) : Offset to start retrieving experiments. Defaults to None.
order_by (list[str], optional) : Order by fields. Defaults to None.

Returns

A list of Experiment objects, that you can manipulate

delete_all_experiments

delete_all_experiments()

Description

Delete all experiments of this project

⚠️ DANGER ZONE: Be very careful here!

Examples

my_project.delete_all_experiments()

create_experiment

create_experiment(
   name: str, description: (str|None) = None,
   base_experiment: (Experiment|None) = None,
   base_model_version: (ModelVersion|None) = None, parameters: (dict|None) = None
)

Description

Create an Experiment in this Project.

By giving parameters, it will create a Log parameters on this Experiment with the content of the dict.
If base_experiment is provided, it will set the base_experiment on this Experiment.
It will copy the labelmap and Artifacts.
It might copy parameters of the base_experiment if no other parameters are given.
If base_model_version is provided it will set the base_model_version on this Experiment.
It will copy the labelmap and the model files, only if no base_experiment already fill them.
It might copy the parameters of the base_model_version if no other parameters are given, only if no base_experiment already fill them.

Examples

base_model_version = client.get_model_version_by_id("fbddcb6e-16de-4226-9624-0737879af774")
my_experiment = my_project.create_experiment(
    "test_experiment",
    description="This is a cool experiment",
    base_model_version=base_model_version,
)

Arguments

name (str, optional) : Name of experiment. Defaults to None.
description (str, optional) : Description of experiment.
base_experiment (Experiment, optional) : Base Experiment of this new experiment. Defaults to None.
base_model_version (ModelVersion, optional) : Base ModelVersion of this new experiment. Defaults to None.
parameters (dict, optional) : Parameters

Returns

A new Experiment of this project

update

update(
   name: (str|None) = None, description: (str|None) = None, private: (bool|None) = None
)

Description

Update a project with a new name or description

Examples

my_project.update(description="This is a cool project")

Arguments

name (str, optional) : New name of project. Defaults to None.
description (str, optional) : New description of project. Defaults to None.
private (bool, optional) : deprecated field.

delete

delete()

Description

Delete a project.

⚠️ DANGER ZONE: Be very careful here!

It will delete the project and all experiments linked.

Examples

my_project.delete()

get_experiment

get_experiment(
   name: str
)

Description

Retrieve an existing experiment by name.

Examples

my_experiment = my_project.get_experiment("test_experiment")

Arguments

name (str, optional) : Experiment's name.

Raises

Exception : Experiment not found

Returns

An Experiment object that you can manipulate

get_experiment_by_id

get_experiment_by_id(
   id: (UUID|str)
)

Description

Retrieve an existing experiment by id.

Examples

my_experiment = my_project.get_experiment_by_id("62cffb84-b92c-450c-bc37-8c4dd4d0f590")

Arguments

id : Experiment's id.

Raises

Exception : Experiment not found

Returns

An Experiment object that you can manipulate

attach_dataset

attach_dataset(
   dataset_version: DatasetVersion
)

Description

Attach a dataset version to this project.

Retrieve or create a dataset version and attach it to this project.

Examples

foo_dataset_version = client.get_dataset("foo").get_version("first")
my_project.attach_dataset(foo_dataset_version)

Arguments

dataset_version DatasetVersion : A dataset version to attach to the project.

detach_dataset

detach_dataset(
   dataset_version: DatasetVersion
)

Description

Detach a dataset version from this project.

Examples

foo_dataset_version = client.get_dataset("foo").get_version("first")
my_project.attach_dataset(foo_dataset_version)
my_project.detach_dataset(foo_dataset_version)

Arguments

dataset_version DatasetVersion : A dataset version to attach to the project.

list_dataset_versions

list_dataset_versions()

Description

Retrieve all dataset versions attached to this project

Examples

datasets = my_project.list_dataset_versions()

Returns

A list of DatasetVersion object attached to this project