
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.
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:
- Text Plain ASCII text format.
- EPS Encapsulated postscript format.
- LaTeX LaTeXFormat.
- HTML HTML format using standard tabbing layout (not Netscape tables).
- 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:
- w Write a new file. If the file already exists silently overwrite it.
- a+ Append the output to a pre-existing file. If there is no existing
file of this name, create a new file.
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:
- FITS Standard fits format.
- EPS Encapsulated postscript format.
- PGM Portable Gray Map format, useful if you have the pbmtools, which
can turn this format into just about any other format.
- Raw Outputs just the floating point numbers which comprise the image.
- 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.
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:
- FITS Standard fits format.
- EPS Encapsulated postscript format.
- PGM Portable Gray Map format, useful if you have the pbmtools, which
can turn this format into just about any other format.
- Raw Outputs just the floating point numbers which comprise the image.
- 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.
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:
- FITS Standard fits format.
- EPS Encapsulated postscript format.
- PGM Portable Gray Map format, useful if you have the pbmtools, which
can turn this format into just about any other format.
- Raw Outputs just the floating point numbers which comprise the image.
- 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
