:tocdepth: 1

.. role:: bred

==================================
sourceタグ
==================================

.. index::
	single: sourceタグ

[|today| 更新]

| 磁場を生じるソース項の設定を行います． 
| ソース項を表す要素群を必要としない **外部電流磁場ソース** と
| それ以外のソースに分類されます．
|
| 外部電流磁場ソースは，要素の生成が困難なケースに有効ですが，
|    **変形ポテンシャル領域** か，解析領域外(特殊なケース)になくてはならない
|    磁場をビオサバール法を用いて算出するため，前処理時間が長くなる
| ことになります．

| ソース項は，種類に応じて，下記の第2タグに分かれます．
| **外部電流磁場ソース** を表す **coil第2タグ** は，さらに，種類に応じた **第3タグ** を持ちます．
| **電源と結線(NETWORK)ソース** を表す **network第2タグ** も，さらに，種類に応じた **第3タグ** を持ちます．

.. note::

	| コイルには，コイル断面で電流密度が均一となるものと，コイル形状に依存するものがあります．
	| 前者は，多数巻きした全体のコイルとして取り扱う場合に使用し，後者は，1ターン毎のコイルを取り扱う場合に使用します．

.. csv-table:: sourceタグの第2タグ
	:header: 第2タグ, 説明
	:widths: 2, 5 

 	:doc:`coil`, "外部電流磁場ソース"
	:ref:`elmcur`, "内部電流磁場ソース"
	:ref:`sdefcoil`, "表面定義電流ソース"
	:ref:`phicoil`, "ポテンシャル電流磁場ソース"
	:ref:`dccurr`, "複数導体ポテンシャル電流磁場ソース"
	:ref:`sufcur`, "面流入電流ソース"
	:ref:`uniformmagnet`, "一様磁化ソース"
	:ref:`distributedmagnet`, "要素毎の磁化ソース"
	:ref:`sinusoidalmagnet`, "正弦関数分布の磁化ソース"
	:ref:`mathfuncmagnet`, "数式で定義する磁化ソース"
	:ref:`demagnet`, "減磁カーブで定義する磁化ソース"
	:ref:`epotsuf`, "電位面電場ソース"
	:doc:`circuit`, "電源と結線(CIRCUIT)ソース"
	:doc:`network`, "電源と結線(NETWORK)ソース"

.. _elmcur:

elmcur第2タグ
===============

| 磁場解析用に生成したメッシュのうち， **六面体および三角柱要素群** の物性番号を指定してコイルとします．
| **要素毎に通過する電流量** は，コイルに流れる総電流量ではなく，個別の要素に流れる電流量です（しかも全ての要素で同じ）．
| **四面体要素には適用できません** .
| コイル内への電流の流入および，コイル外への電流の流出は，要素の相対面番号を使います．
| 要素の面番号を考慮してメッシュを作成しなくてはならないので，適用できるケースは限られます．

.. csv-table:: elmcur第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, :bred:`0`, "| 要素に流れる電流の与え方
	| 0: 要素毎に通過する電流量
	| 1: 電流密度", OPTION
	1, 3, 0, "| AC解析でスリップがある場合
	| 0: 固定部内
	| 1: 可動部内", IN_ROTOR
	"", "", "", "", ""
	2, 1, "", "要素群の物性番号", "MAT_ID"
	2, 2, "", "電流が流入する面番号", "IN_SURFACE"
	2, 3, "", "電流が流出する面番号", "OUT_SURFACE"
	2, 4, "", "要素に流れる電流(量/密度)", "CURRENT"
	2, 5, "", "要素の導電率", "SIGMA"
	2, 6, "0", 1: コイル内部の渦電流を考慮する, CAL_Je

:bred:`赤字の既定値`: :doc:`configファイル<config>` で既定値の変更が可能

| **elmcurを構成するブロックの数だけ，2行を繰り返し追加して下さい．** 

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  elmcur:
	    1 1           # 電流密度を設定する
	    3 3 5 100 5e7 # 流入(IN_SURFACE): 3, 流出(OUT_SURFACE): 5

.. _sdefcoil:

sdefcoil第2タグ
===================

| 断面が長方形のコイルに適用できます．
| コイルを取り囲む4つの面（電流が平行に流れる面）にプレート要素を作成し，それらの要素群の物性番号を指定します．
| コイル断面の電流分布は均一となります．

.. csv-table:: sdefcoil第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, 0, "| AC解析でスリップがある場合
	| 0: 固定部内
	| 1: 可動部内", IN_ROTOR
	"", "", "", "", ""
	2, 1, "", "要素群の物性番号", "MAT_ID"
	2, 2, "", "導体を取り囲む面1の物性番号", "SMAT_ID1"
	2, 3, "", "導体を取り囲む面2の物性番号", "SMAT_ID2"
	2, 4, "", "導体を取り囲む面3の物性番号", "SMAT_ID3"
	2, 5, "", "導体を取り囲む面4の物性番号", "SMAT_ID4"
	2, 6, "", "コイルに流れる総電流量", "CURRENT"
	2, 7, "", "要素の導電率", "SIGMA"
	2, 8, "0", 1: コイル内部の渦電流を考慮する, CAL_Je

| **sdefcoilを構成するブロックの数だけ，2行を繰り返し追加して下さい．** 

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  sdefcoil:
	    1
	    3 101 102 103 104 1500 5e7

.. _phicoil:

phicoil第2タグ
=====================

| コイルの流入面にプレート要素を作成し，要素群の物性番号を指定します．
| コイル内部の電流分布は，流入面(と流出面)に電位を与えて内部で算出します． 
| コイル断面の電流密度分布は，コイル形状に依存します．

.. csv-table:: phicoil第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, 0, "| AC解析でスリップがある場合
	| 0: 固定部内
	| 1: 可動部内", IN_ROTOR
	"", "", "", "", ""
	2, 1, "", "要素群の物性番号", "MAT_ID"
	2, 2, "", "電流の流入面のプレート要素の物性番号", "SMAT_ID"
	2, 3, "", "コイルに流れる総電流", "CURRENT"
	2, 4, "", "要素の導電率", "SIGMA"
	2, 5, "0", 1: コイル内部の渦電流を考慮する, CAL_Je

| **phicoilを構成するブロックの数だけ，2行を繰り返し追加して下さい．** 

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  phicoil:
	    1
	    10 100 1000 4e6 # 物性番号(MAT_ID): 10

.. _dccurr:

dccurr第2タグ
=====================

| コイルの流入面にプレート要素を作成し，要素群の物性番号を指定します．
| 複数の導電率の異なる導体で構成されたコイルに対し，コイル内部の電流分布を内部で算出します．
| コイル断面の電流密度分布は，コイル形状などに依存します．

.. csv-table:: dccurr第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, 0, "| AC解析でスリップがある場合
	| 0: 固定部内
	| 1: 可動部内", IN_ROTOR
	"", "", "", "", ""
	2, 1, "", "要素群の物性番号", "MAT_ID"
	2, 2, "", "電流の流入面の物性番号", "SMAT_ID"
	2, 3, "", "コイルに流れる総電流", "CURRENT"
	2, 4, "", "要素の導電率", "SIGMA"
	2, 5, "0", 1: コイル内部の渦電流を考慮する, CAL_Je
	"", "", "", "", ""
	3, 1, "", "要素群の物性番号", "MAT_ID"
	3, 2, "", "要素の導電率", "SIGMA"

| **dccurrを構成する ブロック-1の数だけ，3行を繰り返し追加して下さい．** 
| （最初のブロックは2行目で記載してあるため）

使用例（3個のブロックから構成される導体のケース）
----------------------------------------------------

.. code-block:: YAML

	source:
	  dccurr:
	    1
	    1 10 1 1e8 # 物性番号(MAT_ID): 1
	    2 5e7 # 物性番号(MAT_ID): 2
	    3 1e8 # 物性番号(MAT_ID): 3

.. _sufcur:

sufcur第2タグ
=====================

| コイルの流入面にプレート要素を作成します．
| 静磁場解析には使えませんが，コイル内の誘導電流が考慮できます．
| コイル断面の電流密度分布は，コイル形状などに依存します．

.. csv-table:: sufcur第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	1, 3, "", "電流の流入面の物性番号", "SMAT_ID"
	1, 4, "", "コイルに流れる総電流", "CURRENT"
	1, 5, 0, "| AC解析でスリップがある場合
	| 0: 固定部内
	| 1: 可動部内", IN_ROTOR

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  sufcur:
	    1 0 14 0.5

.. _uniformmagnet:

uniformmagnet第2タグ
========================

| 物性番号毎に磁化をベクトル成分で指定する磁石です． 
| ハンドブックの
|   17.7.1 一様磁化入力
| に相当します．
| coordinateタグを使った局所座標成分で，ベクトル成分を設定することができます．

.. csv-table:: uniformmagnet第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	"", "", "", "", ""
	2, 1, "", "要素群の物性番号", "MAT_ID"
	2, 2, "", "局所座標系の番号", "COORD_ID"
	2, 3, "", "局所座標における磁化のx成分", "MX/MR"
	2, 4, "", "局所座標における磁化のy成分", "MY/MT"
	2, 5, "", "局所座標における磁化のz成分", "MZ"

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  uniformmagnet:
	    1 1
	    3 0 0.636 0.636 0

.. _distributedmagnet:

distributedmagnet第2タグ
===========================

| 要素毎に磁化をベクトル成分で指定する磁石です． 
| ハンドブックの
|   17.7.2 要素毎に磁化入力 
| に相当します．
| coordinateタグを使った局所座標成分で，ベクトル成分を設定することができます．

.. csv-table:: distributedmagnet第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	"", "", "", "", ""
	2, 1, "", "要素の物性番号", "MAT_ID"
	2, 2, "", "局所座標系の番号", "COORD_ID"

	3, 1, "", "要素番号", "ELEM_ID"
	3, 3, "", "局所座標における磁化のx成分", "MX/MR"
	3, 4, "", "局所座標における磁化のy成分", "MY/MT"
	3, 5, "", "局所座標における磁化のz成分", "MZ"

| **磁石を構成する要素の数だけ，3行を繰り返し追加して下さい．** 

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  distributedmmagnet:
	    1 1
	    2 0             # 物性番号(MAT_ID): 2
	    1 0.636 0.636 0 # 要素番号(ELEM_ID): 1
	    2 0.640 0.630 0 # 要素番号(ELEM_ID): 2
	    3 0.644 0.624 0 # 要素番号(ELEM_ID): 3
	    ...

.. _sinusoidalmagnet:

sinusoidalmagnet第2タグ
===========================

| 正弦波関数に応じた分布の磁化の磁石です． 
| ハンドブックの
|   17.7.3 正弦関数入力 
| に相当します．
| coordinateタグを使った局所座標成分で，ベクトル成分を設定することができます．

.. csv-table:: sinusoidalmagnet第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 2

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	"", "", "", "", ""
	2, 1, "", "磁極数", "NO_POLES"
	2, 2, "", "基準角度", "ANGLE"
	"", "", "", "", ""
	o, 1, "", "高調波次数", "ORDER"
	o, 2, "", "規格化された振幅", "AMPLITUDE"
	"", "", "", "", ""
	m, 1, "", "物性番号", "MAT_ID"
	m, 2, "", "局所座標系の番号", "COORD_ID"
	m, 3, "", "局所座標における磁化のx成分", "MX/MR"
	m, 4, "", "局所座標における磁化のy成分", "MY/MT"
	m, 5, "", "局所座標における磁化のz成分", "MZ"

| **高調波次数の数だけ，o行を繰り返し追加して下さい．** 
| **磁石を構成する要素群の物性番号の数だけ，m行を繰り返し追加して下さい．**

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  sinusoicalmmagnet:
	    1 1
	    4 45
	    1 1
	    3 0.25
	    5 0.05
	    101 1 1 0 0 
	    102 1 1 0 0
	    103 1 1 0 0
	    104 1 1 0 0

.. _mathfuncmagnet:

mathfuncmagnet第2タグ
===========================

| 磁化の各成分毎に数式を入力する磁石です． 
| ハンドブックの
|   17.7.4 数式入力 
| に相当します．
| coordinateタグを使った局所座標成分で，ベクトル成分を設定することができます．

.. csv-table:: mathfuncmagnet第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 4

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	"", "", "", "", ""
	x, "", "", "磁化のx成分の数式", "FUNCTION_MX(x,y,z)"
	"", "", "", "", ""
	y, "", "", "磁化のy成分の数式", "FUNCTION_MY(x,y,z)"
	"", "", "", "", ""
	z, "", "", "磁化のz成分の数式", "FUNCTION_MZ(x,y,z)"
	"", "", "", "", ""
	m, 1, "", "物性番号", "MAT_ID"
	m, 2, "", "局所座標系の番号", "COORD_ID"

| **磁石を構成する要素群の物性番号の数だけ，m行を繰り返し追加して下さい．**

使用例
-------------------------------------------

.. code-block:: YAML

	source:
	  mathfuncmagnet:
	    1 1
	    MX(x,y,z)=sin(2*(y-(PI/4)))+0.25*sin(6*(y-(PI/4)))+0.05*sin(10*(y-(PI/4)));;
	    MY(x,y,z)=0;;
	    MZ(x,y,z)=0;;
	    101 1
	    102 1
	    103 1
	    104 1

.. _demagnet:

demagnet第2タグ
========================

| 減磁カーブのデータを使用する磁石です． 
| ハンドブックの
|   17.7.5 永久磁石の減磁曲線を用いた非線形解析
| に相当します．

.. csv-table:: demagnet第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 4

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "時間変化を与えるデータ番号", "TIME_ID"
	"", "", "", "", ""
	2, 1, "", "物性番号", "MAT_ID"
	2, 2, "", "| 解析の種類
	| 0: 非線形解析
	| 1: 減磁解析", "TYPE"
	2, 3, "", "減磁カーブ番号", "BH_MAGNET_CURVE_ID"
	2, 4, "", "非容易磁化方向の透磁率", "MU"
	"", "", "", "", ""
	m, 1, "", "局所座標系の番号", "COORD_ID"
	m, 2, "", "局所座標における磁化のx成分", "MX/MR"
	m, 3, "", "局所座標における磁化のy成分", "MY/MT"
	m, 4, "", "局所座標における磁化のz成分", "MZ"

.. _epotsuf:

epotsuf第2タグ
===========================

| 静電場，定常電流場解析で用いる，等電位面電場ソースです． 
| ハンドブックの
|   17.10 電位面電場ソース 
| に相当します．

.. csv-table:: epotsuf第2タグの設定項目
	:header: 行, 列, 既定値, 説明, 項目
	:widths: 1, 1, 1, 4, 3

	1, 1, "", "ソースの番号", SERIES_NO
	1, 2, "", "物性番号", "SURFACE_MAT_ID"
	1, 3, "", "| ソースの種類
	| 静電場解析時
	| 0: トータル表面電荷
	| 1: 電位
	| 定常電流場解析時
	| 0: トータル電流量
	| 1: 電位", "POT_OR_CHARGE"
	1, 4, "", "時間変化を与えるデータ番号", "TIME_ID"
	1, 5, "", "| 静電場解析における表面電荷の単位
	| 0: [C]
	| 1: [C/m^2]", "UNIT_TYPE"

