> ## 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.

# モデルのアップロード

> 組み込みの PyBaMM モデルまたは独自のモデルとして Ionworks にモデルを登録し、パラメータと結び付けてパラメータ化モデルにします。

モデルを登録すると、パラメータ化してシミュレーションできるようになります。**モデル**は構造的な定義（SPM、DFN、または独自の方程式）で、[**パラメータ化モデル**](/ja/build/parameterized-models)はモデルをセル仕様とパラメータ値に結び付けたもの — こちらが実行可能な対象です。

<Note>
  先にインストールと認証を行います: `pip install ionworks-api` を実行し、`IONWORKS_API_KEY` を設定します。[Python API クライアント](/ja/api-client) ページを参照してください。
</Note>

```python theme={null}
import pybamm
from ionworks import Ionworks

client = Ionworks()

# 方法 A — 組み込みの PyBaMM モデル。オブジェクトを直接渡します
# （または {"type": "SPM"} の設定 dict）。標準モデル + オプションとして保存されます。
model = client.model.create({
    "name": "SPM with SEI",
    "description": "SPM + SEI growth submodel",
    "config": pybamm.lithium_ion.SPM(options={"SEI": "ec reaction limited"}),
})

# 方法 B — 独自の pybamm.BaseModel サブクラス（新しい方程式）。カスタムモデルとしてアップロードします。
custom_model = client.model.upload_custom(
    MyCustomModel(),             # pybamm.BaseModel インスタンス（またはシリアライズ JSON のパス）
    name="My Custom Model",
    chemistry="lithium_ion",     # lithium_ion (既定) | lithium_sulfur | ecm | generic
)

# モデルをセル仕様 + パラメータ値に結び付けて、実行可能なパラメータ化モデルにします。
parameterized_model = client.parameterized_model.create_or_get("your-cell-spec-id", {
    "name": "LGM50 Chen2020",
    "model_id": model.id,
    "parameters": {...},
})
```

**ポイント**

* **組み込み vs カスタム。** `client.model.create` は**組み込み**の PyBaMM モデルを受け付けます — オブジェクト（`pybamm.lithium_ion.SPM(options=...)`）または `{"type": "SPM"}` の設定 dict を渡すと、オプション付きの標準モデルとして保存されます（`is_custom_model=False`）。`client.model.upload_custom` は、組み込みでないモデルクラス — 新しい方程式/サブモデルを持つ独自の `pybamm.BaseModel` サブクラス — の場合にのみ使用し、カスタムモデルとして保存されます（`is_custom_model=True`）。
* カスタムアップロードには事前に `chemistry` タグが必要です — シミュレーションの調整を左右し、確実には推定できません（`chemistry` のない Li-S モデルはシミュレーション時に失敗します）。
* `Model` はパラメータ値を持たず、単独ではシミュレーションできません。`cell_spec_id` に対して `ParameterizedModel` を作成すると実行可能になります — [スタディ内でのシミュレーション実行](/ja/quickstarts/run-in-study) を参照してください。

## さらに詳しく

* [モデル](/ja/build/models) と [パラメータ化モデル](/ja/build/parameterized-models)
* [プロジェクトとスタディ](/ja/core-concepts/projects-studies)