zospy.analyses.extendedscene.geometric_image_analysis.GeometricImageAnalysisSettings

class zospy.analyses.extendedscene.geometric_image_analysis.GeometricImageAnalysisSettings

Bases: object

Settings for the Geometric Image Analysis.

For an in depth explanation of the parameters, see the OpticStudio user manual.

Attributes:

wavelengthstr | int

The wavelength to use in the analysis. Either ‘All’ or an integer specifying the wavelength number. Defaults to ‘All’.

fieldint

The field to use in the analysis. Should be an integer specifying the field number. Defaults to 1.

surfacestr | int

The surface that is to be analyzed. Either ‘Image’, ‘Object’ or an integer. Defaults to ‘Image’.

field_sizefloat

The width of the image in field coordinates. Defaults to 0.

image_sizefloat

When show_as is set to ‘SpotDiagram’, this defines the size of the scale bar superimposed on the image. Else, it

defines the size of the detector used to capture the rays. Defaults to 50.

filestr

The image file used for the analysis. Must be an .IMA of .BIM file and reside in the OpticStudio images folder. Defaults to ‘LETTERF.IMA’.

rotationfloat

The rotation angle in degrees. Defaults to 0.

rays_x_1000int

The approximate amount of rays that are traced. See OpticStudio manual for further clarification. Defaults to 10.

show_asstr | constants.Analysis.GiaShowAsTypes

Defines how the result is displayed in OpticStudio. Defaults to ‘Surface’. Note that ‘SpotDiagram’ is not implemented.

sourcestr | constants.Analysis.Settings.SourceGia

Specifies how the source is defined. Defaults to ‘Uniform’.

number_of_pixelsint

The number of pixels across the width of the image. Not used when show_as is set to ‘SpotDiagram’. Defaults to 100.

row_column_numberint | str

An integer defining the row or column number used when show_as is either ‘CrossX’ or ‘CrossY’. Also accepts ‘Center’. Defaults to ‘Center’.

nafloat

The numerical aperture cut-off. Ignored if set to 0. Defaults to 0.

total_wattsfloat

The total power in watts. Defaults to 1.

paritystr | constants.Analysis.Settings.Parity

Defines how the object would appear in object space. Defaults to ‘Even’.

referencestr | constants.Analysis.Settings.ReferenceGia

Defines the reference coordinate for the center of the plot. Defaults to ‘ChiefRay’.

use_symbolsbool

Defines whether the plot uses symbols. Only used when show-as is set to ‘SpotDiagram’. Defaults to False.

use_polarizationbool

Defines whether polarization is considered. Defaults to False.

remove_vignetting_factorsbool

Defines whether vignetting factors are automatically removed. Defaults to True.

scatter_raysbool

Defines whether rays are scattered by surfaces with scattering properties. Defaults to False.

delete_vignettedFalse

Defines whether rays vignetted by any surface are drawn. Defaults to False.

use_pixel_interpolationbool

Defines whether pixel interpolation is used. This setting has no effect when show-as is set to ‘SpotDiagram’. Defaults to False.

save_as_bim_filestr

Defines the filename used to save the output image as BIM file. This file will be stored in the OpticStudio images folder. The filename should include the .BIM extension. If set to ‘’, the image will not be saved. Not used when show_as is set to ‘SpotDiagram. Defaults to ‘’.

__init__(*args: Any, **kwargs: Any) → None