先にインストールと認証を行います:
pip install ionworks-api を実行し、IONWORKS_API_KEY(および IONWORKS_PROJECT_ID)を設定します。Python API クライアント ページを参照してください。time_seriesとsteps。time_seriesは生の信号トレースで、記録された時間点ごとに 1 行です。stepsはコンパクトなステップ単位のサマリーで、プロトコルステップごとに 1 行、ステップ/サイクル番号と派生量(容量、エネルギー、電圧の極値)を含みます。これらはread.time_series_and_stepsがパース時に計算します。多くの解析はこの steps を単位にグループ化・フィルタします。ionworksdata.readには主要なサイクラー用のリーダーがあります。read.detect(path)で自動選択も可能です。read.time_series_and_stepsを推奨します — 両方のフレームを返し、処理パイプライン全体を 1 回の呼び出しで実行します。- 電流の符号の規約: Ionworks は正の電流を放電として扱います。サイクラーによって規約が異なるため、元データを確認し、必要ならアップロード前に符号を反転してください(
ionworksdataのset_positive_current_for_dischargeが利用できます)。 create_or_getは冪等です — 再実行すると重複を作らず既存の spec/instance/measurement を返します。呼び出しが完了しただけでなく、オブジェクトが返ることが成功の証拠です。