.. highlight:: none

[sampling] セクション
-------------------------------

レプリカ数や温度の幅, モンテカルロステップ数など,モンテカルロ部分のパラメータを指定します.
以下のようなファイルフォーマットをしています.

  ::
  
        [sampling]
        nreplicas = 3
        nprocs_per_replica = 1
        kTstart = 500.0
        kTend = 1500.0
        nsteps = 5
        RXtrial_frequency = 2
        sample_frequency = 1
        print_frequency = 1

入力形式
^^^^^^^^^^^^
``keyword = value`` の形式でキーワードとその値を指定します.
また, #をつけることでコメントを入力することができます(それ以降の文字は無視されます).

キーワード
^^^^^^^^^^

- サンプリング手法に関する指定

    - ``sampler``

       **形式 :** 文字列

       **説明 :**
       レプリカ交換モンテカルロ法 ("RXMC") あるいは ポピュレーションアニーリングモンテカルロ法 ("PAMC").
       デフォルト値 = "RXMC"

- 温度に関する指定

    - 温度点は ``kTs`` を用いて陽に指定するか、 ``kTstart`` と ``kTend`` とを用いて等間隔に自動生成するかのどちらかで指定します。
      両方指定した場合、 ``kTs`` が優先されます.

    -  ``kTs``

       **形式 :** list of float (>0)

       **説明 :**
       温度のリスト. 
       "RXMC" のときは、温度点の数とレプリカ数とを一致させる必要があります.

    -  ``kTstart``

       **形式 :** float型 (>0)

       **説明 :**
       温度の下限.

    -  ``kTend``

       **形式 :** float型 (>0)

       **説明 :**
       温度の上限.

    -  ``kTnum``

       **形式 :** int型 (>0)

       **説明 :**
       温度点の数.
       ``sampler = "PAMC"`` のときに使用.
       ``sampler = "RXMC"`` のときは、 レプリカ数 ``nreplicas`` と同じ値になります.


- レプリカに関する指定

    -  ``nprocs_per_replica``

       **形式 :** int型 (自然数)

       **説明 :** レプリカに対するプロセス数を指定します. デフォルト値 = 1.

    -  ``nreplicas``

       **形式 :** int型 (自然数)

       **説明 :** レプリカ数を指定します.


- その他

    -  ``nsteps``

       **形式 :** int型 (自然数)

       **説明 :** モンテカルロステップ数を指定します.

    -  ``nsteps_between_anneal``

       **形式 :** int型 (自然数)

       **説明 :** 各温度で実行するモンテカルロステップ数を指定します.
       ``nsteps`` と同時設定不可.
       ``sampler = "PAMC"`` のときのみ使用.

  
    -  ``RXtrial_frequency``

       **形式 :** int型 (自然数)

       **説明 :** レプリカ交換を何モンテカルロステップごとに行うかを指定します. 例えば、1に設定した場合にはモンテカルロ更新を行う度にレプリカ交換が行われ、2に設定した場合には2モンテカルロステップ毎にレプリカ交換が行われます.
       ``sampler = "RXMC"`` のときのみ使用.
       デフォルト値 = 1

    -  ``resample_frequency``

       **形式 :** int型 (自然数)

       **説明 :** レプリカのリサンプリングを行う頻度. 例えば、1に設定した場合には温度降下ごとにリサンプリングされ, 2に設定した場合には2回降下する毎にリサンプリングが行われます.
       ``sampler = "PAMC"`` のときのみ使用.
       デフォルト値 = 1


    -  ``sample_frequency``

       **形式 :** int型 (自然数)

       **説明 :**     物理量測定を何モンテカルロステップごとに行うかを指定します. デフォルト値 = 1

    -  ``print_frequency``

       **形式 :** int型 (自然数)

       **説明 :**     測定した物理量を何モンテカルロステップごとに保存するかを指定します. デフォルト値 = 1

    -  ``reload``

       **形式 :** bool型 ("true" or "false")

       **説明 :**     前回終了したの最後のステップから計算をやりなおすかどうかを指定します. デフォルト値 = false

    -  ``throw_out``

       **形式 :** int型 もしくは float型

       **説明 :**     期待値計算時、熱平衡化のために捨てられる測定値の数(int)あるいは比率(float)を指定します. デフォルト値 = 0.5

    -  ``enable_grandcanonical``

       **形式 :** bool型

       **説明 :**     グランドカノニカルサンプリングを有効にします．デフォルト値 = false

    -  ``gc_ratio``

       **形式 :** float型

       **説明 :**     グランドカノニカルサンプリングが有効な場合、配位更新の試行において粒子数を変えるグランドカノニカルアップデートの割合を指定します．デフォルト値 = 0.3