readme.txt

科学计算程序 （用于光学镊子

###################          CPC Librarian's Note
       ########################


The CPC distribution file differs slightly from the files described below and in 
the manuscipt.


The documentation is held in the directory html-doc. The java source files class 
files etc. are in the tr directory.


################################################################################ 
HOLOTRAP INSTRUCTIONS

The program source is contained in the src directory. 

********************************************************************************
**********

The list of files is:

	TRBase.java - Main class. Generates the Graphical User Interface and 
needs of the default files containing the modulator map phase function and the 
aberration phase correction, that is map_ideal.txt and phaberr_1024x768.txt. It 
also requires the file license.txt. Once compiled, these .txt files have to be 
placed in the directory where the .class files are. 

	PanelCoord.java - in charge of the mouse events. It calls to the third 
class, FrameHolo, which calculates the holograms in response to these events.

	FrameHolo.java - Calculates and displays the holograms with the 
parameters specified by the user in the Graphical User Interface and the mouse 
events. 

	map_ideal.txt - Modulation map phase function.

	phaberr_1024x768.txt - Phase aberration correction. (Only to be used 
with 1024x768 pixels holograms).

	license.txt - General Public License (GPL) text.
	
********************************************************************************
***********

Instructions to compile the application:

With a Java JDK 1.4 or superior installed, execute inside the tr directory 
"javac *.java"
This will generate 18 .class files (one per class defined into the source code). 

Instructions to execute the application:

outside of the directory tr execute "java tr.TRBase" (NOTE: the three .txt files 
listed above have to be placed into the tr directory).

To run the application, press button Init and click "Yes" when asked to use the 
default options. Then just click on the black  panel displayed and the hologram 
will be displayed on an independent window, which has to be sent to the 
modulator device depending on the specific display. By dragging the mouse over 
the panel the hologram will be modified in real time. 

The compiled .jar (compressed and executable) file can be obtained from 
http://www.ub.edu/optics/holotrap/holotrap.jar
This .jar file is executed through the order "java -jar holotrap.jar" on a 
command line
The complete documentation of the program can be found at 
http://www.ub.edu/optics/holotrap/html/index.html