gatk-3.8/R/src/gsalib/man/gsa.plot.venn.Rd

76 lines
1.6 KiB
Plaintext
Raw Normal View History

\name{gsa.plot.venn}
\alias{gsa.plot.venn}
* Added an R package, "gsalib", providing a place to store common, useful, documented R methods. To use this module, you must follow three steps: 1) Build the module with the following command: $ ant gsalib 2) Add the module path to your ~/.Rprofile file: .libPaths("/path/to/Sting/trunk/R/") 3) At the top of each R script that will use the library, include the line: library(gsalib) You can now use the package like any other R package. To get high-level documentation, supply the following command to R: help(gsalib) The methods contained herein are: getargs : A method to easily provide arguments to interactive and non-interactive scripts. Prints out a help message specifying how the script should be run if no arguments or "-h" is provided. Very helpful when you're writing an R-script piecemeal in interactive mode, then want to make it a command-line program. plot.venn : Plots a two-way or three-way proportional Venn diagram. read.eval : Reads VariantEval output that's formatted in R style. read.gatkreport : Reads GATKReport output. gsa.message : Emits a message with the prefix "[gsalib]" to stdout. gsa.warn : Emits a warning message with the prefix "[gsalib] Warning:" to stdout. gsa.error : Emits an error message with the prefix "[gsalib] Error: to stdout, calls traceback() and halts execution. Documentation on each of these methods can be obtained by typing "help(method_name)" at the R prompt. * Retired GATKReport.R, as that functionality has now been moved to gsalib. * Retired gsacommons, as that functionality has been split between gsalib and VariantReport.R. * Modified VariantReport.R to make use of gsalib. The script now uses the getargs() method to provide the user with some information as to the proper way to run the script. Documentation on how to prepare output is given at http://www.broadinstitute.org/gsa/wiki/index.php/VariantEval . * Added 'gsalib' target to build.xml file. Running "ant gsalib" will compile this module and place the R-ready package in R/gsalib . git-svn-id: file:///humgen/gsa-scr1/gsa-engineering/svn_contents/trunk@4416 348d0f76-0448-11de-a6fe-93d51630548a
2010-10-04 08:27:59 +08:00
\title{
Plot a proportional venn diagram
}
\description{
Plot a proportional venn diagram (two or three-way venns allowed)
}
\usage{
gsa.plot.venn(a, b, c = 0, a_and_b, a_and_c = 0, b_and_c = 0, col = c("#FF6342", "#63C6DE", "#ADDE63"), pos = c(0.2, 0.2, 0.8, 0.82), debug = 0)
* Added an R package, "gsalib", providing a place to store common, useful, documented R methods. To use this module, you must follow three steps: 1) Build the module with the following command: $ ant gsalib 2) Add the module path to your ~/.Rprofile file: .libPaths("/path/to/Sting/trunk/R/") 3) At the top of each R script that will use the library, include the line: library(gsalib) You can now use the package like any other R package. To get high-level documentation, supply the following command to R: help(gsalib) The methods contained herein are: getargs : A method to easily provide arguments to interactive and non-interactive scripts. Prints out a help message specifying how the script should be run if no arguments or "-h" is provided. Very helpful when you're writing an R-script piecemeal in interactive mode, then want to make it a command-line program. plot.venn : Plots a two-way or three-way proportional Venn diagram. read.eval : Reads VariantEval output that's formatted in R style. read.gatkreport : Reads GATKReport output. gsa.message : Emits a message with the prefix "[gsalib]" to stdout. gsa.warn : Emits a warning message with the prefix "[gsalib] Warning:" to stdout. gsa.error : Emits an error message with the prefix "[gsalib] Error: to stdout, calls traceback() and halts execution. Documentation on each of these methods can be obtained by typing "help(method_name)" at the R prompt. * Retired GATKReport.R, as that functionality has now been moved to gsalib. * Retired gsacommons, as that functionality has been split between gsalib and VariantReport.R. * Modified VariantReport.R to make use of gsalib. The script now uses the getargs() method to provide the user with some information as to the proper way to run the script. Documentation on how to prepare output is given at http://www.broadinstitute.org/gsa/wiki/index.php/VariantEval . * Added 'gsalib' target to build.xml file. Running "ant gsalib" will compile this module and place the R-ready package in R/gsalib . git-svn-id: file:///humgen/gsa-scr1/gsa-engineering/svn_contents/trunk@4416 348d0f76-0448-11de-a6fe-93d51630548a
2010-10-04 08:27:59 +08:00
}
\arguments{
\item{a}{
size of 'a' circle
}
\item{b}{
size of 'b' circle
}
\item{c}{
size of 'c' circle
}
\item{a_and_b}{
size of a and b overlap
}
\item{a_and_c}{
size of a and c overlap
}
\item{b_and_c}{
size of b and c overlap
}
\item{col}{
vector of colors for each venn piece
}
\item{pos}{
vector of positional elements
}
\item{debug}{
if 1, set debug mode and print useful information
}
}
\details{
Plots a two-way or three-way proportional Venn diagram. Internally, this method uses the Google Chart API to generate the diagram, then renders it into the plot window where it can be annotated in interesting ways.
}
\value{
%% ~Describe the value returned
%% If it is a LIST, use
%% \item{comp1 }{Description of 'comp1'}
%% \item{comp2 }{Description of 'comp2'}
%% ...
}
\references{
}
\author{
Kiran Garimella
}
\note{
%% ~~further notes~~
}
%% ~Make other sections like Warning with \section{Warning }{....} ~
\seealso{
%% ~~objects to See Also as \code{\link{help}}, ~~~
}
\examples{
## Plot a two-way Venn diagram
gsa.plot.venn(1000, 750, 0, 400);
* Added an R package, "gsalib", providing a place to store common, useful, documented R methods. To use this module, you must follow three steps: 1) Build the module with the following command: $ ant gsalib 2) Add the module path to your ~/.Rprofile file: .libPaths("/path/to/Sting/trunk/R/") 3) At the top of each R script that will use the library, include the line: library(gsalib) You can now use the package like any other R package. To get high-level documentation, supply the following command to R: help(gsalib) The methods contained herein are: getargs : A method to easily provide arguments to interactive and non-interactive scripts. Prints out a help message specifying how the script should be run if no arguments or "-h" is provided. Very helpful when you're writing an R-script piecemeal in interactive mode, then want to make it a command-line program. plot.venn : Plots a two-way or three-way proportional Venn diagram. read.eval : Reads VariantEval output that's formatted in R style. read.gatkreport : Reads GATKReport output. gsa.message : Emits a message with the prefix "[gsalib]" to stdout. gsa.warn : Emits a warning message with the prefix "[gsalib] Warning:" to stdout. gsa.error : Emits an error message with the prefix "[gsalib] Error: to stdout, calls traceback() and halts execution. Documentation on each of these methods can be obtained by typing "help(method_name)" at the R prompt. * Retired GATKReport.R, as that functionality has now been moved to gsalib. * Retired gsacommons, as that functionality has been split between gsalib and VariantReport.R. * Modified VariantReport.R to make use of gsalib. The script now uses the getargs() method to provide the user with some information as to the proper way to run the script. Documentation on how to prepare output is given at http://www.broadinstitute.org/gsa/wiki/index.php/VariantEval . * Added 'gsalib' target to build.xml file. Running "ant gsalib" will compile this module and place the R-ready package in R/gsalib . git-svn-id: file:///humgen/gsa-scr1/gsa-engineering/svn_contents/trunk@4416 348d0f76-0448-11de-a6fe-93d51630548a
2010-10-04 08:27:59 +08:00
## Plot a three-way Venn diagram
gsa.plot.venn(1000, 750, 900, 400, 650, 500);
* Added an R package, "gsalib", providing a place to store common, useful, documented R methods. To use this module, you must follow three steps: 1) Build the module with the following command: $ ant gsalib 2) Add the module path to your ~/.Rprofile file: .libPaths("/path/to/Sting/trunk/R/") 3) At the top of each R script that will use the library, include the line: library(gsalib) You can now use the package like any other R package. To get high-level documentation, supply the following command to R: help(gsalib) The methods contained herein are: getargs : A method to easily provide arguments to interactive and non-interactive scripts. Prints out a help message specifying how the script should be run if no arguments or "-h" is provided. Very helpful when you're writing an R-script piecemeal in interactive mode, then want to make it a command-line program. plot.venn : Plots a two-way or three-way proportional Venn diagram. read.eval : Reads VariantEval output that's formatted in R style. read.gatkreport : Reads GATKReport output. gsa.message : Emits a message with the prefix "[gsalib]" to stdout. gsa.warn : Emits a warning message with the prefix "[gsalib] Warning:" to stdout. gsa.error : Emits an error message with the prefix "[gsalib] Error: to stdout, calls traceback() and halts execution. Documentation on each of these methods can be obtained by typing "help(method_name)" at the R prompt. * Retired GATKReport.R, as that functionality has now been moved to gsalib. * Retired gsacommons, as that functionality has been split between gsalib and VariantReport.R. * Modified VariantReport.R to make use of gsalib. The script now uses the getargs() method to provide the user with some information as to the proper way to run the script. Documentation on how to prepare output is given at http://www.broadinstitute.org/gsa/wiki/index.php/VariantEval . * Added 'gsalib' target to build.xml file. Running "ant gsalib" will compile this module and place the R-ready package in R/gsalib . git-svn-id: file:///humgen/gsa-scr1/gsa-engineering/svn_contents/trunk@4416 348d0f76-0448-11de-a6fe-93d51630548a
2010-10-04 08:27:59 +08:00
}
% Add one or more standard keywords, see file 'KEYWORDS' in the
% R documentation directory.
\keyword{ ~kwd1 }
\keyword{ ~kwd2 }% __ONLY ONE__ keyword per line