Description

Performs an illuminance calculation and writes the results to a file.  Depending on the number of rays traced, it may be necessary to dimension ray index and ray counter variables as data type Huge_ instead of Long.  Please see Multi-threaded Raytracing for more information.

Syntax

count = IlluminanceToFileAS( anaSurf, outputUnits, nDetRespSpect, DetRespScale, fileName )

Parameters

count (Long or Huge_)

Number of rays included in the calculation

anaSurf As Long

Node number of the analysis surface used in the calculation.

outputUnits As Long

Value specifies units of the calculation.  Options are:

0: Lumens/(sys units)²

1: Lux

2: Phot

3: Foot-candles

4: Arbitrary Units

If the user has specified to use a detector response, then the units are automatically set to Arbitrary Units.  If the user does not wish to specify a detector response, then set nDetRespSpect = -1.

nDetRespSpect As Long

Node number of the spectrum to be used as the detector response.

DetRespScale As Double

Scale factor for the spectrum being used as the detector response.

fileName As String

Name of the file being created from the Illuminance calculation.

Remarks

The following example creates a file from an Illuminance calculation on an existing rayset.  The units are set to "Phot" and the name of the file is "test_file.fgd".

Dim fname As String

Dim anaSurfNum As long

anaSurfNum = FindFullName( "Analsysis Surface(s).Analysis 1" )

fname = GetDocDir() & "\test_file.fgd"

numRays = IlluminanceToFileAS( anaSurfNum, 2, -1, 1, fname )

See Also

IlluminanceToARN