ParaStoreについて

2004/9/3 改訂
2004/9/22 修正

計測情報開発タスク幹事

ParaStore とは，実験シーケンスに同期した一定のタイミングで，指定の共有ディレクトリ中に置かれたパラメータ・ファイル（コンマ区切りテキストファイル）を，LABCOMデータストレージに自動的に保存・登録（内部的にはdbStoreを利用）する公開サービスです。

ParaStoreで格納されるパラメータ・ファイルは下記に従って作成してください。

1. ファイル名
   ”計測名_p” のように、必ず最後に”_p”を付加したファイル名にしてください。
   例）　Bolometer_p，GPCRADH_p など
   
   これらは予め ParaStoreデータ登録申請 を行った名前である必要があります。
   ※ファイルの格納には dbStore を使用しています。
   　
2. ファイルの置き場所
   Windows共有フォルダ \\ParaStore\parameters\ 中にネットワーク経由で置きます。
   （共有フォルダをうまく認識できない時は，\\ParaStore.LHD.nifs.ac.jp\parameters\ を使用する。）
   
   各ファイルの新規追加・編集には、それぞれ書込権限が必要です．新規でデータを登録する際は，必ず最低１名の書込権限者を登録するようになっています．後で書込権限者を追加したい場合は、ParaStoreデータ登録申請で書込権限者の追加申請を行ってください。
   【注意】 書込権限はLHDドメインユーザーアカウントに与えられるため，LHDドメインユーザーアカウントをお持ちでない方は，LHDドメインユーザーアカウント登録申請を行い，アカウントを取得してからParaStoreデータ登録申請を行ってください。
   　
3. ファイル・レイアウトとレイアウト・タグ
   パラメータ･ファイルは，'#'文字より始まるコメント行と，それ以外で始まるデータ行とで構成されます．コメント行のうち，先頭の'#'文字に続いて[***]というレイアウト・タグが書かれた行と，その直後のコメント行だけが，以下に説明するように特別な意味を持っています．
   データ行は，レイアウト・タグ[DATA]以降の非コメント行であり，コンマ区切りテキスト（CSV）形式になっています．

   有効なレイアウト・タグは以下に示す４つです．レイアウト・タグでは，全て大小文字の違いを無視します．[NAME] = [Name]

   # [MailAddress]	<-メールアドレス定義
   # foo@nifs.ac.jp	<-’#’以降が使用者のメールアドレス．指定できるアドレスは１個のみ．
   #	ここで指定されたユーザのみがデータ削除申請 を行えます．
   #
   # [NAME]	<-パラメータ変数名称の定義
   # CH, CATEGORY, NAME, TAG, …	<-’#’以降が有効なパラメータ変数名称．カンマ区切りテキスト形式．
   #
   # [TYPE]	<-パラメータ変数型の定義（オプション：デフォルトは ６：DOUBLE）
   # 4, 1, 1, 4, …	<-’#’以降が有効なデータ型．カンマ区切りテキスト形式．
   #
   # [DATA]	<-パラメータデータの開始
   1, 100.000, …	<-格納されるデータ．カンマ区切りテキスト形式．
   2, 101.000, …
   … 以下，任意行数のデータが続く

   　

4. 必須パラメータ変数（カラム）
   各チャンネルがどの計測器に対応しているか，あるいは各計測器の属性（アンプの増幅率、較正係数、．．．）などの計測器関連情報を一元的にデータベース化して記録に残すために，以下の必須カラム４つを必ず先頭に設けること．
   　
   1. CH
      • CAMACなどデジタイザの収集チャネル番号（整数 TYPE=4）
      • １からはじまる連続番号．半角数字のみ．
      • ケーブルが接続されていないなどの無信号チャネルでも，データ収集がONで無信号データが入っている場合は，最低‘CH’番号を付した該当行をつくること．
        　
   2. CATEGORY
      • 計測分類名（文字列 TYPE=1）
      • 誰にでもわかる計測分類名とする．（例：ECE, Magnetic_Probe）
      • 半角の英数字と記号＋－＊／＿（　）＆＜＞＃[ ] %？のみ使用可能．空白文字（スペース）は利用不可．
        　
   3. NAME
      • 計測器（同一センサー群などの小集合）の識別名（文字列 TYPE=1）
      • 計測グループ内での識別に使える。（例：RADH_slow）１からはじまる連続番号
      • 半角の英数字と記号＋－＊／＿（　）＆＜＞＃[ ] %？のみ使用可能．空白文字（スペース）は利用不可．
        　
   4. TAG
      • 計測器（同一センサー群などの小集合）のチャネル番号（整数 TYPE=4）
      • 半角数字のみ．

   　

5. 自由利用パラメータ変数（カラム）の名称
   第5カラム目以降は，基本的に登録ファイルごとに自由に記述・利用できますが，あらかじめ登録した変数名（カラム表記名）を共用する規程になりましたので，既存の変数名を利用してください．

   現在の登録変数名は以下のとおりです．
   

   

   Variable_Name	Type	Type_Name	Comment
   CH	4	INT	unique and sequential channel no. of digitizers. Begin with 1.
   CATEGORY	1	STRING	category name of diagnostics
   NAME	1	STRING	measurement or sensor name(s) in its diagnostic category
   TAG	4	INT	channel no. within a measurement
   OBJECT	1	STRING	object of measurement
   PORT	1	STRING	LHD port no. where equipment are installed
   R(m)	5	FLOAT	sensor position in major radius direction
   Z(m)	5	FLOAT	sensor position in vertical direction
   PHI(deg)	5	FLOAT	sensor position in toroidal angular direction
   FREQ	5	FLOAT	sensing frequency
   WAVELENGTH	5	FLOAT	sensing wavelength
   ENERGY	5	FLOAT	sensing energy
   FILTER	5	FLOAT	filtering factor
   GAIN	5	FLOAT	amplifier's gain
   CALIB	5	FLOAT	calibration factor of the sensor
   UNIT	1	STRING	unit of physical value to be measured
   REMARKS	1	STRING	any comment(s) of this channel
   FIL	5	FLOAT	filament current
   CALDATA	4	INT	calibration data number
   SI	4	INT	sensitivity current
   GI	4	INT	gain current
   VOL	4	INT	voltage
   GV	1	STRING	Gatevalve open or close

   上記以外の変数名が必要な場合は，随時申請してください．
   　

6. ファイルの内容例

   稲垣氏提供による RADL 計測用サンプル・ファイル "RADL_p" がこちらにあります．

7. 注意事項など

• 定義に対応する値は、定義の次行に記述してください。
• [Data] は必ず最後に定義してください。（[MailAddress]、[NAME]、[TYPE]の定義順序は一応自由です）
• パラメータ名称が存在しない場合、そのパラメータファイルの格納は行われません。
• パラメータのデータ型が指定されていい場合、デフォルトの型(6: DOUBLE)で格納されます。
  [TYPE] で指定できるデータ型は以下の通りで，（☆）印が推奨のデータ型です．
  　１：STRING  …文字列（☆）
  　２：BYTE    …１バイト整数
  　３：SHORT   …２バイト整数
  　４：INT     …４バイト整数（☆）
  　５：FLOAT   …４バイト浮動小数点数 （単精度実数）（☆）
  　６：DOUBLE  …８バイト浮動小数点数
• パラメータのデータ型指定が１～６の範囲でない場合、そのパラメータファイル全体の格納が失敗します。
• パラメータのデータ型の指定数がパラメータ名称の数より少ない場合、不足分はデフォルトの型(6: DOUBLE)となります。
• 格納データ部 [Data] が存在しない場合、そのパラメータファイルの格納自体が行われません。