:tocdepth: 1

==================================
printoutタグ
==================================

.. index::
	single: printoutタグ

[|today| 更新]

| outputファイルにプリント出力される項目に関して設定します．ハンドブックの
|    11.1 出力オプション 
| の節の項目の設定を行います．
| 基本的に， **0: 出力しない** , **0以外: 出力する** です．

.. csv-table:: printout:タグ
	:header: ラベル, 既定値, 説明
	:widths: 3, 1, 7 

	MESH, 0, "メッシュ情報(デバッグ用途)"
	A, 0, "辺要素A情報(デバッグ用途)"
	V, 0, "スカラポテンシャルΦ情報(デバッグ用途)"
	B_INTEG, 0, "| 空間磁場
	| 1: 有効桁6桁, 2: 有効桁9桁, 3: 有効桁16桁
	| **integregionおよびpoint第2タグを使った追加データが必要** "
	HEAT, 0, "発熱量"
	MAG_FLUX, 0, "| 閉曲線に鎖交する磁束量
	| **loop第2タグを使った追加データが必要** "
	CUR_FLUX, 0, "| 閉曲面に鎖交する電流量
	| **surf第2タグを使った追加データが必要** "
	FORCE_J_B, 0, "ローレンツ力"
	FORCE_NODAL, 0, "| 1: 電磁力
	| 2: 空気を含む領域の節点力積算値
	| **forcenodal第2タグを使った追加データが必要** "
	MAGNETIC_ENERGY, 0, "磁気エネルギー"
	IRON_LOSS, 0, "| 1: 磁束密度の最大値を用いた鉄損
	| 1: 磁気鉄損（交流定常解析時)
	| **ironloss第2タグを使った追加データが必要** 
	| 2: 磁束密度波形を用いた鉄損
	| 3: Playモデルによるヒステリシス損失"
	COIL_FORCE, 0, "| COIL積分要素の電磁力
	| **integregion第2タグを使った追加データが必要** "

.. note::

	| ハンドブックには， **COIL_FORCE** ラベル(コイルに働くローレンツ力)は
	| 10.2 出力ファイルの設定項目に含まれていますが，
	| ローレンツ力はoutputファイルに出力されるので，
	| EMYでは，outputfile:タグではなく，printout:タグに含めました.

| 特定の出力項目では，下記に示す第2タグを使った項目を追加します．

.. csv-table:: print:タグの第2タグ
	:header: 第2タグ, 説明
	:widths: 1, 1

	:ref:`printloop`, 閉曲 **線** の設定
	:ref:`surf`, 閉曲 **面** の設定
	:ref:`integregion`, 空間磁場用の空間の設定
	:ref:`point`, 空間磁場の算出点の座標の設定
	:ref:`forcenodal`, 節点力積算領域の設定
	:ref:`ironloss`, 鉄損算出パラメータの設定

.. _printloop:

loop第2タグ
==================

| MAG_FLUXを有効(1)にして閉曲 **線** に鎖交する磁束量を算出する際の，閉曲 **線** の設定を行います．

1. 節点群の番号（NODE_IDSラベル使用）
2. 線要素群の物性番号（LINE_MAT_IDSラベル使用）
3. プレート要素群の物性番号（MAT_IDSラベル使用）

のうちのいずれかの方式に応じたラベルを使って，番号を記載して下さい．

.. csv-table:: loop第2タグ
	:header: ラベル, 既定値, 説明
	:widths: 3, 1, 7

 	NODE_IDS, "", "閉ループを構成する節点群の番号"
	LINE_MAT_IDS, "", "閉ループを構成している線要素群の物性番号"
	MAT_IDS, "", "閉ループを構成しているプレート要素群の物性番号"

使用例（節点群の番号を使って2本の閉曲 **線** に鎖交する磁束量を算出）
-------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  MAG_FLUX: 1
	  loop:
	    NODE_IDS: 2000 2001 2002 2003 2004 2005 2006
	    NODE_IDS: 3000 3001 3002 3003 3004

使用例（線要素群の物性番号を使って2本の閉曲 **線** に鎖交する磁束量を算出）
------------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  MAG_FLUX: 1
	  loop:
	    LINE_MAT_IDS: 1000
	    LINE_MAT_IDS: 1001

使用例（プレート要素群の物性番号を使って2本の閉曲 **線** に鎖交する磁束量を算出）
----------------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  MAG_FLUX: 1
	  loop:
	    MAT_IDS: 100
	    MAT_IDS: 101

.. _surf:

surf第2タグ
==========================

| CUR_FLUXを有効(1)にして閉曲 **面** に鎖交する電流量を算出する際の，閉曲 **面** の設定を行います．

.. csv-table:: surf第2タグ
	:header: ラベル, 既定値, 説明
	:widths: 3, 1, 7

 	MAT_IN_NOS, "", "閉曲 **面** を構成するプレート要素の物性番号"

使用例（2面の閉曲 **面** に鎖交する電流量を算出）
----------------------------------------------------------

.. code-block:: YAML

	printout:
	  CUR_FLUX: 1
	  surf:
	    MAT_IN_NOS: 100
	    MAT_IN_NOS: 101

.. _integregion:

integregion第2タグ
==========================

* B_INTEGを有効(1)にして空間磁場を算出する場合
* COIL_FORCEを有効(1)にしCOIL積分要素の電磁力を算出する場合

に必要なデータの各種設定を行います．

.. csv-table:: integregion第2タグ
	:header: ラベル, 既定値, 説明
	:widths: 3, 1, 7

	X_SYMMETRY, 0, "| x=0面における対称性の有無
	| 0: 対称性無し
	| 1: Bn=0面
	| -1: Ht=0面"
	Y_SYMMETRY, 0, "| y=0面における対称性の有無
	| 0: 対称性無し
	| 1: Bn=0面
	| -1: Ht=0面"
	Z_SYMMETRY, 0, "| z=0面における対称性の有無
	| 0: 対称性無し
	| 1: Bn=0面
	| -1: Ht=0面"
	ROTATION, 1, "z軸に対する回転対称次数"
	INTEG_OPT, 0, "| 積分する算出点
	| 0: ガウス積分点上の値で積分
	| 1: 重心の値で積分"
	MESH_INPUT, 0, "1: 空間磁場の算出点にB_integ_meshファイルの節点データを使う"
	MAT_IDS, "", "空間磁場の算出に必要な要素群の物性番号"
	COIL_SERIES_NOS, "", "空間磁場の算出に必要な外部電流磁場ソースの番号"

.. _point:

point第2タグ
==========================

| point第2タグは，空間磁場の算出点の座標(x, y, z)を，1行ずつ記載して下さい．
| 下記のn行を，算出点の個数ぶんだけ記載して下さい．

.. csv-table:: point第2タグ
	:header: 行, 列, 説明, 項目
	:widths: 1, 1, 5, 2

	n, 1, 算出点のX座標, XP
	n, 2, 算出点のY座標, YP
	n, 3, 算出点のZ座標, ZP

使用例（x=0面およびy=0面がBn=0面, z=0面がHt=0面で，物性番号1, 3が寄与）
---------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  B_INTEG: 1
	  integregion:
	    X_SYMMETRY: 1
	    Y_SYMMETRY: 1
	    Z_SYMMETRY: -1
	    MATIDS: 1 3
	  point:
	    0 0 0
	    0 0 1
	    ....

.. _forcenodal:

forcenodal第2タグ
=================

| 節点力を算出する要素群の物性番号を設定します．
| 節点力を算出する領域の物性番号を1行で入力して下さい．
| 複数の領域の節点力を算出する場合は，各領域毎に1行ずつ物性番号を入力して下さい．

使用例（物性番号10,11,12と20,21の2つのグループの節点力を算出）
---------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  FORCE_NODAL: 2
	  forcenocal:
	    10 11 12
	    20 21

.. _ironloss:

ironloss第2タグ
=================

| 鉄損の算出に必要な各種パラメータを設定します．
| 交流定常解析の場合は，FREQUENCYラベルのみ設定して下さい．

.. csv-table:: ironloss第2タグ
	:header: ラベル, 既定値, 説明
	:widths: 3, 1, 7

 	FREQUENCY, , "周波数"
	ALPHA, 2, "積層面内渦電流損の周波数のべき乗"
	BETA, 2, "積層面内渦電流損の磁束密度のべき乗"
	GAMMA, 2, "ヒステリシス損失の磁束密度のべき乗"

使用例（周波数 50[Hz] それ以外は既定値）
---------------------------------------------------------------------------

.. code-block:: YAML

	printout:
	  IRON_LOSS: 1
	  ironloss:
	    FREQUENCY: 50
