Creates an unfiltered connectomic edgelist from a Seurat 3.0 object. Allows orphan ligand and receptors and fully non-expressed pairs.

CreateConnectome(
  object,
  LR.database = "fantom5",
  species = NULL,
  include.putative = T,
  include.rejected = F,
  p.values = T,
  max.cells.per.ident = NULL,
  min.cells.per.ident = NULL,
  weight.definition.norm = "product",
  weight.definition.scale = "mean",
  custom.list = NULL,
  calculate.DOR = F,
  assay = "RNA",
  ...
)

Arguments

object

A Seurat object

LR.database

Accepts either 'fantom5' or 'custom'. If custom, a dataframe must be provided to argument custom.list with the first column equal to ligands, second column equal to associated receptors, and third column equal to desired modal categorizations.

species

The species of the object that is being processed. Only required if LR.database = 'fantom5', and allows 'human','mouse','rat', or 'pig'

include.putative

Default TRUE. Includes ligand-receptor pairs deemed putative in FANTOM5 database.

include.rejected

Default FALSE. If TRUE, includes gene pairs labeled "EXCLUDED" in FANTOM5 database. See ncomms8866 .rda file for qualifications for exclusion.

p.values

Default TRUE. Runs a Wilcoxon Rank test to calculate adjusted p-value for ligand and receptor expression within the input object. Change to FALSE for decreased run-time.

max.cells.per.ident

Default NULL. If a value is input, input object will be downsampled to requested number of cells per identity. This can greatly improve run-time.

min.cells.per.ident

Default NULL. If a value is input, only cell populations meeting this threshold will be included in network analysis. Can limit high-variation effects from small clusters.

weight.definition.norm

Method of edgeweight definition from normalized data slot. Either 'sum','mean',or 'product'. Defaults to 'product'. 'Sum' adds values from sending and receiving clusters, 'mean' averages them, and 'product' multiplies them.

weight.definition.scale

Method of edgeweight definition from scaled data slot. Either 'sum','mean',or 'product'. Defaults to 'mean'. 'Sum' adds values from sending and receiving clusters, 'mean' averages them, and 'product' multiplies them.

custom.list

Optional. A dataframe for custom mapping, with the first column equal to ligands, second column equal to associated receptors, and third column equal to desired modal categorizations. If modal categorizations are unknown, fill with 'UNCAT' or similar placeholder.

calculate.DOR

Whether to include log normalized Diagnostic Odds Ratio in the output. Default FALSE.

assay

Which assay to employ to create connectomic mapping. Default = 'RNA', also accepts 'SCT' and others