.. _CUI_UtsusemiD4Matrix2:
============================================================
D4Mat2Slicer（Step By Step測定及び連続回転測定）用コマンド
============================================================

**（2026/3/19更新 作成中）**

.. contents:: 目次
    :depth: 2

多次元系単結晶試料に対する非弾性散乱測定において、広い運動量空間をカバーするためには、試料に対する入射中性子の方位の異なる測定を複数回行い一つの運動量エネルギー空間にあるものとみなしてデータを扱う必要がある。

その測定手法には２種類、 *Step By Step測定* と *連続回転測定* とがある。これらの測定データを処理するソフトウェアとして、 **D4mat2Slicer** （ 参照： :ref:`「D4mat2Slicerマニュアル」<D4Mat2Slicer>` があるが、本章ではそのコマンドラインインターフェースを紹介する。

使用される関数（C++クラス）は、 **UtsusemiD4Matrix2** である。


項目
============================================================
1. データ読み込みから射影処理（バイナリデータ保存も）
3. データスライス（畳み込み処理も含む）
4. そのほか（D4Mat形式への書き出し）



1. データ読み込みから射影処理
============================================================

-----------------------------
1-1 Step-by-Step測定
-----------------------------

Step By Step測定のデータを利用する場合に使用できるものを紹介する。

:ref:`「多次元系単結晶試料非弾性散乱測定（回転測定）のデータ処理（Step-by-Step法）」<D4Mat_StepByStep>` でも使用される RunListファイルを利用して処理を行うスクリプトである。

そのため、D4Mat変換用ファイル（vbinファイル）を作成するスクリプト（Extractスクリプト）とよく似た構造であり、特にRunListファイルを処理する部分は全く同じである。

処理として想定している流れとしては以下のようなものである。

1. RunListファイルを利用してそれぞれのRun情報とゴニオの角度情報を取り出す
2. スクリプトに記述したパラメータと1.の情報を利用してそれぞれのデータをヒストグラム化し、角度情報とともに取り込む
3. スクリプトに記述した試料情報を利用し、射影処理を行う
4. 2Dスライス及び可視化を行う
5. D4MatSlicerで可視化できるD4Matデータを出力する。


大雑把にいえば、D4Mat用のスクリプト（いわゆる *Extract_runlist.py* ）との相違点は、vbinファイルを書き出すコマンドである

.. code-block:: python

    Cmm.VisContMOutputFileByPhi(DAT, XtalParam, PhiValue, savePath)

の部分をD4Mat2へ取り込むためのコマンド

.. code-block:: python

    D4M.ImportEcmStepByStep( DAT, PhiValue, str(PhiValue) ) # 非弾性処理済みデータを回転角度とともに入力

に置き換えるところと、射影処理の部分

.. code-block:: python

    D4M.SetD4MatSampleInfo( LatticeConst, Uvector, Vvector, RotateSteps ) # 試料情報の入力
    D4M.Projection( ProjAxes )                                  # 射影処理の実行


である。

サンプルコード (1-1)
------------------------------------

上記のステップのうち

1. RunListファイルを利用してそれぞれのRun情報とゴニオの角度情報を取り出す
2. スクリプトに記述したパラメータと1.の情報を利用してそれぞれのデータをヒストグラム化し、角度情報とともに取り込む
3. スクリプトに記述した試料情報を利用し、射影処理を行う

を行うコードを示す。


.. code-block:: python
    :caption: D4MatSlicer command script (1-1)
    :name: A-1.py

    #! /usr/bin/env python3
    from __future__ import print_function
    import os
    import sys
    import DR
    import Cmm
    import Manyo
    import Manyo.Utsusemi as mu
    import utsusemi.ana.Reduction.BaseCommandsInEla as BC

    #####################
    # modify here
    ####################
    Ei=50.0151
    HW_bin = 0.3
    HW_min = -0.5
    HW_max = 35.7
    maskfile = "default"
    normFactor = 1000000.0
    time_indep_bg = "TOF:None"
    detect_effi = "SIK-SUS304-3He-PSD.dat"
    gonioValueAtZero = 20.294

    # Sample Info
    LatticeConst = [3.62284, 3.62284, 3.62284, 90.0, 90.0, 90.0]
    Uvector = [1.0, 0.0, 0.0]
    Vvector = [0.0, 1.0, 1.0]
    RotateSteps = [] # [<Ax No.>, <angle>, (<Ax No.>, <angle> ...)]  <Ax No.> 0:"X", 1:"Y", 2:"Z"
    ProjAxes = [1.0, 0.0, 0.0, 0.0,
                0.0, 1.0, 1.0, 0.0,
                0.0,-1.0, 1.0, 0.0,
                0.0, 0.0, 0.0, 1.0]
    AxTitles = ["Q1", "Q2", "Q3", "hw"]
    AxUnits = ["rlu", "rlu", "rlu", "meV"]

    # for data save
    outXtalParam = "XtalParam_A-1.xml"
    outFile = "Sample_A-1.d4mz"

    ############################
    argv = sys.argv
    print("len(argv)={}".format(len(argv)))

    listFileName=""
    if len(argv)==2:
        if os.path.exists(argv[1]):
            listFileName=argv[1]
            print("RunList=[]".format(listFileName))
        else:
            raise UserWarning("Not found file=%s"%(argv[1]))
    else:
        print("Usage::")
        print("        $ ./{} <filename of runlist>".format(argv[0]))
        print("        ")
        print("        $ python {} <filename of runlist>".format(argv[0]))
        sys.exit(0)

    paramDic = {"normFactor":normFactor,"gonio":gonioValueAtZero}
    AngleList, condsDict = BC.LoadRunListToExtract(listFileName, paramDic, mergeAngles=True)
    DataReductParams = [-1, -1, Ei, HW_bin, HW_min, HW_max, -1, -1, -1]

    # Data Reduction
    D4M = mu.UtsusemiD4Matrix2()               # D4matSlicer2のコマンドを実行するための用意
    D4M.isDirectGeometry = True                # 測定手法が直接配置型(Direct Geometry)ならTrue, 逆転配置型(Inverted Geometry)ならFalse
    D4M.ClearAll()                             # データのクリア（念のため）
    # D4M.LoadData(outFile)                    # 以前のデータに追記する場合に読み込み

    D4M.SetD4MatMode(1) # 1 means Step-by-Step mode
    D4M.SetD4MatSampleInfo(LatticeConst, Uvector, Vvector, RotateSteps) # 試料情報の入力
    D4M.SetD4MatDataReductionStepByStepGonioAtZero(gonioValueAtZero)
    D4M.SetD4MatDataReductionInfo(DataReductParams) # For records
    D4M.SetD4MatDataReductionOptions(maskfile, normFactor, time_indep_bg, detect_effi)

    for angle_key in AngleList:
        angle = float(angle_key)
        runNos = condsDict[angle_key][0]
        norm = condsDict[angle_key][1]
        print("==============[ {:s}:{:8.3f},{:10.5f} ]".format(runNos,angle,norm))
        DAT = DR.GetDataOfMonochroEi3(runNos, Ei, HW_bin, "{:g} {:g}".format(HW_min,HW_max),
                                      MaskFile=maskfile, NormFactor=norm)
        D4M.ImportEcmStepByStep(DAT, angle, norm, normFactor) # 非弾性処理済みデータを入力
        del DAT # 入力済みのデータは削除（推奨）

    # Projection
    if D4M.SetD4MatProjectionAxesInfo(ProjAxes, AxTitles, AxUnits): # 射影処理情報の入力
        D4M.Projection(ProjAxes) # 射影処理の実行

    # Save Data
    D4M.SaveXtalParam(outXtalParam)     # ここまでの設定をXtalParamに保存する
    D4M.SaveData(outFile, True)         # d4mzファイル（D4Mat2用バイナリ）に圧縮形式(True)で保存

もしデータをファイルに保存すれば、そのままD4Mat2Slicerから読み込むことができ、すぐにProjectionやSliceができる。

^^^^^^^^^^^^^^^^^^^^^^
使用上の注意と問題点
^^^^^^^^^^^^^^^^^^^^^^
ただし、以下にあげるような問題点（未実装）がある。

..
  - XtalParamとの連携が不十分

  - 個別に取り込んだRunのメタ情報（RunNOやGonio角度、Proton数など）がXtalParamの情報として反映されない（修正予定）
  - Eiやhwの範囲などの情報も同様（修正予定）
  - データ保存用として既存のXtalparamを登録する( *D4M.SetXtalParam(XtalParam)* )ことはできるが、あくまでD4MatSlicerで読み込んだときに格子定数やUV情報、射影、スライスの情報を示すためだけである。

- 既存のd4m/d4mzデータファイルに追記する形で利用する場合、同じ角度のデータであってもマージされないため、再度d4mデータファイルに保存するとサイズが大きくなる

  - これはD4Mat2Slicerでも同様であると思われるが未確認
  - 大きな仕様変更が必要なため、当面の修正は行わない
  - 同じ角度を何度も測定する場合、一連の測定が終了したときに最初から処理しなおした方が良い





-------------------------------------
1-2 連続回転測定
-------------------------------------

連続回転測定のデータを処理する場合に使用するものを紹介する。

1. 測定情報をパラメータとしてデータを角度毎のヒストグラムに落とし込む処理をする (Data Reduction)
2. 試料の情報を利用してヒストグラムデータを見たい座標に射影する (Projection)
3. 射影データを2Dスライスする＋プロットする
4. 連続回転測定のデータを別フォーマットにする（例：Nxspe）

.. 5. 射影データを3Dスライスしてテキストファイルに保存する（未記載）

サンプルコード(1-2)
------------------------------------

連続回転測定のデータ処理のステップのうち

1. 測定情報をパラメータとしてデータを角度毎のヒストグラムに落とし込む処理をする (Data Reduction)
2. 試料の情報を利用してヒストグラムデータを見たい座標に射影する (Projection)

を行うものである。

なお、このコードではそれぞれの角度に分解された全てのヒストグラムに対してデフォルトのデータリダクション処理を行なっている。


このスクリプトの使い方としては、下の３項目のパラメータを修正して空蝉環境で実行する。

- Run Information（Run Noと、測定開始時の角度）

  - `RunNoAngleList` に RunNoと測定開始時の試料の角度をタプルで指定（ `(64930, 0.0)` ）し、そのリストを作る（ `[(64930, 0.0), (64931, 20.0)]` ）

- Data Reductionに必要なパラメータ（Eiやhwのbin情報、角度の分割方法など）
- Sample Informationとして格子定数などのパラメータ

これらの設定以降は処理コマンドが並ぶ。

- ヒストグラム作成
- データリダクションとD4Mat2データへの変換
- 射影処理（Projection）
- D4Mat2データファイル保存

以下のように実行する。

```
$ python3 Sample-1-2.py
```


.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (1-2)
    :name: Sample-1-2.py

    #!/usr/bin/python
    # -*- coding: utf-8 -*-
    import Manyo
    import Manyo.Utsusemi as mu
    from utsusemi.vis.D4Mat2SlicerQ import D4Mat2Utils, PutDefaultMaskFile
    import sys
    import Cmm

    ############################
    # Run inforamtion
    # list of RunNo with the angle value at the beginning of the measurement
    ############################
    RunNoAngleList = [(64930, 0.0), (64931, 20.0)] # list of (<run no>, <st_ang>)
    #RunNoAngleList = [(64930, 0.0)] # list of (<run no>, <st_ang>)

    ############################
    # Data Reduction parameters
    ############################
    Ei = 50.0     #[meV]
    HW_min = 0.0  #[meV]
    HW_max = 40.0 #[meV]
    HW_bin = 0.4  #[meV]

    mask_file = "default"
    norm_factor = 1e+06
    time_indep_bg = "TOF:None"
    detect_effi = "SIK-SUS304-3He-PSD.dat"

    min_ang = -31.0  #[degree]
    max_ang = 115.0  #[degree]
    step_ang = 0.5   #[degree]

    t_start = -1   #[seconds]
    t_end = -1     #[seconds]

    dio = 1 #[TrigNET signal DIO]
    multh = 2 # Multi threadings on histogram creationa

    ############################
    # Sample Info
    ############################
    LatticeConst = [3.615, 3.615, 3.615, 90.0, 90.0, 90.0]
    Uvector = [1.0, 0.0, 0.0]
    Vvector = [0.0, 1.0, 1.0]
    RotateSteps = [] # [<Ax No.>, <angle>, (<Ax No.>, <angle> ...)]  <Ax No.> 0:"X", 1:"Y", 2:"Z"
    ProjAxes = [1.0, 0.0, 0.0, 0.0,
                0.0, 1.0, 1.0, 0.0,
                0.0, 1.0,-1.0, 0.0,
                0.0, 0.0, 0.0, 1.0]
    AxTitles = ["Q1", "Q2", "Q3", "hw"]
    AxUnits = ["rlu", "rlu", "rlu", "meV"]

    ############################
    # For data save
    ############################
    outXtalParam = "XtalParam_B-1.xml"
    outFile = "Sample_B-1.d4mz"

    ############################
    data_dir = "/home/yinamura/data"
    ############################

    ################################
    # Histogram creation from raw data files
    ################################

    # Make parameter files
    st_Params = "hw,%f,%f,%f,%f"%((Ei, HW_min, HW_max, HW_bin))
    DU = D4Mat2Utils()
    wfile, dfile = DU.MakeTempInfoFiles(RunNoAngleList[0][0], st_Params, time_indep_bg)

    ## Create histogram using with the pair of runNo and st_ang
    EDC = mu.UtsusemiEventDataConverterNeunet()
    EDC.LoadParamFiles(wfile, dfile)
    T0List = [] # to store the number of kickers for each run
    for i in range(len(RunNoAngleList)):
        runNo, st_ang = RunNoAngleList[i]
        print(" ---- create histogram runNo = {}, st_angle = {}".format(runNo, st_ang))
        cfile = DU.MakeCaseInfoFile(st_ang, min_ang, max_ang, step_ang, runNo, dio)
        EDC.SetCaseInfoParams(cfile)

        if t_start < 0 and t_end < 0:
            pass
        else:
            if not EDC.SetRangeOfSingleTimeSlicing(t_start, t_end):
                msg = "TimeSlicing arguments are invalid : " + str(t_start) + "," + str(t_end)
                raise UserWarning(msg)

        EDC.LoadTrignetEventFile(runNo, data_dir, "")
        if i == 0:
            EDC.SetHistAllocation(multh)
        EDC.LoadEventDataFiles(runNo, data_dir, "")
        T0List.append(EDC.PutCaseDecoder().PutNumOfT0ListInCases())

    DataReductParams = [t_start, t_end, Ei, HW_bin, HW_min, HW_max, min_ang, max_ang, step_ang]

    print( " ------------ Histogram Creatation finishes" )

    ################################
    # Create parameters to import data
    ################################

    # Make angles and kickers information
    num_of_cases = EDC.PutNumOfCases()
    case_list = EDC.PutListOfCounterConditions()

    # Case ID (IND) and angles (PHI)
    IND = Manyo.MakeUInt4Vector()
    PHI = Manyo.MakeDoubleVector()
    for i in range(num_of_cases):
        IND.push_back(i + 1)
        PHI.push_back((case_list[(i + 1) * 2] + case_list[(i + 1) * 2 + 1 ]) / 2.0)
    # The number of kickers at each angle
    KIC = Manyo.MakeDoubleVector(T0List[0].size())
    for i in range(T0List[0].size()):
        KIC[i] = 0.0
    for i in range(len(T0List)):
        for j in range(KIC.size()):
            KIC[j] += T0List[i][j]

    # Create mask info
    if mask_file.lower() != "default":
        mask_path = mu.FindParamFilePath(mask_file)
    else:
        mask_path = PutDefaultMaskFile(runNo)

    # Get parameter for Solid Angle Corrections
    dOmega = 1.0
    hh = Manyo.HeaderBase()
    if EDC.AddRunInfoToHeader(hh):
        L2 = hh.PutDouble("TypicalL2")
        dS = hh.PutDouble("TypicalDS")
        dOmega = dS/(L2*L2)

    ################################
    # Import Histogram into D4Mat2 data
    ################################

    D4M = mu.UtsusemiD4Matrix2()
    D4M.isDirectGeometry = True

    # Add runNo and angle into XtalParam.xml
    D4M.SetD4MatDataReductionContinuosClearRunNo()
    for runNo, st_ang in RunNoAngleList:
        D4M.SetD4MatDataReductionContinuosAddRunNo(runNo, st_ang)

    # Do import of raw histograms, included EDC, and do the data reduction, then convert to D4Mat2 data.
    D4M.SetD4MatParameters(runNo, DataReductParams, LatticeConst, Uvector, Vvector, RotateSteps)
    D4M.ImportEcmsContRot(EDC, IND, PHI, KIC, mask_path, dOmega, norm_factor, detect_effi)
    print( " ------------ Import data finishes" )

    ################################
    # Do Projection
    ################################
    D4M.SetD4MatProjectionAxesInfo(ProjAxes, AxTitles, AxUnits)
    D4M.Projection(ProjAxes)
    print( " ------------ Projection finishes" )

    ################################
    # Save Data
    ################################
    D4M.SaveXtalParam(outXtalParam)     # ここまでの設定をXtalParamに保存する
    print( "------------- Save XtalParam.xml")
    D4M.SaveData(outFile, True)         # d4mzファイル（D4Mat2用バイナリ）に圧縮形式(True)で保存




サンプルコード(1-2a)
-------------------------
サンプルコード(1-2)のようにデフォルトのデータリダクションを行うのではなく、独自の処理をしたい場合は、(1-2)の

::

    ################################
    # Import Histogram into D4Mat2 data
    ################################


より後の部分を以下のように書き換えれば良い。

.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (1-2a)
    :name: Sample-1-2a.py

    ################################
    # Import Histogram into D4Mat2 data
    ################################

    D4M = mu.UtsusemiD4Matrix2()
    D4M.isDirectGeometry = True

    # Add runNo and angle into XtalParam.xml
    D4M.SetD4MatDataReductionContinuosClearRunNo()
    for runNo, st_ang in RunNoAngleList:
        D4M.SetD4MatDataReductionContinuosAddRunNo(runNo, st_ang)

    # Do import of raw histograms, included EDC, and do the data reduction, then convert to D4Mat2 data.
    D4M.SetD4MatParameters(runNo, DataReductParams, LatticeConst, Uvector, Vvector, RotateSteps)

    # Data Reduction for each angle data and Import
    D4M.AllocateD4MatPseudoOnLine(num_of_cases)
    for i in range(num_of_cases):
        # Pick out a Histogram data at an angle
        DAT = Manyo.ElementContainerMatrix()
        EDC.SetElementContainerMatrix(DAT, IND[i])

        # Do Default Data Reduction
        DR = mu.UtsusemiReductionInEla(DAT)
        DR.CalcPhi()
        DAT.PutHeaderPointer().OverWrite(mu.UTSUSEMI_KEY_HEAD_KICKERCOUNT, KIC[IND[i]])
        Cmm.dHWCorrection(dat=DAT)
        Cmm.SolidAngleCorrection(dat=DAT)
        Cmm.KiKfCorrection(dat=DAT)
        Cmm.DoMask(dat=DAT,filename=mask_path)
        Cmm.NormByKickers(dat=DAT,factor=norm_factor)
        Cmm.DetectorEffi(dat=DAT, dataFile=detect_effi)
        # Other Reduction commands
        """
        # if you want to save a histogram data as nxspe file,
        fname = "Run{:06d}_ang{:08.3f}.nxspe".format(runNo, PHI[i])
        params = "PSI:0.0,TEMP:300.0,USER:mlfuser"
        Cmm.SaveDataToNxspe(dat=DAT, path="./", filename=fname, params=params)
        """
        # Import histogram for each angle into D4Mat2
        D4M.ImportEcmStepByStep(DAT, PHI[i], "{}".format(IND[i]), False)
        del DAT

    print( " ------------ Import all data finishes" )

    # Do Projection
    D4M.SetD4MatProjectionAxesInfo(ProjAxes, AxTitles, AxUnits)
    D4M.Projection(ProjAxes)
    print( " ------------ Projection finish" )



2. データスライス
============================================================

射影されたデータ(Sample-1-1, Sample-1-2)を二次元スライスする。

(Sample-1-1)や(Sample-1-2)に続いて下記を加えると、射影されたデータに対して二次元データスライスが実行され、二次元プロッタにて表示される。



スライスに必要な各軸のパラメータの与え方は :ref:`「運動量エネルギー空間への射影に関連するコマンド」<CUI_UtsusemiSqeCalc>` と同等である。

また画像保存にはM2Plot+（:ref:`詳細 <VisM2PlotPlus_TOP>`）のCUI機能を用いている（詳細はこちら :ref:`「M2Plot+のCUI操作」<M2PlotPlusCui_TOP>`）


.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (2-1)
    :name: Sample-2-1.py

    # 本スクリプトは(1-1), (1-2), (1-2a)に追記すると動作する

    # ただし保存されたデータファイルを読み込んでスライスする場合は下記のコメントアウトを外して利用する
    '''
    import Manyo
    import Manyo.Utsusemi as mu

    D4M = mu.UtsusemiD4Matrix2()               # D4matSlicer2のコマンドを実行するための用意
    D4M.isDirectGeometry = True                # 測定手法が直接配置型(Direct Geometry)ならTrue, 逆転配置型(Inverted Geometry)ならFalse
    D4M.ClearAll()                             # データのクリア（念のため）
    D4M.LoadData("/path/to/file.d4mz")         # 保存されたd4mzファイル（D4Mat2用バイナリ）の読み込み
    D4M.Projection()                           # 射影処理実行
    '''

    # Slice on D4Matrix2
    ## Get maximum range of D4Matrix2 data axes
    limRange = D4M.GetAxLimit()

    # 2D slice test
    ## Make parameters for slicing
    Ax1_slice = ["X", limRange[0], limRange[1], 0.02]
    Ax2_slice = ["T", -0.1, 0.1] # max range [limRange[2], limRange[3]]
    Ax3_slice = ["T", -0.1, 0.1] # max range [limRange[4], limRange[5]]
    Ax4_slice = ["Y", 0.0, 40.0, 0.4]
    DiagFold = []
    AxUnits = ["rlu", "rlu", "rlu", "meV"]

    # Do Slice and plot
    # create empty data container
    sliced_eca = Manyo.ElementContainerArray()

    # Do slice
    if D4M.Slice2d( sliced_eca, Ax1_slice, Ax2_slice, Ax3_slice, Ax4_slice, DiagFold, AxUnits ):
        import uGao.M2PlotPlusCui as mp
        p=mp.M2PlotPlusCui(sliced_eca)
        p.ShowData()
        del p

        ## Save sliced data as PNG figure file   # 夕顔で表示させずに画像だけ保存も可能
        import uGao.U2IFInDark as UIF
        p = UIF.U2IFInDark()
        p.SetKeys("ax3", "ax4", "Intensity")     # 横軸、縦軸のキー("ax1", "ax2", "ax3", "ax4")、および強度のキー
        p.SetData(sliced_eca)                    # データの読み込み
        p.SetRange(False, 0.0, 40.0)             # 強度の範囲指定（最初のFalseはAuto Scaleはしないの意味）
        p.SetTitles("Test Data", "SubTitle")     # TitleとSubTitle
        p.SetLabels("Qa (rlu)", "hw (meV)")      # 軸のラベル
        # p.SetColorMap("turbo")                 # カラーマップ ('Default', 'autumn', 'winter', 'gray', 'haxby', 'terrain', 'turbo')
        # p.SetSmoothing(True, 2, 1)             # スムージング (<Flag>, <WindowSize>, <Times>) （2026/1/23以降の空蝉）
        p.SaveFile("TestData_A-2.png")               # 画像ファイルとして保存
        del p
    else:
        print("## Slice failed.")


-----------------------------
畳み込み機能について
-----------------------------

畳み込み機能を利用したい場合、GUIで指定できるものと同様に、以下の機能が使用できる。

A. 各軸に垂直な面での折りたたみ
B. 指定した2軸に対して対角線の畳み込み
C. 指定した2軸に対して回転の畳み込み

A. 各軸に垂直な面での折りたたみ
-------------------------------------------
この畳み込みの場合、Sample-2-1で指定している、 `Ax1_slice` などに与えるパラメータを増やすことで対応する。

例：Ax1の軸に対して原点で垂直な面での折りたたみの場合、GUIで与えるように `0.0` を引数として追加する

```
  Ax1_slice = ["X", limRange[0], limRange[1], 0.02]
→
  Ax1_slice = ["X", limRange[0], limRange[1], 0.02, 0.0]
```

例：Ax3の軸に対して0.0から1.0の間に折りたたむ場合は、GUIでは `1.0` を与える。コマンドでも同様である。

```
  Ax3_slice = ["T", -0.1, 0.1]
→
  Ax3_slice = ["T", -0.1, 0.1, 1.0]
```

詳細は、


B. 指定した2軸に対して対角線の畳み込み
--------------------------------------------------

```
  DiagFold = []
→
  DiagFold = [<TypeOfFold>, <X' axis>, <Y' axis>[, <Angle range 1>, <Angle range 2>]]
```


















サンプルコード(A-2)
------------------------------------
前述の射影まで処理スクリプトに以下のコードを加えると、2Dスライス＋プロット（正確にはプロットの画像ファイルの保存）を行うことができる。
すなわち前述の

4. 2Dスライス及び可視化を行う

を行うためのスクリプトである。

スライスに必要な各軸のパラメータの与え方は :ref:`「運動量エネルギー空間への射影に関連するコマンド」<CUI_UtsusemiSqeCalc>` と同等である。

また画像保存にはM2Plot+（:ref:`詳細 <VisM2PlotPlus_TOP>`）のCUI機能を用いている（詳細はこちら :ref:`「M2Plot+のCUI操作」<M2PlotPlusCui_TOP>`）

.. code-block:: python
    :caption: D4MatSlicer command script (A-2)
    :name: A-2.py

    # 本スクリプトはA-1に追記すると動作する

    # ただし保存されたデータファイルを読み込んでスライスする場合は下記のコメントアウトを外して利用する
    '''
    import Manyo
    import Manyo.Utsusemi as mu

    D4M = mu.UtsusemiD4Matrix2()               # D4matSlicer2のコマンドを実行するための用意
    D4M.isDirectGeometry = True                # 測定手法が直接配置型(Direct Geometry)ならTrue, 逆転配置型(Inverted Geometry)ならFalse
    D4M.ClearAll()                             # データのクリア（念のため）
    D4M.LoadData("/path/to/file.d4mz")         # 保存されたd4mzファイル（圧縮型D4Mat2用バイナリ）の読み込み

    '''

    # Slice 2D
    ax1 = ["T", -0.420 ,2.350]
    ax2 = ["T", -0.876 ,3.006]
    ax3 = ["X", -0.916 ,0.841 ,0.02]
    ax4 = ["Y", -0.600 ,35.70 ,0.3]
    ax_dFold = []
    ax_units = ["rlu", "rlu", "rlu", "meV"]

    # スライスデータを入れる入れ物（データコンテナ）を用意
    sliced_eca = Manyo.ElementContainerArray()

    # スライスの実行
    if D4M.Slice2d(sliced_eca, ax1, ax2, ax3, ax4, ax_dFold, ax_units):
        print("## Slice succeeded.")
        ## Plot sliced data on display with GUI
        import uGao.M2PlotPlusCui as mp          # 夕顔のGUIを起動してプロットする
        p = mp.M2PlotPlusCui(sliced_eca)
        p.ShowData()
        p.SetLabels("Qa", "Qb")
        del p

        ## Save sliced data as PNG figure file   # 夕顔で表示させずに画像だけ保存も可能
        import uGao.U2IFInDark as UIF
        p = UIF.U2IFInDark()
        p.SetKeys("ax3", "ax4", "Intensity")     # 横軸、縦軸のキー("ax1", "ax2", "ax3", "ax4")、および強度のキー
        p.SetData(sliced_eca)                    # データの読み込み
        p.SetRange(False, 0.0, 40.0)             # 強度の範囲指定（最初のFalseはAuto Scaleはしないの意味）
        p.SetTitles("Test Data", "SubTitle")     # TitleとSubTitle
        p.SetLabels("Qa (rlu)", "hw (meV)")      # 軸のラベル
        # p.SetColorMap("turbo")                 # カラーマップ ('Default', 'autumn', 'winter', 'gray', 'haxby', 'terrain', 'turbo')
        # p.SetSmoothing(True, 2, 1)             # スムージング (<Flag>, <WindowSize>, <Times>) （2026/1/23以降の空蝉）
        p.SaveFile("TestData_A-2.png")               # 画像ファイルとして保存
        del p
    else:
        print("## Slice failed.")


サンプルコード(A-3)
---------------------------------------------
前述の射影まで処理スクリプトに以下のコードを加えると、D4Matデータへの書き出しが行える。

5. D4MatSlicerで可視化できるD4Matデータを出力する。

.. code-block:: python

    ### Make D4Mat data
    v = D4M.PutQRange()

    ax1 = [v[0], v[1], 0.1]
    ax2 = [v[2], v[3], 0.1]
    ax3 = [v[4], v[5], 0.02]
    ax4 = [v[6], v[7], 0.3]
    titles = ["Qa", "Qb", "Qc", "Energy"]
    units = ["rlu", "rlu", "rlu", "meV"]
    data_dir = "./D4Mat"
    paramfile = "D4Mat.xml"

    ret = D4M.AllocateD4MatOnDisk(ax1, ax2, ax3, ax4, titles, units, data_dir, paramfile)
    if ret:
        print("Suceeded to output D4Mat data")



-------------------------------------
サンプルコード（連続回転測定用）
-------------------------------------

連続回転測定のデータを処理する場合に使用するものを紹介する。

1. 測定情報をパラメータとしてデータを角度毎のヒストグラムに落とし込む処理をする (Data Reduction)
2. 試料の情報を利用してヒストグラムデータを見たい座標に射影する (Projection)
3. 射影データを2Dスライスする＋プロットする
4. 連続回転測定のデータを別フォーマットにする（例：Nxspe）

.. 5. 射影データを3Dスライスしてテキストファイルに保存する（未記載）

サンプルコード(B-1)
------------------------------------

連続回転測定のデータ処理のステップのうち

1. 測定情報をパラメータとしてデータを角度毎のヒストグラムに落とし込む処理をする (Data Reduction)
2. 試料の情報を利用してヒストグラムデータを見たい座標に射影する (Projection)

を行うものである。

なお、このコードではそれぞれの角度に分解された全てのヒストグラムに対してデフォルトのデータリダクション処理を行なっている。


このスクリプトの使い方としては、下の３項目のパラメータを修正して空蝉環境で実行する。

- Run Information（Run Noと、測定開始時の角度）

  - `RunNoAngleList` に RunNoと測定開始時の試料の角度をタプルで指定（ `(64930, 0.0)` ）し、そのリストを作る（ `[(64930, 0.0), (64931, 20.0)]` ）

- Data Reductionに必要なパラメータ（Eiやhwのbin情報、角度の分割方法など）
- Sample Informationとして格子定数などのパラメータ

これらの設定以降は処理コマンドが並ぶ。

- ヒストグラム作成
- データリダクションとD4Mat2データへの変換
- 射影処理（Projection）
- D4Mat2データファイル保存

以下のように実行する。

```
$ python3 Sample-B-1.py
```


.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (B-1)
    :name: Sample-B-1.py

    #!/usr/bin/python
    # -*- coding: utf-8 -*-
    import Manyo
    import Manyo.Utsusemi as mu
    from utsusemi.vis.D4Mat2SlicerQ import D4Mat2Utils, PutDefaultMaskFile
    import sys
    import Cmm

    ############################
    # Run inforamtion
    # list of RunNo with the angle value at the beginning of the measurement
    ############################
    RunNoAngleList = [(64930, 0.0), (64931, 20.0)] # list of (<run no>, <st_ang>)
    #RunNoAngleList = [(64930, 0.0)] # list of (<run no>, <st_ang>)

    ############################
    # Data Reduction parameters
    ############################
    Ei = 50.0     #[meV]
    HW_min = 0.0  #[meV]
    HW_max = 40.0 #[meV]
    HW_bin = 0.4  #[meV]

    mask_file = "default"
    norm_factor = 1e+06
    time_indep_bg = "TOF:None"
    detect_effi = "SIK-SUS304-3He-PSD.dat"

    min_ang = -31.0  #[degree]
    max_ang = 115.0  #[degree]
    step_ang = 0.5   #[degree]

    t_start = -1   #[seconds]
    t_end = -1     #[seconds]

    dio = 1 #[TrigNET signal DIO]
    multh = 2 # Multi threadings on histogram creationa

    ############################
    # Sample Info
    ############################
    LatticeConst = [3.615, 3.615, 3.615, 90.0, 90.0, 90.0]
    Uvector = [1.0, 0.0, 0.0]
    Vvector = [0.0, 1.0, 1.0]
    RotateSteps = [] # [<Ax No.>, <angle>, (<Ax No.>, <angle> ...)]  <Ax No.> 0:"X", 1:"Y", 2:"Z"
    ProjAxes = [1.0, 0.0, 0.0, 0.0,
                0.0, 1.0, 1.0, 0.0,
                0.0, 1.0,-1.0, 0.0,
                0.0, 0.0, 0.0, 1.0]
    AxTitles = ["Q1", "Q2", "Q3", "hw"]
    AxUnits = ["rlu", "rlu", "rlu", "meV"]

    ############################
    # For data save
    ############################
    outXtalParam = "XtalParam_B-1.xml"
    outFile = "Sample_B-1.d4mz"

    ############################
    data_dir = "/home/yinamura/data"
    ############################

    ################################
    # Histogram creation from raw data files
    ################################

    # Make parameter files
    st_Params = "hw,%f,%f,%f,%f"%((Ei, HW_min, HW_max, HW_bin))
    DU = D4Mat2Utils()
    wfile, dfile = DU.MakeTempInfoFiles(RunNoAngleList[0][0], st_Params, time_indep_bg)

    ## Create histogram using with the pair of runNo and st_ang
    EDC = mu.UtsusemiEventDataConverterNeunet()
    EDC.LoadParamFiles(wfile, dfile)
    T0List = [] # to store the number of kickers for each run
    for i in range(len(RunNoAngleList)):
        runNo, st_ang = RunNoAngleList[i]
        print(" ---- create histogram runNo = {}, st_angle = {}".format(runNo, st_ang))
        cfile = DU.MakeCaseInfoFile(st_ang, min_ang, max_ang, step_ang, runNo, dio)
        EDC.SetCaseInfoParams(cfile)

        if t_start < 0 and t_end < 0:
            pass
        else:
            if not EDC.SetRangeOfSingleTimeSlicing(t_start, t_end):
                msg = "TimeSlicing arguments are invalid : " + str(t_start) + "," + str(t_end)
                raise UserWarning(msg)

        EDC.LoadTrignetEventFile(runNo, data_dir, "")
        if i == 0:
            EDC.SetHistAllocation(multh)
        EDC.LoadEventDataFiles(runNo, data_dir, "")
        T0List.append(EDC.PutCaseDecoder().PutNumOfT0ListInCases())

    DataReductParams = [t_start, t_end, Ei, HW_bin, HW_min, HW_max, min_ang, max_ang, step_ang]

    print( " ------------ Histogram Creatation finishes" )

    ################################
    # Create parameters to import data
    ################################

    # Make angles and kickers information
    num_of_cases = EDC.PutNumOfCases()
    case_list = EDC.PutListOfCounterConditions()

    # Case ID (IND) and angles (PHI)
    IND = Manyo.MakeUInt4Vector()
    PHI = Manyo.MakeDoubleVector()
    for i in range(num_of_cases):
        IND.push_back(i + 1)
        PHI.push_back((case_list[(i + 1) * 2] + case_list[(i + 1) * 2 + 1 ]) / 2.0)
    # The number of kickers at each angle
    KIC = Manyo.MakeDoubleVector(T0List[0].size())
    for i in range(T0List[0].size()):
        KIC[i] = 0.0
    for i in range(len(T0List)):
        for j in range(KIC.size()):
            KIC[j] += T0List[i][j]

    # Create mask info
    if mask_file.lower() != "default":
        mask_path = mu.FindParamFilePath(mask_file)
    else:
        mask_path = PutDefaultMaskFile(runNo)

    # Get parameter for Solid Angle Corrections
    dOmega = 1.0
    hh = Manyo.HeaderBase()
    if EDC.AddRunInfoToHeader(hh):
        L2 = hh.PutDouble("TypicalL2")
        dS = hh.PutDouble("TypicalDS")
        dOmega = dS/(L2*L2)

    ################################
    # Import Histogram into D4Mat2 data
    ################################

    D4M = mu.UtsusemiD4Matrix2()
    D4M.isDirectGeometry = True

    # Add runNo and angle into XtalParam.xml
    D4M.SetD4MatDataReductionContinuosClearRunNo()
    for runNo, st_ang in RunNoAngleList:
        D4M.SetD4MatDataReductionContinuosAddRunNo(runNo, st_ang)

    # Do import of raw histograms, included EDC, and do the data reduction, then convert to D4Mat2 data.
    D4M.SetD4MatParameters(runNo, DataReductParams, LatticeConst, Uvector, Vvector, RotateSteps)
    D4M.ImportEcmsContRot(EDC, IND, PHI, KIC, mask_path, dOmega, norm_factor, detect_effi)
    print( " ------------ Import data finishes" )

    ################################
    # Do Projection
    ################################
    D4M.SetD4MatProjectionAxesInfo(ProjAxes, AxTitles, AxUnits)
    D4M.Projection(ProjAxes)
    print( " ------------ Projection finishes" )

    ################################
    # Save Data
    ################################
    D4M.SaveXtalParam(outXtalParam)     # ここまでの設定をXtalParamに保存する
    print( "------------- Save XtalParam.xml")
    D4M.SaveData(outFile, True)         # d4mzファイル（D4Mat2用バイナリ）に圧縮形式(True)で保存




サンプルコード(B-1a)
-------------------------
サンプルコード(B-1)のようにデフォルトのデータリダクションを行うのではなく、独自の処理をしたい場合は、(B-1)の

::

    ################################
    # Import Histogram into D4Mat2 data
    ################################


より後の部分を以下のように書き換えれば良い。

.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (B-1a)
    :name: Sample-B-1a.py

    ################################
    # Import Histogram into D4Mat2 data
    ################################

    D4M = mu.UtsusemiD4Matrix2()
    D4M.isDirectGeometry = True

    # Add runNo and angle into XtalParam.xml
    D4M.SetD4MatDataReductionContinuosClearRunNo()
    for runNo, st_ang in RunNoAngleList:
        D4M.SetD4MatDataReductionContinuosAddRunNo(runNo, st_ang)

    # Do import of raw histograms, included EDC, and do the data reduction, then convert to D4Mat2 data.
    D4M.SetD4MatParameters(runNo, DataReductParams, LatticeConst, Uvector, Vvector, RotateSteps)

    # Data Reduction for each angle data and Import
    D4M.AllocateD4MatPseudoOnLine(num_of_cases)
    for i in range(num_of_cases):
        # Pick out a Histogram data at an angle
        DAT = Manyo.ElementContainerMatrix()
        EDC.SetElementContainerMatrix(DAT, IND[i])

        # Do Default Data Reduction
        DR = mu.UtsusemiReductionInEla(DAT)
        DR.CalcPhi()
        DAT.PutHeaderPointer().OverWrite(mu.UTSUSEMI_KEY_HEAD_KICKERCOUNT, KIC[IND[i]])
        Cmm.dHWCorrection(dat=DAT)
        Cmm.SolidAngleCorrection(dat=DAT)
        Cmm.KiKfCorrection(dat=DAT)
        Cmm.DoMask(dat=DAT,filename=mask_path)
        Cmm.NormByKickers(dat=DAT,factor=norm_factor)
        Cmm.DetectorEffi(dat=DAT, dataFile=detect_effi)
        # Other Reduction commands
        """
        # if you want to save a histogram data as nxspe file,
        fname = "Run{:06d}_ang{:08.3f}.nxspe".format(runNo, PHI[i])
        params = "PSI:0.0,TEMP:300.0,USER:mlfuser"
        Cmm.SaveDataToNxspe(dat=DAT, path="./", filename=fname, params=params)
        """
        # Import histogram for each angle into D4Mat2
        D4M.ImportEcmStepByStep(DAT, PHI[i], "{}".format(IND[i]), False)
        del DAT

    print( " ------------ Import all data finishes" )

    # Do Projection
    D4M.SetD4MatProjectionAxesInfo(ProjAxes, AxTitles, AxUnits)
    D4M.Projection(ProjAxes)
    print( " ------------ Projection finish" )



サンプルコード(B-2)
-------------------------

3. 射影データを2Dスライスする

(B-1)や(B-1a)に続いて、下記を加えると2Dデータスライスが実行され,2Dプロッタで表示される。


.. code-block:: python
    :caption: D4Mat2 commands scripts for the continuous rotation method (B-2)
    :name: Sample-B-2.py

    # 本スクリプトはB-1/B-1aに追記すると動作する

    # ただし保存されたデータファイルを読み込んでスライスする場合は下記のコメントアウトを外して利用する
    '''
    import Manyo
    import Manyo.Utsusemi as mu

    D4M = mu.UtsusemiD4Matrix2()               # D4matSlicer2のコマンドを実行するための用意
    D4M.isDirectGeometry = True                # 測定手法が直接配置型(Direct Geometry)ならTrue, 逆転配置型(Inverted Geometry)ならFalse
    D4M.ClearAll()                             # データのクリア（念のため）
    D4M.LoadData("/path/to/file.d4mz")         # 保存されたd4mzファイル（D4Mat2用バイナリ）の読み込み
    D4M.Projection()                           # 射影処理実行
    '''

    # Slice on D4Matrix2
    ## Get maximum range of D4Matrix2 data axes
    limRange = D4M.GetAxLimit()

    # 2D slice test
    ## Make parameters for slicing
    Ax1_slice = ["X", limRange[0], limRange[1], 0.02]
    Ax2_slice = ["T", -0.1, 0.1] # max range [limRange[2], limRange[3]]
    Ax3_slice = ["T", -0.1, 0.1] # max range [limRange[4], limRange[5]]
    Ax4_slice = ["Y", 0.0, 40.0, 0.4]
    Foldings = []
    AxUnits = ["rlu", "rlu", "rlu", "meV"]

    # Do Slice and plot
    # create empty data container
    sliced_eca = Manyo.ElementContainerArray()

    # Do slice
    if D4M.Slice2d( sliced_eca, Ax1_slice, Ax2_slice, Ax3_slice, Ax4_slice, Foldings, AxUnits ):
        import uGao.M2PlotPlusCui as mp
        p=mp.M2PlotPlusCui(sliced_eca)
        p.ShowData()


サンプルコード(B-1b)
-------------------------

4. 連続回転測定のデータを別フォーマットにする（例：Nxspe）

Nxspeに書き出すだけ（D4Mat2で射影・スライスしない）の場合、D4Mat2へのimportなどの手順は省略できる。
この場合も(B-1a)と同様に、(B-1)の

::

       # Do the data reduction and import of histograms

より後の部分を以下のように書き換えれば良い。

.. code-block:: python

    # Do the data reduction and import of histograms

    # Data Reduction for each angle data and save as nxspe
    for i in range(num_of_cases):
        # Pick out a Histogram data at an angle
        DAT = Manyo.ElementContainerMatrix()
        EDC.SetElementContainerMatrix(DAT, IND[i])

    # Do Default Data Reduction
        DR = mu.UtsusemiReductionInEla(DAT)
        DR.CalcPhi()
        DAT.PutHeaderPointer().OverWrite(mu.UTSUSEMI_KEY_HEAD_KICKERCOUNT, KIC[IND[i]])
        Cmm.dHWCorrection(dat=DAT)
        Cmm.SolidAngleCorrection(dat=DAT)
        Cmm.KiKfCorrection(dat=DAT)
        Cmm.DoMask(dat=DAT,filename=mask_path)
        Cmm.NormByKickers(dat=DAT,factor=norm_factor)
        Cmm.DetectorEffi(dat=DAT, dataFile=detect_effi)
        # Other Reduction commands

    # Save a histogram data as a nxspe file.
    fname = "Run{:06d}_ang{:08.3f}.nxspe".format(runNo, PHI[i])
    params = "PSI:0.0,TEMP:300.0,USER:mlfuser"
    Cmm.SaveDataToNxspe(dat=DAT, path="./", filename=fname, params=params)

        del DAT

    print( " ------------ Conversion to nxspe finishes" )


.. _CUI_UtsusemiD4Matrix2_ComRefs:

-----------------------------
UtsusemiD4Matrix2リファレンス
-----------------------------
以下に **UtsusemiD4Matrix2** で使用できるコマンド（メソッド）のうち、主要なものを示す。

.. py:class:: UtsusemiD4Matrix2

    連続回転測定データの処理や、StepByStepデータの処理を、全データをメモリ上に保管することにより、高速に、かつ処理の柔軟性を高めたものである。

    .. py:attribute:: isDirectGeometry

        取り扱うデータ（非弾性散乱測定データ）が、直接配置型の装置で測定されたものか、逆転配置型の装置で測定されたものかを与えるものである。直接配置型であればTrue, 逆転配置型であればFalseを与える。初期値はTrue。

        :type: bool
        :value: True

    .. py:method:: LoadData(FilePath)

        保存されたD4Mat2データ(.d4m)を読み込んで処理できるようにする。

        :param string FilePath: 読み込むファイルパス（拡張子 .d4m）
        :return: 結果 True:成功, False:何らかの失敗
        :rtype: bool

    .. py:method:: SaveData(FilePath, Compress)

        処理中のD4Mat2データ(.d4m)を保存する。第2引数をTrueにすると圧縮して保存される。省略した場合は非圧縮保存。

        :param string FilePath: 保存するファイルパス（拡張子 .d4m）
        :param bool Compress: 圧縮するかどうか
        :return: 結果 True:成功, False:何らかの失敗
        :rtype: bool

    .. py:method:: SaveXtalParam(FilePath)

        処理中の情報をXtalParamで書き出す（連続回転測定のデータリダクションパラメータ含む）。

        :param string FilePath: 保存するXtalParamのファイルパス
        :return: 結果 True:成功, False:何らかの失敗
        :rtype: bool

    .. py:method:: SetD4MatSampleInfo( LatticeConst, Uvector, Vvector, RotateSteps )

        試料情報（格子定数、方位情報など）を与える。

        :param list(float) LatticeConsts: 格子定数の指定 [ a, b, c,α,β,γ]
        :param list(float) Uvector: U-vector
        :param list(float) Vvector: V-vector
        :param list(float) RotateSteps: U-V-vectorの回転を指定
        :return: 結果 True 成功, False 失敗
        :rtype: bool

        RotateSteps フォーマット
            floatのリスト [<Ax No.>, <angle> (, <Ax No.>, <angle>, ...)]

            +------+----+
            |Ax No.|Axis|
            +======+====+
            |0     |"X" |
            +------+----+
            |1     |"Y" |
            +------+----+
            |2     |"Z" |
            +------+----+

            例：

            +-------------------------------------+-----------------+
            |Y軸垂直面で3.4度                     |[1, 3.4]         |
            +-------------------------------------+-----------------+
            |Z軸垂直面で-1.2度 -> Y軸垂直面で3.4度|[2, -1.2, 1, 3.4]|
            +-------------------------------------+-----------------+

    .. py:method:: ImportEcmStepByStep( DAT, PhiValue, title )

        StepByStep測定の非弾性散乱処理済みのデータ（ElementContainerMatrix）を角度情報とともに取り込む。この時点では射影計算はなされない。

        :param ElementContainerMatrix ecm: データ処理済みヒストグラム
        :param float PhiValue: U-vectorと平行な方位を0度とした時の角度
        :param string title: このデータに対するタイトル
        :return: 結果 True 成功, False 失敗
        :rtype: bool

    .. py:method:: Projection( [ProjAxes] )

        StepByStep測定及び連続回転測定の取り込み済みのデータに対し、射影処理を行う。

        :param list(float) ProjAxes: 射影軸の指定（省略可能）
        :return: 結果 True 成功, False 失敗
        :rtype: bool

    .. py:method:: Slice2d( sliced_eca, sl_ax1, sl_ax2, sl_ax3, sl_ax4, sl_dFold, sl_units )

        射影処理終了後のデータに対し2Dスライスを行う。

        :param ElementContainerArray sliced_eca: スライスされたデータを収めるコンテナ
        :param list(float) sl_ax1: 射影軸1のスライス情報
        :param list(float) sl_ax2: 射影軸2のスライス情報
        :param list(float) sl_ax3: 射影軸3のスライス情報
        :param list(float) sl_ax4: 射影軸4のスライス情報
        :param list(float) sl_dFold: 対角線畳み込み情報
        :param list(string) sl_units: 射影軸のそれぞれの単位
        :return: 結果 True 成功, False 失敗
        :rtype: bool


        射影軸ごとにlist(float)でスライス情報を与えるが、そのフォーマットは以下のとおり。

        **[ "Ax", min, max, (width) (,folding) ]**

        +-------+------+----------------------------------------------------+
        |要素   |タイプ|説明                                                |
        +=======+======+====================================================+
        |"Ax"   |str   |軸の役割, X軸なら"X"、Y軸なら"Y"、Z軸なら"Z"、      |
        |       |      |Thickness軸なら"T"                                  |
        +-------+------+----------------------------------------------------+
        |min    |float |範囲の最小値                                        |
        +-------+------+----------------------------------------------------+
        |max    |float |範囲の最大値                                        |
        +-------+------+----------------------------------------------------+
        |width  |float |bin幅、ただしAが"X"か"Y","Z"の時のみ有効            |
        +-------+------+----------------------------------------------------+
        |folding|float |その軸の畳み込みを行うQ値　（下表参照）             |
        +-------+------+----------------------------------------------------+

        *Folding* 値（ **軸に垂直な面での折りたたみ** ）

        +---+--------------------+
        |-1 |（負の値）使用しない|
        +---+--------------------+
        |0.0|その軸=0で折りたたむ|
        +---+--------------------+
        |x  |その軸=xで折りたたむ|
        +---+--------------------+


        例：

        +--------------------------+------------------------+
        |X,Y,Z軸方向は長さ4のリスト|[ "X", -1.8, 2.6, 0.02 ]|
        +--------------------------+------------------------+
        |T軸方向は長さ3のリスト.   |[ "T", -0.1, 0.1 ]      |
        +--------------------------+------------------------+


        **指定した2軸に対して対角線の畳み込み、もしくは指定した2軸に対して回転の畳み込み**

        軸に垂直な面だけではなく、指定した2軸での対角線での畳み込み、もしくは指定した2軸平面上での回転による畳み込みを行うことができる。
        以下にその方法を示す。

        **[<Type>, <XaxisNo>, <YaxisNo> [, <Angle 1>, <Angle 2>]]**

        *<Type>* は0〜3の整数値で、対角線の畳み込みの種類を与える


        +--------------------+----------------------+----+
        |Type                |定義された変数        |実体|
        +====================+======================+----+
        |他の畳み込みはしない|FOLD_TYPE_DIAG_NONE   |0   |
        +--------------------+----------------------+----+
        |X < Y の対角線      |FOLD_TYPE_DIAG_X_LT_Y |1   |
        +--------------------+----------------------+----+
        |X > -Y の対角線     |FOLD_TYPE_DIAG_X_GT_MY|2   |
        +--------------------+----------------------+----+
        |両方の対角線        |FOLD_TYPE_DIAG_BOTH   |3   |
        +--------------------+----------------------+----+
        |回転による畳み込み  |FOLD_TYPE_ROTATE      |4   |
        +--------------------+----------------------+----+

        *<XaxisNo>* , *<YaxisNo>* も0〜3の整数値で、どの軸が畳み込み時のX、およびYにするかを与える

        +---+--------------+----+
        |軸 |定義された定数|実体|
        +===+==============+====+
        |Ax1|FOLD_AXIS_AX1 |1   |
        +---+--------------+----+
        |Ax2|FOLD_AXIS_AX2 |2   |
        +---+--------------+----+
        |Ax3|FOLD_AXIS_AX3 |3   |
        +---+--------------+----+
        |Ax4|（なし）      |    |
        +---+--------------+----+

        *<Angle 1>* , *<Angle 2>* は角度範囲であり単位は度[degree]である。


        例：

        +---------------------------------------------+---------------------------------------------------------------------+
        |Ax1 < Ax3の対角線で畳み込む                  |[D4M.FOLD_TYPE_DIAG_X_LT_Y, D4M.FOLD_AXIS_AX1, D4M.FOLD_AXIS_AX3]    |
        +---------------------------------------------+---------------------------------------------------------------------+
        |Ax3 > -Ax2の対角線で畳み込む                 |[D4M.FOLD_TYPE_DIAG_X_GT_MY, D4M.FOLD_AXIS_AX3, D4M.FOLD_AXIS_AX2]   |
        +---------------------------------------------+---------------------------------------------------------------------+
        |Ax1とAx2の平面で-30 〜 30の角度範囲に畳み込む|[D4M.FOLD_TYPE_ROTATE, D4M.FOLD_AXIS_AX1, D4M.FOLD_AXIS_AX2, -30, 30]|
        +---------------------------------------------+---------------------------------------------------------------------+




    .. py:method:: Slice3d( sliced_ecm, sl_ax1, sl_ax2, sl_ax3, sl_ax4, sl_dFold )

        射影処理終了後のデータに対し3Dスライスを行う。

        :param ElementContainerMatrix sliced_ecm: スライスされたデータを収めるコンテナ
        :param list(float) sl_ax1: 射影軸1のスライス情報
        :param list(float) sl_ax2: 射影軸2のスライス情報
        :param list(float) sl_ax3: 射影軸3のスライス情報
        :param list(float) sl_ax4: 射影軸4のスライス情報
        :param list(float) sl_dFold: 畳み込み情報
        :return: 結果 True 成功, False 失敗
        :rtype: bool

        射影軸のスライス情報は、 Slice2dを参照のこと。

    .. py:method:: AllocateD4MatOnDisk(a1range, a2range, a3range, a4range, titles, data_dir, string paramfile )

        StepByStep測定の入力済みデータから、D4MatSlicer用のデータ（D4Matデータ）を出力するコマンドである。

        :param list(float) a1range: 射影軸1の範囲とbin幅
        :param list(float) a2range: 射影軸2の範囲とbin幅
        :param list(float) a3range: 射影軸3の範囲とbin幅
        :param list(float) a4range: 射影軸4の範囲とbin幅
        :param list(string) titles: 射影軸のタイトル
        :param string data_dir: 出力先のフォルダへのパス指定
        :param string paramfile: 出力先のパラメータファイル名
        :return: 結果 True 成功, False 失敗
        :rtype: bool

        射影軸の範囲とbin幅は、[ min, max, bin ] のフォーマットである。

    .. py:method:: ExportEcmFromStepByStep( ecm, index)

        StepByStep測定の入力済みデータから、特定の角度のデータを取り出す。最低角度のデータをindex=0とする。

        :param ElementContainerMatrix ecm: 取り出すデータのコンテナ
        :param int index: 角度のインデックス
        :return: 結果 True 成功, False 失敗
        :rtype: bool

        例：
        .. code-block:: python

            ecm = ElementContainerMatrix()
            D4M.ExportEcmFromStepByStep(ecm, 10)

    .. py:method:: ClearAll()

        取り込んだデータを全てクリアする。

        :return: None
        :rtype: None

    .. py:method:: PutQRange()

        取り込んだデータから、Q領域及びhw領域のそれぞれの最小値と最大値を返す。

        :return: Q1, Q2, Q3, hwのそれぞれの最小値、最大値のリスト
        :rtype: list(float)

        戻り値は、[Q1_min, Q1_max, Q2_min, ... , hw_max]のサイズ8のリストである。
