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

​
class Table

Table 클래스는 표 형식 데이터를 표시하고 분석하는 데 사용됩니다. 기존 스프레드시트와 달리 Tables는 스칼라 값, 문자열, numpy 배열, 그리고 wandb.data_types.Media의 대부분의 서브클래스를 포함한 다양한 데이터 유형을 지원합니다. 즉, 다른 전통적인 스칼라 값과 함께 Tables 안에 Images, Video, Audio 및 기타 다양한 형태의 주석이 달린 리치 미디어를 직접 포함할 수 있습니다. 이 클래스는 W&B Tables를 생성할 때 사용하는 주요 클래스입니다. 자세한 내용은 https://docs.wandb.ai/guides/models/tables/ 를 참조하세요.

​
method Table.__init__

__init__(
    columns=None,
    data=None,
    rows=None,
    dataframe=None,
    dtype=None,
    optional=True,
    allow_mixed_types=False,
    log_mode: "Literal['IMMUTABLE', 'MUTABLE', 'INCREMENTAL'] | None" = 'IMMUTABLE'
)
Table 객체를 초기화합니다. rows는 하위 호환성을 위해 제공되는 인자이며 사용하지 않는 것을 권장합니다. Table 클래스는 Pandas API를 모방하기 위해 data를 사용합니다. Args:
  • columns: (List[str]) 테이블의 컬럼 이름입니다. 기본값은 [“Input”, “Output”, “Expected”]입니다.
  • data: (List[List[any]]) 값들로 이루어진 2D 행 지향 배열입니다.
  • dataframe: (pandas.DataFrame) 테이블을 생성하는 데 사용되는 DataFrame 객체입니다. 설정되면 data와 columns 인자는 무시됩니다.
  • rows: (List[List[any]]) 값들로 이루어진 2D 행 지향 배열입니다.
  • optional: (Union[bool,List[bool]]) None 값을 허용할지 여부를 결정합니다. 기본값은 True입니다.
    • 단일 bool 값인 경우, 생성 시 지정된 모든 컬럼에 대해 동일한 선택 허용 여부가 적용됩니다.
    • bool 값 리스트인 경우, 각 컬럼별로 선택 허용 여부가 적용되며, columns와 동일한 길이여야 합니다.
  • allow_mixed_types: (bool) 컬럼에 혼합 타입을 허용할지 여부를 결정합니다(타입 검증 비활성화). 기본값은 False입니다.
  • log_mode: Optional[str] Table이 변경될 때 어떻게 로그되는지를 제어합니다. 옵션:
    • “IMMUTABLE” (기본값): Table은 한 번만 로그할 수 있으며, 이후 Table이 변경된 뒤의 추가 로그 시도는 무시됩니다.
    • “MUTABLE”: 변경 후 다시 로그할 수 있으며, 로그될 때마다 새로운 아티팩트 버전을 생성합니다.
    • “INCREMENTAL”: Table 데이터가 점진적으로 로그되며, 각 로그는 마지막 로그 이후 추가된 새 데이터를 포함하는 새로운 아티팩트 엔트리를 생성합니다.

​
메서드 Table.add_column

add_column(name, data, optional=False)
테이블에 데이터 열을 추가합니다. 인수(Args):
  • name: (str) - 열의 고유 이름
  • data: (list | np.array) - 동일한 유형의 데이터로 이루어진 열
  • optional: (bool) - null과 유사한 값을 허용할지 여부

​
method Table.add_computed_columns

add_computed_columns(fn)
기존 데이터를 기반으로 하나 이상의 계산된 열을 추가합니다. 인자:
  • fn: 하나 또는 두 개의 매개변수 ndx(int)와 row(dict)를 입력으로 받아, 해당 행에 대한 새 열들을 나타내는 사전(dict)을 반환하는 함수입니다. 반환되는 사전의 키는 새 열 이름입니다.
    • ndx는 행의 인덱스를 나타내는 정수입니다. include_ndx 가 True 로 설정된 경우에만 포함됩니다.
    • row는 기존 열 이름을 키로 가지는 사전입니다

​
메서드 Table.add_data

add_data(*data)
테이블에 새로운 데이터 행을 추가합니다. 테이블의 최대 행 수는 wandb.Table.MAX_ARTIFACT_ROWS에 의해 결정됩니다. 데이터의 길이는 테이블의 열 개수와 일치해야 합니다.

​
메서드 Table.add_row

add_row(*row)
사용이 중단되었습니다. 대신 Table.add_data 메서드를 사용하세요.

​
method Table.cast

cast(col_name, dtype, optional=False)
열을 특정 데이터 타입으로 캐스팅합니다. 이 타입은 일반적인 Python 클래스, W&B 내부 타입, 또는 wandb.Image나 wandb.Classes 인스턴스와 같은 예제 객체일 수 있습니다. Args:
  • col_name (str): 캐스팅할 열의 이름입니다.
  • dtype (class, wandb.wandb_sdk.interface._dtypes.Type, any): 대상 dtype입니다.
  • optional (bool): 열에서 None 값을 허용할지 여부입니다.

​
method Table.get_column

get_column(name, convert_to=None)
테이블에서 열을 가져오고, 필요에 따라 NumPy 객체로 변환합니다. Args:
  • name: (str) - 열 이름
  • convert_to: (str, optional)
    • “numpy”: 내부 데이터를 NumPy 객체로 변환합니다

​
메서드 Table.get_dataframe

get_dataframe()
테이블을 나타내는 pandas.DataFrame을 반환합니다.

​
메서드 Table.get_index

get_index()
다른 테이블에서 링크를 만들 때 참조할 수 있는 행 인덱스 배열을 반환합니다.