Excel2MaiML

A：実行方法

[入出力データ]

• 入力データ　　※条件等は下記[B:詳細]を参照
  1. document,protocolのコンテンツをもつMaiMLデータファイル
     　　INPUT/maiml/input.maiml or INPUT/xxxxx/yyyyyy.maiml
  2. 計測の情報をもつエクセルデータ
     　　INPUT/excel/input.xlsx or INPUT/xxxxx/zzzzzz.xlsx
• 出力データ
  1. 入力データをマージしたMaiMLファイル
     　　OUTPUT/output.maiml

[実行方法]

• その１.
  1. 入力ファイルを準備
     　　/INPUT/maiml/ ディレクトリにMaiMLファイル
     　　/INPUT/excel/ ディレクトリにエクセルファイル
     　　/INPUT/others/ ディレクトリに外部ファイル
     　1. コマンド実行
     　　python excel2maiml.py
     
• その２.
  1. 入力ファイルを準備
     　　/INPUT/XXXXX/　ディレクトリにMaiMLファイル、エクセルファイル、外部ファイル　
     　　　※'XXXXX'は任意の名前
     　1. コマンド実行
     　　python excel2maiml.py XXXXX
     

B:詳細

[入力するMaiMLデータ]

・program１つを保証

[入力するエクセルデータ]

　・シート名はmethodのID
　・１行目
　　・１列目　’’
　　・２列目以降にinstructionのID、もしくは、templateのID
　・２行目
　　・１行目がtemplateのIDの列
　　・２行目にprotocol以下がもつpropertyのキー名
　・３行目以降は計測データ（複数行＝複数回計測）
　　・１列目にresultsのID
　　　・１行目がinstructionのIDの列
　　　・３行目以降に計測した日時
　　・１行目がtemplateのIDの列
　　　・３行目以降にpropertyのキーに対する値

エクセルの記述方法

［作成するMaiMLデータ］

・複数回の計測データをもつ場合はresultsを複数作成
　　（１行のデータ→results１つ）
・汎用データコンテナはpropertyのみ作成
・入力MaiMLファイルのtemplateをインスタンスとしてコピーする
・templateがもつ汎用データコンテナのkeyとエクセルのkeyが一致した場合のみvalueをエクセルデータで更新
　　（一致しなければ、エクセルデータは無視される）
・エクセルの２行目に'INSERTION'が存在した場合はtemplateIDに基づくインスタンスにinertionコンテンツを作成
　1. INPUTディレクトリに外部ファイルが存在する場合
　　insertionのコンテンツ　uri : ./+ファイル名、hash値：ファイルから算出したhash値
　1. INPUTディレクトリに外部ファイルが存在しない場合
　 　insertionのコンテンツ　uri : ./+ファイル名、hash値：空
・eventLogを１つ作成
・計測日時のデータが存在する場合にtraceを作成
　・複数回の計測データをもつ場合はtraceを複数作成
　・エクセルデータにinstructionIDが存在し、かつ、日時のデータが存在する場合にeventを１つ作成
　　　key=lifecycle:transitionのvalueがcompleteのみ

C:python実行環境の構築

[pythonバージョン]

・3.12.x

[pythonパッケージ]

・requirements.txt

D:サンプルデータ

[MaiMLファイル]

・INPUT/maiml/input.maiml
　１つのmaterialTemplate(material)、１つのconditionTemplate(condition)を１つの操作の入力とし、resultTemplate(result)を１つ出力する計測を記載したMaiMLファイル

[Excelファイル]

・INPUT/excel/input.xlsx
　input.maimlに記載した計測を実施し、使用もしくは取得したデータや入出力ファイル名を記載したエクセルファイル

[外部ファイル]

・INPUT/others/Axoneme-56.008.tif
・INPUT/others/test.txt
　計測時の入出力ファイルを新規MaiMLファイルに要素を用いて記載する例として、input.xlsxファイルに記載した外部ファイル