file_pha - writes phase of the field into a txt file.

Calling Sequence

[field_out]=file_pha(field_in,fnam[,time[,imax[,gnuplot]]])

Parameters

• field_in :input field. it must be diffractive wavefront.
• fnam : the output filename, it must be a string.
• time : the timestamp of the outfile name. default time = -1. If the value of time is not positive,then the timestamp of the outfile will not be included.
• imax : the grid dimension or sampling dimension (must be integer), default imax=64. it equals to grid sampling if you pass the zero to imax
• gnuplot : the indication whether the output file will be processed by gnuplot or fil_ter (it must be bool variant),default gnuplot = fause.
• field_out : the output field or diffractive wavefront.

Description

file_pha is similar to file_int , it writes wrapped phase distribution into a txt file which may be processed or plotted with Scilab graphical functions. One argument is necessary: the output filename. Default grid size is 64x64, you may change the default dimension with the imax argument. Files saved with file_pha and file_int (set the gnuplot paramter to 1) can also be imported with fil_ter , which automatically recognizes pgm and gnuplot formats.

Examples

	F1=begin(0.01,1e-6);
	F2=gauss(F1,0.004);
	
	file_pha(F2,"file1");	
	file_pha(F2,"file2",1);	
	file_pha(F2,"file3",-1,0);	
	file_pha(F2,"file4",-1,128);	
	file_pha(F2,"file5",-1,128,1);	
	
	int = fscanfMat('file1.txt');
	surf(int);
 

Author

Chen jingyuan, Gan guangyong (IAPCM, Beijing,China.)

See Also

dwf_fits ,   file_ps ,   file_int ,   file_pgm ,   cros_out ,