Circular

Circular shape

Since R2026a

expand all in page

    Description

    Add-On Required: This feature requires the Optical Design and Simulation Library for Image Processing Toolbox add-on.

    A Circular object specifies a circular shape for a surface represented by a Surface object.

    Creation

    There are two ways to create a Circular object.

    • Use the addRefractiveSurface, addDiaphragm, or addMirror function, and specify the Radius name-value argument. Use one of these function when you want to add a surface to an optical system, and specify the surface shape, in a single command. The Radius name-value argument specifies that the surface is circular, as well as its radius.

    • Use the optics.shape.Circular function described here. Use this function when you want to modify the shape of a surface in an optical system, or specify the shape of a surface before you add it to the system. After creating the Circular object, you can specify the circular shape semi-diameter by modifying property of the object.

    To specify a rectangular surface, use the Rectangular object, instead.

    Syntax

    cshape = optics.shape.Circular
    cshape = optics.shape.Circular(semidiameter)

    Description

    cshape = optics.shape.Circular creates a Circular object that represents a circular surface shape with a semi-diameter of 1.

    cshape = optics.shape.Circular(semidiameter) specifies the cross sectional boundary of a surface as a circle with the radius semidiameter.

    Input Arguments

    expand all

    Surface semi-diameter, specified as a positive scalar. The semi-diameter is the distance along the positive y-axis, from the center of the optical surface to the edge of the usable optical area, describing the aperture through which light enters. Units are in millimeters. This quantity is half the full diameter of the surface through which light can pass.

    Properties

    expand all

    Surface semi-diameter, specified as a positive scalar.

    Version History

    Introduced in R2026a

    See Also

    | | |