splatPopSimulateMeans: splatPopSimulateMeans

Description Usage Arguments Details Value See Also Examples

View source: R/splatPop-simulate.R

Description

Simulate mean expression levels for all genes for all samples, with between sample correlation structure simulated with eQTL effects and with the option to simulate multiple groups (i.e. cell-types).

Usage

1
2
3
4
5
6
7
8
splatPopSimulateMeans(
  vcf = mockVCF(),
  params = newSplatPopParams(nGenes = 1000),
  verbose = TRUE,
  key = NULL,
  gff = NULL,
  ...
)

Arguments

vcf

VariantAnnotation object containing genotypes of samples.

params

SplatPopParams object containing parameters for population scale simulations. See SplatPopParams for details.

verbose

logical. Whether to print progress messages.

key

Either FALSE or a data.frame object containing a full or partial splatPop key.

gff

Either NULL or a data.frame object containing a GFF/GTF file.

...

any additional parameter settings to override what is provided in params.

Details

SplatPopParams can be set in a variety of ways. 1. If not provided, default parameters are used. 2. Default parameters can be overridden by supplying desired parameters using setParams. 3. Parameters can be estimated from real data of your choice using splatPopEstimate.

'splatPopSimulateMeans' involves the following steps:

  1. Load population key or generate random or GFF/GTF based key.

  2. Format and subset genotype data from the VCF file.

  3. If not in key, assign expression mean and variance to each gene.

  4. If not in key, assign eGenes-eSNPs pairs and effect sizes.

  5. If not in key and groups >1, assign subset of eQTL associations as group-specific and assign DEG group effects.

  6. Simulate mean gene expression matrix without eQTL effects

  7. Quantile normalize by sample to fit single-cell expression distribution as defined in 'splatEstimate'.

  8. Add quantile normalized gene mean and cv info the eQTL key.

  9. Add eQTL effects to means matrix.

Value

A list containing: 'means' a matrix (or list of matrices if n.groups > 1) with the simulated mean gene expression value for each gene (row) and each sample (column) and 'key' a data.frame with population information including eQTL and group effects.

See Also

splatPopParseVCF, splatPopParseGenes, splatPopAssignMeans, splatPopQuantNorm, splatPopQuantNormKey splatPopeQTLEffects, splatPopGroupEffects, splatPopSimMeans, splatPopSimEffects,

Examples

1
2
3
4
if (requireNamespace("VariantAnnotation", quietly = TRUE) &&
    requireNamespace("preprocessCore", quietly = TRUE)) {
    means <- splatPopSimulateMeans()
}

splatter documentation built on Dec. 3, 2020, 2:01 a.m.