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.

              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 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)
              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.


Man(1) output converted with man2html