addImagePlane

Add image plane component to optical system

Since R2026a

collapse all in page

Syntax

addImagePlane(opsys)
addImagePlane(opsys,Name=Value)

Description

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

addImagePlane(opsys) adds a circular image plane to the optical system opsys. The image plane is the surface in an optical system where the image of an object is brought into focus. When you create an image plane using this function, you create an ImagePlane object.

example

addImagePlane(opsys,Name=Value) also specifies properties of the image plane using one or more name-value arguments. For example, SemiDiameter=2.5 specifies the semi-diameter of the image plane as 2.5 millimeters.

Examples

collapse all

This example uses:

Open Live Script

Create an empty optical system and display its properties.

opsys = opticalSystem
opsys = 
  opticalSystem with properties:

   Main properties
                      Name: "Optical System"
         PrimaryWavelength: 587.5618
               Wavelengths: [486.1340 587.5618 656.2810]
               FieldPoints: [1×1 optics.fieldpoint.FieldAngle]
                Components: [0×1 optics.component.Component]
       FlattenedComponents: [0×1 optics.component.Component]
                 Materials: [0×0 opticalMaterial]
                  Surfaces: [0×0 optics.surface.Surface]
              SurfaceTable: [1×0 table]

   Extended properties
                  UserData: []
               ObjectPlane: [1×1 optics.component.ObjectPlane]
    PrimaryWavelengthIndex: 2
           AmbientMaterial: [1×1 opticalMaterial]
                  Coatings: [0×0 opticalCoating]
         ConstructionFrame: [4×4 double]
                  Position: [0 0 0]
                TiltAngles: [0 0 0]

To add a lens component to the optical system, create the two refractive surfaces of the lens using the addRefractiveSurface object function. Specify the lens glass material using the Material name-value argument for the first surface. Specify the center thickness of the lens, in millimeters, using the DistanceToNext name-value argument for the first surface.

addRefractiveSurface(opsys,Radius=15,Material=[1.74 25.4],DistanceToNext=3)
addRefractiveSurface(opsys,Radius=-15,DistanceToNext=6.5)

Add an image plane using the addImagePlane object function.

addImagePlane(opsys)

Trace rays through the optical system using the traceRays object function. Specify the ray wavelength as the Fraunhofer d line using the Wavelengths name-value argument.

rays = traceRays(opsys,Wavelengths=587.5618);

Display a 2-D visualization of the optical system using the view2d object function. Visualize the traced rays on the displayed optical system using the addRays object function.

hv = view2d(opsys);
addRays(hv,rays)

Figure contains an object of type optics.ui.opticalsystemviewer2d. The chart of type optics.ui.opticalsystemviewer2d has title Optical System.

Input Arguments

collapse all

Optical system to which to add the image plane as the next component, specified as an opticalSystem object.

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: addImagePlane(SemiDiameter=2.5) specifies the semi-diameter of the image plane as 2.5 millimeters.

Image plane surface semi-diameter, in millimeters, specified as a positive scalar. The semi-diameter is the distance, along the positive y axis, from the center of the image plane to the edge of the usable optical area. This quantity is half the full diameter of the image plane.

Note

For a rectangular image plane surface, use the RectangleSize name-value argument to specify the image plane size, instead.

Rectangular image plane surface size, in millimeters, specified as a 2-element row vector. The row vector is in the form [Width Height] where Width and Height are the width and height of the rectangular image plane, respectively. The size of the rectangular image plane must be large enough to cover the entire field of view of the optical system.

Note

For a circular image plane surface, use the SemiDiameter name-value argument to specify the image plane size, instead.

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

Version History

Introduced in R2026a

See Also

| | | |