CLDAQ - a Class Library for Data AcQuisition

開発時間を短くしたいということもありまして、 CLDAQは多くのライブラリに依存しています。

もっとも、 大抵のディストリビューションではインストール時に 入っているのがほとんどだと思うのですけれど、 CLHEP と ROOT という非高エネ業界の人々には覚えのないものを使用しており、 かつ強依存しております。

これらふたつのライブラリはデフォルトではまず入ってないと思いますので、 必ずCLDAQ本体をビルドする前に上記のリンクをたどって、 インストールしてくださいますようお願い申し上げます。

ここではCLDAQ本体をホームディレクトリにインストールする例を紹介します。 シェルはcsh系を使っていますので、sh系のシェルを使用している方は適宜、 読み替えて下さい。

% cd $HOME
% tar zxvf CLDAQ-x.xx.xx.tar.gz
% source CLDAQ/config/scripts/cldaq-setup.csh
% cd CLDAQ/source
% make

うまくいけばこれで終わりです。 CLDAQには便利なconfigureスクリプトは存在しません。 上の例中の3行目で cldaq-setup.csh というファイルをsourceしていますが、これが非常に重要です。 CLDAQではライブラリをビルドするとき、 あらかじめ設定されてある環境変数を使用します。

ビルド時に参照される環境変数は以下のようなものがあります。 特に始めの5行は必須項目ですので必ず設定してください。

ライブラリのビルドが終われば、 $CLDAQ_INSTALL/lib にライブラリが生成されているはずです。

動作のテストは $CLDAQ_INSTALL/tests にあるコードで行います。 どれも数１０行〜１００行程度の短いプログラムですが、 CLDAQの使い方を簡単に理解し、 動作しているかどうかを調べるにはここから始めるのが良いでしょう。

% cd $CLDAQ_INSTALL/tests
% make
% ls $CLDAQ_INSTALL/bin

なにやらいろいろ出来ているはずです。 デバイスを必要とするプログラムはドライバとデバイスの接続を必要としますが、 その他のプログラム（ほとんど全てです）はすぐに動くはずです。

$CLDAQ_INSTALL/examples/software 以下にあるプログラムはデバイスを必要とせず、かつ、 実際のDAQシステムに近い枠組みになっているので、 現実的なシステムをイメージするには、ちょうどよい例題だと思います。

以下にアプリケーションの構築から、実行までの一通りの手順を示します。

% cd $CLDAQ_INSTALL/examples/software
% cd sw01
% make
% $CLDAQ_INSTALL/bin/sw01main
CLDAQ> /run/start
CLDAQ> /run/suspend
CLDAQ> /run/stop
CLDAQ> /system/shutdown
% w3m -dump run000000.html
% $CLDAQ_INSTALL/bin/ifiledump run000000.drec
% $CLDAQ_INSTALL/bin/sw01recdisp run000000.drec

上記例ではCLDAQ対話セッションで１ラン実行し、終了した後、 できあがったデータファイルに対して、いくつかの操作を行っています。 （標準出力と可視化）

$CLDAQ_INSTALL/config/scripts/cldaq-build を実行すると、DAQアプリケーションのための雛形が作成されます。 これだけでは、まともに動きませんので、各メンバ関数を実装してください。 ファイル中に埋め込まれたコメントや 例題のソースコードが参考になると思います。

スクリプトを実行すると、いくつかの質問がコンソールに出力されますので、 適宜、答えていって下さい。 下記例のように答えていった場合、 mydaq というディレクトリが掘られ、その中に MySystemAction、 MyRunAction、 MyEventAction、 MyCrateDefinition、 MyReadoutBookDefinition という５つのクラスのソースコードが作成されます。 これらはコンパイル可能ですが、中身が空のため、 動作しません。 これら５つのクラスから、 libDAQ.a（あるいはlibDAQ.so）というライブラリが作成されます。 main関数を含むファイルはこの場合、 main.cc と subsys.cc が作成されます。 実行ファイルの名前はそれぞれ、 main と subsys になります。

% $CLDAQ_INSTALL/config/scripts/cldaq-build
CLDAQ - a Class Library for Data AcQuisition
Copyright (C) 2000-2004 Go IWAI 
  This is free software with ABSOLUTELY NO WARRANTY.
  For details type "cldaq-build --warranty".
----
Enter project name [DAQ]: mydaq
Enter execution name(s) [no default]: main
Add more (Y)es/(N)o?: [Y]: y
Enter execution name(s) [main]: subsys
Add more (Y)es/(N)o?: [Y]: n
Enter library name [mydaq]: DAQ
Enter Prefix [Daq]: My

いろいろメッセージが出る

推奨ドライバへのリンクです。 下記以外のドライバで動かしたい理由がある場合はご相談ください。

• VME - Sanshiro ENOMOTO
• CAMAC - Yasunobu SAKAMOTO

ライセンスは放棄していません。 適当にいじくって亜流を配布してもかまいませんが、 配布コード（もしくはドキュメント）に一言、 CLDAQのコードを参考にした（もしくはパチった）と、 ここのURL(http://cldaq.sourceforge.jp/)とともに書き添えてください。

現在、サルベージ作業中です。

• 文書置き場
• リファレンスマニュアル
• "CLDAQ for experiment coordinators" (PowerPoint)
• "JLC崩壊点検出器(CCD)開発研究の為のDAQシステムの構築とその性能評価及びそれを用いたCCDの放射線損傷の測定", 日本物理学会 秋季大会, (2002年9月), 立教大
• "KONOE: An Object-Oriented/Network-Distributed Online Environment", IEEE NSS and MIC, (Nov 2001), San Diego, USA
• "オブジェクト指向ネットワーク分散オンライン環境KONOEの開発 II 〜Device Driverの実装とDAQへの応用〜", 日本物理学会 春の分科会, (2000年3月), 近畿大

ここより先はどうでもいい内容が多いので、 読み飛ばしていただいて構いません。

上図は開発頻度を可視化したもので、下図はクラスライブラリの規模です。 上図からはビームテストのたびに瞬間的に突風がふいたことが見てとれます。

２００３年５月に公開を開始して以来、 プロジェクトホームページには４００００回以上のアクセスがあり、５０００回以上のダウンロードされました。 CLDAQを構成するクラスの数はおよそ２００程度で、 現在（２００４年６月）ソースコードの規模は１ＭＢ、４万行程度になります。

※ アプリケーションコードまで含めると、１０万行程度になります。

簡単な更新履歴です。 もっと詳しい情報はこちらの「リリースメモ」や「更新履歴」からどうぞ。

1.14.0 (2004-06-25)

DCBA で使ってくださるとのことなので、簡単に整備しました。

1.13.0 (2004-03-27)

各アクションクラスのメソッド名を変更しました。

機能が限定されていますが、CINTへの言語バインディングを用意しました。

1.12.0 (2004-03-01)

圧縮・解凍フィルターを持つファイル入出力機能を加えました。

レコードディスプレイの部品群といくつかのデモプログラムを加えました。

1.11.0 (2003-12-09)

データレコードへの可読性の高い高速アクセスを実装。

ログセンダーの実装。

オブジェクトフィルターの実装。

圧縮・解凍フィルターを用意しました。

GPLへの準拠を意識しはじめました。

1.10.0 (2003-11-03)

正規表現を扱うための機能を追加しました。

GNUスタイルの引数を簡単にかつ直感的に解釈するための機能を追加しました。

Doxygen 用のタグとコメントをうつ試みを開始しました。

1.8.0 (2003-09-07)

データレコードへのアクセスが簡単になりました。

1.7.0 (2003-07-31)

コマンド関係のバグを修正しました。

コミットログをつけることにしました。

1.6.0 (2003-07-17)

SourceForge.jpにて公開を開始しました。

1.4.0 (2003-04-xx)

物理学会（年次大会）直前のスナップショットです。

1.3.1 (2003-02-xx)

APPI 2003 直前のスナップショット。

ライブラリ部分よりもアプリケーションコード、 特にＣＣＤからの読み出し部分が多く更新されました。

1.2.0 (2002-12-xx)

多くの整備を加えたり、汚らしいコードを捨てたりしました。

実質、このバージョンが1.0.0に相当するバージョンだと思います。

1.0.0 (2002-11-xx)

タイムスタンプはなぜか１１月のものになっていて、なんだか怪しい。

サイズから推測するに、バージョン0.7.0相当だと思われます。

0.9.0 (2002-12-xx)

ビームテスト（at LNS）直後のスナップショットです。

CAMACアクセスの部分が完成されました。

0.8.0 (2002-12-xx)

ビームテスト（at LNS）直前のスナップショットです。

カテゴライズして、配布を意識した開発環境に。

0.4.1 (2002-09-xx)

物理学会（秋季大会）の時点でのスナップショットです。

働きすぎて、肺炎になってしまった。

解析カテゴリは頓挫してしまった。

0.3.0 (2002-08-xx)

多くのコマンドを追加して、対話的にシステムをコントロールすることが できるようになりました。

0.2.0 (2002-08-xx)

ユーザーインターフェースやランコントロールの機能を組み込み始めた。

0.1.0 (2001-xx-xx)

BIT3経由でVMEモジュールをコントロールするのが主目的で、 作っては壊しての繰り返し。 まだ汎用クラスライブラリにするつもりもなかった。

• 異なる読み出し方式によるCCDからの出力読み出しに採用
  • VME - Flash ADC (Pentland)
  • VME - IO Register (REPIC)
  • RS232C - Digital Multimeter (KEITHLEY)
• ビームエネルギー測定用にCSI中の光量の読み出しに採用
  • CAMAC ADC, Scaler,...
• ビームプロファイル・モニター用にPINホトダイオードの電流読み出しに採用
  • RS232C - Digital Multimeter (KEITHLEY)

頓挫したプロジェクトは省略しました。

必要なものは、だいたい用意した感がありますし、飽きてきたので、 今後は言語バインディング（CINT,Python,Ruby,PHP） の充実とアプリケーション開発に注力してやっていこうと思っています。 いきあたりばったりで開発しているため、 開発タームが何層になっているか私自身、見通せてはいませんが、 最下層のレイヤーから、ひとつ上のレイヤーに移行したと言えます。

なお、開発タスクとその進捗状況はこちらから閲覧することができます。

現在準備中です。今しばらくお待ち下さいますようお願い申し上げます。