Quick navigation: Home   |    Site Map   ||    References   |    Biography   ||    Copyright   |    Other copyright   |    Contact us   |    Advert   |   
 

XDisplayF (xdisp)

- Protein crystallography

Main steps:

   - Protein purification
   - Crystallisation

Special:

   - Programs for crystallography
       - ADSC-software
       - HKL package
       - HKL2000 package
         - XDisplayF
           - Supported formats
       - HKL2MAP
       - Pocket
   - X-ray detectors

Basic tutorials:

   - Chemistry
   - Protein
   - Peptide
   - Amino Acids

Xtal community:

   - CCP4BB
XDisplayF (xdisp) allows to visualize X-ray data in original form, obtained from X-ray detector as well as observe the progress of data integration. This visualization is very important to monitor the correctness of X-ray data prediction and integration processes as well as quickly adjusts some integration parameters, like mosaicity, spot shape and size.

Please note, that XDisplayF is x-window program and it is necessary to have X-Window support. Because xdisp use the x-window interface it is possible to use remote computer as a host computer.

Starting XdisplayF (xdisp)

XDISP in an alias for running XDisplayF program. Simplest way to run this XDisplayF it is necessary to type next command string:
xdisp FORMAT Image_Name, where
FORMAT is the format of the X-ray data image. All supported by xdisp formats are listed here: Formats supported by xdisp. It is possible to have a list of all supported programs by typing in the command litne xdisp.
Image_Name - Name of the X-ray data image with path to this image.

Another options to run xdisp

It is possible to launch the program with the Image_Name specified with variable number, according to standard numbering scheme.
xdisp FORMAT Image_Name###.ext number - in this case the sign ### will be substituted by number.

xdisp FORMAT Image_Name###.ext number Image_Name###.x
- in this case the sign ### will be substituted by number.
- Image_Name###.x - List of integrated reflections from Denzo output. In the ImageWindow you can click "Update Pred" and prediction will appear on the screen.

Communication between xdisp and Denzo

Denzo and xdisp communicate between each other through the hklprediction ans .test files, that is why it is necessary to use the same directory to run Denzo and xdisp.

XDisplayF (xdisp) window description

After proper running xdisp the window with image will appear. The name of the image will be on the top of the xdisp window. Here you can read description of all buttons and outputs in the xdisp window. Despite this full description it is much more useful to became more familiar is to play by yourself with this xdisp window. In case if everything goes wrong - just kill this window by clicking close button and rerun the XDisplayF program again.

HKL2000, xdisp top part of window

This is a top part of the XDisplayF program window. Please note, that the button alignment on this window is depends from the image displayed. At the top part of window, the image name is displayed.

  • Prof fit R hkl2000, XDisplayF, xdisp: prof fit r Allow to turn on/off the profile fitting radius. This function is working when the prediction is already done. The only spots stronger than WEAK LEVEL, according to Denzo are shown. For definition of PROFILE FITTING RADIUS refer to the Denzo manual. These two X-ray diffraction pattern with prediction shows the xdisp window with and without Prof fit R:
    Lysozyme X-ray diffraction pattern with Prof fit R OFF Lysozyme X-ray diffraction pattern with Prof fit R ON
    Lysozyme X-ray diffraction pattern with Prof fit R OFF Lysozyme X-ray diffraction pattern with Prof fit R ON

Zoom window of XdisplayF (xdisp)


  • Zoom wind hkl2000, XDisplayF, xdisp: zoom wind This button is responsible for launching of ZOOM WINDOW. The size of the ZOOM WINDOW can be adjusted from inside this window. Position of the centre of the ZOOM WINDOW can be selected by mouse middle-button click either in main window, ether in ZOOM WINDOW.

    XDisplayF: window with Zoom Related Zoom window Xdisp main and zoom window
    X-ray diffraction pattern with Zoom window switched ON. It is possible to see the square place, represented the zooming area. Related Zoom window. The papers-suitable representation of the X-ray diffraction pattern with Zoom window.

    Within Zoom window all three mouse buttons are active: Middle mouse button select new centre for the Zoom window; Right mouse button displays the cross-sections through the position of the mouse pointer, to see the 2D profile of the Zoom window; Left mouse button display all information about clicked point and, if this point is related with reflection - displays the h, k, l parameters.
    XDisplayF: window with Zoom 2D section XDisplayF: Zoom window right click no spot XDisplayF: Zoom reflection details
    The 2D profiles for the xdisp Zoom window, which allow to see real signal/background ratio. Information about "empty space". Information about predicted reflection.

    Zoom window contains the following operational buttons:

    • Zoom in hkl2000, XDisplayF, xdisp: ZOOM IN Increase the magnification of the Zoom Window by factor of 2. when the magnification factor exceeds 32, the digital pixel intensities will be displayed on the top of the pixel pattern.

      XDisplayF: Digital zoom window
      Zoom Window with high magnification. Digital pixel intensities are shown.

    • Zoom out hkl2000, XDisplayF, xdisp: ZOOM OUT Performs function opposite to the Zoom in button: Decrease the magnification of Zoom window.
    • Int. box hkl2000, XDisplayF, xdisp: Int. Box Perform the different mode of showing of integration box. Each clicking of this button changes the mode of spot showing. The size of integration box and integration circles are defined by denzo parameters BOX and SPOT. Check denzo manual about the definition of these parameters.
      XDisplayF: Zoom window with default integration box XDisplayF: Zoom window with integration box and circles XDisplayF:  Zoom window with integration circles
      The default integration box shows circles centred on predicted places. The size of these circles is 6 pixels. Color scheme is standard: green - fully recorded reflection, yellow - partially recorded reflection, red - rejected reflection. Next window: In addition to the colored circles with predicted reflection positions the Integration box, Integration circle and Integration background circle are shown with real sizes. Next window: The Integration box is removed. Integration circle - colored white and Integration background circle colored red. Circles with predicted positions are also shown.

    • Diff Vec hkl2000, XDisplayF, xdisp: Difference vector
    • Zoom close hkl2000, XDisplayF, xdisp: zoom close Safely close Zoom window. Other ways to kill Zoom window can results in closing all xdisp windows.
    • Help hkl2000, XDisplayF, xdisp: zoom help This is very informative interactive help system which is still not implicated in full yet. Please be patient for another few years.
      xdisp: Zoom window with help XDisplayF: Zoom in help from Zoom window
      Help for Zoom window - bad alignment, not full. Example of Help window for Zoom in command.

Other XdisplayF (xdisp) functions

  • Write/Print hkl2000, XDisplayF, xdisp: write/print Write to the HDD file with current image in the .XWD format. XWD - X Window Dump. For our studies we newer use this option, but instead we've use Window Grab function implemented into XV viewer, or we've use Alt-Ctrl-PrintScreen to grab the xdisp window from the windows operational system.
  • A/D test hkl2000, XDisplayF, xdisp: A/D test
  • Floor Up hkl2000, XDisplayF, xdisp: floor Up Lift up the lower level for the intensities display range. The image pixels with intensities below the current floor will displayed at lowest color or darkness level. This effectively reduces the displayed range, but increase the contrast of the output image. The left, middle, right click of the mouse cause small, medium and large changes, respectively.
  • Floor Down hkl2000, XDisplayF, xdisp: floor Down The function of this button is completely opposite to the Floor up button.
  • reverse hkl2000, XDisplayF, xdisp: Reverse Invert the image display. Operate with gray and color images (see color button).
  • color hkl2000, XDisplayF, xdisp: Color Change image presentation between black & white and color mode. The selection of the best mode for image presentations depends from personal preferences of scientist, but for the publications the best mode of presentation is the dark reflection on the white background.
    XDisplayF: Deafult window XDisplayF: Reverse window XDisplayF: Reverse window XDisplayF: Color reverse view
    Example of XDisplayF window with default presentation Example of XDisplayF window reverse mode Example of XDisplayF window color presentation Example of XDisplayF window with reverse and color presentation

  • Remove pred hkl2000, XDisplayF, xdisp: Remove prediction and Update pred hkl2000, XDisplayF, xdisp: Update prediction Switch OFF and ON X-ray diffraction prediction. The prediction is automatically updated from the denzo output. Predicted reflections are shown by circles with different colors: green - fully recorded reflections, yellow - partially recorded reflections, red - rejected reflections.
  • Full scale hkl2000, XDisplayF, xdisp: Full scale Change scaling of the image from optimal to full to show the relation between the actual data collection and detector abilities. This function is not always worked correctly.
  • Go hkl2000, XDisplayF, xdisp: Go Run the subsequent image changes. The direction for image numbers to change is defined by the status of the Frame button. hkl2000, XDisplayF, xdisp: Frame UP - for the increase image numbers, and hkl2000, XDisplayF, xdisp: Frame down - for decrease image numbers. This function work properly with images, numbered accordingly standard file name mask: filename###.ext , where ### - number of the image.
  • Show Overfl hkl2000, XDisplayF, xdisp: show overfl Shows overfilled pixels by RED color.
  • Peak Sear hkl2000, XDisplayF, xdisp: Peak search Search peaks on the displayed image. Results are stored in the file peaks.file. After running of this routine, the selected peaks are circled by bold red circles and on the right side of the image the control menu will appear. During the time of program calculation, the information about program status will be displayed with the Peak searching ... button: hkl2000, XDisplayF, xdisp: Peak search message and the picture of very clever man (see the end of this manual) Please note, that these peaks are starting peaks for the denzo indexing and this set should be selected carefully..
    XDisplayF: Peak search
    Window with found peaks. Selected peaks are circled red. The right hand side menu is described below.

    • Ok hkl2000, XDisplayF, xdisp: Peak search ok Finish the Peak search routine and create file peaks.file with selected peaks. The current number of peaks is displayed just above the Ok button. Example: 944 spots found: hkl2000, XDisplayF, xdisp: spots found
    • More peaks hkl2000, XDisplayF, xdisp: Peak search - More peaks Reduce the accepted level (intensity to background) of peaks which results in increasing number of peaks found. When the accepted level is near to the background, XDisplayF can accidentally crash, and it is necessary o run it again.
    • Fewer peaks hkl2000, XDisplayF, xdisp: Peak search fewer peaks Opposite to the More peaks routine.
    • Size peak up hkl2000, XDisplayF, xdisp: Peak search - size UP Increase the size of searched spots. This is necessary when the crystal diffraction pattern appears with unusually large spots.
    • Size peak down hkl2000, XDisplayF, xdisp: Peak search - size down Reduce the size of searched spots. This is necessary when the crystal diffraction pattern appears with unusually small spots and the distance between these spots is extremely small.
    • Pick (Add) hkl2000, XDisplayF, xdisp: Peak add manually Allow to add manually peaks, by clicking in the main window or in the zoom window in close vicinity from the spots, not selected by automated routine.
    • Pick (Remove) hkl2000, XDisplayF, xdisp: Peaks remove manually Allow to remove manually peaks, by clicking in the main window or in the zoom window in close vicinity from already selected spots. This is useful to eliminate problems related with data collected from multi-crystals, or for data collected from crystals with ice-rings.
  • Edit P.S. hkl2000, XDisplayF, xdisp: Edit post script This function was never used in our research activities.
  • Help hkl2000, XDisplayF, xdisp: Help Displays menu with help topics organized as submenu. Not very useful yet. To close help menu - click Help button again.
  • dim hkl2000, XDisplayF, xdisp: Button dim Function is opposite to bright. Increases the intensities range to display with reducing intensities for strong spots representation. A lot of clicks to this button will result in clean of whole image.
  • bright hkl2000, XDisplayF, xdisp: Button bright Function is opposite to dim. Decreases the intensities range to display with improving of weak spots representation. A lot of clicks to this button will result in darkening of whole image.
  • close hkl2000, XDisplayF, xdisp: Button close Close the XDisplayF program.
  • Frame hkl2000, XDisplayF, xdisp: Frame UP and hkl2000, XDisplayF, xdisp: Frame down - controls the direction of automatic number changes activated by Go hkl2000, XDisplayF, xdisp: Go button. Left mouse click set this button to Frame down position, right mouse click set this button to Frame up position and middle mouse button click cause of one frame change, according to selected direction. Work properly only with standard image names filename###.ext, where ### - image number.
  • All program delays related with computations, such as peak search, or image preparation are accompanied with the picture of a very clever man.


    hkl2000, XDisplayF, xdisp: Clever man

    ProteinCrystallography.org: Copyright 2006-2010 by Quid United Ltd