Anatomography map API configuration

Part configuration category

パーツのID、色、不透明度など、描画対象パーツに関するconfiguration parameter群を設定します。

Configuration parameter

"Part" categoryには以下のパラメータが存在します。

Configuration category デフォルト値 説明 指定可能な値
"Part":[ パーツパラメータを、カンマ区切りで繰り返し
{ パラメータの連想配列
"PartID": "" パーツのFMA ID（PartNameより優先されます） 描画可能な任意のFMA ID
"PartName": "" FMAのPreferred Name（PartID未指定時に有効） 描画可能な任意のFMA Preferred Name
"PartColor": "FFFFFF" 16進数表記のパーツ描画色 "000000"～"FFFFFF"
"PartScalar": 0 パーツに割り当てる数値（ScalarColorFlagをtrueにした際に利用） 任意の数値
"ScalarColorFlag": false ヒートマップ表示に利用するかどうかを指定 true|false
"PartOpacity": 1 パーツの不透明度 0～1の任意の数値
"PartRepresentation": "surface" パーツの描画方法 "surface"|"wireframe"|"point"
"UseForBoundingBoxFlag": true ズーム値算出時のバウンディングボックス計算に利用するかどうかを指定 true|false
"PartDeleteFlag": false パーツを描画しない場合にtrueを指定します true|false
}
]

パラメータの使用例

パーツを指定する（"PartID"、"PartName"パラメータ）

描画対象のパーツを指定します。パーツはFMA IDないし、FMAのPreferred Nameによる指定が可能です。
"Part"セクションは複数のパーツを描画することが前提のため、パーツが1つであっても配列として表記する必要があります。例えば、FMA5018のパーツを描画する場合には、下記のように記述します。

同様に、FMA Preferred Nameを利用して下記のように記述することも可能です。
"PartID"および"PartName"を同時に指定した場合には、"PartID"が優先されます。

パーツの色を指定する（"PartColor"パラメータ）

パーツの描画色を指定するには"PartColor"パラメータを利用します。色の指定は赤、緑、青をそれぞれ16進数2桁で表した文字列で構成します。赤ならば"FF0000"、緑ならば"00FF00"、青ならば"0000FF"とあらわされ、黒（"000000"）から白（"FFFFFF"）まで、65536色を表現することができます。
色を指定せずにFMA5018のパーツを描画する場合には白（"FFFFFF")がデフォルト値として採用されますが、明示的に色を指定することで、指定パーツを異なる色で描画することが可能です。例えば赤（"FF0000"）で描画するように指定するには下記のように記述します。

色の指定はパーツ毎に行うことができるので、FMA7148（Stomach）を黄色（"FFFF00")で描画するように追加すると、FMA5018は赤、FMA7148は黄色で同時に描画されます。
包含関係にあるパーツのうち、包含されているパーツの指定を追加することで、その部分だけパラメータを上書きすることが可能です。例えば、FMA5018の他に、FMA9139（"Thoracic vertebra"）に対して別の色を指定して記述することで、FMA9139に該当する部分だけ、色を変えることが可能です。

Choroplethマップ表示をする（"PartScalar"、"ScalarColorFlag"パラメータ）

"PartScalar"パラメータに値を与えておくことで、パーツに割り当てられた値によって色を定義することができます。Choroplethマップ表示には、"Common"カテゴリの"ScalarColorFlag"、"ScalarMaximum"、"ScalarMinimum"パラメータに対する設定も行ってください。
FMA7148（Stomach）に10000、FMA7198（Pancreas）に42000、FMA7202（Gallbladder）に481、FMA7204（Right kidney）に-1589、FMA7205（Left kidney）に-20000という値を設定し、それぞれの"ScalarColorFlag"をtrueに設定しておくことで、Choroplethマップ表示時に、設定した値を元に色が決定されます。

半透明のパーツを描画する（"PartOpacity"パラメータ）

一部が隠れてしまう位置関係にある複数のパーツを同時に描画する場合に、手前側にあるパーツを半透明で描画することにより、隠れてしまうパーツも可視化することが可能です。"PartOpacity"パラメータはパーツ毎に不透明度を定義するパラメータで、1を指定すると完全に不透明になり、0を指定すると完全に透明となります。
FMA5018（"bone organ"）と同時に、FMA12224（"Segment of tracheobronchial tree"）を描画する場合、FMA5018の不透明度を下げることで、FMA1224を見やすく描画することが可能です。

背景用のパーツを定義する（"UseForBoundingBoxFlag"パラメータ）

形状から判別のつかない小さなパーツを描画する場合、骨格など、人体におけるおおまかな位置情報を把握しやすいパーツを同時に描画することで、効果的な図を作成することが可能です。"UseForBoundingBoxFlag"をfalseに設定したパーツは、描画されても、ズーム値の計算に利用されないため、このような背景用のパーツを描画する際に利用します。
FMA7196（Spleen）とFMA7198（Pancreas）を描画する際に、背景としてFMA5018（"bone organ"）を描画します。

パーツの一部を描画しない（"PartDeleteFlag"パラメータ）

多くの部品から構成されるパーツの一部だけが不要な場合、個々の部品となっているパーツを合わせて組上げるよりも、不要なパーツだけを取り除く方が効率的な場合があります。
例えば、FMA5018(bone organ)のFMA52734(frontal bone)が不要な場合、下記のように記載をすることで、FMA52734の後ろにあるパーツ（FMA50801、brain）が見やすくなります。