引言

SIMPLON API 概述

核心設(shè)計理念

1. RESTlike 架構(gòu)：每個探測器資源（配置參數(shù)、狀態(tài)、命令）都通過URL 進行標(biāo)識

2. 語義化 HTTP 方法：使用 GET 讀取參數(shù)、PUT 修改配置或執(zhí)行命令、DELETE 刪除資源

3. 自描述性：所有參數(shù)都包含數(shù)據(jù)類型、取值范圍、單位和訪問權(quán)限信息

4. 一致性：EIGER2、PILATUS 和 POLLUX 系列探測器共享相同的 API 接口

版本控制

• 主版本號：不兼容的 API 變更

• 次版本號：向后兼容的功能新增

• 補丁號：向后兼容的問題修正

API 核心架構(gòu)

URL 結(jié)構(gòu)

• <DCU_IP>：探測器控制單元（Detector Control Unit）的 IP 地址

• <module>：功能模塊（detector、monitor、filewriter、stream、system）

• <version>：API 版本號（如 1.8.0）

• <task>：操作類型（config、status、command）

• <parameter>：具體參數(shù)或命令名稱

主要功能模塊

數(shù)據(jù)格式

核心子系統(tǒng)詳解

1. 探測器子系統(tǒng)（Detector）

關(guān)鍵配置參數(shù)

• 曝光控制：count_time（曝光時間）、frame_time（幀周期）、nimages（圖像數(shù)量）、trigger_mode（觸發(fā)模式）

• 能量設(shè)置：photon_energy（光子能量）、threshold_energy（閾值能量）

• 校正功能：flatfield_correction_applied、countrate_correction_applied、pixel_mask_applied

• 幾何參數(shù)：detector_distance（探測器距離）、beam_center_x/beam_center_y（束斑中心）

• 高級功能：compression（壓縮算法）、roi_mode（感興趣區(qū)域）、binning_mode（像素合并）

重要控制命令

• initialize：初始化探測器（上電或服務(wù)重啟后必須執(zhí)行）

• arm：加載配置并準(zhǔn)備采集

• trigger：軟件觸發(fā)采集

• disarm：結(jié)束采集并寫入所有數(shù)據(jù)

• abort：立即中止所有操作

2. 監(jiān)控子系統(tǒng)（Monitor）

主要特性

• 可配置的緩沖區(qū)大?。J(rèn) 100 幀）

• 支持 TIFF 格式圖像輸出

• 包含完整的元數(shù)據(jù)（曝光時間、能量、束斑中心等）

• 超時機制防止請求掛起

3. 文件寫入子系統(tǒng)（FileWriter）

關(guān)鍵配置

• mode：啟用 / 禁用文件寫入

• name_pattern：文件式（支持$id變量）

• nimages_per_file：每個數(shù)據(jù)文件的最大圖像數(shù)

• compression_enabled：啟用 / 禁用數(shù)據(jù)壓縮

• format：HDF5 文件格式

4. 流子系統(tǒng)（Stream）

• Stream V1：基于 ZeroMQ 的多部分 JSON 消息（端口 9999）

• Stream V2：基于 CBOR 編碼的單部分消息（端口 31001），性能更高，延遲更低

Stream V2 優(yōu)勢

• 單消息設(shè)計，減少網(wǎng)絡(luò)開銷

• CBOR 編碼比 JSON 更緊湊、解析更快

• 支持多客戶端連接（輪詢分發(fā)）

• 包含完整的元數(shù)據(jù)和圖像數(shù)據(jù)

5. 系統(tǒng)子系統(tǒng)（System）

• 網(wǎng)絡(luò)配置（IP 地址、DNS、MTU 等）

• 日期時間設(shè)置（NTP 同步、時區(qū)）

• 系統(tǒng)命令（重啟、關(guān)機、日志收集）

完整數(shù)據(jù)采集流程

1. 初始化探測器
   python
2. import requestsimport json

   DCU_IP = "192.168.0.100"API_VERSION = "1.8.0"# 初始化探測器response = requests.put(f":///detector/api//command/initialize", json={})response.raise_for_status()

3. 配置采集參數(shù)
   python
4. # 設(shè)置曝光時間為0.1秒response = requests.put(

       f":///detector/api//config/count_time",    json=)

5. # 設(shè)置采集100幀圖像response = requests.put(    f":///detector/api//config/nimages",    json=)

6. # 設(shè)置觸發(fā)模式為內(nèi)部觸發(fā)response = requests.put(    f":///detector/api//config/trigger_mode",    json=)

7. 配置數(shù)據(jù)接口
   python
8. # 啟用FileWriterresponse = requests.put(

       f":///filewriter/api//config/mode",    json=)

9. # 設(shè)置文件模式response = requests.put(    f":///filewriter/api//config/name_pattern",    json=)

10. 啟動采集
    python
11. # Arm探測器response = requests.put(f":///detector/api//command/arm", json={})sequence_id = response.json()["sequence_id"]
12. # 觸發(fā)采集response = requests.put(f":///detector/api//command/trigger", json={})
13. 等待采集完成并下載數(shù)據(jù)
    python
14. # 等待采集完成（實際應(yīng)用中應(yīng)輪詢狀態(tài)）import time

    time.sleep(15)

15. # Disarm探測器response = requests.put(f":///detector/api//command/disarm", json={})

16. # 下載HDF5文件master_file = requests.get(f":///data/my_experiment__master.h5")with open(f"my_experiment__master.h5", "wb") as f:    f.write(master_file.content)data_file = requests.get(f":///data/my_experiment__data_000001.h5")with open(f"my_experiment__data_000001.h5", "wb") as f:    f.write(data_file.content)

高級特性

多閾值能量分辨

高效數(shù)據(jù)壓縮

• LZ4：通用高速壓縮算法

• BSLZ4：DECTRIS 優(yōu)化的位洗牌 + LZ4 算法，壓縮比更高，推薦用于全幀率采集

精確幾何坐標(biāo)系統(tǒng)

• 實驗室坐標(biāo)系：原點在樣品中心，Z 軸沿入射束方向，Y 軸向上

• 探測器坐標(biāo)系：原點在傳感器左上角，X 軸沿快速掃描方向，Y 軸沿慢速掃描方向

北京泰坤：您的 DECTRIS 工業(yè)應(yīng)用合作伙伴

1. 專業(yè)的技術(shù)咨詢：根據(jù)您的應(yīng)用需求，推薦最合適的 EIGER2、PILATUS 或 POLLUX 探測器型號

2. 系統(tǒng)集成服務(wù)：將 DECTRIS 探測器無縫集成到您的工業(yè)檢測系統(tǒng)中

3. API 開發(fā)支持：提供 SIMPLON API 的技術(shù)培訓(xùn)和定制化開發(fā)服務(wù)

4. 本地化技術(shù)支持：快速響應(yīng)您的技術(shù)問題，提供現(xiàn)場安裝和維護服務(wù)

5. 備件和維修服務(wù)：建立了備件庫，確保您的系統(tǒng)持續(xù)穩(wěn)定運行

總結(jié)