rotate

Rotate shape about axis by angle

Syntax

rotate(shape,angle,axisPoint1,axisPoint2)

c = rotate(shape,angle,axisPoint1,axisPoint2)

Description

rotate(shape,angle,axisPoint1,axisPoint2) rotates the shape about the specified axis by the specified angle and plots the resultant shape.

c = rotate(shape,angle,axisPoint1,axisPoint2) rotates the shape about the specified axis by the specified angle and returns the resultant shape as shape object.

Examples

Rotate Rectangle

Create a rectangle shape.

r = antenna.Rectangle;
show(r)
axis equal

Rotate the rectangle at 45 degrees about the Z-axis.

r1 = rotate(r,45,[0 0 0],[0 0 1])

r1 = 
  Rectangle with properties:

         Name: 'myrectangle'
       Center: [0 0]
       Length: 1
        Width: 2
    NumPoints: 2

show(r1)

Input Arguments

shape — Shape to rotate

shape object

Shape to rotate, specified as one of the following objects:

• 2-D shapes without material properties:

  • antenna.Circle

  • antenna.Ellipse

  • antenna.Polygon

  • antenna.Rectangle

  • antenna.Triangle

• 2-D and 3-D shapes with material properties:

  • shape.Circle

  • shape.Ellipse

  • shape.Rectangle

  • shape.Polygon

  • shape.Box

  • shape.OpenBox

  • shape.Cylinder

  • shape.OpenCylinder

  • shape.Sphere

  • shape.Custom3D

Example: antenna.Rectangle

Example: shape.Polygon

Example: shape.Box

axisPoint1,axisPoint2 — Axis of rotation

two three-element vectors of Cartesian coordinates in meters

Axis of rotation defined as a line joining two points, specified as two unique three-element vectors of Cartesian coordinates in meters.

Example: [0 0 0], [0 0 1]

Data Types: double

angle — Angle of rotation

scalar

Angle of rotation, specified as a scalar in degrees.

Example: 45

Data Types: double

Output Arguments

c — Resultant shape

shape object

Resultant shape obtained after the rotation operation on the input shape, returned as a shape object.

Example: antenna.Rectangle

Example: shape.Polygon

Example: shape.Box

Version History

Introduced in R2017a