COMSOL Multiphysics™

geomgetwrkpln
Purpose
geomgetwrkpln
Retrieves coordinates for a work plane.
Syntax
Description
[p_wrkpln,localsys] = geomgetwrkpln(type,args)
[p_wrkpln,localsys] = geomgetwrkpln(type,args)
returns the coordinate matrix p_wrkpln, spanning a plane, and the local coordinate
system localsys of that plane, according to the string type and the cell array args.
The columns of the 3-by-3 coordinate matrix p_wrkpln contain point coordinates
for 3 non co-linear points spanning a work plane with a local z-direction defined by
lz = cross(p(:,2)-p(:,1),(p(:,3)-p(:,1)). The vector lx =
p(:,2)-p(:,1) is defined to be the local x-axis, and the local y-axis is defined as ly
= cross(lz,p(:,2)-p(:,1)). The corresponding normalized unit vectors are
nlx, nly, and nlz, respectively.
The local coordinate system localsys is formed as localsys =
[p(:,1),nlx,nly,nlz], where p(:,1) is the position of the local origin and nlx,
nly, and nlz specifies unit vectors in the direction of the positive local coordinate
axes.
Work Plane of Type Explicit
[p_wrkpln,localsys] = geomgetwrkpln('explicit',{p_wrkpln1})
copies the coordinates p_wrkpln1 and forms the corresponding local coordinate
system.
Work Plane of Type Quick
[p_wrkpln,localsys] = geomgetwrkpln('quick',{coordplane,offset})
forms a work plane parallel to the coordinate plane defined by coordplane, which
can have any of the values xy, yz, or zx. The real scalar offset specifies the signed
offset from the coordinate plane.
Work Plane of Type FaceParallel
[p_wrkpln,localsys] =
geomgetwrkpln('faceparallel',{g,fn,dir,offset})
creates a work plane, parallel to face fn in 3D geometry object g. The direction dir
takes the values +1 or -1 and specifies if the local z-axis, localsys(:,4), should be
in the direction of the face’s normal, or reversed normal, respectively. The scalar
offset specifies the displacement along the local z-axis for the work plane with
218 | CHAPTER 1: COMMAND REFERENCE