FieldPosition

Represent light source location at finite location

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 FieldPosition object represents the location of a light source at a finite distance as determined by the ReferenceFrame. The object uses the field position to represent the location of the light source.

    Creation

    You can create a FieldPosition object using the fieldPoint function. For example, fp = fieldPoint(Position=position) specifies the Position name-value argument to create light source representations a finite distance away from the first component in the optical system using one or more name-value arguments. To learn more about creating field points, see Create Field Points.

    Properties

    expand all

    Positions of light sources, specified as one of these options.

    Data FormatDescription

    1-by-3 row vector where each row is of the form [x y z]

    x, y, and z are the coordinates of the light source in the global reference frame. Specify the position in this format by default or when the value of the ReferenceFrame name-value argument is "Global".

    1-by-3 row vector, where each row is of the form [x y 0]

    		x and y are the dimensions of the object in the local coordinate system of the object plane. Specify the position in this format when the value of the ReferenceFrame name-value argument is "Object".

    1-by-3 row vector, where each row is of the form [x y 0]

    		x and y are the heights of the planar image formed in the local coordinate system of the image plane of the optical system. Specify the position in this format when the value of the ReferenceFrame name-value argument is "Image".

    N is the number of light sources.

    Reference frame, specified as one of these options.

    ReferenceFrame ValueReference Frame for Light Source Position
    "Global"

    Represent the position of the light source relative to the global reference frame. Set the Position property as a 3-element row vector of the form [x y z], where x, y, and z are the coordinates of the light source in the global reference frame.

    "Object"

    Represent the position of the light source for a planar object image at a finite locations, such as a projector optical system. Set the Position property as a 3-element row vector of the form [x y 0], where x and y are the dimensions of the object in the local coordinate system of the object plane.

    "Image"

    Represent the position of a light source whose image forms at a specified location. Set the Position property as a 3-element row vector of the form [x y 0] where x and y are the dimensions of the planar image formed, in the local coordinate system of the image plane of the optical system.

    Tip

    To specify a light source that spans the maximum field angle of the system, specify x and y as the top edges of the image plane. To compute the maximum half field of view of the optical system, use the halfFieldOfView function.

    Examples

    collapse all

    This example uses:

    Open Live Script

    Specify the position of a light source located at a finite distance from the first surface of the optical system using the fieldPoint function. Specify the Position name-value argument as the position of the light source in the global coordinate system.

    fp2 = fieldPoint(Position=[0 50 0],ReferenceFrame="Global")
    fp2 = 
  FieldPosition with properties:

          Position: [0 50 0]
    ReferenceFrame: "Global"

    Version History

    Introduced in R2026a

    See Also

    | |

    Topics