diff --git a/articles/manipulation.html b/articles/manipulation.html index 91a4015..ce78e3e 100644 --- a/articles/manipulation.html +++ b/articles/manipulation.html @@ -89,7 +89,7 @@
vignettes/articles/manipulation.Rmd
manipulation.Rmd
vignettes/miaTime.Rmd
miaTime.Rmd
vignettes/articles/minimalgut.Rmd
minimalgut.Rmd
Calculates sample dissimilarity between the given baseline and other
time points, optionally within a group (subject, reaction chamber, or
-similar). The corresponding time difference is returned as well.
-The method operates on SummarizedExperiment
objects, and the results
-are stored in colData
.
optional arguments passed into +
Optional arguments passed into
mia::addDivergence()
.
Character scalar
. Specifies the name of the
-time series field in colData
.
Character scalar
. Specifies a name of the column from
+colData
that identifies the sampling time points for the samples.
Character vector
. Specifies the baseline
-sample(s) to be used. If the group
argument is given, this must be a
-named vector
; one element per group.
Character scalar
. Specifies a name of the column from
+colData
that identifies the baseline samples to be used.
+(Default: NULL
)
Character scalar
. Specifies the grouping
-factor (name of a colData
field). If given, the divergence is calculated
-per group. e.g. subject, chamber, group etc. (Default: NULL
)
Character scalar
. Specifies a name of the column from
+colData
that identifies the grouping of the samples.
+(Default: NULL
)
Character scalar
. Used to calculate the distance.
+
Character scalar
. Used to calculate the dissimilarity
Method is passed to the function that is specified by dis.fun
.
(Default: "bray"
)
Character scalar
. Shows beta diversity between
-samples. (Default: "time_divergence"
)
Character scalar
. Specifies a column name for storing
+divergence results. (Default: "divergence"
)
Character scalar
. Field name for adding the
-time difference between samples used to calculate beta diversity.
-(Default: "time_difference"
)
Character scalar
. Specifies a column name for storing
+time differences. (Default: "time_diff"
)
a
-SummarizedExperiment
+
getBaselineDivergence
returns DataFrame
object
containing the sample dissimilarity and corresponding time difference between
-samples (across n time steps), within each level of the grouping factor.
addBaselineDivergence
, on the other hand, returns a
+SummarizedExperiment
+object with these results in its colData
.
The group argument allows calculating divergence per group. Otherwise, this -is done across all samples at once.
-The baseline sample/s always need to belong to the data object i.e. they +
The group argument allows calculating divergence per group. If given, the +divergence is calculated per group. e.g. subject, chamber, group etc. +Otherwise, this is done across all samples at once.
+The baseline sample(s) always need to belong to the data object i.e. they can be merged into it before applying this function. The reason is that they need to have comparable sample data, at least some time point @@ -170,6 +165,10 @@
Calculates sample dissimilarity between consecutive time points (t, t+i),
-within a group (subject, reaction chamber, or similar). The corresponding
-time difference is returned as well. The method operates on
-SummarizedExperiment
objects, and the results are stored in colData
.
Calculates sample dissimilarity between consecutive time points along with +time difference.
optional arguments passed into +
Optional arguments passed into
mia::addDivergence()
.
Character scalar
. Specifies the name of the
-time series field in colData
.
Character scalar
. Specifies a name of the column from
+colData
that identifies the sampling time points for the samples.
Integer scalar
. Indicates the increment between
-time steps. If you need to take every second, every third, or so, time step
-only, then increase this accordingly. (Default: 1L
)
1L
)
Character scalar
. Specifies the grouping
-factor (name of a colData
field). If given, the divergence is calculated
-per group. e.g. subject, chamber, group etc. (Default: NULL
)
Character scalar
. Specifies a name of the column from
+colData
that identifies the grouping of the samples.
+(Default: NULL
)
Character scalar
. Used to calculate the distance.
+
Character scalar
. Used to calculate the dissimilarity
Method is passed to the function that is specified by dis.fun
.
(Default: "bray"
)
Character scalar
. Shows beta diversity between
-samples. (Default: "time_divergence"
)
Character scalar
. Specifies a column name for storing
+divergence results. (Default: "divergence"
)
Character scalar
. Field name for adding the
-time difference between samples used to calculate beta diversity.
-(Default: "time_difference"
)
Character scalar
. Specifies a column name for storing
+time differences. (Default: "time_diff"
)
a
-SummarizedExperiment
+
getStepwiseDivergence
returns DataFrame
object
containing the sample dissimilarity and corresponding time difference between
-samples (across n time steps), within each level of the grouping factor.
addStepwiseDivergence
, on the other hand, returns a
+SummarizedExperiment
+object with these results in its colData
.
+ These functions calculate time-wise divergence, meaning each sample is
+compared to the previous i-th sample, where i is the specified time
+interval (see time.interval
). By default, the function calculates
+divergence by comparing all samples with each other. However, it is often
+more meaningful to calculate divergence within a specific patient or group
+(see the group
parameter).