Reports Menu

FIGURE 6.37 - Incident Ray Table.

Reports Menu

TracePro can generate reports on the raytrace and properties using the Reports menu. You can generate a Raytrace report, a Flux report, or a Property Data report. The reports provide summary information after a ray trace or about the property informations in the case of a Property Report.

Flux Report

The Flux report provides a summary of the most recent raytrace. The data can also be saved to a tab-delimited text file for viewing and post-processing in other programs via the File|Save As menu.

Data columns include Surface Area, Wavelength and Source, Number of Incident rays, Incident and Absorbed fluxes, and the Lost flux. Lost flux data is broken into various categories to identify which mechanism caused rays to be lost.

Data is displayed for bulk absorption and incident flux for each object. The incident flux is the sum of the flux entering the object so that the ray data is not doubly counted when a ray passes into and out of the object. In the case of a sphere that has a single surface, a ray passing through the sphere will have a incident flux for object at half the value as that of the surface, in the loss less case. The ray is incident on the object once but incident on the surface twice.

The lists at the top of the window allow you to choose which sources and which wavelenths to include in the Flux Report.

The data is displayed for each object in red and for each surface in blue.

Analysis

Property Data Report

This report displays the model's property data. This provides similar information on the Objects and Surfaces as found from the System Tree. The data can be saved to a tab-delimited text file for viewing and post-processing in other programs via the File|Save As menu.

The data is displayed for each object in red and for the object's surfaces in blue.

Raytrace Report

This report displays a modal dialog with memory usage and the elapsed raytrace time for the most recent raytrace of the active model. Both physical and virtual memory are also displayed. The raytrace memory can be deleted with the Delete Raydata Memory command on the tools menu.

TracePro uses the GlobalMemoryStatus2 function of Windows to report memory usage. This function provides the following information.

•Total Physical Memory - Total size of physical memory.

•Available Physical Memory - Size of physical memory available.

•Used Physical Memory - Total minus Available

•Total Virtual Memory - Total size of the user mode portion of the virtual address space of the calling process.

•Available Virtual Memory - Size of unreserved and uncommitted memory in the user mode portion of the virtual address space of the calling process.

•Used Virtual Memory - Total minus Available

The Physical Memory will agree with the Task Manager and System Performance tools but the Virtual memory is tied to the application instance.

Saving and Restoring a Raytrace

An analysis mode raytrace can be saved to disk for later display. First, put TracePro into Ray Saving Mode by selecting File|Save Ray Data.

This action toggles the Save Ray Data menu item on and off. When the menu item is checked and you save a TracePro model, a second file with the extension ray is also saved. The ray file contains data for all the rays from the most recently completed raytrace.

To save ray data, first be sure that TracePro is in ray saving mode. You can check this by looking at the File menu and confirming that the Save Ray Data item is

checked. (If it appears as , it is checked. Selecting it again makes it unchecked.)

Then select File|Save As and type in a file name for the oml file. Press Save to save the file, and TracePro will save both the oml file and the ray file.

It is important that the oml file and ray file stay synchronized. Changes to the geometry and properties in the oml file will make the saved rays obsolete and

2. See Microsoft Windows API Programming reference for additional information.