메인 콘텐츠로 건너뛰기
GitHub 소스 코드

​
class Runs

프로젝트와 선택적 필터에 연관된 Run 객체의 지연 이터레이터입니다. 필요할 때마다 W&B 서버에서 페이지 단위로 Run들이 조회됩니다. 일반적으로 Api.runs 네임스페이스를 통해 간접적으로 사용됩니다.

​
method Runs.__init__

__init__(
    client: 'RetryingClient',
    entity: 'str',
    project: 'str',
    filters: 'dict[str, Any] | None' = None,
    order: 'str' = '+created_at',
    per_page: 'int' = 50,
    include_sweeps: 'bool' = True,
    lazy: 'bool' = True,
    api: 'public.Api | None' = None
)
인자:
  • client: (wandb.apis.public.RetryingClient) 요청에 사용할 API 클라이언트입니다.
  • entity: (str) 프로젝트를 소유한 엔터티(사용자 이름 또는 팀)입니다.
  • project: (str) 실행을 가져올 프로젝트의 이름입니다.
  • filters: (Optional[Dict[str, Any]]) 실행 조회에 적용할 필터 딕셔너리입니다.
  • order: (str) 정렬 기준은 created_at, heartbeat_at, config.*.value, 또는 summary_metrics.*가 될 수 있습니다. 앞에 +를 붙이면 오름차순(기본값), -를 붙이면 내림차순입니다. 기본 정렬 기준은 run.created_at이며, 가장 오래된 것부터 최신까지 정렬합니다.
  • per_page: (int) 요청당 가져올 실행 수입니다(기본값은 50).
  • include_sweeps: (bool) 실행에 스윕 정보를 포함할지 여부입니다. 기본값은 True입니다.

​
property Runs.length

​
메서드 Runs.histories

histories(
    samples: 'int' = 500,
    keys: 'list[str] | None' = None,
    x_axis: 'str' = '_step',
    format: "Literal['default', 'pandas', 'polars']" = 'default',
    stream: "Literal['default', 'system']" = 'default'
) → list[dict[str, Any]] | pd.DataFrame | pl.DataFrame
필터 조건에 맞는 모든 실행에 대해 샘플링된 이력 메트릭을 반환합니다. Args:
  • samples: 실행당 반환할 샘플 개수
  • keys: 특정 키에 대한 메트릭만 반환
  • x_axis: 이 메트릭을 x축으로 사용하며, 기본값은 _step
  • format: 데이터를 반환할 형식. 선택지는 “default”, “pandas”, “polars”입니다
  • stream: 메트릭용 “default”, 머신 메트릭용 “system”
Returns:
  • pandas.DataFrame: format="pandas"인 경우, 이력 메트릭을 담은 pandas.DataFrame을 반환합니다.
  • polars.DataFrame: format="polars"인 경우, 이력 메트릭을 담은 polars.DataFrame을 반환합니다.
  • list of dicts: format="default"인 경우, run_id 키를 포함한 이력 메트릭 dict 리스트를 반환합니다.

​
메서드 Runs.upgrade_to_full

upgrade_to_full() → None
이 Runs 컬렉션을 lazy 모드에서 full 모드로 전환합니다. 전체 실행 데이터를 가져오도록 전환하며, 이미 로드된 Run 객체도 전체 데이터를 포함하도록 업그레이드합니다. 여러 실행을 업그레이드할 때 성능 향상을 위해 병렬 로딩을 사용합니다.