COMSOL Multiphysics™

otate
Purpose
rotate
Rotate geometry object.
Syntax
Description
[g,...] = rotate(g,r,...)
[g3,...] = rotate(g,r,v,c,...)
[g3,...] = rotate(g,r,vx,vy,vz,cx,cy,cz,...)
[g3,Q,c] = rotate(g,...)
[g,...] = rotate(g,r,c,...)
[g,...] = rotate(g,r,cx,cy,...)
[g,...] = rotate(g,r,...) rotates the 2D or 3D geometry object g, r radians
about the z-axis.
[g3,...] = rotate(g,r,v,c,...) rotates the 3D geometry object g by r radians
about the axis v=(vx,vy,vz), with center of rotation c=(cx,cy,cz). v can also be
a vector of spherical coordinates, where v(1) is the polar angle, that is, the angle
between the axis of rotation and the positive z-axis, and v(2) is the azimuthal angle
of the axis of rotation.
[g3,...] = rotate(g,r,vx,vy,vz,cx,cy,cz,...) is the same as above, but
the components of the axis and center of rotation are explicitly given.
[g3,Q,c] = rotate(g,...) additionally returns a rotation matrix Q
corresponding to rotation given by r and v centered at the origin. The translation
vector c is also returned for convenience. This means that a point set p, of size
3-by-n, containing 3D point coordinates, that is to be rotated in the same way as g,
is transformed according to prot = Q*(p-cp)+cp, where cp =
repmat(c(:),1,size(p,2)) represents the center of rotation.
[c,...] = rotate(g,r,c,...) rotates a 2D geometry object about the point
c=(cx,cy).
[c,...] = rotate(g,r,cx,cy,...) is the same as above, but the center
coordinates are explicitly given.
The function rotate accepts the following property/values:
TABLE 1-38: VALID PROPERTY/VALUE PAIRS
PROPERTY VALUE DEFAULT DESCRIPTION
Out stx | ftx | ctx |
ptx
empty
See geomcsg for more information on geometry objects.
Output parameters
Example
The command below rotates the ellipse by 1 radian about (2,3) and plots the result.
378 | CHAPTER 1: COMMAND REFERENCE