Excel2MaiMLProtocol

A: 概要

計測分析の手順や条件等の計画情報を記載したエクセルファイルを入力ファイルとし、 入力データをもとに、protocolFileRootType タイプの MaiML データファイルを作成するプログラム。

B: 実行方法

入出力データ

入力データ

1. エクセルファイル

記載方法は、settings/ExcelFormat.xlsx を参照。
入力するエクセルのファイルパスは、実行引数の有無によって決まる。

実行条件	入力するエクセルファイルのファイルパス
引数なし	USERS/usersettings.py に記載した１つのエクセルのファイルパスに対してプログラムを実行
引数あり	引数で指定したディレクトリに存在する全てのエクセルファイルに対してそれぞれプログラムを実行

出力データ

入力データをMaiMLデータフォーマットへ変換したMaiMLファイルを出力する。 実行するpythonプログラムによって、エクセルで必須入力ではなく、かつ、プログラムで自動設定しない要素に対する出力内容が異なる。

1. 実行pythonプログラムの出力仕様

実行pythonファイル名	エクセルで未入力の項目の処理
excel2protocolMaiML.py	タグのみを記載（値なしのタグを出力）
excel2protocolMaiML2.py	タグ自体を記載しない

2. 出力ファイルの保存先

出力されるMaiMLファイルの保存場所は、実行時の引数の有無によって決まる。

実行条件	出力先
引数なし	OUTPUT/output.maiml に保存
引数あり	指定されたディレクトリに、入力ファイル名の拡張子を .maiml に変更して保存

例

• python excel2protocolMaiML.py を実行
  → OUTPUT/output.maiml に保存

• python excel2protocolMaiML2.py XXXXX を実行
  → /INPUT/XXXXX/入力ファイル名.maiml に保存

実行方法

その1. 実行引数無しで実行

1. 入力ファイルを準備
   • USERS/usersettings.py の入力ファイルのパス (_IN_EXCEL_FILENAME)、 <maiml> 要素の属性 (_MAIML_ATTR) を編集。
   • 指定した入力ファイルのパスにエクセルファイルを配置。
2. コマンド実行

   python excel2protocolMaiML.py

   または

   python excel2protocolMaiML2.py

その2. 実行引数にディレクトリを指定して実行

1. 入力ファイルを準備
   • USERS/usersettings.py の <maiml> 要素の属性 (_MAIML_ATTR) を編集。
   • /INPUT/XXXXX/ ディレクトリにエクセルファイルを配置。
     ※ XXXXX は任意の名前。
2. コマンド実行

   python excel2protocolMaiML2.py XXXXX

C: python実行環境の構築

Python 3.9以上

• 実行パスが通っていること

実行に必要なPythonパッケージ

• settings/requirements.txt に記載

D: sampleファイルの実行

①/INPUT/test/ディレクトリに入力ファイルが存在していることを確認

• exampleX.xlsx

②/USERS/usersettings.pyに名前空間の定義が追加されていることを確認

   'xmlns:BBBB="http://BBBB.corp/index.jp"'
   'xmlns:BBBBHPLC="http://BBBB.corp/ontology/hplc"'
   'xmlns:CDF="http://BBBB.corp/ontology/cdf"'

③コマンド実行

python excel2protocolMaiML2.py test

④/INPUT/testディレクトリに出力されたMaiMLファイルを確認

• exampleX.maiml