Navigation: Analyses Commands > Ray Status

 

Ray Status

 

Contact Us: fredsupport@photonengr.com

 

 

 

Description


The Ray Status command outputs the status of all the rays in the system in the output window. This command is very useful for diagnosing errors.

 

Rays in the following categories are counted:

 

total ray slots

below absolute transmitted power threshold

coherent secondary ray errors

total live rays

below absolute reflected power threshold

coherent secondary ray invariant errors

active

below relative transmitted power threshold

coherent Gaussian exponential decay violation

traceable

below relative reflected power threshold

evanescent

specular

material ambiguity

TIR not allowed

scatter

transmitted glue material ambiguity

acquired bad position

absorbed

reflected glue material ambiguity

acquired bad direction

polarized

exceeded total intersection count

exceeded allowed steps in an inhomogenous material

coherent

exceeded specular ancestry threshold

unspecified inactive (usually associated with MPC ray trace)

stopped by raytrace control

exceeded scatter ancestry threshold

 

 

New organization like this? Should status  messages be alphabetized? Best way to order?

 

Status Message

Description

total ray slots

Total number of slots in the ray buffer reserved for ray data.

total live rays

Total number of rays in the ray buffer.  May be less than the "total ray slots".

active

Number of active rays in the ray buffer.  Active rays can be raytraced and analyzed.  Inactive rays are ignored. 

traceable

Number of traceable rays in the ray buffer.  Traceable rays can continue to be raytraced using Trace Existing Rays. 

specular

Number of specular rays in the ray buffer.  Specular rays have a scatter ancestry level of 0. 

scatter

Number of scatter rays in the ray buffer.  Scatter rays have scatter ancestry > 0. 

absorbed

Number of absorbed rays in the ray buffer. Also, see topic: Absorbed Rays

polarized

Number of polarized rays in the ray buffer. 

coherent

Number of coherent rays in the ray buffer. 

stopped by raytrace control

Number of rays whose propagation was halted due to a raytrace control specification. 

below absolute transmitted power threshold

Number of rays whose propagation was halted because their power values fell below an absolute transmitted power cutoff threshold defined in a Raytrace Property. 

below absolute reflected power threshold

Number of rays whose propagation was halted because their power values fell below an absolute reflected power cutoff threshold defined in a Raytrace property. 

below relative transmitted power threshold

Number of rays whose propagation was halted because their power values fell below a relative transmitted power cutoff threshold defined in a Raytrace Property. 

below relative reflected power threshold

Number of rays whose propagation was halted because their power values fell below an absolute reflected power cutoff threshold defined in a Raytrace Property. 

material ambiguity

Number of rays whose propagation was halted because they were unable to resolve an ambiguous material assignment at a surface intersection. Also, see topic: Materials Assignment Rules 

transmitted glue material ambiguity

Number of rays whose propagation was halted because they were unable to resolve an ambiguous material assignment for glued surfaces in transmission. Also, see topic: Glue Surfaces 

reflected glue material ambiguity

Number of rays whose propagation was halted because they were unable to resolve an ambiguous material assignment for glued surfaces in reflection. Also, see topic: Glue Surfaces 

exceeded total intersection count

Number of rays whose propagation was halted because their total intersection counts exceeded the value specified in a Raytrace Property.

exceeded specular ancestry threshold

Number of rays whose propagation was halted because their specular ancestry level exceeded the value specified in a Raytrace Property.

exceeded scatter ancestry threshold

Number of rays whose propagation was halted because their scatter ancestry level exceeded the value specified in a Raytrace Property. 

coherent secondary ray errors

Number of coherent rays with secondary ray errors. Also, see topic: Coherent Sources

coherent secondary ray invariant errors

Number of coherent rays with secondary ray invariant errors. Also, see topic: Coherent Sources

coherent Gaussian exponential decay violation

Number of coherent rays that have become non-gaussian. Also, see topic: Coherent Sources

evanescent

Number of rays whose propagation was halted due to being evanescent at a grating interface.

TIR not allowed

Number of rays whose propagation was halted because a Raytrace Property does not allow TIR. 

acquired bad position

Number of rays whose propagation was halted because the ray's position is invalid (usually related to GRIN material raytracing).

acquired bad direction

Number of rays whose propagation was halted because the ray's direction is invalid (usually related to GRIN material raytracing).

exceeded allowed steps in an inhomogenous material

Number of rays whose propagation was halted because they exceeded the number of allowed steps inside of a GRIN material. 

unspecified inactive (usually associated with MPC ray trace)

Rays traced using FREDmpc may be suppressed by various controls (raytrace property, scatter model, etc.) during the GPU raytrace.  At the time these rays get suppressed during the GPU raytrace sequence, they do not have their final, properly scaled flux values.  Consequently, these rays are marked as inactive so that they will not be included in any subsequent analyses.

 

 

Navigation


This command can be accessed in the following ways:

Menu > Analyses > Ray Status

Shift + F10

Toolbar button:

 

 

Related Topics


Ray Statistics

Ray Summary

Surface Incident / Absorbed Power

 

 

 

 

 

Copyright © Photon Engineering, LLC