ObjectPlane

Optical object plane properties

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.

    An ObjectPlane object specifies the properties of an object plane in an optical system, such as its shape, position, and angular orientation.

    Creation

    There are two ways to create an ObjectPlane object.

    • Use the optics.component.ObjectPlane function described here. Use this function when you want to create an object plane without adding it to the optical system, or modify the properties of an object plane already in the system. After creating the object, you can specify the object plane properties by modifying the properties of the object.

    • Create an ObjectPlane with default properties when you create an opticalSystem object. Modify the default ObjectPlane property of opticalSystem by setting it to the function handle optics.component.ObjectPlane that you specify above.

    Syntax

    oplane = optics.component.ObjectPlane
    oplane = optics.surface.Surface(PropertyName=Value)

    Description

    oplane = optics.component.ObjectPlane creates an ObjectPlane object with default properties.

    oplane = optics.surface.Surface(PropertyName=Value) sets writeable properties using one or more name-value arguments.

    Example: optics.component.ObjectPlane(Position=[2 0 4]) creates an ObjectPlane object representing an object plane at a position [2 0 4] relative to the optical axis.

    Properties

    expand all

    Name of the object plane, specified as a scalar or character vector.

    Shape of the object plane surface, specified as one of these options.

    By default, the shape of the object plane surface is circular, with a semi-diameter of 1.

    Position of the object plane, specified as a 3-element row vector. The vector is in the form [x y z], where each element is the optical system x-, y-, and z-coordinate.

    To learn more about optical coordinate systems, see Coordinate Systems in Optical Design.

    Tilt angles of the object plane, specified as a 3-element row vector. The vector is in the form [θx θy θz], where θx, θy, and θz are tilt angles with respect to the optical system x, y, and z-axes, respectively.

    To learn more about optical coordinate systems, see Coordinate Systems in Optical Design.

    Note

    The TiltAngles property represents Euler angles. If you specify angles that are multiples of 90 degrees, visually verify the orientation of the optical system. Gimbal lock can occur, in which two of the three rotational axes become aligned. This alignment results in the loss of one degree of freedom, and can lead to ambiguous or unintended orientations.

    Version History

    Introduced in R2026a

    See Also