.. _17_6_SUFCUR:

##################################
**17.6 面流入電流ソース**
##################################

有限要素内の導体領域の端面に電流入力面を定義し，渦電流解析により外部からの電流と渦電流の両方を考慮することができます。

---------------------
設定項目
---------------------

:paramdef:`SUFCUR(17.6)`    JSONキー：面流入電流ソースオブジェクト

    :paramdef:`SERIES_ID(17.6)`        系列番号。

    :paramdef:`IN_ROTOR(17.6)`        定義領域が回転子にあるかどうかのフラグ。

    :paramdef:`SMAT_ID(17.6)`        流入面を構成する面要素の物性番号。

    :paramdef:`CURRENT(17.6)`        規格化電流値。


:paramdef:`SUFCUR2(17.6.2)`    JSONキー：複数導体面流入電流ソースオブジェクト

    :paramdef:`SERIES_ID(17.6.2)`        系列番号。

    :paramdef:`IN_ROTOR(17.6.2)`        定義領域が回転子にあるかどうかのフラグ。

    :paramdef:`MAT_IDS(17.6.2)`        要素の物性番号。

    :paramdef:`SMAT_ID(17.6.2)`        流入面を構成する面要素の物性番号。

    :paramdef:`CURRENT(17.6.2)`        規格化電流値。

---------------------
設定フォーマット
---------------------
.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

        :種類: 固定パラメータセット1
        :行数: 1  
        :パラメータ数: 6

    .. code-block:: text
        :caption: Text format

        * SUFCUR * SERIES_NO * TIME_ID * SURFACE_MAT_ID * CURRENT * IN_ROTOR *
        SUFCUR        I         I         I                 E       I

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション
    
        :種類: 固定パラメータセット1
        :行数: 2  
        :パラメータ数: 4, 3

    .. code-block:: text
        :caption: Text format

        * SUFCUR2 * SERIES_NO * NO_PARTS * IN_ROTOR *
        SUFCUR2        I         I        I
        * MAT_ID * SMAT_ID * CURENT * 
            I      I        E


======================
JSONフォーマット
======================

.. code-block:: json
    :caption: JSON format from 2024.11

    "17_Field_Source" : 
    [
        {
            "SUFCUR" : 
            {
                "SERIES_ID" : I,
                "TIME_ID" : I,
                "SMAT_ID" : I,
                "CURRENT" : E,
                "IN_ROTOR" : I
			},
            "SUFCUR2" : 
            {
                "SERIES_ID" : I,
                "IN_ROTOR" : I,
                "data" : 
                [
                    {
                        "MAT_IDS" : [ I ],
                        "SMAT_ID" : I,
                        "CURRENT" : E,
                        "CAL_Je" : I
                    }
                ]
            }
        }
    ]

---------------------
**詳細説明**
---------------------

``SUFCUR`` は導体領域の端面に電流入力面を定義し，渦電流解析により外部からの電流と渦電流の両方を考慮することができます。

.. hint:: 
    二次元解析で ``SUFCUR`` を使用すると，渦電流を含む導体に電流を与えることと等価となります。

    三次元解析では，導体形状に合わせた導電電流と，表皮効果などによる渦電流が重畳された電流分布となります。

``SUFCUR2`` は，複数の導体領域に電流を与える場合に使用します。例えば複数導体からなるモータコイルを電源に接続し，鎖交磁束を算出したい場合に使用します。

==========================
**SUFCUR**
==========================
.. paramdef:: SUFCUR(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]
 
:型: 文字列 (S)
:説明: 面流入電流ソース ``SUFCUR`` の指定。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**SERIES_ID**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: SERIES_ID(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 整数 (I)
:説明: ソース項の識別番号。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**TIME_ID**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: TIME_ID(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]

:型: 整数 (I)
:説明: 時間依存性のある電流を与える場合の時間定義番号。

.. hint:: 
    ソースが :paramdef:`CIRCUIT(17.8)` あるいは :paramdef:`NETWORK(17.9)` に接続される場合は 0 とすること。:paramdef:`CIRCUIT(17.8)` あるいは :paramdef:`NETWORK(17.9)` に接続することを推奨します。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**SMAT_ID**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: SMAT_ID(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 1]

:型: 整数 (I)
:説明: 流入面を構成する面要素の物性番号。面方向は任意。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**CURRENT**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: CURRENT(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 2]

:型: 実数 (E)
:単位: A
:説明: 通過規格化電流量。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**IN_ROTOR**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: IN_ROTOR(17.6)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

.. list-table:: 定義領域が回転子にあるかどうかのフラグ
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0
      - 固定部内。 **デフォルト値**
    * - 1
      - 可動部内。  

交流定常解析で，スライド運動でスリップがある場合，  
:paramdef:`N_CORRECT(8)` ≠0 の場合必要。


.. figure:: figs/sufcur.png
    :align: center
    :name: SUFCUR
    :alt: SUFCURの定義例

    ``SUFCUR`` の定義例

------------------------

==========================
**SUFCUR2**
==========================
.. paramdef:: SUFCUR2(17.6.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 1]

:型: 文字列 (S)
:説明: 複数導体面流入電流ソース ``SUFCUR2`` の指定。

設定方法は :paramdef:`PHICOIL(17.4)` とほぼ同じです。

計算時は ``SUFCUR`` として扱われます。
ポスト処理時の電気回路接続時の導体領域鎖交磁束の算出では， :paramdef:`PHICOIL(17.4)` として計算された規格化直流電流分布を使用して計算されます。そのため， :paramdef:`PHICOIL(17.4)` の渦電流を考慮した磁場ソースと等価になります。

.. hint:: 
    ``SUFCUR2`` は，複数の導体領域に電流を与える場合に使用します。例えば複数導体からなるモータコイルを電源に接続し，鎖交磁束を算出したい場合に使用します。

    ``SUFCUR2`` は， ``SUFCUR`` と同じように，導体領域の端面に電流入力面を定義し，渦電流解析により外部からの電流と渦電流の両方を考慮することができます。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**SERIES_ID**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: SERIES_ID(17.6.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 2]

:型: 整数 (I)
:説明: ソース項の識別番号。


.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    **NO_PARTS（テキストのみ）**

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 3]
        Type=I

    領域に設定するプロパティの数。 ``NO_PARTS`` で指定した ``SUFCUR2`` は独立した導体領域と電流入力面を持つ必要があります。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**IN_ROTOR**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: IN_ROTOR(17.6.2)
.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [1, 4]

.. list-table:: 定義領域が回転子にあるかどうかのフラグ
    :header-rows: 1

    * - 設定値
      - 説明
    * - 0
      - 固定部内。 **デフォルト値**
    * - 1
      - 可動部内。

交流定常解析で，スライド運動でスリップがある場合，  
:paramdef:`N_CORRECT(8)` ≠0 の場合必要。  

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**data**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. paramdef:: data(17.4)

:JSONキー: 面流入電流ソースのデータ

``data`` は配列で， ``SUFCUR2`` 要素の数だけ定義する。

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**MAT_IDS**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: MAT_IDS(17.6.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 1]

:型: 整数配列 (I)
:説明: 要素の物性番号 ( :paramdef:`MAT_ID(16.1)` )。

.. note:: 
    複数の導体領域を一つの ``SUFCUR2`` として定義する場合に，JSONフォーマットを使用して配列で設定します。

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**SMAT_ID**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: SMAT_ID(17.6.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 2]

:型: 実数 (E)
:単位: A
:説明: 通過規格化電流量。

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**CURRENT**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. paramdef:: CURRENT(17.6.2)

.. collapsible:: 
    :title: テキストフォーマットの折りたたみセクション

    .. code-block:: none
        :caption: 固定パラメータセット1

        [row, col] = [2, 3]

:型: 実数 (E)
:単位: A
:説明: 通過規格化電流量。

    巻線コイルの場合，ターン数と読み替えると理解しやすい。