変数 vs カスタム変数
バッテリーモデルは、ソルバーが各タイムステップで計算する電圧、電流、温度などの量である数十の組み込み 変数 を解きます。カスタム変数 は、これらの組み込み変数をパラメータと数学と組み合わせるためにユーザーが定義する式です。評価された値はシミュレーション結果ファイルに保存されるため、カスタム変数は追加のみ可能です。シミュレーション実行後に変数を変更・削除すると、それらの結果が無効になります。
事前設定されたカスタム変数
すべてのシステムモデル（SPM、SPMe、DFN、それらのコンポジットバリアント、LumpedSPMR、LumpedSPMeR、フルセルおよびハーフセル ECM）には、次のカスタム変数があらかじめ定義されています:
これらはシミュレーション結果で即座に利用できます — システムモデルを使うときに自分で追加する必要はありません。
システムモデルをクローンして新しいカスタムモデルを作成する場合、カスタム変数は自動的に引き継がれます。モデルをゼロから作成する場合は、必要なカスタム変数を手動で追加する必要があります。
モデルタイプ別の電極電位式
電極電位に使用される式はモデルタイプによって異なります:フルセル ECM は回路ベースであり、個別の電極電位を直接解きません。代わりに、Anode overpotential fraction パラメータを使用して総過電圧を負極と正極の間で分割することにより再構築します。詳細と BioLogic EWE/ECE 制御の再現などのユースケースは Models の ECM を参照してください。ハーフセル ECM は作用電極を正極として扱う（負極電位 = 0 V）ため、セル電圧は正極電位と等しくなります。
式の構文
カスタム変数の式は PyBaMM のビルディングブロックを使用します:型
数学演算
標準の算術:+、-、*、/、**（べき乗）
関数
exp()、log()、sqrt()、tanh()、cosh()、sinh()
例
温度変換（ケルビンから摂氏）:評価
カスタム変数は遅延評価されます — シミュレーション結果で表示されたときのみ評価されます。プロットや表示用にカスタム変数を選択すると、システムはバックグラウンドで評価ジョブを送信します。評価実行中はローディングインジケーターが進捗を示します。 評価が失敗した場合（一時的なエラーなど）、プロットは読み込みを続ける代わりにエラー状態を表示します。表示される Retry ボタンをクリックして評価ジョブを再送信してください。検証
カスタム変数を追加すると、システムは式を検証します:- 有効な構文 — 式は有効な PyBaMM 式として解析できる必要があります
- 参照が存在する — すべての
CoupledVariable参照は、既存のモデル変数またはすでに定義した他のカスタム変数を指す必要があります - 循環参照なし — カスタム変数 A は、B が A を参照する場合（直接または間接的に）B を参照できません
- パラメータ認識 —
Parameter("name")を使う場合、システムは既存のモデルパラメータに一致するか新しいものを作成するかを知らせます。名前が完全に一致しない場合、類似する既存パラメータを提案します
制限事項
- 追加のみ — カスタム変数は作成後に編集や削除はできません
- アップロードされたモデルでは利用不可 — 組み込みの PyBaMM モデルタイプのみカスタム変数をサポートします
- システムモデルは変更不可 — まずシステムモデルをクローンしてから、クローンにカスタム変数を追加してください