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