> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-run-filter-ui-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 表

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub のソース
  </a>;

<GitHubLink url="https://github.com/wandb/wandb/blob/main/wandb/sdk/data_types/table.py" />

## <kbd>class</kbd> `Table`

表形式データを表示・分析するための `Table` クラスです。

従来のスプレッドシートとは異なり、表はさまざまなデータ型をサポートします。たとえば、スカラー値、文字列、numpy 配列、`wandb.data_types.Media` のほとんどのサブクラスを扱えます。つまり、`Images`、`Video`、`Audio`、そのほかのリッチな注釈付きメディアを、従来のスカラー値と並べて 表に直接埋め込むことができます。

このクラスは、W\&B 表を生成するための主要なクラスです [https://docs.wandb.ai/models/tables](https://docs.wandb.ai/models/tables)

### <kbd>method</kbd> `Table.__init__`

```python theme={null}
__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'
)
```

表 objectを初期化します。

`rows` は後方互換性のために用意されていますが、使用しないでください。表 classは、Pandas APIを模倣するために `data` を使用します。

**引数:**

* `columns`:  (List\[str]) 表の列名。デフォルトは \["Input", "Output", "Expected"] です。
* `data`:  (List\[List\[any]]) 値の2次元の行指向配列。
* `dataframe`:  (pandas.DataFrame) 表の作成に使用するDataFrame object。これを設定すると、`data` 引数と `columns` 引数は無視されます。
* `rows`:  (List\[List\[any]]) 値の2次元の行指向配列。
* `optional`:  (Union\[bool,List\[bool]]) `None` 値を許可するかどうかを判定します。デフォルトは True です
  * 単一の bool 値を指定した場合、構築時に指定されたすべての列に対して optionality が強制されます
  * bool 値の list を指定した場合、optionality は各列に適用されます。長さは `columns` と同じである必要があります。
* `allow_mixed_types`:  (bool) 列に複数のタイプが混在することを許可するかどうかを判定します (タイプ検証を無効化します) 。デフォルトは False です
* `log_mode`:  Optional\[str] 変更が発生したときに 表 をどのようにログするかを制御します。オプション:
  * "IMMUTABLE" (デフォルト): 表 は一度だけログできます。表 が変更された後に再度ログしようとしても no-op になります。
  * "MUTABLE": 変更後に 表 を再度ログでき、ログするたびに新しい artifact version が作成されます。
  * "INCREMENTAL": 表 data は段階的にログされ、ログのたびに前回のログ以降の新しい data を含む新しい artifact entry が作成されます。

***

### <kbd>method</kbd> `Table.add_column`

```python theme={null}
add_column(name, data, optional=False)
```

テーブルにデータ列を追加します。

**引数:**

* `name`:  (str) - 列の一意な名前
* `data`:  (list | np.array) - 同種のデータで構成される列
* `optional`:  (bool) - null 相当の値を許可するかどうか

***

### <kbd>method</kbd> `Table.add_computed_columns`

```python theme={null}
add_computed_columns(fn)
```

既存のデータに基づいて、1 つ以上の算出列を追加します。

**引数:**

* `fn`:  1 つまたは 2 つのパラメーター `ndx` (int) と `row` (dict) を受け取る関数です。各行について、新しい列名をキーとする、新しい列を表す dict を返すことが想定されています。
  * `ndx` は行のインデックスを表す整数です。`include_ndx` が `True` に設定されている場合にのみ含まれます。
  * `row` は既存の列をキーとする辞書です

***

### <kbd>method</kbd> `Table.add_data`

```python theme={null}
add_data(*data)
```

表に新しいデータ行を追加します。

表の最大行数は、`wandb.Table.MAX_ARTIFACT_ROWS` で決まります。

データの長さは、表の列数と一致している必要があります。

***

### <kbd>method</kbd> `Table.add_row`

```python theme={null}
add_row(*row)
```

非推奨です。代わりに `Table.add_data` method を使用してください。

***

### <kbd>method</kbd> `Table.cast`

```python theme={null}
cast(col_name, dtype, optional=False)
```

列を特定のデータ型にキャストします。

指定できるのは、通常の Python クラス、W\&B の内部タイプ、または wandb.Image や wandb.Classes のインスタンスのようなサンプル object のいずれかです。

**引数:**

* `col_name` (str):  キャストする列の名。
* `dtype` (class, wandb.wandb\_sdk.interface.\_dtypes.Type, any):  対象の dtype。
* `optional` (bool):  列で None を許可するかどうか。

***

### <kbd>method</kbd> `Table.get_column`

```python theme={null}
get_column(name, convert_to=None)
```

表から列を取得し、必要に応じて NumPy オブジェクトに変換します。

**引数:**

* `name`:  (str) - 列の名前
* `convert_to`:  (str, optional)
  * "numpy": 元のデータを NumPy オブジェクトに変換します

***

### <kbd>method</kbd> `Table.get_dataframe`

```python theme={null}
get_dataframe()
```

表を `pandas.DataFrame` として返します。

***

### <kbd>method</kbd> `Table.get_index`

```python theme={null}
get_index()
```

他の表でリンクを作成する際に使用する行インデックスの配列を返します。

***
