CutPlane

Create a cut plane data set.

Syntax

model.result().dataset().create(<dtag>,"CutPlane");

model.result().dataset(<dtag>).set(property, <value>);

Description

model.result().dataset().create(<dtag>,"CutPlane") creates a cut plane data set with the name <dtag>.

The following properties are available:

Table 7-17: Valid Property/Value Pairs for Cut Plane Data Sets

Property	Value	Default	Description
data	none | data set name	First compatible data set	The data set this feature refers to.
genparaactive	on | off	off	Decides if parallel lines should be drawn.
genparadist	double array	{}	Active when genparaactive is on, this property contains the distances from the extra parallel planes to the base plane.
genmethod	threepoint | pointnormal	threepoint	Active when planetype equals general, this property indicates whether the plane should be specified by three points or through one point and a normal.
genpoints	double matrix	{{0, 0, 0}, {1,0,0},{0,1,0}}	Active when method equals threepoint, this property contains the coordinates of the three points in the rows of the matrix.
genpnpoint	String array of length three	Zero string vector	Active when genmethod equals pointnormal, this property contains the coordinates of the point.
genpnvec	String array of length three	Zero string vector	Active when genmethod equals pointnormal, this property contains the normal vector.
normal	String array of length three	Created from the feature tag.	The names of the variables that can be used to evaluate the plane’s normal.
planetype	quick | general	quick	Specify plane type
quickplane	xy | yz | zx | yx | zy | xz	yz	Specify quick plane type. Active when planetype is quick.
quickx	String	"0"	x-coordinate if planetype is yz or zy.
quicky	String	"0"	y-coordinate if planetype is zx or xz.
quickz	String	"0"	z-coordinate if planetype is xy or yx.
spacevars	String array of length 2	Created from the feature tag.	The names of the variables that evaluate to the plane’s parameterization.

Examples

This example creates a cut plane and plots a surface plot and a contour plot on it.

Create a solution data set and set it to point to the named solution Sol1 from a solver sequence:

Code for use with Java

DatasetFeature ds = model.result().dataset().create("dset1", "Solution");

ds.set("solution", "sol1");

Code for use with MATLAB

ds = model.result.dataset.create('dset1', 'Solution');

ds.set('solution', 'sol1');

Create 3D plot group:

Code for use with Java

ResultFeature pg = result().create("pg1",3);

DatasetFeature ds = result().dataset().create("cutp1","CutPlane");

ds.set("data", "dset1");

pg.create("surf1","Surface");

pg.feature("surf1").set("data","cutp1");

pg.create("cont1","Contour");

pg.feature("cont1").set("data","cutp1");

Code for use with MATLAB

pg = result.create('pg1',3);

ds = result.dataset.create('cutp1','CutPlane');

ds.set('data', 'dset1');

pg.create('surf1','Surface');

pg.feature('surf1').set('data','cutp1');

pg.create('cont1','Contour');

pg.feature('cont1').set('data','cutp1');

See Also

Surface