## File: oriloc.Rd

package info (click to toggle)
r-cran-seqinr 3.4-5-2
 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147 \name{oriloc} \alias{oriloc} \title{ Prediction of origin and terminus of replication in bacteria.} \description{ This program finds the putative origin and terminus of replication in procaryotic genomes. The program discriminates between codon positions. } \usage{ oriloc(seq.fasta = system.file("sequences/ct.fasta.gz", package = "seqinr"), g2.coord = system.file("sequences/ct.predict", package = "seqinr"), glimmer.version = 3, oldoriloc = FALSE, gbk = NULL, clean.tmp.files = TRUE, rot = 0) } \arguments{ \item{seq.fasta}{Character: the name of a file which contains the DNA sequence of a bacterial chromosome in fasta format. The default value, \code{system.file("sequences/ct.fasta.gz", package ="seqinr")} is the fasta file \code{ct.fasta.gz}. This is the file for the complete genome sequence of \emph{Chlamydia trachomatis} that was used in Frank and Lobry (2000). You can replace this by something like \code{seq.fasta = "myseq.fasta"} to work with your own data if the file \code{myseq.fasta} is present in the current working directory (see \code{\link{getwd}}), or give a full path access to the sequence file (see \code{\link{file.choose}}).} \item{g2.coord}{Character: the name of file which contains the output of glimmer program (\code{*.predict} in glimmer version 3)} \item{glimmer.version}{Numeric: glimmer version used, could be 2 or 3} \item{oldoriloc}{Logical: to be set at TRUE to reproduce the (deprecated) outputs of previous (publication date: 2000) version of the oriloc program.} \item{gbk}{Character: the URL of a file in GenBank format. When provided \code{oriloc} use as input a single GenBank file instead of the \code{seq.fasta} and the \code{g2.coord}. A local temporary copy of the GenBank file is made with \code{\link{download.file}} if \code{gbk} starts with \code{http://} or \code{ftp://} or \code{file://} and whith \code{\link{file.copy}} otherwise. The local copy is then used as input for \code{\link{gb2fasta}} and \code{\link{gbk2g2}} to produce a fasta file and a glimmer-like (version 2) file, respectively, to be used by oriloc instead of \code{seq.fasta} and \code{g2.coord} .} \item{clean.tmp.files}{Logical: if TRUE temporary files generated when working with a GenBank file are removed.} \item{rot}{Integer, with zero default value, used to permute circurlarly the genome. } } \details{ The method builds on the fact that there are compositional asymmetries between the leading and the lagging strand for replication. The programs works only with third codon positions so as to increase the signal/noise ratio. To discriminate between codon positions, the program use as input either an annotated genbank file, either a fasta file and a glimmer2.0 (or glimmer3.0) output file. } \value{ A data.frame with seven columns: \code{g2num} for the CDS number in the \code{g2.coord} file, \code{start.kb} for the start position of CDS expressed in Kb (this is the position of the first occurence of a nucleotide in a CDS \emph{regardless} of its orientation), \code{end.kb} for the last position of a CDS, \code{CDS.excess} for the DNA walk for gene orientation (+1 for a CDS in the direct strand, -1 for a CDS in the reverse strand) cummulated over genes, \code{skew} for the cummulated composite skew in third codon positions, \code{x} for the cummulated T - A skew in third codon position, \code{y} for the cummulated C - G skew in third codon positions. } \references{ More illustrated explanations to help understand oriloc outputs are available there: \url{https://pbil.univ-lyon1.fr/software/Oriloc/howto.html}.\cr Examples of oriloc outputs on real sequence data are there: \url{https://pbil.univ-lyon1.fr/software/Oriloc/index.html}.\cr The original paper for oriloc:\cr Frank, A.C., Lobry, J.R. (2000) Oriloc: prediction of replication boundaries in unannotated bacterial chromosomes. \emph{Bioinformatics}, \bold{16}:566-567.\cr \url{https://doi.org/10.1093/bioinformatics/16.6.560}\cr\cr A simple informal introduction to DNA-walks:\cr Lobry, J.R. (1999) Genomic landscapes. \emph{Microbiology Today}, \bold{26}:164-165.\cr \url{http://seqinr.r-forge.r-project.org/MicrTod_1999_26_164.pdf}\cr\cr An early and somewhat historical application of DNA-walks:\cr Lobry, J.R. (1996) A simple vectorial representation of DNA sequences for the detection of replication origins in bacteria. \emph{Biochimie}, \bold{78}:323-326.\cr Glimmer, a very efficient open source software for the prediction of CDS from scratch in prokaryotic genome, is decribed at \url{http://www.cbcb.umd.edu/software/glimmer/}.\cr For a description of Glimmer 1.0 and 2.0 see:\cr Delcher, A.L., Harmon, D., Kasif, S., White, O., Salzberg, S.L. (1999) Improved microbial gene identification with GLIMMER, \emph{Nucleic Acids Research}, \bold{27}:4636-4641.\cr Salzberg, S., Delcher, A., Kasif, S., White, O. (1998) Microbial gene identification using interpolated Markov models, \emph{Nucleic Acids Research}, \bold{26}:544-548.\cr \code{citation("seqinr")} } \author{J.R. Lobry, A.C. Frank} \seealso{ \code{\link{draw.oriloc}}, \code{\link{rearranged.oriloc}} } \note{ The method works only for genomes having a single origin of replication from which the replication is bidirectional. To detect the composition changes, a DNA-walk is performed. In a 2-dimensional DNA walk, a C in the sequence corresponds to the movement in the positive y-direction and G to a movement in the negative y-direction. T and A are mapped by analogous steps along the x-axis. When there is a strand asymmetry, this will form a trajectory that turns at the origin and terminus of replication. Each step is the sum of nucleotides in a gene in third codon positions. Then orthogonal regression is used to find a line through this trajectory. Each point in the trajectory will have a corresponding point on the line, and the coordinates of each are calculated. Thereafter, the distances from each of these points to the origin (of the plane), are calculated. These distances will represent a form of cumulative skew. This permets us to make a plot with the gene position (gene number, start or end position) on the x-axis and the cumulative skew (distance) at the y-axis. Depending on where the sequence starts, such a plot will display one or two peaks. Positive peak means origin, and negative means terminus. In the case of only one peak, the sequence starts at the origin or terminus site. } \examples{ \dontrun{ # # A little bit too long for routine checks because oriloc() is already # called in draw.oriloc.Rd documentation file. Try example(draw.oriloc) # instead, or copy/paste the following code: # out <- oriloc() plot(out$st, out$sk, type = "l", xlab = "Map position in Kb", ylab = "Cumulated composite skew", main = expression(italic(Chlamydia~~trachomatis)~~complete~~genome)) # # Example with a single GenBank file: # out2 <- oriloc(gbk="ftp://pbil.univ-lyon1.fr/pub/seqinr/data/ct.gbk") draw.oriloc(out2) # # (some warnings are generated because of join in features and a gene that # wrap around the genome) # } }