File: repDiversity.Rd

package info (click to toggle)
r-cran-tcr 2.3.2%2Bds-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, trixie
  • size: 2,316 kB
  • sloc: cpp: 187; makefile: 5
file content (64 lines) | stat: -rw-r--r-- 2,148 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/repdiversity.R
\name{repDiversity}
\alias{repDiversity}
\title{General function for the repertoire diversity estimation.}
\usage{
repDiversity(
  .data,
  .method = c("chao1", "gini.simp", "inv.simp", "gini", "div", "entropy"),
  .quant = c("read.count", "umi.count", "read.prop", "umi.prop"),
  .q = 5,
  .norm = F,
  .do.norm = NA,
  .laplace = 0
)
}
\arguments{
\item{.data}{Cloneset or a list of clonesets.}

\item{.method}{Which method to use for the diversity estimation. See "Details" for methods.}

\item{.quant}{Which column to use for the quantity of clonotypes: "read.count" for the "Read.count" column, 
"umi.count" for the "Umi.count" column, "read.prop" for the "Read.proportion" column, "umi.prop" for 
the "Umi.proportion" column.}

\item{.q}{q-parameter for the Diversity index.}

\item{.norm}{If T than compute the normsalised entropy.}

\item{.do.norm}{One of the three values - NA, T or F. If NA than check for distrubution (sum(.data) == 1)
and normalise it with the given laplace correction value if needed. if T then do normalisation and laplace
correction. If F than don't do normalisaton and laplace correction.}

\item{.laplace}{Value for Laplace correction.}
}
\description{
General interface to all cloneset diversity functions.
}
\details{
You can see a more detailed description for each diversity method at \link{diversity}.

Parameter \code{.method} can have one of the following value each corresponding to the specific method:

- "div" for the true diversity, or the effective number of types (basic function \code{diversity}).

- "inv.simp" for the inverse Simpson index (basic function \code{inverse.simpson}).

- "gini" for the Gini coefficient (basic function \code{gini}).

- "gini.simp" for the Gini-Simpson index (basic function \code{gini.simpson}).

- "chao1" for the Chao1 estimator (basic function \code{chao1}).

- "entropy" for the Shannon entropy measure (basic function \code{entropy}).
}
\examples{
\dontrun{
data(twb)
twb.div <- repDiversity(twb, "chao1", "read.count")
}
}
\seealso{
\link{diversity}, \link{entropy}
}