.. _17_1_COIL:

##################################
**17.1 外部電流磁場ソース**
##################################

有限要素メッシュとは独立に定義できる，外部電流磁場ソース ``COIL`` を定義します。
``COIL`` はビオ・サバール則を使用したコイル，もしくは磁場ソースが定義できます。

``COIL`` の作成領域は空気領域を想定しており，:paramdef:`POTENTIAL(16.1)` の変形ポテンシャル領域内にコイルの形状を定義します。

---------------------
設定項目
---------------------

:paramdef:`COIL(17.1)`    外部電流磁場ソースCOILの指定。

    :paramdef:`SERIES_ID(17.1)`        COILの系列番号。

    :paramdef:`TIME_ID(17.1)`        COILの時間番号。

    :paramdef:`MOTION_ID(17.1)`        MOTION=1の場合，COILの運動番号。

    :paramdef:`IN_ROTOR(17.1)`        回転子内にあるかどうかのフラグ。

    :paramdef:`POTENTIAL(17.1)`        変形ポテンシャル番号。

    :paramdef:`TO_MESHED_COIL(17.1)`        メッシュコイルへの変換フラグ。

    :paramdef:`data(17.1)`        COILの定義データ。

        :paramdef:`TYPE(17.1)`            データタイプ。

    :paramdef:`UNIF(17.1.1)`        一様磁場の定義。

        :paramdef:`B_XYZ(17.1.1)`            一様規格化磁束密度XYZ成分。

        :paramdef:`A_FORM(17.1.1)`            一様磁場の磁気ベクトルポテンシャルとしての表現法。

    :paramdef:`LOOP(17.1.2)`        軸対称矩形断面コイルの定義。

        :paramdef:`CURRENT(17.1.2)`           規格化電流値。

        :paramdef:`RADIUS(17.1.2)`            平均半径。

        :paramdef:`CENTER_Z(17.1.2)`            中心のz座標。

        :paramdef:`RADIAL_W(17.1.2)`            径方向幅。

        :paramdef:`AXIAL_W(17.1.2)`            軸方向幅。
    
    :paramdef:`GCE(17.1.3)`        直方体電流要素の定義。

        :paramdef:`CURRENT(17.1.3)`            規格化電流値。

        :paramdef:`S_XYZ(17.1.3)`            始点座標。

        :paramdef:`E_XYZ(17.1.3)`            終点座標。

        :paramdef:`W1_XYZ(17.1.3)`            始点の幅。

        :paramdef:`W2_XYZ(17.1.3)`            終点の幅。
    
    :paramdef:`ARC(17.1.4)`        円弧コイルの定義。

        :paramdef:`CURRENT(17.1.4)`            規格化電流値。

        :paramdef:`XYZ(17.1.4)`            始点座標。

        :paramdef:`RADIUS(17.1.4)`            半径。

        :paramdef:`AXIAL_W(17.1.4)`            軸方向幅。

        :paramdef:`RADIAL_W(17.1.4)`            径方向幅。

        :paramdef:`ALPHA(17.1.4)`            オイラー角 α

        :paramdef:`BETA(17.1.4)`            オイラー角 β

        :paramdef:`PHI1(17.1.4)`            x2 軸よりの始点角度。

        :paramdef:`PHI2(17.1.4)`            x2 軸よりの終点角度。

    :paramdef:`FGCE(17.1.5)`        円弧コイルの定義。

        :paramdef:`CURRENT(17.1.5)`            規格化電流値。

        :paramdef:`S_XYZ(17.1.5)`            始点座標。

        :paramdef:`E_XYZ(17.1.5)`            終点座標。

    :paramdef:`FARC(17.1.6)`        円弧コイルの定義。

        :paramdef:`CURRENT(17.1.6)`            規格化電流値。

        :paramdef:`XYZ0(17.1.6)`            始点座標。

        :paramdef:`RADIUS(17.1.6)`            半径。

        :paramdef:`ALPHA(17.1.6)`            オイラー角 α。

        :paramdef:`BETA(17.1.6)`            オイラー角 β。

        :paramdef:`PHI1(17.1.6)`            x2 軸よりの始点角度。

        :paramdef:`PHI2(17.1.6)`            x2 軸よりの終点角度。

    :paramdef:`MESH(17.1.7)`        メッシュコイルの定義。

        :paramdef:`CURRENT(17.1.7)`            規格化電流値。

        :paramdef:`MESH_ID(17.1.7)`            メッシュID。

    :paramdef:`LOOP-(17.1.8)`        矩形断面コイルの定義。

    :paramdef:`GCE-(17.1.8)`        直方体電流要素の定義。

    :paramdef:`ARC-(17.1.8)`        円弧コイルの定義。

    :paramdef:`MESH-(17.1.8)`        メッシュコイルの定義。

        :paramdef:`INT_X(17.1.8)`            X 方向のガウス積分点数

        :paramdef:`INT_Y(17.1.8)`            Y 方向のガウス積分点数

        :paramdef:`INT_Z(17.1.8)`            Z 方向のガウス積分点数

    :paramdef:`LINE(17.1.9)`        線状コイルの定義。

        :paramdef:`CURRENT(17.1.9)`            規格化電流値。

        :paramdef:`XYZ0(17.1.9)`            直線の通過する点の座標

        :paramdef:`DXYZ(17.1.9)`            直線の方向ベクトル成分

    :paramdef:`DIPO(17.1.10)`        磁気双極子コイルの定義。

        :paramdef:`DBZDX(17.1.10)`            z 方向磁場の x 方向への規格化磁場勾配

    :paramdef:`EXMAG(17.1.11)`        永久磁石の定義。

        :paramdef:`READ_OPTION(17.1.11)`            永久磁石データの読み込みオプション

        :paramdef:`MAT_ID(17.1.11)`            永久磁石材料番号

        :paramdef:`COORD_ID(17.1.11)`            座標変換番号

        :paramdef:`MXYZ(17.1.11)`            入力磁化ベクトル


---------------------
設定フォーマット
---------------------
.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 7

    .. code-block:: text
        :caption: Text format

        *COIL * SERIES_NO * TIME_ID * NO_ELEMENTS * MOTION_ID * IN_ROTOR * POTENTIAL *
         COIL       I          I          I           I          I          I


======================
JSONフォーマット
======================

.. code-block:: json
    :caption: JSON format from 2024.11

    "17_Field_Source" : 
    [
        {
            "COIL" : 
            {
                "SERIES_ID" : I,
                "TIME_ID" : I,
                "MOTION_ID" : I,
                "IN_ROTOR" : I,
                "POTENTIAL" : I,
                "TO_MESHED_COIL" : I,
                "data" : 
                [
                    {
                        "TYPE" : I,
                        "CURRENT" : I,
                        ...
                    }
                ]
            }
        },
    ]

---------------------
**詳細説明**
---------------------

外部電流磁場ソース ``COIL`` はビオ・サバール則を使用したコイル，もしくは磁場ソースが定義できます。
有限要素メッシュとは独立に定義されるため，メッシュの影響を受けません。
``COIL`` の作成領域は空気領域を想定しており，:paramdef:`POTENTIAL(16.1)` の変形ポテンシャル領域内にコイルの形状を定義します。

==========================
**COIL**
==========================
.. paramdef:: COIL(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 外部電流磁場ソース ``COIL`` の指定。

==========================================
**SERIES_ID**
==========================================
.. paramdef:: SERIES_ID(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 整数 (I)
:説明: 外部電流磁場ソース ``COIL`` の系列番号。

===========================================
**TIME_ID**
===========================================
.. paramdef:: TIME_ID(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 整数 (I)
:説明: 時間変化を与えるデータ番号 :paramdef:`TIME_ID(18)` 。

.. hint:: 
    ソースが :paramdef:`CIRCUIT(17.8)` あるいは :paramdef:`NETWORK(17.9)` に接続される場合は0とすること。 :paramdef:`CIRCUIT(17.8)` あるいは :paramdef:`NETWORK(17.9)` に接続することを推奨する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    
    **NO_ELEMENTS**
    

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]
        Type=I

    COIL要素の数。

=========================================
**MOTION_ID**
=========================================
.. paramdef:: MOTION_ID(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]

:型: 整数 (I)
:説明: :paramdef:`MOTION(2)` =1の場合，ソース全体の運動を表す運動データ識別番号 ( :paramdef:`MOTION(19)`)

0の場合は運動しない。

==========================
**IN_ROTOR**
==========================
.. paramdef:: IN_ROTOR(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]

.. list-table:: 回転子内にあるかどうかのフラグ
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0: **デフォルト値**
      - 固定部内
    * - 1
      - 可動部内

:paramdef:`N_CORRECT(8)` ≠ 0 の場合必要

=========================
**POTENTIAL**
=========================
.. paramdef:: POTENTIAL(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション
    
    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 7]

:型: 整数 (I)
:説明: 変形ポテンシャル番号 :paramdef:`POTENTIAL(16.1)`。 **デフォルト値** =1

固定部と可動部は異なる :paramdef:`POTENTIAL(16.1)` 番号でなくてはならない。

==========================
**TO_MESHED_COIL**
==========================
.. paramdef:: TO_MESHED_COIL(17.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 8]

.. list-table:: ``COIL`` を ``MESHED_COIL`` に変換するのかを指定するフラグ。
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0
      - ``COIL`` を ``MESHED_COIL`` に変換しない。 **デフォルト値**
    * - 1
      - ``COIL`` を ``MESHED_COIL`` に変換する。


.. note:: 
    ``COIL`` は解析積分により磁場を計算するが， ``COIL`` と有限要素メッシュの位置関係によっては解析積分が発散してしまうことがある。
    そのような場合は， ``COIL`` を ``MESHED_COIL`` に変換することにより回避することができる。``MESHED_COIL`` については :paramdef:`MESH(17.1.7)` を参照のこと。

==========================
**data**
==========================
.. paramdef:: data(17.1)

:JSONキー: COIL要素の定義。

JSONフォーマットの場合，  ``data`` に ``COIL`` 要素の定義をする。

``data`` は配列で， ``COIL`` 要素の数だけ定義する。

テキストフォーマットの場合，``TYPE`` で定義する文字識別子を記述する。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**TYPE**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: TYPE(17.1)

`data` 内に，以下に示すCOIL要素のタイプを指定する。

- :paramdef:`UNIF(17.1.1)`
- :paramdef:`LOOP(17.1.2)`
- :paramdef:`GCE(17.1.3)`
- :paramdef:`ARC(17.1.4)`
- :paramdef:`FGCE(17.1.5)`
- :paramdef:`FARC(17.1.6)`
- :paramdef:`MESH(17.1.7)`
- :paramdef:`LOOP-(17.1.8)` , :paramdef:`GCE-(17.1.8)` , :paramdef:`ARC-(17.1.8)` , :paramdef:`MESH-(17.1.8)`

以下の二つはほぼ使用されない。

- :paramdef:`LINE(17.1.9)`
- :paramdef:`DIPO(17.1.10)`

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.1 一様磁場 UNIF**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

一様磁場入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 4 

    .. code-block:: text
        :caption: Text format

        * UNIF * BXYZ * A_FORM *
        UNIF   0.0  0.0  1.0     2

.. code-block:: json
    :caption: JSON format from 2024.11

                "data" : 
                [
                    {
                        "type" : "UNIF",
                        "B_XYZ" : [ 0.0, 0.0, 1.0 ],
                        "A_FORM" : 0
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^
**UNIF**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: UNIF(17.1.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 一様磁場の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
**B_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: B_XYZ(17.1.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数配列 (E)
:単位: T
:数: 3
:説明: 一様規格化磁束密度XYZ成分。 "B_XYZ" : [ 0.0, 0.0, 1.0 ] のように記述する。

^^^^^^^^^^^^^^^^^^^^^^^^
**A_FORM**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: A_FORM(17.1.1)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]

.. list-table:: 一様磁場の磁気ベクトルポテンシャルとしての表現法
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0
      - A = ( B × r ) /2, r は位置ベクトル。
    * - 1
      - Ax = By*z, Ay = Bz*x, Az = Bx*y。
    * - 2
      - Ax = -Bz*y, Ay = -Bx*z, Az = -By*x。

境界条件に適合するように選ぶ。

.. hint::
    例えば磁場が z 方向として，x=0, y=0 面において，Bn=0 (At=0) の場合は，A_FORM=0。
    x=a, x=b 面 (a≠b) において，Bn=0 (At=0) の場合は，A_FORM=1。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.2 軸対称矩形断面コイル LOOP**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

軸対称矩形断面コイル入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 6 

    .. code-block:: text
        :caption: テキストフォーマット

        * LOOP * CURRENT * RADIUS * CENTER_Z * RADIAL_W * AXIAL_W *
        LOOP    1.0      0.5      0.0        0.1        0.2

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "LOOP",
                        "CURRENT" : 1.0,
                        "RADIUS" : 0.5,
                        "CENTER_Z" : 0.0,
                        "RADIAL_W" : 0.1,
                        "AXIAL_W" : 0.2
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^
**LOOP**
^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: LOOP(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 軸対称矩形断面コイルの定義。


^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。

^^^^^^^^^^^^^^^^^^^^^^^^
**RADIUS**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: RADIUS(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 実数 (E)
:単位: m
:説明: 平均半径

^^^^^^^^^^^^^^^^^^^^^^^^
**CENTER_Z**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CENTER_Z(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 実数 (E)
:単位: m
:説明: 中心の z 座標

^^^^^^^^^^^^^^^^^^^^^^^^
**RADIAL_W**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: RADIAL_W(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]

:型: 実数 (E)
:単位: m
:説明: 径方向幅

^^^^^^^^^^^^^^^^^^^^^^^^
**AXIAL_W**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: AXIAL_W(17.1.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]

:型: 実数 (E)
:単位: m
:説明: 軸方向幅


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.3 直方体電流要素 GCE**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

直方体電流要素入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 14

    .. code-block:: text
        :caption: テキストフォーマット

        * GCE * CURRENT * XS * YS * ZS * XE * YE * ZE * W1X * W1Y * W1Z * W2X * W2Y * W2Z *
        GCE    E      E  E  E  E  E  E  E  E  E  E  E  E

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "GCE",
                        "CURRENT" : E,
                        "S_XYZ" : [E, E, E],
                        "E_XYZ" : [E, E, E],
                        "W1_XYZ" : [E, E, E],
                        "W2_XYZ" : [E, E, E]
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^
**GCE**
^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: GCE(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 直方体電流要素の定義。


^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。


^^^^^^^^^^^^^^^^^^^^^^^^
**S_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: S_XYZ(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明:  中心軸始点座標。
    

^^^^^^^^^^^^^^^^^^^^^^^^
**E_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: E_XYZ(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 中心軸終点座標。

^^^^^^^^^^^^^^^^^^^^^^^^
**W1_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: W1_XYZ(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 断面半幅ベクトル a の成分


^^^^^^^^^^^^^^^^^^^^^^^^
**W2_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: W2_XYZ(17.1.3)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]


:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 断面半幅ベクトル b の成分。

.. figure:: figs/gce.png
    :align: center
    :name: gce

a から b へ回転したとき右ねじの進む方向が電流方向。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.4 矩形断面円弧電流要素 ARC**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

矩形断面円弧電流要素入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 13

    .. code-block:: text
        :caption: テキストフォーマット

        * ARC * CURRENT * X0 * Y0 * Z0 * RADIUS * AXIAL_W * RADIAL_W * ALPHA * BETA * PHI1 * PHI2 *
        ARC    1.0      0.0  0.0  0.0  0.5     0.1      0.2       0.0    0.0   0.0    90.0

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "ARC",
                        "CURRENT" : 1.0,
                        "XYZ" : [0.0, 0.0, 0.0],
                        "RADIUS" : 0.5,
                        "AXIAL_W" : 0.1,
                        "RADIAL_W" : 0.2,
                        "ALPHA" : 0.0,
                        "BETA" : 0.0,
                        "PHI1" : 0.0,
                        "PHI2" : 90.0
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^^
**ARC**
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: ARC(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 矩形断面円弧電流要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]


:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。

^^^^^^^^^^^^^^^^^^^^^^^^
**XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: XYZ(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]


:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 円弧中心座標。

^^^^^^^^^^^^^^^^^^^^^^^^
**RADIUS**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: RADIUS(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]


:型: 実数 (E)
:単位: m
:説明: 円弧中心半径。

^^^^^^^^^^^^^^^^^^^^^^^^
**AXIAL_W**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: AXIAL_W(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]


:型: 実数 (E)
:単位: m
:説明: 軸方向幅。

^^^^^^^^^^^^^^^^^^^^^^^^
**RADIAL_W**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: RADIAL_W(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]


:型: 実数 (E)
:単位: m
:説明: 径方向幅。

^^^^^^^^^^^^^^^^^^^^^^^^
**ALPHA**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: ALPHA(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 7]


:型: 実数 (E)
:単位: deg
:説明: オイラー角 :math:`\alpha` (z1 軸まわり)。

^^^^^^^^^^^^^^^^^^^^^^^^
**BETA**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: BETA(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 8]


:型: 実数 (E)
:単位: deg
:説明: オイラー角 :math:`\beta` (x2 軸まわり)。

^^^^^^^^^^^^^^^^^^^^^^^^
**PHI1**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: PHI1(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 9]


:型: 実数 (E)
:単位: deg
:説明: x2 軸よりの始点角度 :math:`\phi 1`。

^^^^^^^^^^^^^^^^^^^^^^^^
**PHI2**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: PHI2(17.1.4)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 10]

:型: 実数 (E)
:単位: deg
:説明: x2 軸よりの終点角度 :math:`\phi 2`。

.. figure:: figs/arc.png
    :align: center
    :name: arc

.. hint:: 
    全体座標の中でオイラー角でコイルの向きを与えるより，局所座標をオイラー角がゼロになるように指定して入力する方が簡単。


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.5 直線線電流要素 FGCE**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

直線線電流要素入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 7

    .. code-block:: text
        :caption: テキストフォーマット

        * FGCE * CURRENT * XS * YS * ZS * XE * YE * ZE *
        FGCE    1.0      0.0  0.0  0.0  1.0  1.0  1.0

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "FGCE",
                        "CURRENT" : 1.0,
                        "S_XYZ" : [0.0, 0.0, 0.0],
                        "E_XYZ" : [1.0, 1.0, 1.0]
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^
**FGCE**
^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: FGCE(17.1.5)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 直線線電流要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.5)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。

^^^^^^^^^^^^^^^^^^^^^^^^
**S_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: S_XYZ(17.1.5)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 始点座標。

^^^^^^^^^^^^^^^^^^^^^^^^
**E_XYZ**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: E_XYZ(17.1.5)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 終点座標。

``GCE(17.1.3)`` の断面寸法をゼロとした要素です。線上では磁場はゼロとします。線近傍の点では磁場が非常に大きくなりますので注意下さい。 ``GCE(17.1.3)`` では，折れ曲がりの所で ``ARC(17.1.4)`` と接続する必要がありますが， ``FGCE(17.1.5)`` では円弧近似しなければその必要がありません。円弧近似したい場合は，次の ``FARC(17.1.6)`` を使用して下さい。

.. figure:: figs/fgce.png
    :align: center
    :name: fgce

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.6 円弧線電流要素 FARC**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

円弧線電流要素入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 10

    .. code-block:: text
        :caption: テキストフォーマット

        * FARC * CURRENT * X0 * Y0 * Z0 * RADIUS * ALPHA * BETA * PHI1 * PHI2 *
        FARC    E        E    E    E    E       E      E      E      E

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "FARC",
                        "CURRENT" : E,
                        "XYZ0" : [E, E, E],
                        "RADIUS" : E,
                        "ALPHA" : E,
                        "BETA" : E,
                        "PHI1" : E,
                        "PHI2" : E
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^^
**FARC**
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: FARC(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 円弧線電流要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。

^^^^^^^^^^^^^^^^^^^^^^^^
**XYZ0**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: XYZ0(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 円弧中心座標。

^^^^^^^^^^^^^^^^^^^^^^^^
**RADIUS**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: RADIUS(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 実数 (E)
:単位: m
:説明: 円弧中心半径。

^^^^^^^^^^^^^^^^^^^^^^^^
**ALPHA**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: ALPHA(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]

:型: 実数 (E)
:単位: deg
:説明: オイラー角 :math:`\alpha` (z1 軸まわり)。

^^^^^^^^^^^^^^^^^^^^^^^^
**BETA**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: BETA(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 6]

:型: 実数 (E)
:単位: deg
:説明: オイラー角 :math:`\beta` (x2 軸まわり)。

^^^^^^^^^^^^^^^^^^^^^^^^
**PHI1**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: PHI1(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 7]

:型: 実数 (E)
:単位: deg
:説明: x2 軸よりの始点角度 :math:`\phi 1`。

^^^^^^^^^^^^^^^^^^^^^^^^
**PHI2**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: PHI2(17.1.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 8]

:型: 実数 (E)
:単位: deg
:説明: x2 軸よりの終点角度 :math:`\phi 2`。


``ARC(17.1.4)`` で断面をゼロとした要素です。線上では磁場はゼロとします。線近傍の点では磁場が非常に大きくなりますので注意下さい。パラメータの定義は ``ARC(17.1.4)`` と同様です。

.. hint:: 
    全体座標の中でオイラー角でコイルの向きを与えるより，局所座標をオイラー角がゼロになるように指定して入力する方が簡単。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.7 MESHED_COIL 要素**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

``MESHED_COIL`` 要素入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 3

    .. code-block:: text
        :caption: テキストフォーマット

        * MESH * CURRENT * MESH_ID *
        MESH    1.0      1

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "MESH",
                        "CURRENT" : 1.0,
                        "MESH_ID" : 1
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^^
**MESH**
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: MESH(17.1.7)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: ``MESHED_COIL`` 要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.7)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。

^^^^^^^^^^^^^^^^^^^^^^^^
**MESH_ID**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: MESH_ID(17.1.7)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 整数 (I)
:説明: *COIL_geom* ファイル中の物性番号。


``MESHED_COIL`` 要素はコイル形状を六面体要素で作成したメッシュ入力を表します。  
:paramdef:`INPUT_MESH_FILE(10.1)` で指定した形式のメッシュファイル ( *COIL_geom* ) が必要です。  
電磁力の出力は :paramdef:`COIL_FORCE(10.3)` で指定します。

.. note::
    - 電流方向は底面（1-2-3-4）から上面（5-6-7-8）と定義されます。底面および上面は必ずしも長方形でなくてもよいが、一平面上に定義する必要があります。
    - ``GCE(17.1.3)`` では歪んだ六面体が定義できないが、 ``MESHED_COIL(17.1.7)`` では定義可能です。
    - ``ARC(17.1.4)`` や ``GCE(17.1.3)`` で表現できるものであれば、``ARC(17.1.4)`` や ``GCE(17.1.3)`` で定義した方が解析的に計算できて精度が高いです。
    - ``ARC(17.1.4)`` や ``GCE(17.1.3)`` を用いて有限要素メッシュとの位置関係によっては解析積分が発散する場合に使用すると効果があります。
    - ``MESHED_COIL(17.1.7)`` 要素の電流密度分布を *COIL_current* ファイルに出力（確認用）。

.. figure:: figs/meshed_coil.png
    :align: center
    :name: meshed_coil

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**17.1.8 COIL 積分要素**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

``COIL`` 積分要素の入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 8

    .. code-block:: text
        :caption: テキストフォーマット

        * COIL- * NDIV * INT_X * INT_Y * INT_Z *
        LOOP-    1       5       5       3

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "LOOP-",
                        "NDIV" : 1,
                        "INT_X" : 5,
                        "INT_Y" : 5,
                        "INT_Z" : 3
                    },
                    {
                        "type" : "GCE-",
                        "NDIV" : 1,
                        "INT_X" : 5,
                        "INT_Y" : 5,
                        "INT_Z" : 3
                    },
                    {
                        "type" : "ARC-",
                        "NDIV" : 1,
                        "INT_X" : 5,
                        "INT_Y" : 5,
                        "INT_Z" : 3
                    }
                    {
                        "type" : "MESH-",
                        "NDIV" : 1,
                        "INT_X" : 5,
                        "INT_Y" : 5,
                        "INT_Z" : 3
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^
**LOOP-, GCE-, ARC-, MESH-**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: LOOP-(17.1.8)
.. paramdef:: GCE-(17.1.8)
.. paramdef:: ARC-(17.1.8)
.. paramdef:: MESH-(17.1.8)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]


:paramdef:`LOOP(17.1.2)` , :paramdef:`GCE(17.1.3)` , :paramdef:`ARC(17.1.4)` , :paramdef:`MESH(17.1.7)` の後ろに負符号 (-) をつけた要素。  

インダクタンスおよび電磁力の積分領域を表す。対応する :paramdef:`LOOP(17.1.2)` , :paramdef:`GCE(17.1.3)` , :paramdef:`ARC(17.1.4)` , :paramdef:`MESH(17.1.7)` と同じ ``COIL`` シリーズとして入力する。  

規格化電流および形状寸法は対応するものと同様に入力する。

^^^^^^^^^^^^^^^^^^^^^^^^
**NDIV**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: NDIV(17.1.8)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 整数 (I)
:説明: 積分要素の電流方向分割数
    ``MESH-(17.1.8)`` の場合は ``NDIV`` =1 と入力すること。  
    ``LOOP-(17.1.8)`` で ``NDIV`` =0, 1 の場合、デフォルト値 (適当値) として **12** を自動設定。  
    ``ARC-(17.1.8)`` で ``NDIV`` =0, 1 の場合、デフォルト値 (適当値) として **12/定義角度**を自動設定。
:デフォルト値: 1

^^^^^^^^^^^^^^^^^^^^^^^^
**INT_X**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: INT_X(17.1.8)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 整数 (I)
:説明: X 方向（ ``GCE-(17.1.8)`` のときベクトル a 方向、 ``LOOP-(17.1.8)`` ,  ``ARC-(17.1.8)`` のとき径方向）のガウス積分点数。
:デフォルト値: 5

^^^^^^^^^^^^^^^^^^^^^^^^
**INT_Y**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: INT_Y(17.1.8)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 整数 (I)
:説明: Y 方向（ ``GCE-(17.1.8)`` のときベクトル b 方向、 ``LOOP-(17.1.8)`` ,  ``ARC-(17.1.8)`` のとき軸方向）のガウス積分点数。
:デフォルト値: 5

^^^^^^^^^^^^^^^^^^^^^^^^
**INT_Z**
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: INT_Z(17.1.8)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 5]

:型: 整数 (I)
:説明: Z 方向（電流方向）のガウス積分点数。
:デフォルト値: 3

.. note::
    - 電磁力の出力は電流方向に等間隔に ``NDIV`` 分割して出力される。
    - コイル断面方向に分割して出力するときは、それぞれの部分を個々に定義する。
    - 分割数、ガウス積分点数は、コイル内の磁場分布に依存するので、計算時間と精度を考慮して決めること。最大ガウス積分次数は **12**。
    - 軸対称二次元計算の場合は、:paramdef:`DELTA_Z_THETA(12)` に対して、- ``DELTA_Z_THETA(12)`` /2 から ``DELTA_Z_THETA(12)`` /2 の部分を入力すること。この場合、``INT_Z`` =1 で充分。
    - ``MESH-(17.1.8)`` の場合、積分要素を定義要素以上分割できないため必ず NDIV=1 とすること。

--------------------------

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*17.1.9 無限直線電流 LINE*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

無限直線電流入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 8

    .. code-block:: text
        :caption: テキストフォーマット

        * LINE * CURRENT * X0 * Y0 * Z0 * DX * DY * DZ *
        LINE    E        E    E    E    E    E    E

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "LINE",
                        "CURRENT" : E,
                        "XYZ0" : [E, E, E],
                        "DXYZ" : [E, E, E]
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^
*LINE*
^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: LINE(17.1.9)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 無限直線電流要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
*CURRENT*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.1.9)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: A
:説明: 規格化電流値。

^^^^^^^^^^^^^^^^^^^^^^^^
*XYZ0*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: XYZ0(17.1.9)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 実数配列 (E)
:単位: m
:数: 3
:説明: 直線の通過する点の座標。

^^^^^^^^^^^^^^^^^^^^^^^^
*DXYZ*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: DXYZ(17.1.9)



.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

:型: 実数配列 (E)
:単位: 無し
:数: 3
:説明: 直線の方向ベクトル成分。

.. caution::
    電流の断面は点としており，直線の近傍の磁場は無限大に発散する。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*17.1.10 ダイポール磁場 DIPO*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ダイポール磁場入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 2

    .. code-block:: text
        :caption: テキストフォーマット

        * DIPO * DBZDX *
        DIPO    E

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "DIPO",
                        "DBZDX" : E
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^^
*DIPO*
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: DIPO(17.1.10)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: ダイポール磁場要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
*DBZDX*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: DBZDX(17.1.10)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 実数 (E)
:単位: T/m
:説明: z 方向磁場の x 方向への規格化磁場勾配。


磁場は次の式で与えられる。

    Bx = DBZDX * z, By = 0, Bz = DBZDX * x.

    Ax = 0, Ay = DBZDX/2 * (x**2 - z**2), Az = 0.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*17.1.11 永久磁石 EXMAG*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

永久磁石入力を指定する。

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 2

    .. code-block:: text
        :caption: テキストフォーマット

        * EXMAG * READ_OPTION *
        EXMAG   I
        * MAT_ID * COORD_ID * MXYZ *
          I   I   E    E    E

.. code-block:: json
    :caption: JSONフォーマット

                "data" : 
                [
                    {
                        "type" : "EXMAG",
                        "READ_OPTION" : I,
                        "MAT_ID" : I,
                        "COORD_ID" : I,
                        "MXYZ" : [E, E, E]
                    }
                ]

^^^^^^^^^^^^^^^^^^^^^^^^^^^
*EXMAG*
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: EXMAG(17.1.11)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 永久磁石要素の定義。

^^^^^^^^^^^^^^^^^^^^^^^^
*READ_OPTION*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: READ_OPTION(17.1.11)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

.. list-table:: 読込オプション
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0
      - 外部ATLASファイル *EXMAG_magnetization* からの読み込み。
    * - 1
      - *EXMAG_mesh* ファイルからの読み込み。

.. caution::
    ``READ_OPTION`` = 1 では，:paramdef:`INPUT_MESH_FILE(10.2)` で指定したATLASファイルが必要です。  

    ``READ_OPTION`` = 0 では，外部ファイル *EXMAG_magnetization* が必要です。動作不定のため，試用したい場合はお問い合わせください。

^^^^^^^^^^^^^^^^^^^^^^^^
*MAT_ID*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: MAT_ID(17.1.11)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 1]


:型: 整数 (I)
:説明: *EXMAG_geom* ファイル中の物性番号。

^^^^^^^^^^^^^^^^^^^^^^^^
*COORD_ID*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: COORD_ID(17.1.11)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 2]

:型: 整数 (I)
:説明: *EXMAG_geom* ファイル中の座標番号( :paramdef:`COORD_ID(12)` )。

^^^^^^^^^^^^^^^^^^^^^^^^
*MXYZ*
^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: MXYZ(17.1.11)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 2]

:型: 実数配列 (E)
:単位: T
:説明: 磁化ベクトル成分。

``EXMAG`` 要素は磁化分布を与える永久磁石形状を六面体要素で作成したメッシュ入力を表します。  
:paramdef:`INPUT_MESH_FILE(10.1)` で指定した形式のメッシュファイル ( *EXMAG_geom* ) が必要です。
``MXYZ`` で磁化ベクトルを与えるため，非一様な磁化分布を与えることはできません。

.. important::
    EXMAG 要素は，COILであるため外部磁場ソースとして永久磁石相当の磁化を与える。そのため，自己減磁や外部磁界による磁化変化は考慮されない。
