Runs

less than a minute

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

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

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

Args
`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.