Runs

Description

A lazy iterator of Run objects associated with a project and optional filter.

Runs are retrieved in pages from the W&B server as needed.

This is generally used indirectly using the Api.runs namespace.

Args:

• client: (wandb.apis.public.RetryingClient) The API client to use for requests.
• entity: (str) The entity (username or team) that owns the project.
• project: (str) The name of the project to fetch runs from.
• filters: (Optional[Dict[str, Any]]) A dictionary of filters to apply to the runs query.
• order: (str) Order can be created_at, heartbeat_at, config.*.value, or summary_metrics.*. If you prepend order with a + order is ascending (default). If you prepend order with a - order is descending. The default order is run.created_at from oldest to newest.
• per_page: (int) The number of runs to fetch per request (default is 50).
• include_sweeps: (bool) Whether to include sweep information in the runs. Defaults to True.
• lazy: (bool) Whether to lazily load run data or fetch full data immediately.
• service_api: (Optional[ServiceApi]) An optional ServiceApi instance for making additional API calls, such as fetching run history exports.

Methods:

histories

Return sampled history metrics for all runs that fit the filters conditions.

next

Return the next item from the iterator. When exhausted, raise StopIteration

update_variables

Update the query variables for the next page fetch.

upgrade_to_full

Upgrade this Runs collection from lazy to full mode.

This switches to fetching full run data and upgrades any already-loaded Run objects to have full data. Uses parallel loading for better performance when upgrading multiple runs.