|
a |
|
b/man/runUMAP.Rd |
|
|
1 |
% Generated by roxygen2: do not edit by hand |
|
|
2 |
% Please edit documentation in R/scAI_model.R |
|
|
3 |
\name{runUMAP} |
|
|
4 |
\alias{runUMAP} |
|
|
5 |
\title{Perform dimension reduction using UMAP} |
|
|
6 |
\usage{ |
|
|
7 |
runUMAP(data.use, n.neighbors = 30L, n.components = 2L, |
|
|
8 |
distance = "correlation", n.epochs = NULL, learning.rate = 1, |
|
|
9 |
min.dist = 0.3, spread = 1, set.op.mix.ratio = 1, |
|
|
10 |
local.connectivity = 1L, repulsion.strength = 1, |
|
|
11 |
negative.sample.rate = 5, a = NULL, b = NULL, seed.use = 42L, |
|
|
12 |
metric.kwds = NULL, angular.rp.forest = FALSE, verbose = TRUE) |
|
|
13 |
} |
|
|
14 |
\arguments{ |
|
|
15 |
\item{data.use}{input data} |
|
|
16 |
|
|
|
17 |
\item{n.neighbors}{This determines the number of neighboring points used in |
|
|
18 |
local approximations of manifold structure. Larger values will result in more |
|
|
19 |
global structure being preserved at the loss of detailed local structure. In general this parameter should often be in the range 5 to 50.} |
|
|
20 |
|
|
|
21 |
\item{n.components}{The dimension of the space to embed into.} |
|
|
22 |
|
|
|
23 |
\item{distance}{This determines the choice of metric used to measure distance in the input space.} |
|
|
24 |
|
|
|
25 |
\item{n.epochs}{the number of training epochs to be used in optimizing the low dimensional embedding. Larger values result in more accurate embeddings. If NULL is specified, a value will be selected based on the size of the input dataset (200 for large datasets, 500 for small).} |
|
|
26 |
|
|
|
27 |
\item{learning.rate}{The initial learning rate for the embedding optimization.} |
|
|
28 |
|
|
|
29 |
\item{min.dist}{This controls how tightly the embedding is allowed compress points together. |
|
|
30 |
Larger values ensure embedded points are moreevenly distributed, while smaller values allow the |
|
|
31 |
algorithm to optimise more accurately with regard to local structure. Sensible values are in the range 0.001 to 0.5.} |
|
|
32 |
|
|
|
33 |
\item{spread}{he effective scale of embedded points. In combination with min.dist this determines how clustered/clumped the embedded points are.} |
|
|
34 |
|
|
|
35 |
\item{set.op.mix.ratio}{Interpolate between (fuzzy) union and intersection as the set operation used to combine local fuzzy simplicial sets to obtain a global fuzzy simplicial sets.} |
|
|
36 |
|
|
|
37 |
\item{local.connectivity}{The local connectivity required - i.e. the number of nearest neighbors |
|
|
38 |
that should be assumed to be connected at a local level. The higher this value the more connected |
|
|
39 |
the manifold becomes locally. In practice this should be not more than the local intrinsic dimension of the manifold.} |
|
|
40 |
|
|
|
41 |
\item{repulsion.strength}{Weighting applied to negative samples in low dimensional embedding |
|
|
42 |
optimization. Values higher than one will result in greater weight being given to negative samples.} |
|
|
43 |
|
|
|
44 |
\item{negative.sample.rate}{The number of negative samples to select per positive sample in the |
|
|
45 |
optimization process. Increasing this value will result in greater repulsive force being applied, greater optimization cost, but slightly more accuracy.} |
|
|
46 |
|
|
|
47 |
\item{a}{More specific parameters controlling the embedding. If NULL, these values are set automatically as determined by min. dist and spread.} |
|
|
48 |
|
|
|
49 |
\item{b}{More specific parameters controlling the embedding. If NULL, these values are set automatically as determined by min. dist and spread.} |
|
|
50 |
|
|
|
51 |
\item{seed.use}{Set a random seed. By default, sets the seed to 42.} |
|
|
52 |
|
|
|
53 |
\item{metric.kwds}{A dictionary of arguments to pass on to the metric, such as the p value for Minkowski distance} |
|
|
54 |
|
|
|
55 |
\item{angular.rp.forest}{Whether to use an angular random projection forest to initialise the |
|
|
56 |
approximate nearest neighbor search. This can be faster, but is mostly on useful for metric that |
|
|
57 |
use an angular style distance such as cosine, correlation etc. In the case of those metrics angular forests will be chosen automatically.} |
|
|
58 |
|
|
|
59 |
\item{verbose}{Controls verbosity |
|
|
60 |
This function is modified from Seurat package} |
|
|
61 |
} |
|
|
62 |
\description{ |
|
|
63 |
Perform dimension reduction using UMAP |
|
|
64 |
} |