4SEASONS(SIK), AMATERAS(AMR)専用#

最終更新日

2022.03.18

概要#

空蟬・非弾性散乱環境とは、空蟬で実装されている非弾性散乱実験でのデータ解析用に作成された一連のソフトウェア環境を指す。主な構成要素としては、

  • 解析実行環境ソフトウェア

  • 可視化ソフトウェア

がある。解析実行環境ソフトウェアの要として、SequenceEditorと呼ばれるコマンド実行環境ソフトウェアがあり、そこに登録されているコマンド群を順次実行する事でデータリダクション（データ収集システムが出す生データを処理する過程）を行う。

本マニュアルでは、主にSequenceEditorに登録されている、中性子非弾性散乱のデータ用、特に四季やアマテラス用に作成された解析コマンドを中心に解説を行う。 なお空蟬および非弾性散乱用の環境（四季やアマテラスの環境）の構築には触れない。

解析実行環境の起動#

解析用シーケンサープログラムの起動#

$ 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#

データリダクション個別処理グループ：Cmm#

SIK, AMRにおいてCmmグループは、「空蟬基本関数リファレンス」 と同じであるので、そちらを参照のこと（それぞれのコマンドにリンクあり）。

  • GetNeunetHist

    各種パラーメータ指定により、イベントデータの様々なヒストグラム化を行う。全てのヒストグラム化の基礎関数。

  • DetectorEffi

    検出器の検出効率補正を行う。

  • GetMultiEi

    イベントデータから最小限の処理で入射エネルギーを計算する。複数の入射エネルギーに対応。中身は基本関数の GetEiFromEvent である。

  • GetEi

    指定したPixelをビームモニターと見なし入射エネルギーを計算する。

  • NormByBeamCurrent

    中性子源への陽子ビーム強度で測定データの規格化を行う。

  • NormByKickers

    イベントデータをヒストグラム化したElementContainerMatrixに対し、中性子発生回数（キッカー数）で規格化する。

  • SolidAngleCorrection

    各Pixelの計算された立体角で強度を補正。

  • KiKfCorrection

    散乱因子のki/kf補正を行う。

  • DoMask

    不要なセグメントを除去するためのマスク処理を行う。

  • ToPowder

    Energy Transferへ変換後のデータに対し円環平均をとる。

  • RadialCollimatorCorrect

    RadialCollimatorによるバックグランドを補正する。

  • VisContMOutputFileByPhi

    単結晶試料解析のスライスデータを出力する。

  • BoseFactorCorrection

    ボーズ因子の補正を行う。

  • BoseFactCorrEC

    ボーズ因子の補正をElementContainerに対し行う。

  • DymPDF

    動的対相関関数による処理を行う。

  • FlexCalc

    エネルギー遷移変換後のデータに対し、自由な式で強度の補正を行う。

  • GetOrigPixelFromQXtalParam

    XtalParamファイルによって与えた結晶情報などを利用し、逆格子空間座標(Q,hw)から検出器Pixelを計算する。

  • GetOrigPixelFromQString

    与えた結晶情報などを利用し、逆格子空間座標(Q,hw)から検出器Pixelを計算する。

  • CalcYRotAngleFromQXtalParam

    XtalParamファイルによって与えた結晶情報などを利用し、逆格子空間座標(Q,hw)を観測するために必要な回転角度と観測されるPixelを計算する。

  • CalcYRotAngleFromQString

    与えた結晶情報などを利用し、逆格子空間座標(Q,hw)を観測するために必要な回転角度と観測されるPixelを計算する。

  • SumOfTOF

    あるPSDに対して、飛行時間方向の和をとる。

  • SumOfPixel

    複数のPixelの和をとる。

  • PickUpRegion

    特定のPSD,Pixel領域を抜き出して、新しいデータを作成する。

  • GetPH

    GetNeunetHistでパルス波高値込みで作成したデータからパルス波高値を取り出す。

  • NormByBeam

    中性子源への陽子ビーム強度で測定データの規格化を行う。（測定開始、終了時刻は手入力）

  • getBeamCurrent

    中性子源への陽子ビーム強度を返す。

  • SaveDataToNxspe

    非弾性散乱処理を行なったデータコンテナ（ElementContainerMatrix）をHoraceのフォーマットであるNXSPEファイルとして書き出す。LoadDataFromNxspe

  • LoadDataFromNxspe

    HoraceのフォーマットであるNXSPEファイルを変換して空蟬で使用できるElementContainerMatrixに変換して読み込む。

  • SaveDataToSPE

    データをISISのデータフォーマットのSPEファイルとして書き出す。

  • SaveDataToManyoBinary

    万葉ライブラリのデータコンテナを万葉ライブラリ標準のバイナリファイルとして書き出す。

  • LoadDataFromManyoBinary

    万葉ライブラリ標準のバイナリファイルとして書き出されたデータコンテナを読み込む。

  • SaveDataToDAVEgrp

    与えられたELementContainerMatrixデータをDAVE用のフォーマットに変換して書き出す。

  • SavePowderDataToText

    ToPowder処理されたデータをテキスト出力。

  • SaveDataToDump

    データをファイルに書き出す。

  • LoadDataFromDump

    ファイルに書き出されたデータを読み込む。

  • SaveDataToSrlz

    与えたElementContainer, -Array, -MatrixデータをManyoライブラリシリアライズフォーマットに書き出す。このフォーマットは非常に高速に読み書きができるが、そのPCの環境に依存するので、他のPC（同じOSでも）で読み込むことはできない。

  • LoadDataFromSrlz

    Manyoライブラリシリアライズフォーマットからデータを取り出す。このフォーマットは非常に高速に読み書きができるが、そのPCの環境に依存するので、他のPC（同じOSでも）で作成されたファイルを読み込むことはできない。

  • SaveDataToNeXus

    NeXusフォーマットで書き出す。

  • GetDataFromNeXus

    NeXusフォーマットのデータを読み込む。

  • AppendRawDataFiles

    複数のRaw Data（イベントデータ）を結合し、別データとして保存する。

  • VisContMOutputFigure

    VisualContM上でのスライスを行い画像を保存する。

共通データ一般処理（グループ：Com）#

共通データ一般処理（グループ：Com） を参照のこと。