diff --git a/R/methods-TxpResult-plot.R b/R/methods-TxpResult-plot.R index f195b99..4b72339 100644 --- a/R/methods-TxpResult-plot.R +++ b/R/methods-TxpResult-plot.R @@ -23,13 +23,13 @@ #' when `TRUE` #' @param ... Passed to [pieGridGrob] when plotting ToxPi and to pointsGrob #' when plotting ranks -#' @param ncol Number of columns for [ggplot2] ToxPi profiles +#' @param ncol Number of columns for ggplot2 ToxPi profiles #' @param bgColor,borderColor,sliceBorderColor,sliceValueColor,sliceLineColor -#' Various color options when creating [ggplot2] ToxPi profiles. Set to NULL +#' Various color options when creating ggplot2 ToxPi profiles. Set to NULL #' for no color -#' @param showMissing Boolean for coloring data missingness in [ggplot2] +#' @param showMissing Boolean for coloring data missingness in ggplot2 #' ToxPi profiles -#' @param showCenter Boolean for showing inner circle in [ggplot2] ToxPi +#' @param showCenter Boolean for showing inner circle in ggplot2 ToxPi #' profiles. When set to False overrides showMissing #' #' @details @@ -44,7 +44,7 @@ #' If the labels are running of the device, the top or bottom margins can be #' increased with the `margins` parameter. #' -#' ToxPi profiles can also be plotted using the [ggplot2] package. +#' ToxPi profiles can also be plotted using the ggplot2 package. #' #' @template roxgn-loadExamples #' @template roxgn-calcTxpModel diff --git a/man/TxpResult-plot.Rd b/man/TxpResult-plot.Rd index 2cdedcf..e59a600 100644 --- a/man/TxpResult-plot.Rd +++ b/man/TxpResult-plot.Rd @@ -59,15 +59,15 @@ when \code{TRUE}} \item{...}{Passed to \link{pieGridGrob} when plotting ToxPi and to pointsGrob when plotting ranks} -\item{ncol}{Number of columns for \link{ggplot2} ToxPi profiles} +\item{ncol}{Number of columns for ggplot2 ToxPi profiles} -\item{bgColor, borderColor, sliceBorderColor, sliceValueColor, sliceLineColor}{Various color options when creating \link{ggplot2} ToxPi profiles. Set to NULL +\item{bgColor, borderColor, sliceBorderColor, sliceValueColor, sliceLineColor}{Various color options when creating ggplot2 ToxPi profiles. Set to NULL for no color} -\item{showMissing}{Boolean for coloring data missingness in \link{ggplot2} +\item{showMissing}{Boolean for coloring data missingness in ggplot2 ToxPi profiles} -\item{showCenter}{Boolean for showing inner circle in \link{ggplot2} ToxPi +\item{showCenter}{Boolean for showing inner circle in ggplot2 ToxPi profiles. When set to False overrides showMissing} \item{y}{Rank vector, i.e. \code{txpRanks(x)}} @@ -96,7 +96,7 @@ edited as such. If the labels are running of the device, the top or bottom margins can be increased with the \code{margins} parameter. -ToxPi profiles can also be plotted using the \link{ggplot2} package. +ToxPi profiles can also be plotted using the ggplot2 package. } \section{Functions}{ \itemize{ diff --git a/vignettes/introduction.Rmd b/vignettes/introduction.Rmd index 06fd257..fa69a5d 100644 --- a/vignettes/introduction.Rmd +++ b/vignettes/introduction.Rmd @@ -46,7 +46,7 @@ This document introduces ToxPi and describes how to use the `toxpiR` package to ## What is ToxPi? -The Toxicological Prioritization Index (ToxPi) is a statistical modeling framework that allows transparent integration and visualization of data across disparate sources (i.e. multimodal or multiscale information). This framework aggregates related features into scored ‘slices’, rescales individual slice scores to range 0–1, and then develops an overall score for each sample using a weighted model. The slice weights can be interpreted as the "importance" of categorized features when predicting sample scores and associated ranks. The resulting scores for each sample are visualized as ToxPi profiles (see image below). Slice weights are represented as the arc-width, slice scores are represented as the radius, and the overall sample scores are represented by the combination of slice weights and radii. These visualizations allow for quick comparison of overall feature importance, feature impacts driving a specific sample, relative impact ranking of common features between samples, and overall ranking between samples. As a flexible method capable of integrating data from any source, it has been [applied](https://scholar.google.com/scholar?start=5&hl=en&as_sdt=0,34&sciodt=0,34&cites=14315759707117183281,8409987751811922970,6830405381891567320,6660731247750930378,6264826653350493071,6008919238370157052,5228323847718230279,14470107422640831138) to problems in several different fields. Additional information is linked from [toxpi.org](https://toxpi.org). +The Toxicological Prioritization Index (ToxPi) is a statistical modeling framework that allows transparent integration and visualization of data across disparate sources (i.e. multimodal or multiscale information). This framework aggregates related features into scored ‘slices’, rescales individual slice scores to range 0–1, and then develops an overall score for each sample using a weighted model. The slice weights can be interpreted as the "importance" of categorized features when predicting sample scores and associated ranks. The resulting scores for each sample are visualized as ToxPi profiles (see image below). Slice weights are represented as the arc-width, slice scores are represented as the radius, and the overall sample scores are represented by the combination of slice weights and radii. These visualizations allow for quick comparison of overall feature importance, feature impacts driving a specific sample, relative impact ranking of common features between samples, and overall ranking between samples. As a flexible method capable of integrating data from any source, it has been applied to problems in several different fields. Additional information is linked from [toxpi.org](https://toxpi.org).