ZBFPROPERTIES

Opens the specified ZBF file and places various data about the beam in a vector variable.

Syntax

ZBFPROPERTIES filename, vector

Discussion

This keyword requires the name of the ZBF file and a value for the vector number to place the data in. The value of vector must be between 1 and 4, inclusive. After the ZBFPROPERTIES function executes, the following beam data will be placed in the specified vector: nx, ny, dx, dy, waist_x, waist_y, position_x, position_y, rayleigh_x, rayleigh_y, wavelength (in lens units), total power, peak irradiance (power per area), the is_polarized flag (0 for no, 1 for yes), and the media index; the values are placed in vector positions 1 through 15.

See Purpose for comments that apply to all ZBF related keywords.

Note: This command only supports *.ZBF file format. It does not support *.ZBF2 file format.

Example

ZBFPROPERTIES "TEST.ZBF", 1 
rayleighx = VEC1(9)