pyvista.ImageDataFilters.contour_labeled#

ImageDataFilters.contour_labeled(n_labels: int | None = None, smoothing: bool = False, smoothing_num_iterations: int = 50, smoothing_relaxation_factor: float = 0.5, smoothing_constraint_distance: float = 1, output_mesh_type: Literal['quads', 'triangles'] = 'quads', output_style: Literal['default', 'boundary'] = 'default', scalars: str | None = None, progress_bar: bool = False) → PolyData[ソース]#

3Dラベルマップからラベル付きコンターを生成します．

SurfaceNetsアルゴリズムは，ラベルマップから選択されたラベルのシャープな境界を保持する輪郭を抽出するために使用されます．オプションとして，低解像度の入力ラベルマップの場合、階段状の外観を減らすために境界を平滑化することができます．

このフィルタは ImageData が画像セグメンテーションから生成されたマルチラベルマップのような整数の点スカラーを持っていることを必要とします．

注釈

vtk>=9.3.0 が必要です．

パラメータ:

n_labelsint, optional: 抽出されるラベルの数(Noneを指定するとすべて抽出されます)．
smoothingbool, default: False: メッシュにスムージングを適用します．
smoothing_num_iterationsint, default: 50: 平滑化の繰り返し回数．
smoothing_relaxation_factorfloat, default: 0.5: 平滑化の緩和係数．
smoothing_constraint_distancefloat, default: 1: 平滑化の拘束距離．
output_mesh_typestr, default: 'quads': 出力メッシュのタイプ． 'quads' または 'triangles' でなければなりません．
output_stylestr, default: 'default': 出力メッシュのスタイル． 'default' または 'boundary' のいずれかを指定する必要があります． 'default' を指定すると，内側と外側の両方のポリゴンを持つメッシュが生成されます． 'boundary' を選択すると，背景との境界線上のポリゴンだけが生成されます(内側のポリゴンは生成されません)．スタイル 'selected' は現在実装されていないことに注意してください．
scalarsstr, optional: 処理に使用するスカラーの名前．デフォルトは現在アクティブなスカラーです．
progress_barbool, default: False: 進行状況を示す進行状況バーを表示します．

戻り値:

pyvista.PolyData: pyvista.PolyData セグメントがラベル付けされたメッシュ．

参考

pyvista.DataSetFilters.contour: 一般化された輪郭抽出手法は，MarchingCubesまたはFlyingEdgesを使用します．
pyvista.DataSetFilters.pack_labels: SurfaceNetsによって内部で使用される関数であり，連続したラベルデータを生成するために使用されます．

参考文献

Sarah F. Frisken, SurfaceNets for Multi-Label Segmentations with Preservation of Sharp Boundaries, Journal of Computer Graphics Techniques (JCGT), vol. 11, no. 1, 34-54, 2022. Available online http://jcgt.org/published/0011/01/03/

https://www.kitware.com/really-fast-isocontouring/

例

このフィルターを使った完全な例についてはコンタリングを参照してください．