MENU
R'MES general view rmes.gaussien rmes.poisson.composee rmes.poisson
rmes.gfam rmes.format rmes.histo
rmes.compar
rmes.pyramide


Splus Function: rmes.compar
Graphical Comparison of Results from R'MES Programs.



Description Usage Required Arguments Optional Arguments Details Note Examples Axis Labels



Description

Interactive function to graphically compare exceptional words or families of words either under two models, or in two sequences, or in two phases, or using two count approximations or using two algorithms, from R'MES results. The Splus function rmes.compar produces a scatter plot on which each point corresponds to a word or a family of words.
If no graphical device is active, X11 is used. Otherwise, the current graphical device is used.

Usage


rmes.compar (don1, don2, lg.mot, mod1, mod2, 
             ident=NULL, filtre=NULL, 
             comptage=F,  esperance=F, sigma2=F, 
             conjugue=F,lang="fr")

Required Arguments

don1, don2
Character strings equal to the pathnames of the files containing the information to be compared. These files should have been created by one of the following commands: rmes.gaussien, rmes.poisson, rmes.poisson.composee.
If they concern families of words, these must be identical on both files.

Information from don1 will be on the x-axis whereas information from don2 will be on the y-axis. According to don1 and don2:

Sommaire

Optional Arguments

lg.mot
Length of the words to be represented. It must be less or equal 8. By default, the largest word length found in common in the input files.
Ignored when families of words are compared.
mod1, mod2
Ignored in the current version.
ident
This argument allows to define a list of words or families to be identified on the plot, either by their indices (numbers), or by their names, according to what will be subsequently chosen by the menu (see KIND of DISPLAY).
It introduces a vector that contains words, or family-names, or their indices (words of a given length are numbered according to the lexicographic order a,g,c,t and families to the order on the input files).
(See also the paragraph Note to identify overlapping words or palindromes),
filtre
This argument allows the selection of words or families of words to be displayed. It can be:
- an integer vector of indices of words or families (see the paragraph Note to select overlapping words or palindromes),
- a character vector of words or family-names,
- a character string corresponding to a logical expression: this logical expression must be written with respect to the word counts, the expected counts, the squares of normalizing factors, the statistics or the plotted values associated to the words or families in don1 and don2, via the key-words: val.cmpt.1, val.cmpt.2, val.esp.1, val.esp.2, val.sigma2.1, val.sigma2.2, val.stat.1, val.stat.2, val.plot.1, val.plot.2.
(see example 5 )
comptage, esperance, sigma2
Logical values. Only one can be TRUE that defines what kind of results is presented: the words counts, the expected counts, or the squares of normalizing factors.
By default, the statistics.
conjugue
Logical value. When TRUE, the y-axis coordinate of a word is the quantity related to its conjugate in the file don2.
Ignored when families of words are compared.
lang
When equal to "fr", labels and messages are in french. When equal to "en", labels and messages are in english. By default, they are in french.

Sommaire

Details

A menu allows the user to modify the displays and to store them.
Select item 7 (screen display) or 8 (print) after each selection to make the new display appearing.
In the following, replace the occurrences of "word" by "family of words", in case of families of words.

The choices are:

0 - QUIT

1 - SELECT A RADIUS CIRCLE
to define a circle of center (0, 0) inside which points are not represented. A null radius deletes the preceding circle.

2 - SELECT A WINDOW
to specify the minimal and maximal bounds of the display window. When one of the bounds is not specified, the current bound is used. The value NA implies the drop-out of a preceding value.

3 - SELECT A KIND OF DISPLAY
to choose how the words are represented. A sub-menu appears with the following choices:

A null reply to this sub-menu means that the previous choice is kept.

NOTE: when some words have been selected (see 6 below) and option NUMBERS or NAMES have been chosen, the numbers or names only appear above the selected points.

4 - CHANGE THE SIZE
to specify a character expansion relative to the device's standard size. For example, 2 implies that characters are twice as big as normal. Reply 1 to reset the normal size.

5 - CHANGE THE SCALE
to specify if the scales on the x-axis and the y-axis should be different when no window bounds are mentionned.

6 - IDENTIFY WORDS (OR FAMILIES)
to modify or reset a list of words (or families of words) to be specifically identified. A sub-menu appears with the following choices:

7 - SCREEN DISPLAY
to display the plot on the current graphical device unit (X11 by default).

8 - PRINT
to store the plot in a PostScript file. Its name is then asked to the user.

Sommaire

Note

In order to filter or to identify more easily palindromes or overlapping words, several files containing the list of these word indices are provided in the directory EXMOT into the installation directory of R'MES.

Sommaire

Examples

1- Comparison of the exceptional 3-words in the phage lambda genome and the pt7 genome under M1. The input files lambda.gaussien.3_1.0 and pt7.gaussien.3_1.0 have been previously obtained by rmes.gaussien (exemple 1 in rmes.gaussien).

> rmes.compar("lambda.gaussien.3_1.0","pt7.gaussien.3_1.0",lg.mot=3,lang="en")
2- Comparison of the exceptional 4-words in phase 1 and in phase 3 of a coding DNA sequence of E. coli (coli-codant) under M2_3. The input files coli-codant.gaussien.4_2.1 and coli-codant.gaussien.4_2.3 have been previously obtained by rmes.gaussien (example 2 in rmes.gaussien).

> rmes.compar("coli-codant.gaussien.4_2.1","coli-codant.gaussien.4_2.3",
	       lg.mot=4)
3- Comparison of the exceptional 4-words in the ecomori sequence under M1 and M2. All the palindromes of length 4 are identified. The input files ecomori.gaussien.4_1.0 and ecomori.gaussien.4_2.0 have been previously obtained by rmes.gaussien (example 3 in rmes.gaussien).

> mot.pal.4 <- c(16,28,40,52,79,91,103,115,142,154,166,178,205,217,229,241)
> rmes.compar("ecomori.gaussien.4_1.0", "ecomori.gaussien.4_2.0", 
	       lg.mot=4, ident=mot.pal.4)
 
4- Comparison of the exceptional palindromes of length 4 in the ecomori sequence under M1 and M2. Only the palindromes are represented.

> rmes.compar("ecomori.gaussien.4_1.0", "ecomori.gaussien.4_2.0", 
	       lg.mot=4, filtre=mot.pal.4)
 
5- Idem but only the words for statistics values greater than 6 are represented.

> rmes.compar("ecomori.gaussien.4_1.0", "ecomori.gaussien.4_2.0", 
	       filtre="val.stat.1>6 & val.stat.2>6")  
 
6- Comparison of the exceptional families of the family file fam.xnxxxxxx in the sequence hf-rep (the replication genome of H. Influenzae) and hf-rep-sans-uptake (the replication genome of H. Influenzae without the uptake sequence aagtgcggt and its complementary). The input files hf-rep.xnxxxxxx_1.0 and hf-rep-sans-uptake.xnxxxxxx_1.0 have been previously obtained by rmes.gaussien (example 7 in rmes.gaussien).

> rmes.compar("hf-rep.xnxxxxxx_1.0","hf-rep-sans-uptake.xnxxxxxx_1.0",
               ident="gntggtgg",lang="en")
 

Axis Labels

The table Axis Labels gives the link between the axis labels in rmes.compar and the notation of the statistics used in the french user guide.

Sommaire