Skip to main content

ZOS-API interface 2024 R1

ZOSAPI.Analysis Namespace Reference

Last update: 17.07.2025

Namespaces

namespace  Data
 
namespace  PhysicalOptics
 
namespace  RayTracing
 
namespace  Settings
 
namespace  Tolerancing
 

Classes

interface  I_Analyses
 Methods and interfaces for opening, closing, and retrieving analyses. This interface can be accessed via the IOpticalSystem interface. More...
 
interface  IA_
 Base interface for all analysis windows. This interface can be accessed via the I_Analyses interface. More...
 
interface  IColorTranslator
 
interface  IMessage
 
interface  IMessages
 
interface  IUser2DLineData
 Properties and methods for configuring a 2D line User Analysis plot. This interface can be accessed via the IUserAnalysisData interface. More...
 
interface  IUserAnalysisData
 Properties and methods used to generate a User Analysis. This interface can be accessed via the IZOSAPI_Application interface. Note that this interface is only available when creating a User Analysis plugin application. More...
 
interface  IUserGridData
 Properties and methods for configuring a 2D grid User Analysis plot. This interface can be accessed via the IUserAnalysisData interface. More...
 
interface  IUserGridRGBData
 Properties and methods for configuring a 2D rgb grid User Analysis plot. This interface can be accessed via the IUserAnalysisData interface. More...
 
interface  IUserTextData
 Properties and methods for configuring a text User Analysis window. This interface can be accessed via the IUserAnalysisData interface. More...
 

Enumerations

enum  AnalysisIDM {
  XXXTemplateXXX = -1 , RayFan , OpticalPathFan , PupilAberrationFan ,
  FieldCurvatureAndDistortion , FocalShiftDiagram , GridDistortion , LateralColor ,
  LongitudinalAberration , RayTrace , SeidelCoefficients , SeidelDiagram ,
  ZernikeAnnularCoefficients , ZernikeCoefficientsVsField , ZernikeFringeCoefficients , ZernikeStandardCoefficients ,
  FftMtf , FftThroughFocusMtf , GeometricThroughFocusMtf , GeometricMtf ,
  FftMtfMap , GeometricMtfMap , FftSurfaceMtf , FftMtfvsField ,
  GeometricMtfvsField , HuygensMtfvsField , HuygensMtf , HuygensSurfaceMtf ,
  HuygensThroughFocusMtf , FftPsf , FftPsfCrossSection , FftPsfLineEdgeSpread ,
  HuygensPsfCrossSection , HuygensPsf , DiffractionEncircledEnergy , GeometricEncircledEnergy ,
  GeometricLineEdgeSpread , ExtendedSourceEncircledEnergy , SurfaceCurvatureCross , SurfacePhaseCross ,
  SurfaceSagCross , SurfaceCurvature , SurfacePhase , SurfaceSag ,
  StandardSpot , ThroughFocusSpot , FullFieldSpot , MatrixSpot ,
  ConfigurationMatrixSpot , RMSField , RMSFieldMap , RMSLambdaDiagram ,
  RMSFocus , Foucault , Interferogram , WavefrontMap ,
  DetectorViewer , Draw2D , Draw3D , ImageSimulation ,
  GeometricImageAnalysis , IMABIMFileViewer , GeometricBitmapImageAnalysis , BitmapFileViewer ,
  LightSourceAnalysis , PartiallyCoherentImageAnalysis , ExtendedDiffractionImageAnalysis , BiocularFieldOfViewAnalysis ,
  BiocularDipvergenceConvergence , RelativeIllumination , VignettingDiagramSettings , FootprintSettings ,
  YYbarDiagram , PowerFieldMapSettings , PowerPupilMapSettings , IncidentAnglevsImageHeight ,
  FiberCouplingSettings , YNIContributions , SagTable , CardinalPoints ,
  DispersionDiagram , GlassMap , AthermalGlassMap , InternalTransmissionvsWavelength ,
  DispersionvsWavelength , GrinProfile , GradiumProfile , UniversalPlot1D ,
  UniversalPlot2D , PolarizationRayTrace , PolarizationPupilMap , Transmission ,
  PhaseAberration , TransmissionFan , ParaxialGaussianBeam , SkewGaussianBeam ,
  PhysicalOpticsPropagation , BeamFileViewer , ReflectionvsAngle , TransmissionvsAngle ,
  AbsorptionvsAngle , DiattenuationvsAngle , PhasevsAngle , RetardancevsAngle ,
  ReflectionvsWavelength , TransmissionvsWavelength , AbsorptionvsWavelength , DiattenuationvsWavelength ,
  PhasevsWavelength , RetardancevsWavelength , DirectivityPlot , SourcePolarViewer ,
  PhotoluminscenceViewer , SourceSpectrumViewer , RadiantSourceModelViewerSettings , SurfaceDataSettings ,
  PrescriptionDataSettings , FileComparatorSettings , PartViewer , ReverseRadianceAnalysis ,
  PathAnalysis , FluxvsWavelength , RoadwayLighting , SourceIlluminationMap ,
  ScatterFunctionViewer , ScatterPolarPlotSettings , ZemaxElementDrawing , ShadedModel ,
  NSCShadedModel , NSC3DLayout , NSCObjectViewer , RayDatabaseViewer ,
  ISOElementDrawing , SystemData , TestPlateList , SourceColorChart1931 ,
  SourceColorChart1976 , PrescriptionGraphic , CriticalRayTracer , ContrastLoss ,
  CoatingListing , FullFieldAberration , SurfaceSlope , SurfaceSlopeCross ,
  QuickYield , SystemCheck , ToleranceYield , ToleranceHistogram ,
  DiffEfficiency2D , DiffEfficiencyAngular , DiffEfficiencyChromatic , NSCSurfaceSag ,
  NSCSingleRayTrace , NSCGeometricMtf , SurfacePhaseSlope , SurfacePhaseSlopeCross
}
 All available analysis types. See the I_Analyses interface for more information. More...
 
enum  ColorPaletteType {
  GreyScale , FalseColor , FalseColorOriginal , Viridis ,
  Magma
}
 
enum  POPSampling {
  S_32 = 5 , S_64 = 6 , S_128 = 7 , S_256 = 8 ,
  S_512 = 9 , S_1024 = 10 , S_2048 = 11 , S_4096 = 12 ,
  S_8192 = 13 , S_16384 = 14 , S_32768 = 15 , S_65536 = 16 ,
  S_131072 = 17 , S_262144 = 18 , S_524288 = 19 , S_1048576 = 20 ,
  S_2097152 = 21 , S_4194304 = 22 , S_8388608 = 23 , S_16777216 = 24 ,
  S_33554432 = 25 , S_67108864 = 26 , S_134217728 = 27 , S_268435456 = 28 ,
  S_536870912 = 29 , S_1073741824 = 30 , S_1K = 10 , S_2K = 11 ,
  S_4K = 12 , S_8K = 13 , S_16K = 14 , S_32K = 15 ,
  S_64K = 16 , S_128K = 17 , S_256K = 18 , S_512K = 19 ,
  S_1M = 20 , S_2M = 21 , S_4M = 22 , S_8M = 23 ,
  S_16M = 24 , S_32M = 25 , S_64M = 26 , S_128M = 27 ,
  S_256M = 28 , S_512M = 29 , S_1G = 30
}
 
enum  ErrorType {
  Success , InvalidParameter , InvalidSettings , Failed ,
  AnalysisUnavailableForProgramMode , NotYetImplemented , NoSolverLicenseAvailable = 10000 , ToolAlreadyOpen ,
  SequentialOnly , NonSequentialOnly , SingleNSCRayTraceSupported , HPCNotAvailable ,
  FeatureNotSupported , NotAvailableInLegacy
}
 
enum  SurfaceCurvatureData { TangentialCurvature = 0 , SagitalCurvature = 1 , X_Curvature = 2 , Y_Curvature = 3 }
 
enum  SurfaceCurvatureCrossData {
  TangentialCurvature = 0 , SagitalCurvature = 1 , X_Curvature = 2 , Y_Curvature = 3 ,
  TanPlusSagCurvature = 4 , XPlusYCurvature = 5
}
 
enum  SurfacePhaseData { SurfacePhase = 0 }
 
enum  SurfaceSagData { SurfaceSag = 0 }
 
enum  SurfaceSlopeData {
  SurfaceSlope = 0 , TangentialSlope = 0 , SagittalSlope = 1 , XSlope = 2 ,
  YSlope = 3
}
 
enum  SurfaceSlopeCrossData {
  TangentialCurvature = 0 , SagitalCurvature = 1 , X_Curvature = 2 , Y_Curvature = 3 ,
  TanPlusSagCurvature = 4 , XPlusYCurvature = 5
}
 
enum  SurfacePhaseSlopeData { PhaseSlopeTangential = 0 , PhaseSlopeSaggital = 1 , PhaseSlopeX = 2 , PhaseSlopeY = 3 }
 
enum  SurfacePhaseSlopeCrossData {
  PhaseSlopeTangential = 0 , PhaseSlopeSaggital = 1 , PhaseSlopeX = 2 , PhaseSlopeY = 3 ,
  PhaseSlopeTangentialAndSaggital = 4 , PhaseSlopeX_and_Y = 5
}
 
enum  RemoveOptions {
  None = 0 , BaseROC = 1 , BestFitSphere = 2 , BaseSag = 3 ,
  CompositeSag = 4
}
 
enum  BestFitSphereOptions { MinimumVolume = 0 , MinimumRMS = 1 , MinimumRMSWithOffset = 2 }
 
enum  SampleSizes {
  S_32x32 = 1 , S_64x64 = 2 , S_128x128 = 3 , S_256x256 = 4 ,
  S_512x512 = 5 , S_1024x1024 = 6 , S_2048x2048 = 7 , S_4096x4096 = 8 ,
  S_8192x8192 = 9 , S_16384x16384 = 10
}
 
enum  SampleSizes_Pow2Plus1 {
  S_33 = 1 , S_65 = 2 , S_129 = 3 , S_257 = 4 ,
  S_513 = 5 , S_1025 = 6 , S_2049 = 7 , S_4097 = 8 ,
  S_8193 = 9
}
 
enum  SampleSizes_Pow2Plus1_X {
  S_33x33 = 1 , S_65x65 = 2 , S_129x129 = 3 , S_257x257 = 4 ,
  S_513x513 = 5 , S_1025x1025 = 6 , S_2049x2049 = 7 , S_4097x4097 = 8 ,
  S_8193x8193 = 9
}
 
enum  SampleSizes_ContrastLoss {
  S_3x3 = 1 , S_5x5 = 2 , S_7x7 = 3 , S_9x9 = 4 ,
  S_11x11 = 5 , S_13x13 = 6 , S_15x15 = 7 , S_17x17 = 8 ,
  S_19x19 = 9 , S_21x21 = 10 , S_23x23 = 11 , S_25x25 = 12 ,
  S_27x27 = 13 , S_29x29 = 14 , S_31x31 = 15 , S_33x33 = 16 ,
  S_35x35 = 17 , S_37x37 = 18 , S_39x39 = 19 , S_41x41 = 20 ,
  S_43x43 = 21 , S_45x45 = 22 , S_47x47 = 23 , S_49x49 = 24 ,
  S_51x51 = 25 , S_53x53 = 26 , S_55x55 = 27 , S_57x57 = 28 ,
  S_59x59 = 29 , S_61x61 = 30 , S_63x63 = 31 , S_65x65 = 32 ,
  S_67x67 = 33 , S_69x69 = 34 , S_71x71 = 35 , S_73x73 = 36 ,
  S_75x75 = 37 , S_77x77 = 38 , S_79x79 = 39 , S_81x81 = 40 ,
  S_83x83 = 41
}
 
enum  ShowAs {
  Surface , Contour , GreyScale , InverseGreyScale ,
  FalseColor , InverseFalseColor
}
 
enum  DetectorViewerShowAsTypes {
  FullListing = 0 , AzimuthCrossSection , Text_CrossSection_Row = 1 , Text_CrossSection_Column ,
  FluxVsWaveLength , GreyScale = 0 , GreyScale_Inverted , FalseColor ,
  FalseColor_Inverted , TrueColor , Color_CrossSection_Row , Color_CrossSection_Column ,
  Color_FluxVsWavelength , CrossSection = 5 , Directivity_Full , Directivity_Half ,
  CrossSection_Row = 4 , CrossSection_Column , GeometricMtf = 6
}
 
enum  DetectorViewerShowDataTypes {
  IncidentFlux , AbsorbedFlux , AbsorbedFluxVolume , PositionSpace = 0 ,
  AngleSpace , Polar_AngleSpace = 0 , IncoherentIrradiance = 0 , CoherentIrradiance ,
  CoherentPhase , RadiantIntensity , RadiancePositionSpace , RadianceAngleSpace ,
  IncoherentIlluminance = 0 , CoherentIlluminance , LuminousIntensity = 3 , LuminancePositionSpace ,
  LuminanceAngleSpace , IncoherentFluence = 0 , CoherentFluence
}
 
enum  HuygensSurfaceMftShowAsTypes { GreyScale , InverseGreyScale , FalseColor , InverseFalseColor }
 
enum  HuygensShowAsTypes {
  Surface , Contour , GreyScale , InverseGreyScale ,
  FalseColor , InverseFalseColor , TrueColor
}
 
enum  Beam {
  Reference , Configuration_1 , Configuration_2 , Configuration_3 ,
  Configuration_4 , Configuration_5 , Configuration_6 , Configuration_7 ,
  Configuration_8 , Configuration_9 , Configuration_10 , Configuration_11 ,
  Configuration_12 , Configuration_13 , Configuration_14 , Configuration_15 ,
  Configuration_16 , Configuration_17 , Configuration_18 , Configuration_19 ,
  Configuration_20
}
 
enum  GiaShowAsTypes {
  Surface , Contour , GreyScale , InverseGreyScale ,
  FalseColor , InverseFalseColor , SpotDiagram , CrossX ,
  CrossY
}
 
enum  UserAnalysisDataType {
  None , Line2D , Grid , GridRGB ,
  Text
}
 
enum  GridPlotType {
  Surface , Contour , GrayScale , InverseGrayScale ,
  FalseColor , InverseFalseColor
}
 

Enumeration Type Documentation

◆ AnalysisIDM

All available analysis types. See the I_Analyses interface for more information.

Enumerator
XXXTemplateXXX 
RayFan 

Ray Fan.

OpticalPathFan 

OPD Fan.

PupilAberrationFan 

Pupil Aberration Fan.

FieldCurvatureAndDistortion 

Field Curv/Dist.

FocalShiftDiagram 

Focal Shift.

GridDistortion 

Grid Distortion.

LateralColor 

Lateral Color.

LongitudinalAberration 

Longitudinal Aberration.

RayTrace 

Single Ray Trace.

SeidelCoefficients 

Seidel Coefficients.

SeidelDiagram 

Seidel Diagram.

ZernikeAnnularCoefficients 

Zernike Annular Coefficients.

ZernikeCoefficientsVsField 

Zernike Coefficients vs. Field.

ZernikeFringeCoefficients 

Zernike Fringe Coefficients.

ZernikeStandardCoefficients 

Zernike Standard Coefficients.

FftMtf 

FFT MTF.

FftThroughFocusMtf 

FFT Through Focus MTF.

GeometricThroughFocusMtf 

Through Focus Geometric MTF.

GeometricMtf 

Geometric MTF.

FftMtfMap 

FFT MTF Map.

GeometricMtfMap 

Geometric MTF Map.

FftSurfaceMtf 

FFT Surface MTF.

FftMtfvsField 

FFT MTF vs. Field.

GeometricMtfvsField 

Geometric MTF vs. Field.

HuygensMtfvsField 

Huygens MTF vs. Field.

HuygensMtf 

Huygens MTF.

HuygensSurfaceMtf 

Huygens Surface MTF.

HuygensThroughFocusMtf 

Huygens Through Focus MTF.

FftPsf 

FFT PSF.

FftPsfCrossSection 

FFT PSF Cross Section.

FftPsfLineEdgeSpread 

FFT Line/Edge Spread.

HuygensPsfCrossSection 

Huygens PSF Cross Section.

HuygensPsf 

Huygens PSF.

DiffractionEncircledEnergy 

Diffraction Encircled Energy.

GeometricEncircledEnergy 

Geometric Encircled Energy.

GeometricLineEdgeSpread 

Line/Edge Spread.

ExtendedSourceEncircledEnergy 

Extended Source Encircled Energy.

SurfaceCurvatureCross 

Surface Curvature Cross Section.

SurfacePhaseCross 

Surface Phase Cross Section.

SurfaceSagCross 

Surface Sag Cross Section.

SurfaceCurvature 

Surface Curvature.

SurfacePhase 

Surface Phase.

SurfaceSag 

Surface Sag.

StandardSpot 

Spot Diagram.

ThroughFocusSpot 

Through Focus Spot Diagram.

FullFieldSpot 

Full Field Spot Diagram.

MatrixSpot 

Matrix Spot Diagram.

ConfigurationMatrixSpot 

Configuration Matrix Spot Diagram.

RMSField 

RMS vs. Field.

RMSFieldMap 

RMS Field Map.

RMSLambdaDiagram 

RMS vs. Wavelength.

RMSFocus 

RMS vs. Focus.

Foucault 

Foucault Analysis.

Interferogram 

Interferogram.

WavefrontMap 

Wavefront Map.

DetectorViewer 

Detector Viewer.

Draw2D 

Layout.

Draw3D 

3D Layout

ImageSimulation 

Image Simulation.

GeometricImageAnalysis 

Geometric Image Analysis.

IMABIMFileViewer 

IMA/BIM File Viewer.

GeometricBitmapImageAnalysis 

Geometric Bitmap Image Analysis.

BitmapFileViewer 

Bitmap File Viewer.

LightSourceAnalysis 

Light Source Analysis.

PartiallyCoherentImageAnalysis 

Partially Coherent Image Analysis.

ExtendedDiffractionImageAnalysis 

Extended Diffraction Image Analysis.

BiocularFieldOfViewAnalysis 

Biocular Field Of View Analysis.

BiocularDipvergenceConvergence 

Biocular Dipvergence/Convergence.

RelativeIllumination 

Relative Illumination.

VignettingDiagramSettings 

Vignetting Diagram.

FootprintSettings 

Footprint Diagram.

YYbarDiagram 

Y-Ybar Diagram.

PowerFieldMapSettings 

Power Field Map.

PowerPupilMapSettings 

Power Pupil Map.

IncidentAnglevsImageHeight 

Incident Angle vs. Image Height.

FiberCouplingSettings 

Fiber Coupling.

YNIContributions 

YNI Contributions.

SagTable 

Sag Table.

CardinalPoints 

Cardinal Point Data.

DispersionDiagram 

Dispersion Diagram.

GlassMap 

Glass Map.

AthermalGlassMap 

Athermal Glass Map.

InternalTransmissionvsWavelength 

Internal Transmission.

DispersionvsWavelength 

Dispersion vs. Wavelength.

GrinProfile 

Grin Profile.

GradiumProfile 

Gradium Profile.

UniversalPlot1D 

Universal Plot 1D.

UniversalPlot2D 

Universal Plot 2D.

PolarizationRayTrace 

Polarization Ray Trace.

PolarizationPupilMap 

Polarization Pupil Map.

Transmission 

Transmission.

PhaseAberration 

Phase Aberration.

TransmissionFan 

Transmission Fan.

ParaxialGaussianBeam 

Paraxial Gaussian Beam Data.

SkewGaussianBeam 

Skew Gaussian Beam Data.

PhysicalOpticsPropagation 

Physical Optics Propagation.

BeamFileViewer 

Beam File Viewer.

ReflectionvsAngle 

Reflection vs. Angle.

TransmissionvsAngle 

Transmission vs. Angle.

AbsorptionvsAngle 

Absorption vs. Angle.

DiattenuationvsAngle 

Diattenuation vs. Angle.

PhasevsAngle 

Phase vs. Angle.

RetardancevsAngle 

Retardance vs. Angle.

ReflectionvsWavelength 

Reflection vs. Wavelength.

TransmissionvsWavelength 

Transmission vs. Wavelength.

AbsorptionvsWavelength 

Absorption vs. Wavelength.

DiattenuationvsWavelength 

Diattenuation vs. Wavelength.

PhasevsWavelength 

Phase vs. Wavelength.

RetardancevsWavelength 

Retardance vs. Wavelength.

DirectivityPlot 

Source Directivity Viewer.

SourcePolarViewer 

Source Polar Viewer.

PhotoluminscenceViewer 

Phosphors and Fluorescence Spectrum Plot.

SourceSpectrumViewer 

Source Spectrum Viewer.

RadiantSourceModelViewerSettings 

Radiant Source Model™ Viewer.

SurfaceDataSettings 

Surface Data.

PrescriptionDataSettings 

Prescription Data.

FileComparatorSettings 

File Comparator.

PartViewer 

Part Viewer.

ReverseRadianceAnalysis 

ReverseRadiance™ Analysis.

PathAnalysis 

Path Analysis.

FluxvsWavelength 

Flux vs. Wavelength.

RoadwayLighting 

Roadway Lighting Analysis.

SourceIlluminationMap 

Source Illumination Map.

ScatterFunctionViewer 

Scatter Function Viewer.

ScatterPolarPlotSettings 

Scatter Polar Plot.

ZemaxElementDrawing 

Zemax Element Drawing.

ShadedModel 

Shaded Model.

NSCShadedModel 

NSC Shaded Model.

NSC3DLayout 

NSC 3D Layout.

NSCObjectViewer 

NSC Object Viewer.

RayDatabaseViewer 

Ray Database Viewer.

ISOElementDrawing 

ISO Element Drawing.

SystemData 

System Data.

TestPlateList 

Test Plate List.

SourceColorChart1931 

CIE 1931 Color Chart.

SourceColorChart1976 

CIE 1976 Color Chart.

PrescriptionGraphic 

System Summary Graphic.

CriticalRayTracer 

Critical Ray Tracer.

ContrastLoss 
CoatingListing 
FullFieldAberration 
SurfaceSlope 

Surface Slope.

SurfaceSlopeCross 

Surface Slope Cross Section.

QuickYield 

Quick Yield.

SystemCheck 
ToleranceYield 

Tolerancing Yield.

ToleranceHistogram 

Tolerancing Histogram.

DiffEfficiency2D 

Diffraction Efficiency 2D.

DiffEfficiencyAngular 

Diffraction Efficiency Angular.

DiffEfficiencyChromatic 

Diffraction Efficiency Chromatic.

NSCSurfaceSag 

NSC Surface Sag.

NSCSingleRayTrace 

NSC Single Ray Trace.

NSCGeometricMtf 

Non-Sequential Geometric MTF.

SurfacePhaseSlope 

Surface Phase Slope.

SurfacePhaseSlopeCross 

Phase Slope Cross Section.

◆ Beam

Enumerator
Reference 
Configuration_1 
Configuration_2 
Configuration_3 
Configuration_4 
Configuration_5 
Configuration_6 
Configuration_7 
Configuration_8 
Configuration_9 
Configuration_10 
Configuration_11 
Configuration_12 
Configuration_13 
Configuration_14 
Configuration_15 
Configuration_16 
Configuration_17 
Configuration_18 
Configuration_19 
Configuration_20 

◆ BestFitSphereOptions

Enumerator
MinimumVolume 
MinimumRMS 
MinimumRMSWithOffset 

◆ ColorPaletteType

Enumerator
GreyScale 
FalseColor 
FalseColorOriginal 
Viridis 
Magma 

◆ DetectorViewerShowAsTypes

Usage (see Example 10 for a full sample)

C#

// Open Detector Viewer, view previously saved .zrd file
IA_ DetectorView = TheSystem.Analyses.New_DetectorViewer();
IAS_DetectorViewer DetectorView_Settings = DetectorView.GetSettings() as IAS_DetectorViewer;
DetectorView_Settings.RayDatabaseFilename = "e10_API_RayTrace.ZRD";
DetectorView_Settings.ShowAs = DetectorViewerShowAsTypes.FalseColor;
DetectorView_Settings.Filter = "X_HIT(2, 4)"; // Detector will only display rays which hit object 2 exactly 4 times
DetectorView.ApplyAndWaitForCompletion(); // Apply Settings to Detector Viewer
Base interface for all analysis windows. This interface can be accessed via the I_Analyses interface.
Definition: IA_Base.cs:29
IAS_ GetSettings()
Gets the settings for the current analysis.
IMessage ApplyAndWaitForCompletion()
Re-runs the analysis with the current settings and waits for it to finish calculating.
DetectorViewerShowAsTypes
Definition: I_ShowAs.cs:34

C++

// Open Detector Viewer, view previously saved .zrd file
IA_Ptr DetectorView = TheSystem->Analyses->New_DetectorViewer();
IAS_DetectorViewerPtr DetectorView_Settings = DetectorView->GetSettings();
DetectorView_Settings->RayDatabaseFilename = "e10_API_Raytrace.ZRD";
DetectorView_Settings->ShowAs = DetectorViewerShowAsTypes_FalseColor;
// Detector will only display rays which hit object 2 exactly 4 times
DetectorView_Settings->Filter = "X_HIT(2, 4)";
// Apply Settings to Detector Viewer
DetectorView->ApplyAndWaitForCompletion();

Matlab

% Open Detector Viewer, view previously saved .zrd file
DetectorView = TheSystem.Analyses.New_DetectorViewer();
DetectorView_Settings = DetectorView.GetSettings();
DetectorView_Settings.RayDatabaseFilename = 'e10_API_Raytrace.ZRD';
DetectorView_Settings.ShowAs = ZOSAPI.Analysis.DetectorViewerShowAsTypes.FalseColor;
DetectorView_Settings.Filter = 'X_HIT(2, 4)'; % Detector will only display rays which hit object 2 exactly 4 times
DetectorView.ApplyAndWaitForCompletion(); % Apply Settings to Detector Viewer
Definition: IAS_FieldCurvatureAndDistortion.cs:5
The ZOSAPI namespace contains classes for initially connecting to zemax. See also ZOSAPI_Connection,...
Definition: IAS_FieldCurvatureAndDistortion.cs:5

Python

# Open Detector Viewer, view previously saved .zrd file
DetectorView = TheSystem.Analyses.New_DetectorViewer()
DetectorView_Settings = DetectorView.GetSettings()
DetectorView_Settings.RayDatabaseFilename = "e10_API_Raytrace.ZRD"
DetectorView_Settings.ShowAs = ZOSAPI.Analysis.DetectorViewerShowAsTypes.FalseColor
DetectorView_Settings.Filter = "X_HIT(2, 4)" # Detector will only display rays which hit object 2 exactly 4 times
DetectorView.ApplyAndWaitForCompletion() # Apply Settings to Detector Viewer
Enumerator
FullListing 
AzimuthCrossSection 
Text_CrossSection_Row 
Text_CrossSection_Column 
FluxVsWaveLength 
GreyScale 
GreyScale_Inverted 
FalseColor 
FalseColor_Inverted 
TrueColor 
Color_CrossSection_Row 
Color_CrossSection_Column 
Color_FluxVsWavelength 
CrossSection 
Directivity_Full 
Directivity_Half 
CrossSection_Row 
CrossSection_Column 
GeometricMtf 

◆ DetectorViewerShowDataTypes

Enumerator
IncidentFlux 
AbsorbedFlux 
AbsorbedFluxVolume 
PositionSpace 
AngleSpace 
Polar_AngleSpace 
IncoherentIrradiance 
CoherentIrradiance 
CoherentPhase 
RadiantIntensity 
RadiancePositionSpace 
RadianceAngleSpace 
IncoherentIlluminance 
CoherentIlluminance 
LuminousIntensity 
LuminancePositionSpace 
LuminanceAngleSpace 
IncoherentFluence 
CoherentFluence 

◆ ErrorType

Enumerator
Success 
InvalidParameter 
InvalidSettings 
Failed 
AnalysisUnavailableForProgramMode 
NotYetImplemented 
NoSolverLicenseAvailable 
ToolAlreadyOpen 
SequentialOnly 
NonSequentialOnly 
SingleNSCRayTraceSupported 
HPCNotAvailable 
FeatureNotSupported 
NotAvailableInLegacy 

◆ GiaShowAsTypes

Enumerator
Surface 
Contour 
GreyScale 
InverseGreyScale 
FalseColor 
InverseFalseColor 
SpotDiagram 
CrossX 
CrossY 

◆ GridPlotType

Enumerator
Surface 
Contour 
GrayScale 
InverseGrayScale 
FalseColor 
InverseFalseColor 

◆ HuygensShowAsTypes

Enumerator
Surface 
Contour 
GreyScale 
InverseGreyScale 
FalseColor 
InverseFalseColor 
TrueColor 

◆ HuygensSurfaceMftShowAsTypes

Enumerator
GreyScale 
InverseGreyScale 
FalseColor 
InverseFalseColor 

◆ POPSampling

Enumerator
S_32 
S_64 
S_128 
S_256 
S_512 
S_1024 
S_2048 
S_4096 
S_8192 
S_16384 
S_32768 
S_65536 
S_131072 
S_262144 
S_524288 
S_1048576 
S_2097152 
S_4194304 
S_8388608 
S_16777216 
S_33554432 
S_67108864 
S_134217728 
S_268435456 
S_536870912 
S_1073741824 
S_1K 
S_2K 
S_4K 
S_8K 
S_16K 
S_32K 
S_64K 
S_128K 
S_256K 
S_512K 
S_1M 
S_2M 
S_4M 
S_8M 
S_16M 
S_32M 
S_64M 
S_128M 
S_256M 
S_512M 
S_1G 

◆ RemoveOptions

Enumerator
None 
BaseROC 
BestFitSphere 
BaseSag 
CompositeSag 

◆ SampleSizes

Enumerator
S_32x32 
S_64x64 
S_128x128 
S_256x256 
S_512x512 
S_1024x1024 
S_2048x2048 
S_4096x4096 
S_8192x8192 
S_16384x16384 

◆ SampleSizes_ContrastLoss

Enumerator
S_3x3 
S_5x5 
S_7x7 
S_9x9 
S_11x11 
S_13x13 
S_15x15 
S_17x17 
S_19x19 
S_21x21 
S_23x23 
S_25x25 
S_27x27 
S_29x29 
S_31x31 
S_33x33 
S_35x35 
S_37x37 
S_39x39 
S_41x41 
S_43x43 
S_45x45 
S_47x47 
S_49x49 
S_51x51 
S_53x53 
S_55x55 
S_57x57 
S_59x59 
S_61x61 
S_63x63 
S_65x65 
S_67x67 
S_69x69 
S_71x71 
S_73x73 
S_75x75 
S_77x77 
S_79x79 
S_81x81 
S_83x83 

◆ SampleSizes_Pow2Plus1

Enumerator
S_33 
S_65 
S_129 
S_257 
S_513 
S_1025 
S_2049 
S_4097 
S_8193 

◆ SampleSizes_Pow2Plus1_X

Enumerator
S_33x33 
S_65x65 
S_129x129 
S_257x257 
S_513x513 
S_1025x1025 
S_2049x2049 
S_4097x4097 
S_8193x8193 

◆ ShowAs

Enumerator
Surface 
Contour 
GreyScale 
InverseGreyScale 
FalseColor 
InverseFalseColor 

◆ SurfaceCurvatureCrossData

Enumerator
TangentialCurvature 
SagitalCurvature 
X_Curvature 
Y_Curvature 
TanPlusSagCurvature 
XPlusYCurvature 

◆ SurfaceCurvatureData

Enumerator
TangentialCurvature 
SagitalCurvature 
X_Curvature 
Y_Curvature 

◆ SurfacePhaseData

Enumerator
SurfacePhase 

◆ SurfacePhaseSlopeCrossData

Enumerator
PhaseSlopeTangential 
PhaseSlopeSaggital 
PhaseSlopeX 
PhaseSlopeY 
PhaseSlopeTangentialAndSaggital 
PhaseSlopeX_and_Y 

◆ SurfacePhaseSlopeData

Enumerator
PhaseSlopeTangential 
PhaseSlopeSaggital 
PhaseSlopeX 
PhaseSlopeY 

◆ SurfaceSagData

Enumerator
SurfaceSag 

◆ SurfaceSlopeCrossData

Enumerator
TangentialCurvature 
SagitalCurvature 
X_Curvature 
Y_Curvature 
TanPlusSagCurvature 
XPlusYCurvature 

◆ SurfaceSlopeData

Enumerator
SurfaceSlope 
TangentialSlope 
SagittalSlope 
XSlope 
YSlope 

◆ UserAnalysisDataType

Enumerator
None 
Line2D 
Grid 
GridRGB 
Text 

Connect with Ansys