SurfaceTiltTolerance

R2026b

Tolerance for surface tilt

Since R2026b

expand all in page

    Description

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

    A SurfaceTiltTolerance object defines a tolerance for the tilt of one or more surfaces of an optical system for use in sensitivity and Monte Carlo tolerance analysis.

    Creation

    Syntax

    tol = optics.tolerance.SurfaceTiltTolerance(propertyName,value)
    tol = optics.tolerance.SurfaceTiltTolerance(propertyName,value,TargetIndex=targetIdx)

    Description

    tol = optics.tolerance.SurfaceTiltTolerance(propertyName,value) creates a tolerance with the specified value for the specified surface tilt property. The tolerance applies to all top-level surfaces in an optical system.

    tol = optics.tolerance.SurfaceTiltTolerance(propertyName,value,TargetIndex=targetIdx) applies the tolerance to only the surfaces specified by targetIdx.

    example

    Input Arguments

    expand all

    Surface tilt property to which to apply the tolerance, specified as "TiltX", "TiltY", or "TiltZ".

    Data Types: char | string

    Tolerance value, specified as a numeric scalar or a 1-by-2 numeric vector of the form [min max].

    • Scalar — Specifies a percentage tolerance relative to the nominal value. Percentage tolerances have no effect when the nominal value is zero.

    • 1-by-2 vector — Specifies an offset tolerance range [min max] relative to the nominal value.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Surface indices to target, specified as a vector of positive integers. By default, the tolerance applies to all top-level surfaces. Tolerancing for surfaces of nested components is not supported.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Properties

    expand all

    This property is read-only.

    Property to which the tolerance applies, represented as "TiltX", "TiltY", or "TiltZ".

    Target surface indices, represented as a vector of positive integers. An empty value means the tolerance applies to all top-level surfaces.

    Tolerance range, represented as a 1-by-2 numeric vector of the form [min max]. When you specify value as a scalar, this is of the form [-value +value].

    This property is read-only.

    Tolerance interpretation type, represented as "Percentage" when you specify value as a scalar, or "Absolute" when you specify value as a 1-by-2 vector.

    Object Functions

    applyApply tolerance perturbation to optical system

    Examples

    collapse all

    This example uses:

    Open Live Script

    Import an optical system into the workspace.

    opsys = zmximport("PhotographicLens.zmx");

    Define a surface tilt tolerance ranging from -0.5 to 0.5 for the Y-tilt of the 3rd top-level surface.

    tol = optics.tolerance.SurfaceTiltTolerance(TiltY=0.5,TargetIndex=3)
    tol = 
  SurfaceTiltTolerance with properties:

    TargetProperty: "TiltY"
       TargetIndex: 3
    ToleranceRange: [-0.5000 0.5000]
     ToleranceType: "Percentage"

    Apply the tolerance to the optical system.

    newopsys = apply(tol,opsys);

    Version History

    Introduced in R2026b

    See Also

    | | |