data.GrayscaleImage

data.GrayscaleImage(self, array, *, adjacency=four_points_adjacency())

GrayscaleImage オブジェクトは、形状が (n, m) のスカラー配列を表します。
このオブジェクトは AbstractGraph を継承しており、格子グラフとして扱われます。

nodes、edges、および link_table は Geometry グラフのものと互換性があります。
ノードは 2 次元整数格子上に位置するピクセルです。
典型的な格子グラフと比較すると、GrayscaleImage の隣接関係は一般化されています。
すなわち、各格子点は参照球近傍内の点と接続されます。
この球近傍は adjacency パラメータによって指定され、リンクの実体は保持されません。
この非典型的な隣接構造は、グレースケール画像におけるトポロジカルノイズへの対処や、
データサイズや球近傍が大きい場合のメモリ使用量の過剰増大を防ぐことを目的としています。

パラメータ

名前	型	説明	デフォルト
array	numpy.ndarray	グレースケール画像を表す 2 次元数値配列	必須
adjacency	numpy.ndarray	格子隣接関係を表す 2 次元数値配列	four_points_adjacency()

注意

adjacency パラメータには、以下のような配列を生成する関数のいずれかを使用することを想定しています。

• box_adjacency(r): 半径 r のボックス内にあるすべての格子点を接続します。
• ball_adjacency(p, r): 半径 r の L^p 球内にあるすべての格子点を接続します。
• four_points_adjacency(): ball_adjacency(1, 1) と等価（デフォルト）。
• eight_points_adjacency(): box_adjacency(1) と等価。

クラス

名前	説明
MockLinkTable	Edge 実体を保持しない GrayscaleImage 用のモックリンクテーブル

MockLinkTable

data.GrayscaleImage.MockLinkTable(image)

Edge 実体を保持しない GrayscaleImage 用のモックリンクテーブル。

メソッド

名前	説明
create_graph	GrayscaleImage のファクトリメソッド
to_geometry	与えられた 2 次元配列 pict を格子ジオメトリに変換する

create_graph

data.GrayscaleImage.create_graph()

GrayscaleImage のファクトリメソッド。

to_geometry

data.GrayscaleImage.to_geometry()

与えられた 2 次元配列 pict を格子ジオメトリに変換します。
格子ジオメトリにおけるエッジは 4 近傍を結びます。
格子ジオメトリにおけるノードは、
{'x': i, 'y': j, 'level': pict[i, j], 'geotype': 0}
という属性を持ちます。

戻り値

名前	型	説明
geometry	psiclone.data.Geometry	格子ジオメトリ