Skip to main content
April 20, 2026
Python SDK のリソースクライアント、検証の初期条件、容量計算の修正

Python SDK のリソースクライアント

Python SDK に、Studio リソースをプログラムから管理するための型付きサブクライアントが追加された。Ionworks クライアントから、プロジェクト、モデル、パラメータ化モデル、スタディ、プロトコル、最適化を直接作成・一覧取得・取得・更新・削除できるようになった。たとえば client.project.list()client.model.get(id)client.study.create(...) などである。Python API ドキュメントには各サブクライアントの使用例を解説する新しい「リソースの管理」セクションが追加され、Projects・Models・Studies のバックエンド URL パスはフラット化されて、組織が URL で必須だったものから認証トークンによって解決されるようになった。

検証の初期条件と UX の改善

検証では、シミュレーションの初期化方法を選択できるようになった。測定値からの自動検出、カスタム開始電圧、カスタム充電状態のいずれかである。Report タブの各検証行は確認ダイアログとともに個別に削除でき、同じ初期電圧を共有する 2 つの測定値が互いのドライブサイクルを上書きしてしまう重複除去のバグも修正された。検証エラープロットも、読みやすさ向上のためグリッド線とともに描画されるようになった。

多電極セルの容量計算の修正

ElectrodeCapacity が、並列接続された電極数について非正規の PyBaMM パラメータ名を読み取っていたため、ユーザーが正しいキーを設定した場合に c_max が N 倍に過大計算されていた。本修正ですべてのルックアップが PyBaMM の正規パラメータ名に揃えられ、多電極セルが正しくパラメータ化されるようになった。
改善
  • 単一の実験タイプのシミュレーションを持つスタディは、そのタイプを自動選択するようになり、可視化ビューにすぐにアクセスできるようになった。
  • 失敗した変数評価ジョブは、無限に回転し続ける代わりに、Retry ボタン付きのエラー状態を表示するようになった。
  • スタディ一覧エンドポイントが itemscounttotal を含むページネーション結果を返すようになった。
  • ページネーション対応のパラメータ化モデル一覧エンドポイントを追加した。
修正
  • 数千の短いステップを持つ時系列測定値(例: 約 1500 ステップの HPPC パルスプロトコル)を描画する際のクラッシュを修正した。ダッシュボードでこれらの測定値を読み込めるようになった。
  • 結合されたカスタム変数が解決に失敗した際に黙って削除され、「Temperature [degC]」などの便利な変数がシミュレーション出力から失われることがあった問題を修正した。
  • 422 エラーを防ぐため、モデル一覧のフォールバックページサイズをバックエンドの 100 行上限にキャップした。
改善
  • PyBaMM を 26.3.1 に更新した。カスタムモデルの base_class が、ワーカー環境にインストールされていないパッケージを参照している場合、警告とともに pybamm.BaseModel にフォールバックするようになった。
  • OCP 目的関数(OCPHalfCellElectrodeBalancingHalfCellElectrodeBalancing)を _run パターンを使うようにリファクタリングし、raise_on_failure をサポートし、Validation パイプラインで正しく動作するようにした。
修正
  • DataFit が裸の目的関数を {ClassName: objective} で自動ラップするようになり、ラップされていない単一の目的関数で送信されたパイプラインがシリアライズに失敗しなくなった。
改善
  • Models・Studies・Optimizations・Projects・Protocols・ParameterizedModels の型付きサブクライアントを追加し、リソース管理における生の HTTP リクエストを置き換えた。
  • SDK エンドポイントがパスに organization_id を含めなくなった。組織は認証トークンから解決される。
  • シミュレーションのポーリングがエラーを握りつぶさず即座に伝播するようになり、サーバー計算の is_terminal / is_failed フィールドを持つ型付き JobResponse オブジェクトを使うようになった。
修正
  • シミュレーションジョブのポーリングエンドポイントを修正した(存在しない /simulations/jobs/{id} ルートにアクセスしていた)。
修正
  • ECM バリデーターの符号検出バグを修正した。対称的な電流プロファイル(充電 / 放電 / 充電で同じ正味電荷量に戻る)が、ゼロでない SOC 範囲を持つにもかかわらず誤って却下されていた。