Main Content

shape.Ellipse

Create ellipse centered at origin on xy-plane

Since R2023b

expand all in page

    Description

    The shape.Ellipse lets you create an ellipse with metal material properties on the xy-plane, centered at the origin. Use this ellipse along with the other shapes and the geometric operations to create a shape for the custom antenna.

    Creation

    Syntax

    ell = shape.Ellipse
    ell = shape.Ellipse(Name=Value)

    Description

    ell = shape.Ellipse creates an ellipse centered at the origin and on the xy-plane.

    ell = shape.Ellipse(Name=Value) sets additional Properties using one or more name-value arguments. Name is the property name and Value is the corresponding value. You can specify several name-value arguments in any order as Name1=Value1, ..., NameN=ValueN. Properties that you do not specify retain their default values.

    example

    Properties

    expand all

    Ellipse name, specified as a string.

    Example: "Ellipse1"

    Data Types: string

    Ellipse center point, specified as a two-element vector of Cartesian coordinates in meters.

    Example: [1 1]

    Data Types: double

    Length of the ellipse major axis, specified as a scalar in meters.

    Example: 2

    Data Types: double

    Length of the ellipse minor axis, specified as a scalar in meters.

    Example: 0.75

    Data Types: double

    Number of discretization points on ellipse circumference, specified as a scalar.

    Example: 28

    Data Types: double

    Metal material of the shape, specified as a metal name string from the Metal Catalog.

    Example: "Copper"

    Data Types: string

    Color of shape, specified as either a character for color short name or a three-element real vector of RGB triplets. The default shape color is yellow. See the Types of Color Values supported by this property. When you unite two shapes of different colors, use "Individual" value to retain the colors of the original shapes in the resultant shape.

    Example: "r"

    Example: [0 0.447 0.741]

    Data Types: double | string | char

    Transparency of shape, specified as a scalar in the (0,1) range, where 0 corresponds to full transparency while 1 corresponds to full opaqueness.

    Example: 0.75

    Data Types: double

    Color of shape edges, specified as either a character for color short name or a three-element real vector of RGB triplets. The default edge color is black. See the Types of Color Values supported by this property. When you unite two shapes of different edge colors, use "Individual" value to retain the edge colors of the original shapes in the resultant shape.

    Example: "b"

    Example: [0.4940 0.1840 0.5560]

    Data Types: double | string | char

    Object Functions

    addBoolean unite operation on two shapes
    subtractBoolean subtraction operation on two shapes
    intersectIntersection of shape1 and shape2
    plusJoin two shapes
    minusCarve a shape from other shape
    andBoolean intersection operation on two shapes
    areaCalculate area of 2-D shapes in square meters
    showDisplay antenna, array structures, shapes, or platform
    plotPlot boundary of 2-D shape
    meshMesh properties of metal, dielectric antenna, or array structure
    rotateRotate shape about axis by angle
    rotateXRotate shape about x-axis by angle
    rotateYRotate shape about y-axis by angle
    rotateZRotate shape about z-axis by angle
    translateMove shape to new location
    scaleChange size of shape by fixed factor
    imprintShapeImprint 2-D shape on another shape
    createHoleCreate a 2-D hole on custom shape
    extrudeExtrude 2-D shape on another shape
    extrudeLinearLinearly extrude 2-D shape along specified direction
    extrudeRotateExtrude 2-D shape by angle about z-axis
    removeSliversRemove sliver outliers from boundary of shape

    Examples

    collapse all

    Open Live Script

    Create an aluminium ellipse with length of major axis as 0.75 m and length of the minor axis as 0.25 m.

    ell = shape.Ellipse(MajorAxis=0.75,MinorAxis=0.25,Metal="Aluminium", ...
    Color=[0.7 0.7 0.7]);
show(ell)

    Figure contains an axes object. The axes object with xlabel x (mm), ylabel y (mm) contains 2 objects of type patch.

    Locate its focal points.

    ell.Foci
    ans = 2×3

   -0.3536         0         0
    0.3536         0         0

    Version History

    Introduced in R2023b

    See Also

    Functions

    Objects