polyshape
2 次元の多角形のような形状
説明
関数 polyshape は、2 次元の頂点から多角形のような形状を作成します。ただし、多角形とは異なり、polyshape は不連続の領域および穴をもつことができます。polyshape オブジェクトのプロパティでは頂点、固体領域、および穴を記述します。
たとえば、pgon = polyshape([0 0 1 1],[1 0 0 1]) は 4 点 (0,1)、(0,0)、(1,0)、(1,1) で定義される固体正方形を作成します。
>> pgon = polyshape([0 0 1 1],[1 0 0 1])
pgon =
polyshape with properties:
Vertices: [4×2 double]
NumRegions: 1
NumHoles: 0>> plot(pgon)
作成
polyshape オブジェクトの作成時に、入力頂点により、交差がなく適切に入れ子になっている多角形の境界を 1 つ以上定義する必要があります。そうしない場合、関数 polyshape は必要に応じて入力頂点を自動的に変更し、適切に定義された多角形を作成します。
正多角形を作成する場合、関数 nsidedpoly を使用することもできます。nsidedpoly では、多角形の中心点、辺の長さなどのパラメーターをオプションで指定できます。
構文
説明
pgon = polyshape() は、空の polyshape オブジェクトを作成します。
pgon = polyshape( は、N 行 2 列の行列 P)P (N は頂点の数) で定義される 2 次元の頂点から polyshape を作成します。P の 1 列目は x 座標を定義し、2 列目は y 座標を定義します。
pgon = polyshape(___, は、前述の任意の構文について、Name,Value)polyshape オブジェクトを作成するための追加パラメーターを指定します。
入力引数
名前と値の引数
プロパティ
オブジェクト関数
例
4 つの点で構成される多角形を作成してプロットし、その面積、周囲長、重心座標を計算します。
pgon = polyshape([0 0 1 3], [0 3 3 0]); plot(pgon)
A = area(pgon)
A = 6
P = perimeter(pgon)
P = 10.6056
[Cx Cy] = centroid(pgon)
Cx = 1.0833
Cy = 1.2500
境界が交差している多角形を解析します。
境界に自己交差が存在する多角形を作成します。既定では、関数 polyshape は境界を 2 つの個別の境界に分割し、適切に定義された多角形を作成します。
P = [0 0; 1 1; 1 0; 0 1; 0 0]; pgon = polyshape(P)
Warning: Polyshape has duplicate vertices, intersections, or other inconsistencies that may produce inaccurate or unexpected results. Input data has been modified to create a well-defined polyshape.
pgon =
polyshape with properties:
Vertices: [7×2 double]
NumRegions: 2
NumHoles: 0
多角形をプロットして、面積を計算します。
plot(pgon)
A = area(pgon)
A = 0.5000
元の入力頂点を単純化しない場合、多角形の 2 つの三角形領域の面積が相殺されます。
pgon2 = polyshape(P,'Simplify',false)pgon2 =
polyshape with properties:
Vertices: [4×2 double]
NumRegions: 1
NumHoles: 0
A2 = area(pgon2)
A2 = 0
入れ子になった境界がある多角形を解析します。
適切に入れ子になっている 2 つの境界がある多角形を作成します。polyshape は、最も外側にある境界を、固体領域の外側の境界として定義します。内側に向かって次の境界は、穴の開始を定義します。
t = 0.05:0.5:2*pi;
x1 = cos(t);
y1 = sin(t);
x2 = 0.5*cos(t);
y2 = 0.5*sin(t);
pgon = polyshape({x1,x2},{y1,y2})pgon =
polyshape with properties:
Vertices: [27×2 double]
NumRegions: 1
NumHoles: 1
plot(pgon)
関数 addboundary を使用して、pgon に 3 番目の外側の境界を追加する 2 番目の多角形を作成します。
x3 = 2*cos(t); y3 = 2*sin(t); pgon2 = addboundary(pgon,x3,y3)
pgon2 =
polyshape with properties:
Vertices: [41×2 double]
NumRegions: 2
NumHoles: 1
plot(pgon2)
3 番目の外側の境界を追加するには、polyshape が新しい入れ子パターンに基づいて固体の境界と穴の境界を再構成する必要があります。前述のとおり、polyshape は固体領域の開始を示す最も外側の境界から始まり、内側に向かって、入れ子になっているそれぞれの境界で穴の境界と固体の境界を切り替えます。新しい多角形には 2 つの固体領域と 1 つの穴があります。
