Content-type: text/html
Man page of X-GEN
X-GEN
Section: X-GEN Commands (1)
Updated: October 2005
Index
Return to Main Contents
NAME
X-GEN - pdisplay
SYNOPSIS
xgen
pdisplay [frameno]
DESCRIPTION
"pdisplay" enables an Motif-based display of diffraction images within
X-GEN. Since it is built with Motif widgets, it must be run on a screen
with X-windows capabilities. Pdisplay has a number of internal capabilities
that can be invoked by pushing buttons on its display menus.
When you first invoke pdisplay, the display of an image will appear,
along with a control strip, a blow-up menu, and a few standalone buttons.
The display will be at least 512x512 pixels in size unless the actual pixel
size of the image is smaller than that. For larger images the display will be
constructed from 2x2, 3x3, 4x4, or even 5x5 binnings of the detector pixels.
For example, it will display a 1900x1900-pixel RAxisII image by binning the
data into 4x4 pixel groupings, so the display will be 475x475 pixels.
OPTIONS
- <frameno>
-
The image to be initially displayed may be specified
-
either as a filename or as a number. In the latter case the image
displayed is determined by reference to the FRAMES file. Thus if
image 173 is specified in the FRAMES file as
/data0/ahoward/udgmut1/udgmut12/udgmut1_2.173, then that file will
be displayed if pdisplay is invoked with the argument 173.
Default value: the first image in the frame index.
Pull-down menus and their contents:
-
* Files:
-
o Exit: terminates the program.
o Up Display: Decreases the brightness of the display.
o Down Display: Increases the brightness of the display.
o Redraw: Updates the display (typically after the window
-
has been interfered with).
-
o Next Frame: Display the image following the current one.
o Prev Frame: Display the image preceding the current one.
o Brass-plate: Display the brass-plate image used for
-
calibration.
-
o Background: Display the UREFLS background image.
o Frame #s: Bring up a slider on which the user can dial up
-
the image to display next.
-
o Files...: Bring up a full-featured file browser to use in
-
choosing an image to display.
-
* Urefls:
-
o Intensity: Display, in place of an actual detector image,
-
a pseudo-image on which measured reflections are displayed.
The intensity of the spot is shown by color-coding, using a
scale where the interval between colors is by equal cube-roots.
-
o I/sigma: Display, in place of an actual detector image, a
-
pseudo-image on which measured reflections are displayed.
The intensity / sigma value of the spot is shown by
color-coding, where the interval between colors is by equal
cube roots.
-
o Err(omega): Display, in place of an actual detector image,
-
a pseudo-image on which measured reflections are displayed.
The (omega_obs - omega_pred ) value of the spot is shown by
color-coding.
-
o Err(X): Display, in place of an actual detector image, a
-
pseudo-image on which measured reflections are displayed.
The (Xobs - Xpred ) value of the spot is shown by
color-coding.
-
o Err(Y): Display, in place of an actual detector image, a
-
pseudo-image on which measured reflections are displayed.
The (Yobs - Ypred ) value of the spot is shown by
color-coding.
-
o Scatterplot: Display, in place of an actual detector
-
image, a scatterplot of various dependent variables as a
function of various independent variables. Two sets of radio
buttons allow you choose the independent and dependent
variables to use in the scatterplot:
Independent Variables Dependent Variables
sin(theta)/lambda, omega, X, Y Err(omega), Err(X), Err(Y)
-
o hkl plots: Sets up displays of intensity or I/sigma in
-
planes of (h,k,l) space--e.g. all (h,k) values at l=5.
-
o Files: Allows the user to choose the UREFLS file from
-
which all these results will be derived via a full-featured
file browser.
-
* Multirefs:
-
o Intensity: Displays over the (X,Y) grid the values of the
-
individual reflection intensities as a color-code.
-
o I/sigma: Displays over the (X,Y) grid the values of the
-
individual reflection I/sigma values as a color-code.
-
o DelI/s: Displays over the (X,Y) grid the values of (Iij -
-
<I>j )/sigma(ij)
-
o Files: Allows the user to choose the MULTIREF file from
-
which all these results will be derived via a full-featured
file browser.
-
* Overlays:
-
o Calibrate: Displays as an overlay over the current image
-
the mapping from pixels to centimeters used with the data.
-
o Predict: Displays as an overlay over the current image the
-
positions of the Bragg spots predicted to fall in the image.
-
o Border: Displays an overlay indicating the boundaries of
-
the active area of the detector.
-
o Centroids: Displays an overlay showing the (X,Y) positions
-
of the centroids found in *spots* or *reduce -c*. Only those
found in images fairly close to the currently displayed
image will be shown.
-
o Cal. Centroids: Displays an overlay of the calibration
-
centroids as found in *calibrate*.
-
There is also a crucial button just above the EXIT button: it says
PROCESS, and it means it. If you mash that button, a menu similar
to that produced by pmotif will appear, and you will be able to use
it to jump to specific applications within the X-GEN package. This
_is_ the primary graphical user interface for X-GEN currently.
-
For detectors with time-independent conversions from pixels to
centimeters and back again, pdisplay examines the images it is
working with and copies over a standard pixel-to-centimeter
conversion file with suffix .uca into the current working
directory for use during data processing. Thus if the run
identifier is "george" and the data come from a Mar 165 CCD
detector, then pdisplay will, when the user sets up the command
files, copy over a standard file marccd.uca into $WORK/george.uca.
Text Interface:
-
pdisplay accepts commands from the terminal window as well. A line
containing only a non-negative integer is taken to be a request to
display the image with that number. Otherwise commands consist of
verbs followed by parameters, usually numeric. Thus the sequence
-
14
ov ce
no pr
cs bw
-
would tell pdisplay to display image 14 with the CENTROIDS overlay
turned on, the predicted-reflections overlay turned off, in the
black-to-white colorscheme.
EXAMPLES
-
pdisplay 14 View and (perhaps) manipulate image number 14:
REPORTING BUGS
Report bugs to Andy Howard at howard@iit.edu or 312-567-5881.
COPYRIGHT
Copyright © 2002, Illinois Institute of Technology.
See the file 'LICENSE' for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- REPORTING BUGS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 02:12:19 GMT, October 03, 2005