pyvista.DataObject.add_field_data

DataObject.add_field_data(array: ndarray, name: str, deep: bool = True)

フィールドデータを追加します．

データセットに関連付けたいデータのサイズが，データセットのポイント数やセル数と一致しない場合，フィールドデータを使用します．

パラメータ:

arraysequence

データセットにフィールド配列として追加するデータの配列．

namestr

フィールド配列に割り当てる名前．

deepbool, default: True

データセットにデータを追加する際に，データのディープコピーを行います．

例

PolyDataデータセットにフィールドデータを追加します．

>>> import pyvista as pv
>>> import numpy as np
>>> mesh = pv.Sphere()
>>> mesh.add_field_data(np.arange(10), 'my-field-data')
>>> mesh['my-field-data']
pyvista_ndarray([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])

ImageDataデータセットにフィールドデータを追加します．

>>> mesh = pv.ImageData(dimensions=(2, 2, 1))
>>> mesh.add_field_data(
...     ['I could', 'write', 'notes', 'here'], 'my-field-data'
... )
>>> mesh['my-field-data']
pyvista_ndarray(['I could', 'write', 'notes', 'here'], dtype='<U7')

MultiBlockデータセットにフィールドデータを追加します．

>>> blocks = pv.MultiBlock()
>>> blocks.append(pv.Sphere())
>>> blocks["cube"] = pv.Cube(center=(0, 0, -1))
>>> blocks.add_field_data([1, 2, 3], 'my-field-data')
>>> blocks.field_data['my-field-data']
pyvista_ndarray([1, 2, 3])