MAD-X Primer (3): マッチング : ローカルバンプの作成
=========================================================

目的
------

* MAD-X Primer Appendix 1.3（Example 3）
*  :blue:`match` ( **軌道補正マッチング機能** ) を使用し、「垂直方向の局所バンプ」を生成する方法を学ぶ．

|
   
目標軌道
--------------

3つのキッカー（垂直軌道補正器： KCV7, KCV9, KCV10）を使用し、ビームを変位させる軌道を設計する．

* **入口** (BPMV5)で y=0 mm
* **中央のモニタ** (BPMV8)で y=5 mm にバンプ
* **出口** (BPMV11)で再び y=0 mm に戻す

ビーム軌道を作るキッカを  :blue:`MATCHコマンドを使って自動調整` ．

|

コード
---------------

.. literalinclude:: codes/madx_primer/local-orbit-bump/local-orbit-bump.madx
                    :emphasize-lines: 20-28

|


命令
-------------------

* `MATCH, ORBIT` ： **軌道補正専用のマッチング** ブロック
* `CONSTRAINT` ： **位置・角度（Y, PY）の制約指定**
* `VARY` ： **変数（キッカーの強度）の最適化**
* `LMDIF` ： **数値最適化 (Levenberg-Marquardt algorithm )のトレランスと関数呼出し回数上限**

|

補足ポイント
-------------------

* `PY=0.0` の指定により、「まっすぐ進む」ことが保証される
* `Y=0.005` (5 mm) など単位はメートル(SI)系であることに注意
* `:=` を使って変数（KCV7 など）が遅延評価されるようにしておくと、マッチング後も値が反映される

|