当グループではLHD計測データ収集系(LABCOMシステム)の運転と、同実験関係者・共同研究者の計測データ収集・データ利用・遠隔実験等を支援する以下のサービスを行っています。詳細は各項目をクリックしてください。
English
You are the th visitor since 4 July 2000
Contact : LABCOM
プライバシーポリシー
各種フォームから個人情報を入力・送信する前に必ず上記をご覧ください。

dbStore利用方法 for dbStoreEXE

ver.16.0.1 '12.8.27現在

計測データを保存するには、データファイルを作成後、dbStoreコマンドを呼び出します。

事前準備

参照サイトを変更する

Retrieve+dbStoreをインストールすると、参照サイトが自動的に「LHD」に設定されます。デフォルトの参照サイトを変更したい場合はこちらをご覧ください。

テンポラリファイルの作成場所を変更する

dbStoreはテンポラリファイルを作成します。デフォルトではカレントディレクトリに作成します。
テンポラリファイルを作成するディレクトリを変更したい場合は、次の手順に沿って環境変数「DBSTORE_TMP」を作成してください。 (インストール時には環境変数「DBSTORE_TMP」は作成されません)

  1. コントロールパネルで「システム」を選択します。
  2. 「システムのプロパティ」ダイアログが表示されますので、「詳細設定」タブの中にある「環境変数」をクリックします。
  3. 「環境変数」ダイアログが表示されますので、システム環境変数で「新規」をクリックします。
  4. 変数名に「DBSTORE_TMP」、変数値にテンポラリファイルを作成するディレクトリを指定し「OK」をクリックします。
  5. 「環境変数」ダイアログでもう一度「OK」、「システムのプロパティ」ダイアログでも「OK」をクリックします。

データファイル・パラメータファイルを作成する

登録データは、データファイルとパラメータファイルの2種類のファイルに格納します。

データファイル : 配列型のデータを格納します
パラメータファイル : 単一型のデータを名前を付けて格納します
複数のパラメータデータを格納できます

※データファイルまたはパラメータファイルのいずれかが存在しないかサイズ0の場合、当該チャネルのデータまたはパラメータは存在しないものとして登録されます。
どちらのファイルもない場合は、処理を終了します。

データファイル
  1. ファイル名

    実行時の引数を使用してファイルを特定するため、以下のようにファイル名をつけてください。

    • データファイル名
      diagName+"-"+shotNumber+"-"+subshotNumber+"-"+channelNumber+".dat"
      例)"Bolometer-1234-1-1.dat"
       
    • データファイル名(フレーム形式)
      diagName+"-"+shotNumber+"-"+subshotNumber+"-"+channelNumber+"-"+frameNumber+".dat"
      *フレーム番号は1からフレーム数まで
      例)"IRcamera-edge-999110-1-1-1.dat"
       
  2. ファイル形式

    配列型のデータを先頭から順に、変換せずに(バイナリで)格納してください。

パラメータファイル
  1. ファイル名

    実行時の引数を使用してファイルを特定するため、以下のようにファイル名をつけてください。

    diagName+"-"+shotNumber+"-"+subshotNumber+"-"+channelNumber+".prm"
    例)"Bolometer-1234-1-1.prm"

  2. ファイル形式

    パラメータファイルのフォーマットは以下のように作成してください。
    (Retrieve.exeが生成するものと同一形式です)

    • 1行1データとする
    • 1行の各項目がカンマで区切られたテキストファイル
    • 1行の形式
      任意名称,パラメータ名称,値,データタイプ

      データタイプは以下の数値を指定してください。
      1 : TYPE_STRING
      2 : TYPE_BYTE ( 8bit)
      3 : TYPE_SHORT (16bit)
      4 : TYPE_INT (32bit)
      5 : TYPE_FLOAT (32bit)
      6 : TYPE_DOUBLE (64bit)
      7 : TYPE_INT64 (64bit)

    例)
    Generic,ClockSpeed,10000,4
    Generic,MemorySize,131072,4

  3. 予約パラメータ
     
    •  意味のあるパラメータ名
      "ImageType", "FileName", "SampledFrame", "AcquisitionWindowWidth", "AcquisitionWindowHeight", "SignalName"
       
    • 無視されるパラメータ名
      "DiagnosticsName", "Shot", "SubShot", "DataType", "ModuleGroup", "ModuleType", "ManagementVersion", "ChannelNumber", "DataLength(byte)", "CompressionMethod", "FrameByteSize", "CRC32"
       
  4. データ型の指定

    パラメータファイルにデータファイルのデータの型を指定します。
    パラメータ名 : "ImageType" (TYPE_STRING)

    "INT8" : 8ビット整数
    "INT16" : 16ビット整数
    "INT32" : 32ビット整数
    "INT64" : 64ビット整数
    "FLT32" : 32ビット浮動少数点
    "FLT64" : 64ビット浮動少数点
    "GRAYn" : nビットグレースケール画像(n:8~16) 例)'GRAY8'
    "RGB" : 24ビットカラー画像(RGBの順が変更可) 例)'BGR'
    "ARGB" : 32ビットカラー画像(ARGBの順が変更可) 例)'BGRA'

    例)Generic,ImageType,INT8,1

  5. オリジナルファイル名の指定

    データファイルのオリジナルファイル名を指定したい場合、"FileName"パラメータ(TYPE_STRING)を指定します。
    コマンドライン版Retrieveでデータを取り出す際に、"--original-name"オプションをつけることで、このパラメータで指定した名前でファイルが作成されます。

    "FileName" :ファイル名

    例)
    Generic,FileName,Bolo,1

  6. フレーム形式のパラメータ指定

    フレーム形式で保存する場合、"SampledFrame"パラメータ(TYPE_INT)、"AcquisitionWindowWidth"パラメータ(TYPE_INT)、"AcquisitionWindowHeight"パラメータ(TYPE_INT)の3つを指定します。

    • "SampledFrame" :フレーム数
    • "AcquisitionWindowWidth" :フレームのX方向サイズ(幅)
    • "AcquisitionWindowHeight" :フレームのY方向サイズ(高さ)

    例)
    Generic,SampledFrame,300,4
    Generic,AcquisitionWindowWidth,640,4
    Generic,AcquisitionWindowHeight,480,4

  7. シグナル名の指定

    チャネルのシグナル名(信号名)を指定したい場合、"SignalName"パラメータ(TYPE_STRING)を指定します。
    データ取得(Retrieve)時に、このシグナル名を指定できます。

    "SignalName" :シグナル名

    例)
    Generic,SignalName,sig1,1

dbStoreコマンドでデータを保存する

計測データを保存するには、dbStoreコマンドで次のように呼び出します。
※パラメータファイルがない場合は、image_typeを指定してください(必須)。

dbstore mail_addr diag shot sub_shot ch data_type [path [image_type] ] [Options]

各項目は次を参考に設定します。

mail_addr : ユーザのメールアドレス
※保存したデータを削除するときに必要になります
diag : データ名
※事前準備で申請したデータ名を使用します
shot : ショット番号
sub_shot : サブショット番号
※特にない場合は1を指定します
ch : チャネル番号 "from:to" 形式で指定
保存後のチャンネル番号は1から順になります
1チャンネルの場合は "1:1"としてしてください
data_type : RAW あるいは ANA のいずれかを指定
[path] : 登録データがあるフォルダの絶対パス(省略時はカレント)
[image_type] : 1次元データの型宣言 INT8, INT16, INT32, FLT32, FLT64 から1つ指定(パラメータファイルでImageTypeが指定してある場合、パラメータファイルの値が有効になります)
※複数チャネルを登録する場合は、パラメータファイルでチャネルごとに型宣言してください
※フレーム形式(2次元画像等)を保存する場合は、パラメータファイル中で型宣言してください(フレーム形式の場合、ここで型宣言してもパラメータファイルで型宣言していないとエラーになります)
[Options]  
--accept_sizes (-z) : フレームデータのサイズをX*Yサイズ以外でも受け入れる
--cndb_timeout=n (-t n) : データベース接続タイムアウトをn秒に設定する
--cndb_retry=m (-y m) : データベース接続タイムアウト時の繰り返し回数をm回に設定する

例)dbstore foo@nifs.ac.jp ECH 50001 1 2:2 RAW D:\lhd-das.5\ INT16


この Web に関する問題または質問等については,LABCOM までご連絡下さい.