PSFImage

R2026b

Point spread function image chart

Since R2026b

Description

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

A PSFImage object displays point spread function (PSF) image data for one or more PSF result objects.

Use a PSFImage chart to visualize geometric or Huygens PSF intensity images, select wavelength channels, combine wavelength channels, and customize the display colormap.

Creation

Create a PSFImage object by using the show object function of an GeometricPSF or HuygensPSF object. Create a PSF result object by using the psf object function.

hpsf = show(psfr)

You can specify chart properties when you call show.

hpsf = show(psfr,CombineWavelengths="off",WavelengthIndices=[1 3])

Properties

Title — Chart title

string scalar | character vector

Chart title, specified as a string scalar or character vector. The default title is "Point Spread Function".

PSF — Point spread function results to display

GeometricPSF object | HuygensPSF object | array of GeometricPSF or HuygensPSF objects

Point spread function results to display, specified as a GeometricPSF object, a HuygensPSF object, or an array of PSF result objects.

When you specify an array of PSF result objects, all objects in the array must use the same wavelengths.

CombineWavelengths — Option to combine wavelength channels

"on" or "off" | true or false

Option to combine wavelength channels, specified as a logical value or a "on"/"off" value. When this property is "on", the chart sums the selected wavelength channels and displays one image for each PSF object. When this property is "off", the chart displays a separate image for each selected wavelength. The default value is "on".

WavelengthIndices — Wavelength channels to display

vector of positive integers

Wavelength channels to display, specified as a vector of positive integers. Each index refers to an element of the Wavelengths property of the PSF result object. By default, the chart displays all wavelength channels.

Data Types: double

Colormap — Colormap for PSF image display

N-by-3 numeric matrix

Colormap for PSF image display, specified as an N-by-3 numeric matrix of RGB triplets. The default colormap is parula.

Data Types: double

Parent — Parent UI container

Figure object | Panel object | GridLayout object | Tab object | TiledChartLayout object

Parent UI container, specified as a Figure object, Panel object, GridLayout object, Tab object, or TiledChartLayout object. If you do not specify this property, MATLAB creates a new figure. You can create these UI containers using their respective creation functions.

• UI Figure: uifigure

• UI Panel: uipanel

• UI Grid Layout: uigridlayout

• UI Tab: uitab

• Tiled Chart Layout: tiledlayout

Examples

Create PSF Image Chart

Load the sample Double Gauss lens system using zmximport. Define a field point at an angle of 4 degrees along the x-axis, specify a wavelength of 587.56 nm, and calculate the geometric PSF.

opsys = zmximport("DoubleGaussLens.zmx");
fp = fieldPoint(Angles=[0 4]);
lambda = 587.56;
psfr = psf(opsys, FieldPoints=fp, Wavelengths=lambda, Method="Geometric");

Visualize the computed point spread function by passing the result object to the show function. The function renders the intensity profile and returns a chart handle for further customization.

hpsf = show(psfr)

hpsf = 
  PSFImage with properties:

                 Title: "Point Spread Function"
                   PSF: [1×1 optics.result.GeometricPSF]
    CombineWavelengths: on
     WavelengthIndices: 1
              Colormap: [256×3 double]
              Position: [0.1143 0.1126 0.7524 0.7381]
                 Units: 'normalized'

  Show all properties

Display Selected Wavelengths Separately

Load the sample Double Gauss lens system using zmximport. Define a field point at an angle of 4 degrees along the x-axis and specify an array of three wavelengths (486.13 nm, 587.56 nm, and 656.28 nm).

opsys = zmximport("DoubleGaussLens.zmx");
fp = fieldPoint(Angles=[0 4]);
lambdas = [486.13 587.56 656.28];

Compute the Huygens PSF across all specified wavelengths. Use the show function to display the intensity distributions. Set the CombineWavelengths name-value argument to "off" to render the channels in separate tiles, and use WavelengthIndices to isolate the first and third wavelengths. Customize the chart appearance by modifying its Title and Colormap properties.

psfr = psf(opsys, FieldPoints=fp, Wavelengths=lambdas, Method="Huygens");
hpsf = show(psfr, CombineWavelengths="off", WavelengthIndices=[1 3]);
hpsf.Title = "Selected PSF Wavelengths";
hpsf.Colormap = hot(256);

More About

PSF Image Display

The PSFImage chart uses the physical extent stored in the Position property of the PSF result object to label the image-plane axes in millimeters.

When CombineWavelengths is "on", the chart sums the selected wavelength channels before display. When CombineWavelengths is "off", each selected wavelength channel is displayed separately.

Version History

Introduced in R2026b