Runs

An iterable collection of runs associated with a project and optional filter.

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)
)

This is generally used indirectly via the Api.runs method.

Attributes

Methods

convert_objects

View source

convert_objects()

histories

View source

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

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

Arguments
samples	(int, optional) The number of samples to return per run
keys	(list[str], optional) Only return metrics for specific keys
x_axis	(str, optional) Use this metric as the xAxis defaults to _step
format	(Literal, optional) Format to return data in, options are "default", "pandas", "polars"
stream	(Literal, optional) "default" for metrics, "system" for machine metrics

Returns
pandas.DataFrame	If format="pandas", returns a pandas.DataFrame of history metrics.
polars.DataFrame	If format="polars", returns a polars.DataFrame of history metrics. list of dicts: If format="default", returns a list of dicts containing history metrics with a run_id key.

next

View source

next()

update_variables

View source

update_variables()

__getitem__

View source

__getitem__(
    index
)

__iter__

View source

__iter__()

__len__

View source

__len__()

Class Variables
QUERY