2と10のリビジョン間の差分 (その間の編集: 8回)

ATLAS Run-2データの解析

ATLAS Run-2データの解析

説明

ATLAS実験で取得したデータは、検出器からの生データから粒子の情報を再構成してxAODと呼ばれる形式に変換される。ほとんどのデータ解析はxAOD形式のファイルを使って行えるはずである。

データ解析の環境整備

以下の作業はCVMFSのインストールされたLinuxマシンのターミナル上で行うことを前提とする。

解析環境を用意するために一度だけ行う

解析を行うディレクトリを作り、そこで以下のコマンドを実行する。

setupATLAS
lsetup 'rcsetup Base,2.3.34'
rc find_packages
rc compile

これを実行するといくつかのディレクトリや環境変数が定義される。最初のsetupATLASというコマンドは、ATLASでよく使うソフトウェアを使えるようにするためのものである。二つ目のコマンドはxAODデータの解析に必要な環境を整備するためのものであり、xAODファイルを解析する上で便利なフレームワーク(RootCore)の設定をしてくれる。2.3.34の部分は、RootCoreのバージョンで、おそらく最新のバージョンを使うべきである。Baseというのは、解析を行うグループごとに特別のソフトウェアを使っている場合があり、どのグループのソフトウェアを使うかを指定している。Baseは特定のグループに依らない一般的なソフトウェアという意味である。

xAODファイルはROOTファイルであるが、保存されているデータはATLASの衝突データをモデル化したクラスのオブジェクトたちである。データを解析するためにはRootCoreと呼ばれるフレームワークを使うことが推奨されている。利点は

事象データを読み込んで自動的にオブジェクトとしてメモリ上に展開してくれる。
複数のファイルを順番に読んでいくことができる。
データ解析でよく使う実験全体で共通のコードをライブラリから利用できる。
他にもあると思う。

新しくセッションを始めた時、毎回行う

setupATLAS
lsetup rcsetup

最初に環境を作った時のコマンドと似ているが、2つ目のコマンドでソフトウェアのバージョンを指定していない。最初に設定を行ったときに、設定情報を保存したファイルが作られていてそこから情報を読み込んでいるので必要ない。同じバージョンを指定しても問題はない。

RootCoreの使い方

RootCoreで管理するソフトウェアに対してコンパイル等の操作をするには、rcというコマンドを用いる。

rc help

のように、rcに続けて操作内容を指定する。rc helpとやると、どんな操作が可能かを表示してくれる。

解析コードを書く

パッケージの作成

RootCoreでは、ファイルから事象を一つずつ読み込んでいく機能は用意されており、解析する際に書く必要があるのは事象データを基に何を行うかということである。ここでは、チュートリアルに従って新しくMyPackageというパッケージ（ライブラリのこと）を作って、その中にMyxAODAnalysisというクラスを作る。

rc make_skeleton MyPackage
$ROOTCOREBIN/EventLoop/bin/make_skeleton MyxAODAnalysis

最初のコマンドを実行すると、RootCoreディレクトリの下にMyAnalysisというディレクトリが新たに作られ、その下にさらにいくつかのファイルやディレクトリができているはずである。2つ目のコマンドを実行すると、その中にMyPackage/MyxAODAnalysis.h、Root/MyxAODAnalysis.cxxというファイルができる。

MyPackageや!MyxAODAnalysisという名前は適切なものに変換して使う。

データ解析のためのアルゴリズム(C++クラス)の作成

事象解析の基本的な流れは次のようになる。

初期化 initialize()
- ヒストグラムの作成など
ファイルにある事象をループ
- 事象データを基に何か処理を行う execute()
終了処理 finalize()
- ヒストグラム・出力ファイルの保存

EventLoopではファイルから事象データを順番に読み込むための仕組みが用意されている。ユーザーが書くべきコードは、ヒストグラムの作成、データ処理等の解析の内容に関連した部分だけでよい。これらのコードをクラスの決まった関数（initialize, execute, finalize）に記述することで、EventLoopが適切に呼び出してくれる。上の流れは実際に、もう少し細かいステップに分かれていて、ヒストグラムの作成はhistInitialize()という関数の中で行うとよい。

ATLASの事象データにアクセスするためには、TEventというクラスを利用する。これはMyxAODAnalysisクラスの関数からは

xAOD::TEvent* event = wk()->event();

として利用できる。ここから事象のデータを取ってくるにはretrieve(...)という関数を利用する。例えば、飛跡（Track）の情報を取ってくるには

const xAOD::TrackParticleContainer* tracks=0;
if (!event->retrieve(tracks, "TrackParticles").isSuccess()) {
  // エラー
} else {
  // データを処理
  auto p_track = tracks->begin();
  for (; p_track!=tracks->end(); ++p_track) {
    const TrackParticle* track = *p_track;
    // .....
  }
}

のようにして個々のTrackParticleオブジェクトにアクセスできる。

xAOD::TEventやxAOD::TrackParticle等のクラスは、それぞれxAODRootAccess、xAODTrackingというパッケージで定義されているので、MyPackageがこれらのパッケージに依存することを記述する必要がある。そのためにはMyPackage/cmt/Makefile.RootCoreの中の"_DEP = "の部分に"xAODRootAccess xAODTracking"を追加する。Makefile.RootCoreを編集した後には、もう一度rc find_packagesを実行する必要がある。その後、rc compileとやってコードをコンパイルする。

xAODファイルに入っている情報

xAODファイルにはATLAS測定器で測定した検出器の情報や、そこから事象を再構成した粒子の情報が保存されている。検出器のヒットや粒子は複数あるものなので、これらの情報のほとんどは、コンテナという形で保存されている。コンテナとはクラス・オブジェクトの配列のようなものである。xAODファイルに実際にどのようなデータが保存されているかを確認するには、checkxAOD.pyというプログラムを利用する。

checkxAOD.py xaod.root

とすると、ファイルに保存されているコンテナとそれに関連づけられたキーの一覧が出力される。

メイン・プログラムの作成

EventLoopとMyxAODAnalysisを使って実際にxAODデータを解析するためには、これらを一つのプログラムとしてまとめ上げるために、もう少し準備が必要である。 MyPackage/util/にtestRun.cxxというファイルを作って、ここにmain関数を書く。

AtlasRun2Analysis (最終更新日時 2016-03-17 08:13:57 更新者 TakanoriKono)

-  ⇤ ← 2015-11-16 12:41:11時点のリビジョン2 → 
  サイズ: 3367
  編集者: TakanoriKono
  コメント:
+   ← 2015-11-23 07:20:42時点のリビジョン10 → ⇥
  サイズ: 7633
  編集者: TakanoriKono
  コメント:
-削除された箇所はこのように表示されます。
+追加された箇所はこのように表示されます。
 行 1:
-= ATLAS Run-2のデータ解析 =
+= ATLAS Run-2データの解析 =

<<TableOfContents()>>
-行 33:
+行 35:
-== !RootCoreの使い方 ==
+== RootCoreの使い方 ==
-行 41:
+行 43:
+=== パッケージの作成 ===
-行 42:
+行 45:
+ここでは、チュートリアルに従って新しく!MyPackageというパッケージ（ライブラリのこと）を作って、その中にMyxAODAnalysisというクラスを作る。
-行 43:
+行 47:
-$ROOTCOREBIN/EventLoop/bin/make_skeleton MyAnalysis
+rc make_skeleton MyPackage
$ROOTCOREBIN/EventLoop/bin/make_skeleton MyxAODAnalysis
-行 45:
+行 50:
+最初のコマンドを実行すると、!RootCoreディレクトリの下に!MyAnalysisというディレクトリが新たに作られ、その下にさらにいくつかのファイルやディレクトリができているはずである。2つ目のコマンドを実行すると、その中にMyPackage/MyxAODAnalysis.h、Root/MyxAODAnalysis.cxxというファイルができる。

!MyPackageや!MyxAODAnalysisという名前は適切なものに変換して使う。

=== データ解析のためのアルゴリズム(C++クラス)の作成 ===
事象解析の基本的な流れは次のようになる。
 1. 初期化 initialize()
  * ヒストグラムの作成など
 1. ファイルにある事象をループ
  * 事象データを基に何か処理を行う execute()
 1. 終了処理 finalize()
  * ヒストグラム・出力ファイルの保存

!EventLoopではファイルから事象データを順番に読み込むための仕組みが用意されている。ユーザーが書くべきコードは、ヒストグラムの作成、データ処理等の解析の内容に関連した部分だけでよい。これらのコードをクラスの決まった関数（initialize, execute, finalize）に記述することで、!EventLoopが適切に呼び出してくれる。上の流れは実際に、もう少し細かいステップに分かれていて、ヒストグラムの作成はhistInitialize()という関数の中で行うとよい。

ATLASの事象データにアクセスするためには、TEventというクラスを利用する。これはMyxAODAnalysisクラスの関数からは
{{{
xAOD::TEvent* event = wk()->event();
}}}
として利用できる。ここから事象のデータを取ってくるには{{{retrieve(...)}}}という関数を利用する。例えば、飛跡（Track）の情報を取ってくるには
{{{
const xAOD::TrackParticleContainer* tracks=0;
if (!event->retrieve(tracks, "TrackParticles").isSuccess()) {
  // エラー
} else {
  // データを処理
  auto p_track = tracks->begin();
  for (; p_track!=tracks->end(); ++p_track) {
    const TrackParticle* track = *p_track;
    // .....
  }
}
}}}
のようにして個々の!TrackParticleオブジェクトにアクセスできる。

xAOD::TEventやxAOD::!TrackParticle等のクラスは、それぞれxAODRootAccess、xAODTrackingというパッケージで定義されているので、!MyPackageがこれらのパッケージに依存することを記述する必要がある。そのためにはMyPackage/cmt/Makefile.!RootCoreの中の"_DEP = "の部分に"xAODRootAccess xAODTracking"を追加する。Makefile.!RootCoreを編集した後には、もう一度{{{rc find_packages}}}を実行する必要がある。その後、{{{rc compile}}}とやってコードをコンパイルする。

=== xAODファイルに入っている情報 ===
xAODファイルにはATLAS測定器で測定した検出器の情報や、そこから事象を再構成した粒子の情報が保存されている。検出器のヒットや粒子は複数あるものなので、これらの情報のほとんどは、コンテナという形で保存されている。コンテナとはクラス・オブジェクトの配列のようなものである。xAODファイルに実際にどのようなデータが保存されているかを確認するには、checkxAOD.pyというプログラムを利用する。
{{{
checkxAOD.py xaod.root
}}}
とすると、ファイルに保存されているコンテナとそれに関連づけられたキーの一覧が出力される。

=== メイン・プログラムの作成 ===
!EventLoopとMyxAODAnalysisを使って実際にxAODデータを解析するためには、これらを一つのプログラムとしてまとめ上げるために、もう少し準備が必要である。
MyPackage/util/にtestRun.cxxというファイルを作って、ここにmain関数を書く。

"AtlasRun2Analysis"の差分