これは、このセクションの複数ページの印刷可能なビューです。 印刷するには、ここをクリックしてください.

このページの通常のビューに戻る.

インポート&エクスポート API

クラス

class Api: wandb サーバーをクエリするために使用されます。

class File: File は wandb によって保存されたファイルに関連付けられているクラスです。

class Files: File オブジェクトの反復可能なコレクション。

class Job

class Project: プロジェクトは、run の名前空間です。

class Projects: Project オブジェクトの反復可能なコレクション。

class QueuedRun: entity と project に関連付けられた単一のキューされた run。run = queued_run.wait_until_running() または run = queued_run.wait_until_finished() を呼び出して run にアクセスします。

class Run: entity と project に関連付けられた単一の run。

class RunQueue

class Runs: プロジェクトとオプションのフィルタに関連付けられたいくつかの run の反復可能なコレクション。

class Sweep: sweep に関連付けられた一連の runs。

1 - Api API (Application Programming Interface) は、プログラム間でデータや機能をやり取りするためのインターフェースを提供します。W&B API は、ユーザーがwandb を通じて**Projects**、**Entities**、**Runs**などのデータにアクセスし、管理することを可能にします。このAPIにより、**Experiments**の追跡や**Reports**の共有を自動化できます。W&B APIはPythonを含むさまざまなプログラミング言語で利用可能です。これにより、カスタムスクリプトの作成や他のツールとの統合が簡単になります。APIの使用方法に関する詳細な情報は、[API documentation](https://wandb.ai)を参照してください。

wandb サーバーをクエリするために使用されます。

Api(
    overrides: Optional[Dict[str, Any]] = None,
    timeout: Optional[int] = None,
    api_key: Optional[str] = None
) -> None

例:

最も一般的な初期化方法

>>> wandb.Api()
引数
overrides (dict) https://api.wandb.ai 以外の wandb サーバーを使用している場合に base_url を設定できます。また、entityproject、および run のデフォルト設定をすることができます。
属性

メソッド

artifact

ソースを表示

artifact(
    name: str,
    type: Optional[str] = None
)

project/name または entity/project/name の形式でパスを解析することにより、単一のアーティファクトを返します。

引数
name (str) アーティファクト名。project/ または entity/project/ で始まる場合があります。name に entity が指定されていない場合、Run または API 設定の entity が使用されます。有効な名前は次の形式になります: name:version name:alias
type (str, オプション) 取得するアーティファクトのタイプ。
戻り値
Artifact オブジェクト。
例外
ValueError アーティファクト名が指定されていない場合。
ValueError アーティファクトタイプが指定されているが、取得したアーティファクトのタイプと一致しない場合。

注意:

このメソッドは外部利用のみを目的としています。wandb リポジトリコード内で api.artifact() を呼び出さないでください。

artifact_collection

ソースを表示

artifact_collection(
    type_name: str,
    name: str
) -> "public.ArtifactCollection"

タイプと entity/project/name の形式でパスを解析することにより、単一のアーティファクトコレクションを返します。

引数
type_name (str) 取得するアーティファクトコレクションのタイプ。
name (str) アーティファクトコレクション名。entity/project で始まる場合があります。
戻り値
ArtifactCollection オブジェクト。

artifact_collection_exists

ソースを表示

artifact_collection_exists(
    name: str,
    type: str
) -> bool

指定されたプロジェクトとエンティティ内にアーティファクトコレクションが存在するかどうかを返します。

引数
name (str) アーティファクトコレクション名。entity/project で始まる場合があります。entity または project が指定されていない場合、オーバーライドパラメーターから推測されます。その他の場合、entity はユーザー設定から取得され、project は “uncategorized” にデフォルト設定されます。
type (str) アーティファクトコレクションのタイプ
戻り値
アーティファクトコレクションが存在する場合は True、そうでない場合は False。

artifact_collections

ソースを表示

artifact_collections(
    project_name: str,
    type_name: str,
    per_page: Optional[int] = 50
) -> "public.ArtifactCollections"

一致するアーティファクトコレクションのコレクションを返します。

引数
project_name (str) フィルタリングするプロジェクトの名前。
type_name (str) フィルタリングするアーティファクトタイプの名前。
per_page (int, オプション) クエリのページネーションのページサイズを設定します。None はデフォルトサイズを使用します。通常、これを変更する理由はありません。
戻り値
イテラブルな ArtifactCollections オブジェクト。

artifact_exists

ソースを表示

artifact_exists(
    name: str,
    type: Optional[str] = None
) -> bool

指定されたプロジェクトとエンティティ内にアーティファクトバージョンが存在するかどうかを返します。

引数
name (str) アーティファクト名。entity/project で始まる場合があります。entity または project が指定されていない場合、オーバーライドパラメータから推測されます。その他の場合、entity はユーザー設定から取得され、project は “uncategorized” にデフォルト設定されます。有効な名前は次の形式になります: name:version name:alias
type (str, オプション) アーティファクトのタイプ
戻り値
アーティファクトバージョンが存在する場合は True、そうでない場合は False。

artifact_type

ソースを表示

artifact_type(
    type_name: str,
    project: Optional[str] = None
) -> "public.ArtifactType"

一致する ArtifactType を返します。

引数
type_name (str) 取得するアーティファクトタイプの名前。
project (str, オプション) 指定されている場合、フィルタリングするプロジェクト名またはパス。
戻り値
ArtifactType オブジェクト。

artifact_types

ソースを表示

artifact_types(
    project: Optional[str] = None
) -> "public.ArtifactTypes"

一致するアーティファクトタイプのコレクションを返します。

引数
project (str, オプション) 指定されている場合、フィルタリングするプロジェクト名またはパス。
戻り値
イテラブルな ArtifactTypes オブジェクト。

artifact_versions

ソースを表示

artifact_versions(
    type_name, name, per_page=50
)

非推奨、代わりに artifacts(type_name, name) を使用してください。

artifacts

ソースを表示

artifacts(
    type_name: str,
    name: str,
    per_page: Optional[int] = 50,
    tags: Optional[List[str]] = None
) -> "public.Artifacts"

指定されたパラメータから Artifacts コレクションを返します。

引数
type_name (str) 取得するアーティファクトのタイプ。
name (str) アーティファクトコレクションの名前。entity/project で始まる場合があります。
per_page (int, オプション) クエリのページネーションのページサイズを設定します。None はデフォルトサイズを使用します。通常、これを変更する理由はありません。
tags (list[str], オプション) これらのタグがすべて含まれているアーティファクトのみを返します。
戻り値
イテラブルな Artifacts オブジェクト。

create_project

ソースを表示

create_project(
    name: str,
    entity: str
) -> None

新しいプロジェクトを作成します。

引数
name (str) 新しいプロジェクトの名前。
entity (str) 新しいプロジェクトのエンティティ。

create_run

ソースを表示

create_run(
    *,
    run_id: Optional[str] = None,
    project: Optional[str] = None,
    entity: Optional[str] = None
) -> "public.Run"

新しい run を作成します。

引数
run_id (str, オプション) 指定された場合、run に割り当てられる ID。run ID はデフォルトで自動生成されますので、通常はこれを指定する必要はありません。指定する場合はリスクを負ってください。
project (str, オプション) 指定された場合、新しい run のプロジェクト。
entity (str, オプション) 指定された場合、新しい run のエンティティ。
戻り値
新たに作成された Run

create_run_queue

ソースを表示

create_run_queue(
    name: str,
    type: "public.RunQueueResourceType",
    entity: Optional[str] = None,
    prioritization_mode: Optional['public.RunQueuePrioritizationMode'] = None,
    config: Optional[dict] = None,
    template_variables: Optional[dict] = None
) -> "public.RunQueue"

新しい run キュー (launch) を作成します。

引数
name (str) 作成するキューの名前
type (str) キューに使用されるリソースのタイプ。“local-container”、“local-process”、“kubernetes”、“sagemaker”、または “gcp-vertex” のいずれか。
entity (str) キューを作成するエンティティのオプションの名前。None の場合、設定されたまたはデフォルトのエンティティが使用されます。
prioritization_mode (str) オプションのプライオリティバージョン。“V0” または None
config (dict) キューに使用されるデフォルトのリソース設定のオプション。テンプレート変数を指定するにはハンドルバー(例:{{var}})を使用します。
template_variables (dict) 設定内で使用されるテンプレート変数のスキーマの辞書。期待される形式: { "var-name": { "schema": { "type": ("string", "number", or "integer"), "default": (optional value), "minimum": (optional minimum), "maximum": (optional maximum), "enum": [..."(options)"] } } }
戻り値
新しく作成された RunQueue
例外
ValueError: パラメーターのいずれかが無効な場合 wandb.Error: wandb API のエラー

create_team

ソースを表示

create_team(
    team, admin_username=None
)

新しいチームを作成します。

引数
team (str) チーム名
admin_username (str) チームの管理ユーザーのオプションのユーザー名、デフォルトは現在のユーザーです。
戻り値
Team オブジェクト

create_user

ソースを表示

create_user(
    email, admin=(False)
)

新しいユーザーを作成します。

引数
email (str) ユーザーのメールアドレス
admin (bool) このユーザーがグローバルインスタンス管理者であるかどうか
戻り値
User オブジェクト

flush

ソースを表示

flush()

ローカルキャッシュをフラッシュします。

API オブジェクトは run のローカルキャッシュを保持するため、スクリプトを実行中に run の状態が変更される可能性がある場合、api.flush() を使用してローカルキャッシュをクリアし、run に関連付けられた最新の値を取得します。

from_path

ソースを表示

from_path(
    path
)

パスから run、sweep、プロジェクト、またはレポートを返します。

例:

project = api.from_path("my_project")
team_project = api.from_path("my_team/my_project")
run = api.from_path("my_team/my_project/runs/id")
sweep = api.from_path("my_team/my_project/sweeps/id")
report = api.from_path("my_team/my_project/reports/My-Report-Vm11dsdf")
引数
path (str) プロジェクト、run、sweep、またはレポートへのパス
戻り値
ProjectRunSweep、または BetaReport インスタンス。
例外
wandb.Error: パスが無効、またはオブジェクトが存在しない場合

job

ソースを表示

job(
    name: Optional[str],
    path: Optional[str] = None
) -> "public.Job"

指定されたパラメーターから Job を返します。

引数
name (str) ジョブの名前。
path (str, オプション) 指定された場合、ジョブアーティファクトをダウンロードするルートパス。
戻り値
Job オブジェクト。

list_jobs

ソースを表示

list_jobs(
    entity: str,
    project: str
) -> List[Dict[str, Any]]

指定されたエンティティとプロジェクトに対して、利用可能なジョブのリストを返します。

引数
entity (str) リストされたジョブのエンティティ。
project (str) リストされたジョブのプロジェクト。
戻り値
一致するジョブのリスト。

project

ソースを表示

project(
    name: str,
    entity: Optional[str] = None
) -> "public.Project"

指定された名前 (および指定された場合はエンティティ) の Project を返します。

引数
name (str) プロジェクト名。
entity (str) リクエストされたエンティティ名。None の場合、Api に渡されたデフォルトのエンティティにフォールバックします。デフォルトのエンティティがない場合は、ValueError をスローします。
戻り値
Project オブジェクト。

projects

ソースを表示

projects(
    entity: Optional[str] = None,
    per_page: Optional[int] = 200
) -> "public.Projects"

指定されたエンティティのプロジェクトを取得します。

引数
entity (str) リクエストされたエンティティ名。None の場合、Api に渡されたデフォルトのエンティティにフォールバックします。デフォルトのエンティティがない場合は、ValueError をスローします。
per_page (int) クエリのページネーションのページサイズを設定します。None はデフォルトサイズを使用します。通常、これを変更する理由はありません。
戻り値
Projects オブジェクトで、Project オブジェクトのイテラブルなコレクションです。

queued_run

ソースを表示

queued_run(
    entity, project, queue_name, run_queue_item_id, project_queue=None,
    priority=None
)

パスに基づいて単一のキューされた run を返します。

entity/project/queue_id/run_queue_item_id の形式のパスを解析します。

registries

ソースを表示

registries(
    organization: Optional[str] = None,
    filter: Optional[Dict[str, Any]] = None
) -> Registries

レジストリのイテレータを返します。

イテレータを使用して、組織のレジストリ内のレジストリ、コレクション、またはアーティファクトバージョンを検索およびフィルタリングします。

例:

“model” を含む名前のすべてのレジストリを見つけます。

import wandb

api = wandb.Api()  # エンティティが複数の組織に属する場合、組織を指定します。
api.registries(filter={"name": {"$regex": "model"}})

“my_collection” という名前と “my_tag” というタグのあるコレクションをレジストリで見つけます。

api.registries().collections(filter={"name": "my_collection", "tag": "my_tag"})

“my_collection” を含むコレクション名と “best” というエイリアスを持つバージョンのあるすべてのアーティファクトバージョンを見つけます。

api.registries().collections(
    filter={"name": {"$regex": "my_collection"}}
).versions(filter={"alias": "best"})

“model” を含み、タグ “prod” またはエイリアス “best” を持つすべてのアーティファクトバージョンをレジストリで見つけます。

api.registries(filter={"name": {"$regex": "model"}}).versions(
    filter={"$or": [{"tag": "prod"}, {"alias": "best"}]}
)
引数
organization (str, オプション) 取得するレジストリの組織。指定されていない場合、ユーザー設定で指定された組織を使用します。
filter (dict, オプション) レジストリイテレータ内の各オブジェクトに適用する MongoDB スタイルのフィルタ。コレクションをフィルタリングする際に利用可能なフィールド: name, description, created_at, updated_at。コレクションをフィルタリングする際に利用可能なフィールド: name, tag, description, created_at, updated_at。バージョンをフィルタリングする際に利用可能なフィールド: tag, alias, created_at, updated_at, metadata
戻り値
レジストリのイテレータ。

reports

ソースを表示

reports(
    path: str = "",
    name: Optional[str] = None,
    per_page: Optional[int] = 50
) -> "public.Reports"

指定されたプロジェクトパスのレポートを取得します。

警告: この API はベータ版であり、将来のリリースで変更される可能性があります。

引数
path (str) レポートが存在するプロジェクトのパス、形式は: “entity/project” となります。
name (str, オプション) リクエストされたレポートのオプションの名前。
per_page (int) クエリのページネーションのページサイズを設定します。None はデフォルトサイズを使用します。通常、これを変更する理由はありません。
戻り値
Reports オブジェクトで、BetaReport オブジェクトのイテラブルなコレクションです。

run

ソースを表示

run(
    path=""
)

entity/project/run_id の形式でパスを解析することにより、単一の run を返します。

引数
path (str) entity/project/run_id 形式の run へのパス。api.entity が設定されている場合、この形式は project/run_id となり、api.project が設定されている場合、run_id のみです。
戻り値
Run オブジェクト。

run_queue

ソースを表示

run_queue(
    entity, name
)

エンティティの名前付き RunQueue を返します。

新しい RunQueue を作成するには、wandb.Api().create_run_queue(...) を使用してください。

runs

ソースを表示

runs(
    path: Optional[str] = None,
    filters: Optional[Dict[str, Any]] = None,
    order: str = "+created_at",
    per_page: int = 50,
    include_sweeps: bool = (True)
)

指定されたフィルターに一致するプロジェクトからの一連の run を返します。

フィルターに使用できるフィールドには以下のものがあります:

  • createdAt: run が作成されたタイムスタンプ。(ISO 8601 フォーマット、例: “2023-01-01T12:00:00Z”)
  • displayName: run の人間が読みやすい表示名。(例: “eager-fox-1”)
  • duration: run の合計実行時間(秒単位)。
  • group: 関連する run をまとめるために使用されるグループ名。
  • host: run が実行されたホスト名。
  • jobType: ジョブのタイプまたは run の目的。
  • name: run の一意の識別子。(例: “a1b2cdef”)
  • state: run の現在の状態。
  • tags: run に関連付けられたタグ。
  • username: run を開始したユーザーのユーザー名。

さらに、run の設定や要約メトリクス内の項目によるフィルタリングが可能です。例: config.experiment_name, summary_metrics.loss など。

より複雑なフィルタリングには、MongoDB クエリオペレーターを使用できます。詳細は、以下を参照してください: https://docs.mongodb.com/manual/reference/operator/query サポートされている操作には以下のものがあります:

  • $and
  • $or
  • $nor
  • $eq
  • $ne
  • $gt
  • $gte
  • $lt
  • $lte
  • $in
  • $nin
  • $exists
  • $regex

例:

設定されている foo という experiment_name を持つ my_project 内の run を見つけます

api.runs(
    path="my_entity/my_project",
    filters={"config.experiment_name": "foo"},
)

設定されている foo または bar という experiment_name を持つ my_project 内の run を見つけます

api.runs(
    path="my_entity/my_project",
    filters={
        "$or": [
            {"config.experiment_name": "foo"},
            {"config.experiment_name": "bar"},
        ]
    },
)

experiment_name が正規表現に一致する my_project 内の run を見つけます(アンカーはサポートされていません)

api.runs(
    path="my_entity/my_project",
    filters={"config.experiment_name": {"$regex": "b.*"}},
)

run の名前が正規表現に一致する my_project 内の run を見つけます(アンカーはサポートされていません)

api.runs(
    path="my_entity/my_project",
    filters={"display_name": {"$regex": "^foo.*"}},
)

実験に “category” というネストされたフィールドを持つ run を探します

api.runs(
    path="my_entity/my_project",
    filters={"config.experiment.category": "testing"},
)

要約メトリクスの model1 下に辞書としてネストされている損失値0.5を持つ run を探します

api.runs(
    path="my_entity/my_project",
    filters={"summary_metrics.model1.loss": 0.5},
)

上昇損失に基づいて my_project 内の run を探します

api.runs(path="my_entity/my_project", order="+summary_metrics.loss")
引数
path (str) プロジェクトへのパス。形式は: “entity/project”
filters (dict) MongoDB クエリ言語を使用して特定の run をクエリします。run のプロパティ(config.key、summary_metrics.key、state、entity、createdAt など)でフィルタリングできます。例: {"config.experiment_name": "foo"} は、実験名に foo が設定されている run を見つけます。
order (str) 並び順は created_atheartbeat_atconfig.*.valuesummary_metrics.* にできます。order の前に + を付けると昇順になります。order の前に - を付けると降順(デフォルト)になります。デフォルトの並び順は、run の created_at で、古い順から新しい順です。
per_page (int) クエリのページネーションのページサイズを設定します。
include_sweeps (bool) 結果に sweep run を含めるかどうか。
戻り値
Runs オブジェクトで、Run オブジェクトのイテラブルなコレクションです。

sweep

ソースを表示

sweep(
    path=""
)

sweep_id の形式でパスを解析することにより、sweep を返します。

引数
path (str, オプション) エンティティまたはプロジェクトの設定がされていない場合、sweep に対するパスの形式は entity/project/sweep_id である必要があります。api.entity が設定されている場合、この形式は project/sweep_id になり、api.project が設定されている場合、sweep_id のみです。
戻り値
Sweep オブジェクト。

sync_tensorboard

ソースを表示

sync_tensorboard(
    root_dir, run_id=None, project=None, entity=None
)

tfevent ファイルを含むローカルディレクトリを wandb に同期します。

team

ソースを表示

team(
    team: str
) -> "public.Team"

指定された名前の Team を返します。

引数
team (str) チーム名。
戻り値
Team オブジェクト。

upsert_run_queue

ソースを表示

upsert_run_queue(
    name: str,
    resource_config: dict,
    resource_type: "public.RunQueueResourceType",
    entity: Optional[str] = None,
    template_variables: Optional[dict] = None,
    external_links: Optional[dict] = None,
    prioritization_mode: Optional['public.RunQueuePrioritizationMode'] = None
)

run キュー (launch) をアップサートします。

引数
name (str) 作成するキューの名前
entity (str) 作成するキューのエンティティのオプションの名前。None の場合、設定されたまたはデフォルトのエンティティを使用します。
resource_config (dict) キューに使用されるデフォルトのリソース設定のオプション。テンプレート変数を指定するにはハンドルバー(例:{{var}})を使用します。
resource_type (str) キューに使用されるリソースのタイプ。“local-container”、“local-process”、“kubernetes”、“sagemaker”、または “gcp-vertex” のいずれか。
template_variables (dict) 設定内で使用されるテンプレート変数のスキーマの辞書。期待される形式: { "var-name": { "schema": { "type": ("string", "number", or "integer"), "default": (optional value), "minimum": (optional minimum), "maximum": (optional maximum), "enum": [..."(options)"] } } }
external_links (dict) キューで使用される外部リンクのオプションの辞書。期待される形式: { "name": "url" }
prioritization_mode (str) 使用するプライオリティのバージョン。 “V0” または None
戻り値
アップサートされた RunQueue
例外
ValueError: パラメーターのいずれかが無効な場合 wandb.Error: wandb API のエラー

user

ソースを表示

user(
    username_or_email: str
) -> Optional['public.User']

ユーザー名またはメールアドレスからユーザーを返します。

注意: この関数はローカル管理者のみ機能します。 自分のユーザーオブジェクトを取得しようとしている場合は api.viewer を使用してください。

引数
username_or_email (str) ユーザーのユーザー名またはメールアドレス
戻り値
User オブジェクトまたはユーザーが見つからない場合は None

users

ソースを表示

users(
    username_or_email: str
) -> List['public.User']

部分的なユーザー名またはメールアドレスクエリからすべてのユーザーを返します。

注意: この関数はローカル管理者のみ機能します。 自分のユーザーオブジェクトを取得しようとしている場合は api.viewer を使用してください。

引数
username_or_email (str) 検索したいユーザーのプレフィックスまたはサフィックス
戻り値
User オブジェクトの配列
クラス変数
CREATE_PROJECT
DEFAULT_ENTITY_QUERY
USERS_QUERY
VIEWER_QUERY

2 - QueuedRun

エンティティとプロジェクトに関連付けられた単一のキューに入った run。run = queued_run.wait_until_running() または run = queued_run.wait_until_finished() を呼び出して run に アクセスします。

QueuedRun(
    client, entity, project, queue_name, run_queue_item_id,
    project_queue=LAUNCH_DEFAULT_PROJECT, priority=None
)
属性

メソッド

delete

ソースを見る

delete(
    delete_artifacts=(False)
)

指定されたキューに入った run を wandb のバックエンドから削除します。

wait_until_finished

ソースを見る

wait_until_finished()

wait_until_running

ソースを見る

wait_until_running()

3 - run

プロジェクトに関連付けられた runs の反復可能なコレクションとオプションフィルター。

Runs(
    client: "RetryingClient",
    entity: str,
    project: str,
    filters: Optional[Dict[str, Any]] = None,
    order: Optional[str] = None,
    per_page: int = 50,
    include_sweeps: bool = (True)
)

これは通常、Api.runs メソッドを介して間接的に使用されます。

属性

メソッド

convert_objects

ソースを表示

convert_objects()

histories

ソースを表示

histories(
    samples: int = 500,
    keys: Optional[List[str]] = None,
    x_axis: str = "_step",
    format: Literal['default', 'pandas', 'polars'] = "default",
    stream: Literal['default', 'system'] = "default"
)

フィルター条件に適合するすべての runs のサンプル履歴メトリクスを返します。

引数
samples (int, オプション) 各 run に対して返されるサンプルの数
keys (list[str], オプション) 特定のキーのメトリクスのみを返します
x_axis (str, オプション) このメトリクスを x 軸として使用します。デフォルトは _step
format (Literal, オプション) データを返すフォーマット、オプションは “default”, “pandas”, “polars”
stream (Literal, オプション) メトリクスの “default”, マシンメトリクスの “system”
戻り値
pandas.DataFrame format=“pandas” の場合、履歴メトリクスの pandas.DataFrame を返します。
polars.DataFrame format=“polars” の場合、履歴メトリクスの polars.DataFrame を返します。リスト of dicts: format=“default” の場合、履歴メトリクスを含む dicts のリストを run_id キー付きで返します。

next

ソースを表示

next()

update_variables

ソースを表示

update_variables()

__getitem__

ソースを表示

__getitem__(
    index
)

__iter__

ソースを表示

__iter__()

__len__

ソースを表示

__len__()
クラス変数
QUERY

4 - Run

エンティティおよびプロジェクトに関連付けられた単一の run。

Run(
    client: "RetryingClient",
    entity: str,
    project: str,
    run_id: str,
    attrs: Optional[Mapping] = None,
    include_sweeps: bool = (True)
)
属性

メソッド

create

ソースを見る

@classmethod
create(
    api, run_id=None, project=None, entity=None
)

指定されたプロジェクトのために run を作成します。

delete

ソースを見る

delete(
    delete_artifacts=(False)
)

指定された run を wandb バックエンドから削除します。

display

ソースを見る

display(
    height=420, hidden=(False)
) -> bool

このオブジェクトを Jupyter で表示します。

file

ソースを見る

file(
    name
)

指定された名前のファイルのパスをアーティファクトで返します。

引数
name (str): 要求されたファイルの名前。
戻り値
指定された name 引数と一致する File

files

ソースを見る

files(
    names=None, per_page=50
)

指定された名前のすべてのファイルのファイルパスを返します。

引数
names (list): 要求されたファイルの名前、指定されていない場合はすべてのファイルを返す。 per_page (int): ページあたりの結果数。
戻り値
Files オブジェクトで、これは File オブジェクトのイテレータです。

history

ソースを見る

history(
    samples=500, keys=None, x_axis="_step", pandas=(True), stream="default"
)

run のサンプル化された履歴メトリクスを返します。

履歴レコードがサンプリングされることを許容できる場合、こちらの方が簡単で高速です。

引数
samples (int, オプション) 返すサンプル数
pandas (bool, オプション) パンダのデータフレームを返す
keys (list, オプション) 特定のキーのメトリクスのみを返す
x_axis (str, オプション) xAxis として使用するメトリクス、デフォルトは _step
stream (str, オプション) メトリクス用の “default”、マシンメトリクス用の “system”
戻り値
pandas.DataFrame pandas=True の場合は歴史メトリクスの pandas.DataFrame を返します。 pandas=False の場合は歴史メトリクスの辞書のリストを返します。

load

ソースを見る

load(
    force=(False)
)

log_artifact

ソースを見る

log_artifact(
    artifact: "wandb.Artifact",
    aliases: Optional[Collection[str]] = None,
    tags: Optional[Collection[str]] = None
)

アーティファクトを run の出力として宣言します。

引数
artifact (Artifact): wandb.Api().artifact(name) から返されたアーティファクト。 aliases (list, オプション): このアーティファクトに適用するエイリアス。
tags (list, オプション) このアーティファクトに適用するタグ。
戻り値
Artifact オブジェクト。

logged_artifacts

ソースを見る

logged_artifacts(
    per_page: int = 100
) -> public.RunArtifacts

この run によってログされているすべてのアーティファクトを取得します。

run 中にログされたすべての出力アーティファクトを取得します。取得した結果はページネーションされ、イテレートするか、単一のリストにまとめることができます。

引数
per_page API リクエストごとに取得するアーティファクトの数。
戻り値
この run 中に出力として記録されたすべての Artifact オブジェクトのイテレート可能なコレクション。

例:

>>> import wandb
>>> import tempfile
>>> with tempfile.NamedTemporaryFile(
...     mode="w", delete=False, suffix=".txt"
... ) as tmp:
...     tmp.write("これはテストアーティファクトです")
...     tmp_path = tmp.name
>>> run = wandb.init(project="artifact-example")
>>> artifact = wandb.Artifact("test_artifact", type="dataset")
>>> artifact.add_file(tmp_path)
>>> run.log_artifact(artifact)
>>> run.finish()
>>> api = wandb.Api()
>>> finished_run = api.run(f"{run.entity}/{run.project}/{run.id}")
>>> for logged_artifact in finished_run.logged_artifacts():
...     print(logged_artifact.name)
test_artifact

save

ソースを見る

save()

scan_history

ソースを見る

scan_history(
    keys=None, page_size=1000, min_step=None, max_step=None
)

run のすべての履歴レコードをイテレート可能なコレクションで返します。

例:

例として全ての損失値をエクスポート

run = api.run("l2k2/examples-numpy-boston/i0wt6xua")
history = run.scan_history(keys=["Loss"])
losses = [row["Loss"] for row in history]
引数
keys ([str], オプション): これらのキーのみをフェッチし、これらの定義されたすべてのキーを含む行のみをフェッチします。 page_size (int, オプション): API からフェッチするページのサイズ。 min_step (int, オプション): 一度にスキャンするページの最小数。 max_step (int, オプション): 一度にスキャンするページの最大数。
戻り値
履歴レコード (辞書) のイテレート可能なコレクション。

snake_to_camel

ソースを見る

snake_to_camel(
    string
)

to_html

ソースを見る

to_html(
    height=420, hidden=(False)
)

この run を表示する iframe を含む HTML を生成します。

update

ソースを見る

update()

run オブジェクトに対する変更を wandb バックエンドに保存します。

upload_file

ソースを見る

upload_file(
    path, root="."
)

ファイルをアップロードします。

引数
path (str): アップロードするファイルの名前。 root (str): ファイルを保存するルートパス。例: ファイルを “my_dir/file.txt” として保存したい場合で、現在 “my_dir” にいる場合は、 root を “../” に設定します。
戻り値
指定された name 引数に一致する File

use_artifact

ソースを見る

use_artifact(
    artifact, use_as=None
)

アーティファクトを run への入力として宣言します。

引数
artifact (Artifact): wandb.Api().artifact(name) から返されたアーティファクト。 use_as (string, オプション): スクリプトでアーティファクトがどのように使用されるかを識別する文字列。 run で使用されるアーティファクトを簡単に識別するために、ベータ版の wandb launch 機能のアーティファクト交換機能を使用します。
戻り値
Artifact オブジェクト。

used_artifacts

ソースを見る

used_artifacts(
    per_page: int = 100
) -> public.RunArtifacts

この run で明示的に使用されているアーティファクトを取得します。

run 中に明示的に使用された入力アーティファクトのみを取得します。通常は run.use_artifact() を通じて宣言される。取得した結果はページネーションされ、イテレートするか、単一のリストにまとめることができます。

引数
per_page API リクエストごとに取得するアーティファクトの数。
戻り値
この run 中に入力として明示的に使用された Artifact オブジェクトのイテレート可能なコレクション。

例:

>>> import wandb
>>> run = wandb.init(project="artifact-example")
>>> run.use_artifact("test_artifact:latest")
>>> run.finish()
>>> api = wandb.Api()
>>> finished_run = api.run(f"{run.entity}/{run.project}/{run.id}")
>>> for used_artifact in finished_run.used_artifacts():
...     print(used_artifact.name)
test_artifact

wait_until_finished

ソースを見る

wait_until_finished()

5 - RunQueue

RunQueue(
    client: "RetryingClient",
    name: str,
    entity: str,
    prioritization_mode: Optional[RunQueuePrioritizationMode] = None,
    _access: Optional[RunQueueAccessType] = None,
    _default_resource_config_id: Optional[int] = None,
    _default_resource_config: Optional[dict] = None
) -> None
属性
items 最初の100個のキューに入れられた runs まで。 このリストを変更しても、キューやキューに入れられた項目は変更されません!

メソッド

create

ソースを見る

@classmethod
create(
    name: str,
    resource: "RunQueueResourceType",
    entity: Optional[str] = None,
    prioritization_mode: Optional['RunQueuePrioritizationMode'] = None,
    config: Optional[dict] = None,
    template_variables: Optional[dict] = None
) -> "RunQueue"

delete

ソースを見る

delete()

wandb のバックエンドから run queue を削除します。

6 - Sweep

スイープに関連付けられた一連の runs。

Sweep(
    client, entity, project, sweep_id, attrs=None
)

例:

次のようにインスタンス化します:

api = wandb.Api()
sweep = api.sweep(path / to / sweep)
属性
runs (Runs) run のリスト
id (str) スイープの id
project (str) プロジェクトの名前
config (str) スイープ設定の辞書
state (str) スイープの状態
expected_run_count (int) スイープの予想される run の数

メソッド

best_run

ソースを表示

best_run(
    order=None
)

設定で定義されたメトリックまたは渡された順序でソートされた最良の run を返します。

display

ソースを表示

display(
    height=420, hidden=(False)
) -> bool

このオブジェクトを jupyter に表示します。

get

ソースを表示

@classmethod
get(
    client, entity=None, project=None, sid=None, order=None, query=None, **kwargs
)

クラウドバックエンドに対してクエリを実行します。

load

ソースを表示

load(
    force: bool = (False)
)

snake_to_camel

ソースを表示

snake_to_camel(
    string
)

to_html

ソースを表示

to_html(
    height=420, hidden=(False)
)

このスイープを表示する iframe を含む HTML を生成します。

クラス変数
LEGACY_QUERY
QUERY

7 - ジョブ

Job(
    api: "Api",
    name,
    path: Optional[str] = None
) -> None
属性

メソッド

call

ソースを表示

call(
    config, project=None, entity=None, queue=None, resource="local-container",
    resource_args=None, template_variables=None, project_queue=None, priority=None
)

set_entrypoint

ソースを表示

set_entrypoint(
    entrypoint: List[str]
)

8 - ファイル

File オブジェクトの反復可能なコレクション。

Files(
    client, run, names=None, per_page=50, upload=(False)
)
属性

メソッド

convert_objects

ソースを表示

convert_objects()

next

ソースを表示

next()

update_variables

ソースを表示

update_variables()

__getitem__

ソースを表示

__getitem__(
    index
)

__iter__

ソースを表示

__iter__()

__len__

ソースを表示

__len__()
クラス変数
QUERY

9 - プロジェクト

プロジェクトは、run のための名前空間です。

Project(
    client, entity, project, attrs
)
属性

メソッド

artifacts_types

ソースを見る

artifacts_types(
    per_page=50
)

display

ソースを見る

display(
    height=420, hidden=(False)
) -> bool

jupyter でこのオブジェクトを表示します。

snake_to_camel

ソースを見る

snake_to_camel(
    string
)

sweeps

ソースを見る

sweeps()

to_html

ソースを見る

to_html(
    height=420, hidden=(False)
)

このプロジェクトを表示する iframe を含む HTML を生成します。

10 - プロジェクト

Project オブジェクトの反復可能なコレクション。

Projects(
    client, entity, per_page=50
)
属性

メソッド

convert_objects

ソースを見る

convert_objects()

next

ソースを見る

next()

update_variables

ソースを見る

update_variables()

__getitem__

ソースを見る

__getitem__(
    index
)

__iter__

ソースを見る

__iter__()

__len__

ソースを見る

__len__()
クラス変数
QUERY

11 - 申し訳ありませんが、私は提供された文書の翻訳を行うためのテキストが不足しています。何か特定のテキストまたは文書を提供していただければ、それを翻訳いたします。それに基づいて正確な翻訳を提供できますので、どうぞよろしくお願いします。

File は wandb によって保存されたファイルに関連付けられているクラスです。

File(
    client, attrs, run=None
)
属性
path_uri ストレージバケット内のファイルへの URI パスを返します。

メソッド

delete

ソースを表示

delete()

display

ソースを表示

display(
    height=420, hidden=(False)
) -> bool

このオブジェクトを jupyter で表示します。

download

ソースを表示

download(
    root: str = ".",
    replace: bool = (False),
    exist_ok: bool = (False),
    api: Optional[Api] = None
) -> io.TextIOWrapper

wandb サーバーから run によって以前に保存されたファイルをダウンロードします。

引数
replace (boolean): True の場合、ローカルファイルが存在するときにダウンロードがそのファイルを上書きします。デフォルトは False。root (str): ファイルを保存するローカルディレクトリー。デフォルトは “."。exist_ok (boolean): True の場合、ファイルが既に存在しているときに ValueError を発生させず、replace=True でない限り再ダウンロードしません。デフォルトは False。api (Api, optional): 指定された場合、ファイルをダウンロードするのに使用される Api インスタンス。
Raises
ファイルが既に存在し、replace=False でかつ exist_ok=False の場合に ValueError を発生させます。

snake_to_camel

ソースを表示

snake_to_camel(
    string
)

to_html

ソースを表示

to_html(
    *args, **kwargs
)