DIBER/RIBER

Manual (version 5.0 and above)

INTRODUCTION

This is the documentation for RIBER/DIBER version 5 with updated command line interface. The use of this version is strongly recommended. For instructions on how to use older versions refer to the obsolete manual page.

SYNOPSIS

rdiber -mtzin foo.mtz -f F column label -sigf sigF column label -mode diber|riber -phaser phaser output root filename -psout postscript output filename
[Keyworded input]

DESCRIPTION

The program RIBER/DIBER takes diffraction data as input and uses a support vector machine classifier to predict whether a crystal contains only protein, only nucleic acid, or a mixture of both. The DIBER is intended to search for the double stranded B-DNA and not the rarer A-DNA or double stranded RNA. RIBER was tuned to detect the presence of regular RNA stems in macromolecular crystals.
You can use one of two modes of the program: standalone (DIBER and RIBER) or combined (DIBER only). In standalone mode prediction is prepared based on the cube root of the reciprocal unit cell volume of a crystal and the largest local average of reflection intensities in a thin resolution shell. The prediction prepared in combined mode is enhanced with the PHASER Maximum Likelihood Fast Rotation Function score and is more reliable. However, PHASER is subject to third-party constraints and it is your responsibility that you comply with any such restrictions. Please contact the PHASER developers to obtain the necessary permissions for academic and commercial use.

KEYWORDED INPUT

-mtzin mtz filename

Compulsory keyword Input MTZ file containing structure factor amplitudes (F) and its standard deviations (SIGF). Data must extend to at least 3.0 Å resolution.

-mode [diber/riber]

Compulsory keyword Defines the program mode. DIBER should be used if a crystal was grown in the presence of DNA. If a crystalliztion solution contained RNA you should use RIBER.

-f column label

Compulsory keyword Label of column containing structure factor amplitudes (F's).

-sigf column label

Compulsory keyword Label of column containing structure factor standard deviations (SIGF's).

-psout filename

Optional keyword If given, the program will produce graphical output in a postscript format.

-phaser root filename

Optional keyword (DIBER only) If given, the program will run PHASER and use its LLG to enhance prediction reliability. If root filename is not given, DIBER will create its own root name based on MTZ input file name.

OUTPUT DESCRIPTION

The RIBER/DIBER classification of a crystal unknown content can be carried out in two modes: standalone and combined with the PHASER rotation function score. In both cases the text output is basically the same (plain text prediction and related classification probabilities), the graphical output depends on the program mode.

Standalone mode

Two graphs are produced. One presents feature space with the classification boundaries and regions of high level of correct classification probability


As a by-product of the classification, the program outputs a plot of the local intensity averages on a stereographic net. If a nucleic acid present in your crystal displays long, regular helices their orientations in the unit cell may be derived from the postion of strong signals on the projection.

Combined mode (DIBER only)

In this mode, the feature space becomes three-dimensional and thus is not graphically presented. Instead, the top ten solutions of the PHASER rotation function are marked on the stereographic net along with the contour plot of the local intensity averages.