装置

Organization
└── Site           (ラボ / 施設 — 組織スコープ、共有)
    └── Cycler     (バッテリーサイクラー — 単一プロジェクトに所属)
        └── Channel  (サイクラー上の単一テストチャンネル — 親サイクラーのプロジェクトを継承)
             └── channel_id 経由でセル測定にリンク

from ionworks import Ionworks

client = Ionworks(project_id="your-project-id")

# 1. サイトを作成（またはフェッチ）— 組織スコープでプロジェクト間で共有。
site = client.site.create_or_get({
    "name": "Main lab",
    "location": "Building 3, Room 210",
})

# 2. サイトの下にサイクラーを作成。project_id は必須 — サイクラーは
#    そのプロジェクトが所有します。
cycler = client.cycler.create_or_get(
    site.id,
    {
        "name": "Cycler-01",
        "manufacturer": "Arbin",
        "model": "LBT-5V-6A",
        "project_id": client.project_id,
    },
)

# 3. サイクラー上にチャンネルを作成し、任意で電気的定格を設定します。
for i in range(1, 9):
    client.channel.create_or_get(
        cycler.id,
        {
            "name": f"Ch-{i:02d}",
            "max_amps": 6.0,
            "min_volts": 0.0,
            "max_volts": 5.0,
        },
    )

# 更新（部分更新）。新しい site_id を渡すと、同じ組織内の別サイトに
# サイクラーを移動できます。所有プロジェクトは変更できません。新しい
# cycler_id を渡すとチャンネルの親を付け替えられますが、同じプロジェクト内の
# 別サイクラーに限ります。
client.cycler.update(cycler.id, {"model": "S4000M"})

# 削除 — 階層を下方向にカスケードします（サイト -> サイクラー -> チャンネル）。
# チャンネルを削除すると、それを参照していた測定の channel_id は NULL に戻ります。
# 測定自体は削除されません。
client.cycler.delete(cycler.id)

channels = client.channel.list(cycler.id)
ch01 = next(c for c in channels if c.name == "Ch-01")

bundle = client.cell_measurement.create(
    cell_instance.id,
    {
        "measurement": {
            "name": "Formation Cycle 1",
            "channel_id": ch01.id,
        },
        "time_series": time_series,
    },
)

# 既存の測定にチャンネルを付ける／付け替える
client.cell_measurement.update(bundle.id, {"channel_id": ch01.id})

# 測定を削除せずに切り離す
client.cell_measurement.update(bundle.id, {"channel_id": None})

from datetime import datetime, timedelta, timezone

client.cell_measurement.update(
    measurement_id,
    {
        "estimated_end_time": (
            datetime.now(timezone.utc) + timedelta(hours=18)
        ).isoformat(),
    },
)

# 現在のプロジェクトが所有するサイト内のすべてのサイクラー
cyclers = client.cycler.list(site.id, project_id=client.project_id)

# サイクラー上のすべてのチャンネルを 1 ページで取得
channels = client.channel.list(cycler.id, limit=100)
print(channels.total)

site = client.site.list(name_exact="Boston Lab")[0]
cycler = client.cycler.list(site.id, name_exact="Cycler-01")[0]
channel = client.channel.list(cycler.id, name_exact="Ch-01")[0]

print(site.id, cycler.id, channel.id)