APPENDIX 1

Utilities

 

A1.1 plot.py

 

plot.py plots curves and scatter plots saved in CPL reflection file format.  See CPL reference for details of the format.  Type plot.py ¨Ch for a help message:

 

Usage: plot.py [-h|help] [-c|s|cc|ss|cs|sc] data [data2] [x [x0 [y [y0]]]]

   Displays a curve and/or a scatter plot.

   data, data2: cpl.io.reflection files that contain data in the 4th and 5th

      columns.

   x, x0, y, y0: If no numerical argument is given, the entire curve(s) will

      be plotted.  If some numbers are given, plots the curve(s) in the ranges

      of [x0, x] and [y0, y].

   -c|s|cc|ss|cs|sc: Specifies plotting styles of curve or scatter plot for

      data and data2, respectively.

   -h|help: Prints this message.

 

Listing A1.1.0.0.1 Usage of plot.py.

 

A1.2 swap1.py

 

swap1.py swaps bytes of a file.  The original file will be overwritten.  Type swap1.py without an argument for usage.  This utility is useful when some images have swapped bytes.

 

Usage: swap1.py file

 

Listing A1.2.0.0.1 Usage of swap1.py.

 

 

Figure A1.2.0.0.1 A byte-swapped diffraction image.


APPENDIX 2

README File

 

A README file can be found in the top directory of the distribution.

 

This README file is in /usr/local/rriyyyymmdd.  If not, you need to replace

/usr/local with other appropriate path.

 

0) As root,

   % cd /usr/local

   % tar xzvf [path/]rriyyyymmdd.tgz

   % cd rriyyyymmdd

 

   You must have done these, if you are reading this file.

 

1) As root,

   % cd /usr/local

   % ln -s rriyyyymmdd rri

 

2) As a user,

   % cd

   Insert these lines into your .tcshrc file:

 

setenv RRILICENSE      "your_home_directory/license.rri"

setenv RRI             /usr/local/rri

setenv PATH            "${RRI}/bin:${RRI}/pub/bin:${PATH}"

setenv CCLHOME         "${RRI}/ccl"

setenv CPLHOME         "${RRI}/cpl"

setenv PRECOGNITION    "${RRI}/gpr"

setenv LD_LIBRARY_PATH "${RRI}/pub/lib"

setenv PYTHONPATH      "${RRI}/pub:${CPLHOME}/..:${CPLHOME}:${CPLHOME}/ptr:${CPL

HOME}/std:${CPLHOME}/mac:${CPLHOME}/ccl"

 

   % source .tcshrc

 

3) If you have a license file, skip to 4).

 

   As a user,

   % cd

   % python

   Python 2.3.4 (#1, Oct 21 2004, 21:26:45)

   [GCC 3.4.1] on linux2

   Type "help", "copyright", "credits" or "license" for more information.

   >>> import cpl

 

   |||)) Welcome to CPL M0.16.0

   |||\\ Renz Research, Inc.

 

   >>> cpl.license.getinfo()

 

   SOURCE: cpl.license.getinfo

   TYPE:   result

   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

   To obtain a license on this host, please send file info.rri to Renz Research.

   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 

   E-mail the file info.rri to renz@renzresearch.com to request a license file.

 

4) Put the license file license.rri in your home directory.

   % printenv RRILICENSE

   Check if this points to your license file.  If not, change in .tcshrc.  See

   2).

 

5) % Precognition and

   % Epinorm

 

   Refer to /usr/local/rri/doc/userGuide.pdf or the updated manual at

   http://renzresearch.com/pdf/userGuide.pdf.

   Enjoy.

 

You may reach me by any means:

 

Zhong Ren

 

Renz Research, Inc.

P. O. Box 605

Westmont, IL 60559

U. S. A.

 

Tel    630-230-0272

Fax    435-514-2645

E-mail renz@renzresearch.com

WWW    http://renzresearch.com

 

Listing A2.0.0.0.1 README file.