================================================= 4SEASONS(SIK), AMATERAS(AMR)専用 ================================================= :最終更新日: 2022.03.18 概要 ==== 空蟬・非弾性散乱環境とは、空蟬で実装されている非弾性散乱実験でのデータ解析用に作成された一連のソフトウェア環境を指す。主な構成要素としては、 - 解析実行環境ソフトウェア - 可視化ソフトウェア がある。解析実行環境ソフトウェアの要として、SequenceEditorと呼ばれるコマンド実行環境ソフトウェアがあり、そこに登録されているコマンド群を順次実行する事でデータリダクション（データ収集システムが出す生データを処理する過程）を行う。 本マニュアルでは、主にSequenceEditorに登録されている、中性子非弾性散乱のデータ用、特に四季やアマテラス用に作成された解析コマンドを中心に解説を行う。 なお空蟬および非弾性散乱用の環境（四季やアマテラスの環境）の構築には触れない。 解析実行環境の起動 ================== 解析用シーケンサープログラムの起動 ---------------------------------- .. code-block:: shell $ Ana もしくは $ python /opt/mlfsoft/python-utsusemi/ana/Sequencer2.py 基礎知識 ======== イベントデータの保存先（MLFでの測定中もしくは直後） --------------------------------------------------- SIK（四季）、AMR（アマテラス）のイベントデータ保存先を示す。 **データストレージ** - MLFにおけるデフォルトのストレージ（マウント）の場所 /data/XXX (XXXは装置コード) データの扱い ------------ - 各ピクセルのヒストグラムは、X（横軸）、Y（強度）、E（エラー）を一セットとして、ElementContainerと呼ばれる入れ物（データコンテナ）に納められた状態で取り扱う。 - データコンテナは、基本的にPSD毎にまとめられて、ElementContainerArrayと呼ばれるデータコンテナへ登録されている。 - さらにPSDをまとめるElementContainerMatrixデータコンテナへ登録される。 - これらのコンテナは、含まれているフォーマットが等しければ、互いに四則演算が行える。さらに単独での定数倍が行える。 詳細は万葉ライブラリユーザーマニュアル（Japanese Only）を参照のこと。 コマンド一覧 ============ +---------+----------------------------+------------------------------------------------------------------------------------------+ | Group | Commands | | +=========+============================+==========================================================================================+ | DR | GetDataOfWhite | 白色中性子測定のイベントデータをヒストグラム化し、各種補正を行う | | +----------------------------+------------------------------------------------------------------------------------------+ | | GetDataOfMonochroEi | （最初期に作成された関数で現在使用不可能） | | +----------------------------+------------------------------------------------------------------------------------------+ | | GetDataOfMonochroEi2 | 単色中性子測定のイベントデータをヒストグラム化し、各種補正を行う | | +----------------------------+------------------------------------------------------------------------------------------+ | | GetDataOfMonochroEi3 | 上のGetDataOfMonochroEi2の時間スライスができるようにしたもの（現在のデフォルト） | | +----------------------------+------------------------------------------------------------------------------------------+ | | ToPowder | Energy Transferへ変換後のデータに対し円環平均をとる | | +----------------------------+------------------------------------------------------------------------------------------+ | | MakeRunList | 指定したRun Noの測定情報を取り出す | +---------+----------------------------+------------------------------------------------------------------------------------------+ データリダクション連続処理グループ：DR ------------------------------------------ .. toctree:: DRref データリダクション個別処理グループ：Cmm ------------------------------------------ SIK, AMRにおいてCmmグループは、:ref:`「空蟬基本関数リファレンス」` と同じであるので、そちらを参照のこと（それぞれのコマンドにリンクあり）。 - :ref:`GetNeunetHist` 各種パラーメータ指定により、イベントデータの様々なヒストグラム化を行う。全てのヒストグラム化の基礎関数。 - :ref:`DetectorEffi` 検出器の検出効率補正を行う。 - :ref:`GetMultiEi` イベントデータから最小限の処理で入射エネルギーを計算する。複数の入射エネルギーに対応。中身は基本関数の **GetEiFromEvent** である。 - :ref:`GetEi` 指定したPixelをビームモニターと見なし入射エネルギーを計算する。 - :ref:`NormByBeamCurrent` 中性子源への陽子ビーム強度で測定データの規格化を行う。 - :ref:`NormByKickers` イベントデータをヒストグラム化したElementContainerMatrixに対し、中性子発生回数（キッカー数）で規格化する。 - :ref:`SolidAngleCorrection` 各Pixelの計算された立体角で強度を補正。 - :ref:`KiKfCorrection` 散乱因子のki/kf補正を行う。 - :ref:`DoMask` 不要なセグメントを除去するためのマスク処理を行う。 - :ref:`ToPowder` Energy Transferへ変換後のデータに対し円環平均をとる。 - :ref:`RadialCollimatorCorrect` RadialCollimatorによるバックグランドを補正する。 - :ref:`VisContMOutputFileByPhi` 単結晶試料解析のスライスデータを出力する。 - :ref:`BoseFactorCorrection` ボーズ因子の補正を行う。 - :ref:`BoseFactCorrEC` ボーズ因子の補正をElementContainerに対し行う。 - :ref:`DymPDF` 動的対相関関数による処理を行う。 - :ref:`FlexCalc` エネルギー遷移変換後のデータに対し、自由な式で強度の補正を行う。 - :ref:`GetOrigPixelFromQXtalParam` XtalParamファイルによって与えた結晶情報などを利用し、逆格子空間座標(Q,hw)から検出器Pixelを計算する。 - :ref:`GetOrigPixelFromQString` 与えた結晶情報などを利用し、逆格子空間座標(Q,hw)から検出器Pixelを計算する。 - :ref:`CalcYRotAngleFromQXtalParam` XtalParamファイルによって与えた結晶情報などを利用し、逆格子空間座標(Q,hw)を観測するために必要な回転角度と観測されるPixelを計算する。 - :ref:`CalcYRotAngleFromQString` 与えた結晶情報などを利用し、逆格子空間座標(Q,hw)を観測するために必要な回転角度と観測されるPixelを計算する。 - :ref:`SumOfTOF ` あるPSDに対して、飛行時間方向の和をとる。 - :ref:`SumOfPixel` 複数のPixelの和をとる。 - :ref:`PickUpRegion` 特定のPSD,Pixel領域を抜き出して、新しいデータを作成する。 - :ref:`GetPH` GetNeunetHistでパルス波高値込みで作成したデータからパルス波高値を取り出す。 - :ref:`NormByBeam` 中性子源への陽子ビーム強度で測定データの規格化を行う。（測定開始、終了時刻は手入力） - :ref:`getBeamCurrent` 中性子源への陽子ビーム強度を返す。 - :ref:`SaveDataToNxspe` 非弾性散乱処理を行なったデータコンテナ（ElementContainerMatrix）をHoraceのフォーマットであるNXSPEファイルとして書き出す。LoadDataFromNxspe - :ref:`LoadDataFromNxspe` HoraceのフォーマットであるNXSPEファイルを変換して空蟬で使用できるElementContainerMatrixに変換して読み込む。 - :ref:`SaveDataToSPE` データをISISのデータフォーマットのSPEファイルとして書き出す。 - :ref:`SaveDataToManyoBinary` 万葉ライブラリのデータコンテナを万葉ライブラリ標準のバイナリファイルとして書き出す。 - :ref:`LoadDataFromManyoBinary` 万葉ライブラリ標準のバイナリファイルとして書き出されたデータコンテナを読み込む。 - :ref:`SaveDataToDAVEgrp` 与えられたELementContainerMatrixデータをDAVE用のフォーマットに変換して書き出す。 - :ref:`SavePowderDataToText` ToPowder処理されたデータをテキスト出力。 - :ref:`SaveDataToDump` データをファイルに書き出す。 - :ref:`LoadDataFromDump` ファイルに書き出されたデータを読み込む。 - :ref:`SaveDataToSrlz` 与えたElementContainer, -Array, -MatrixデータをManyoライブラリシリアライズフォーマットに書き出す。このフォーマットは非常に高速に読み書きができるが、そのPCの環境に依存するので、他のPC（同じOSでも）で読み込むことはできない。 - :ref:`LoadDataFromSrlz` Manyoライブラリシリアライズフォーマットからデータを取り出す。このフォーマットは非常に高速に読み書きができるが、そのPCの環境に依存するので、他のPC（同じOSでも）で作成されたファイルを読み込むことはできない。 - :ref:`SaveDataToNeXus` NeXusフォーマットで書き出す。 - :ref:`GetDataFromNeXus` NeXusフォーマットのデータを読み込む。 - :ref:`AppendRawDataFiles` 複数のRaw Data（イベントデータ）を結合し、別データとして保存する。 - :ref:`VisContMOutputFigure` VisualContM上でのスライスを行い画像を保存する。 共通データ一般処理（グループ：Com） ------------------------------------------ :ref:`共通データ一般処理（グループ：Com）` を参照のこと。