> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# どのパッケージが必要ですか？

> Ionworks Studio、ionworks-api Python クライアント、ionworks-schema、ionworksdata の中から選びます

Ionworks は 1 つのプラットフォームに複数の入り口を持っています。ほとんどの方はそのうちの 1 つだけを必要とし、間違ったものを選ぶことが、序盤でつまずく最もよくある原因です。

## まずはここから

| やりたいこと…                                                      | 使うもの                                           |
| ------------------------------------------------------------ | ---------------------------------------------- |
| コードを書かずにセル、測定、シミュレーションをクリックで操作したい                            | [Ionworks Studio](/ja/introduction) — インストール不要 |
| プラットフォームをスクリプトから操作したい：データのアップロード、シミュレーションの実行、パイプラインの送信、結果の取得 | [`ionworks-api`](/ja/api-client)               |
| パイプラインを記述したい — 何をどのデータに対してどのオプティマイザでフィットするか                  | [`ionworks-schema`](/ja/pipelines/overview)    |
| 生のサイクラーファイルを自分のマシン上で Ionworks のデータ形式に変換したい                   | [`ionworksdata`](/ja/data/preparing-data)      |

スクリプトによるワークフローの多くは **`ionworks-api` と `ionworks-schema` を組み合わせて**使います。`ionworks-schema` でパイプラインを記述し、`ionworks-api` でそれを送信して結果を取得します。

## パッケージの詳細

| パッケージ             | インストール                        | インポート                           | こんなときに使う                                                                                |
| ----------------- | ----------------------------- | ------------------------------- | --------------------------------------------------------------------------------------- |
| Ionworks Studio   | —                             | —                               | UI が使いたい場合。以下のすべての機能はブラウザからも利用できます。                                                     |
| `ionworks-api`    | `pip install ionworks-api`    | `import ionworks`               | Python からプラットフォームを自動化したい場合 — データのアップロード、シミュレーション、パイプラインの送信、結果の取得。                       |
| `ionworks-schema` | `pip install ionworks-schema` | `import ionworks_schema as iws` | パイプライン構成を組み立てたい場合：`iws.Pipeline`、`iws.SimplePipeline`、`iws.DataFit`、目的関数、コスト、オプティマイザなど。 |
| `ionworksdata`    | `pip install ionworksdata`    | `import ionworksdata`           | 生のサイクラーのエクスポートデータ（Arbin、Maccor、Basytec、Neware など）をアップロード前にローカルで変換したい場合。                 |

<Warning>
  **配布名とインポート名は必ずしも一致しません。** `pip install
      ionworks-api` を実行すると `import ionworks` になり、`pip install
      ionworks-schema` を実行すると `import ionworks_schema` になります。
  `ionworks` という単独のパッケージは存在せず、`pip install ionworks`
  を実行しても API クライアントは手に入りません。
</Warning>

## 次のステップ

<CardGroup cols={2}>
  <Card title="クイックスタート" icon="rocket" href="/ja/quickstart">
    何もない状態から最初の結果を得るまでの手順です。
  </Card>

  <Card title="Python API クライアント" icon="code" href="/ja/api-client">
    インストール、認証、サブクライアントの紹介です。
  </Card>

  <Card title="パイプライン" icon="diagram-project" href="/ja/pipelines/overview">
    `ionworks-schema` でフィットと検証を記述します。
  </Card>

  <Card title="データの準備" icon="database" href="/ja/data/preparing-data">
    `ionworksdata` で生のサイクラーファイルを変換します。
  </Card>
</CardGroup>