get another manpage
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 capabil-
ities 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 but-
tons.
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 dis-
play 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 (typi-
cally 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 func-
tion of various independent variables. Two sets of radio buttons
allow you choose the independent and dependent variables to use
in the scatterplot: Independent Variables Depen-
dent 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 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 con-
version 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 com-
mands 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 over-
lay 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 (C) 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
Version 5.5.5 October 2005 X-GEN(1)
"get my man!" .. in association with
man2html
and cor