\name{ReporterIons-class} \Rdversion{1.1} \docType{class} \alias{ReporterIons-class} \alias{class:ReporterIons} \alias{ReporterIons} \alias{show,ReporterIons-method} \alias{[,ReporterIons-method} \alias{length-method} \alias{length,ReporterIons-method} \alias{mz-method} \alias{mz,ReporterIons-method} \alias{reporterColours-method} \alias{reporterColours,ReporterIons-method} \alias{reporterColours} \alias{reporterColors-method} \alias{reporterColors,ReporterIons-method} \alias{reporterColors} \alias{reporterNames-method} \alias{reporterNames,ReporterIons-method} \alias{reporterNames} \alias{reporterNames<-,ReporterIons-method} \alias{reporterNames<-,ReporterIons,ANY-method} \alias{reporterNames<-,ReporterIons,character-method} \alias{reporterNames<-} \alias{width-method} \alias{width,ReporterIons-method} \alias{width} \alias{names,ReporterIons-method} \alias{description,ReporterIons-method} \title{The "ReporterIons" Class} \description{ The \code{ReporterIons} class allows to define a set of isobaric reporter ions that are used for quantification in MSMS mode, e.g. iTRAQ (isobaric tag for relative and absolute quantitation) or TMT (tandem mass tags). \code{ReporterIons} instances can them be used when quantifying \code{"\linkS4class{MSnExp}"} data of plotting the reporters peaks based on in \code{"\linkS4class{Spectrum2}"} ojects. Some reporter ions are provided with \code{MSnbase} an can be loaded with the \code{\link{data}} function. These reporter ions data sets are: \describe{ \item{\code{iTRAQ4}:}{\code{ReporterIon} object for the iTRAQ 4-plex set. Load with \code{data(iTRAQ4)}. } \item{\code{iTRAQ5}:}{\code{ReporterIon} object for the iTRAQ 4-plex set plus the isobaric tag. Load with \code{data(iTRAQ5)}. } \item{\code{TMT6}:}{\code{ReporterIon} object for the TMT 6-plex set. Load with \code{data(TMT6)}. } \item{\code{TMT7}:}{\code{ReporterIon} object for the TMT 6-plex set plus the isobaric tag. Load with \code{data(TMT6)}. } } } \section{Objects from the Class}{ Objects can be created by calls of the form \code{new("ReporterIons", ...)}. } \section{Slots}{ \describe{ \item{\code{name}:}{Object of class \code{"character"} to identify the \code{ReporterIons} instance. } \item{\code{reporterNames}:}{Object of class \code{"character"} naming each individual reporter of the \code{ReporterIons} instance. If not provided explicitely, they are names by concatenating the \code{ReporterIons} name and the respective MZ values. } \item{\code{description}:}{Object of class \code{"character"} to describe the \code{ReporterIons} instance. } \item{\code{mz}:}{Object of class \code{"numeric"} providing the MZ values of the reporter ions. } \item{\code{col}:}{Object of class \code{"character"} providing colours to highlight the reporters on plots. } \item{\code{width}:}{Object of class \code{"numeric"} indicating the width around the individual reporter ions MZ values were to search for peaks. This is dependent on the mass spectrometer's resolution and is used for peak picking when quantifying the reporters. See \code{\link{quantify}} for more details about quantification. } \item{\code{.__classVersion__}:}{Object of class \code{"Versions"} indicating the version of the \code{ReporterIons} instance. Intended for developer use and debugging. } } } \section{Extends}{ Class \code{"\linkS4class{Versioned}"}, directly. } \section{Methods}{ \describe{ \item{\code{show(object)}}{ Displays object content as text. } \item{\code{object[]}}{ Subsets one or several reporter ions of the \code{ReporterIons} object and returns a new instance of the same class. } \item{\code{length(object)}}{ Returns the number of reporter ions in the instance. } \item{\code{mz(object)}}{ Returns the expected mz values of reporter ions. } \item{\code{reporterColours(object)} or reporterColors(object)}{ Returns the colours used to highlight the reporter ions. } \item{\code{reporterNames(object)}}{ Returns the name of the individual reporter ions. If not specified or is an incorrect number of names is provided at initialisation, the names are generated automatically by concatenating the instance name and the reporter's MZ values. } \item{\code{reporterNames(object) <- value}}{ Sets the reporter names to \code{value}, which must be a character of the same length as the number of reporter ions. } \item{\code{width(object)}}{ Returns the widths in which the reporter ion peaks are expected. } \item{\code{names(object)}}{ Returns the name of the \code{ReporterIons} object. } \item{\code{description(object)}}{ Returns the description of the \code{ReporterIons} object. } } } \references{ Ross PL, Huang YN, Marchese JN, Williamson B, Parker K, Hattan S, Khainovski N, Pillai S, Dey S, Daniels S, Purkayastha S, Juhasz P, Martin S, Bartlet-Jones M, He F, Jacobson A, Pappin DJ. "Multiplexed protein quantitation in Saccharomyces cerevisiae using amine-reactive isobaric tagging reagents." \emph{Mol Cell Proteomics}, 2004 Dec;3(12):1154-69. Epub 2004 Sep 22. PubMed PMID: 15385600. Thompson A, Sch\"{a}fer J, Kuhn K, Kienle S, Schwarz J, Schmidt G, Neumann T, Johnstone R, Mohammed AK, Hamon C. "Tandem mass tags: a novel quantification strategy for comparative analysis of complex protein mixtures by MS/MS." \emph{Anal Chem.} 2003 Apr 15;75(8):1895-904. \emph{Erratum} in: \emph{Anal Chem.} 2006 Jun 15;78(12):4235. Mohammed, A Karim A [added] and \emph{Anal Chem.} 2003 Sep 15;75(18):4942. Johnstone, R [added]. PubMed PMID: 12713048. } \author{ Laurent Gatto } \examples{ ## Code used for the iTRAQ4 set ri <- new("ReporterIons", description="4-plex iTRAQ", name="iTRAQ4", reporterNames=c("iTRAQ4.114","iTRAQ4.115", "iTRAQ4.116","iTRAQ4.117"), mz=c(114.1,115.1,116.1,117.1), col=c("red","green","blue","yellow"), width=0.05) ri reporterNames(ri) ri[1:2] } \seealso{ \code{\link{TMT6}} or \code{\link{iTRAQ4}} for readily available examples. } \keyword{classes}