Prev Up
Go backward to 7.2 ef_seq and related commands.
Go up to 7 Tcl functions for implementing wavefront reconstruction

7.3 Output of results.

Once you have computed a wavefront you will probably want to save the results. You can do this in any of the ways that you can from the GUI version, by calling the relevant Tcl function.

The wavefront map format is the most general format, since it always contains the complete wavefront information. In this format the magnitudes of any subtracted Zernikes are stored in the fits header of the wavefront file.

7.3.1 Saving a zernike list.

The function ef_saveZernikesCmndLine saves the contents of the current wavefront as a zernike list. The function takes the following seven arguments.
efs
An ef_claude object.
normalization
Not currently used, but intended to specify Zernike normalization eventually. Set this to the value "Noll" for future compatibility.
from
The first Zernike term you wish to output.
to
The last Zernike term that you wish to output.
format
The format of file you wish to write, the current choices are:
file name
The name of the file you wish to write the data to. If you use "stdout" as the file name, the output will be written to the programs standard output.
file mode
You may use any file mode which is legal to tcl. The most useful two modes are:

7.3.2 Saving a wavefront.

The procedure ef_saveWavefrontCmndLine saves the current wavefront, with a range of zernikes subtracted. The procedure takes the following 6 arguments:
efs
An ef_claude object, containing the wavefront to be saved.
from
The first Zernike term you wish to subtract from the wavefront.
to
The last Zernike term that you wish to subtract from the wavefront.
format
The format of file you wish to write, the current choices are:
file name
The name of the file you wish to write the data to. If you use "stdout" as the file name, the output will be written to the programs standard output.
file mode
You may use any file mode which is legal to tcl. Probably the only meaningful mode in this context is w. Mode w means write a new file but if the file already exists silently overwrite it.

7.3.3 Saving a synthetic image.

The procedure ef_saveImageCmndLine saves the current wavefront as a synthetic image. As with the other save functions you can eliminate a range of Zernike terms. The procedure takes the following 8 arguments:
efs
An ef_claude object, containing the wavefront to be saved.
from
The first Zernike term you wish to subtract from the wavefront.
to
The last Zernike term that you wish to subtract from the wavefront.
wavelength
The wavelength for which you wish to compute the synthetic image.
sampling
The amount of over-sampling in the image plane. Passing 1 here will give you a Nyquist sampled image. You can use this parameter to match the image scale of a real sensor. It does not make sense to make the over-sampling factor smaller than 0.5, and values between 0.5 and 1 are probably not useful. Large over-sampling factors can result in the necessity to perform large FFT's with the concomital time and memory penalties. The FFT size is approximately 4*wavefront_rad*oversampling.
format
The format of file you wish to write, the current choices are:
file name
The name of the file you wish to write the data to. If you use "stdout" as the file name, the output will be written to the programs standard output.
file mode
You may use any file mode which is legal to tcl. Probably the only meaningful mode in this context is w. Mode w means write a new file but if the file already exists silently overwrite it.

7.3.4 Saving a synthetic fringe pattern.

The procedure ef_saveFringeCmndLine saves the current wavefront as a synthetic fringe pattern. As with the other save functions you can eliminate a range of Zernike terms. The procedure takes the following 9 arguments:
efs
An ef_claude object, containing the wavefront to be saved.
from
The first Zernike term you wish to subtract from the wavefront.
to
The last Zernike term that you wish to subtract from the wavefront.
wavelength
The wavelength for which you wish to compute the synthetic fringe pattern.
tilt
The amount of tilt in the reference wavefront. This is measured in fringes across cross the total wavefront. The absolute reference wavefront tilt is therefore dependent on the wavelength you have selected. If you wish to see "fluffed out" fringes, set the tilt to zero.
angle
This is the angle of the tilt on the reference wavefront, it is specified in degrees. For a non aberrated wavefront the fringes will appear orthogonal to the angle you specify here.
format
The format of file you wish to write, the current choices are:
file name
The name of the file you wish to write the data to. If you use "stdout" as the file name, the output will be written to the programs standard output.
file mode
You may use any file mode which is legal to tcl. Probably the only meaningful mode in this context is w. Mode w means write a new file but if the file already exists silently overwrite it.

Laplacian Optics Inc.     Email:   laplace@laplacian.com

Prev Up