Cell-cell communication
The cell_communication pipeline scores immune ligand-receptor signaling and cytokine networks. It is the canonical shared engine used by Oncology.
The current implementation includes an initial CellPhoneDB/CellChat-style method-parity slice: heteromeric ligand/receptor complexes, subunit-aware expression thresholds, permutation p-values, adjusted p-values, interaction specificity scores, pathway aggregation, communication probability summaries, and incoming/outgoing sender-receiver role summaries.
Inputs
| Input | Description |
|---|---|
expression_path or expression_rows | Per-cell expression table |
metadata_path or metadata_rows | Cell metadata with cell type and optional condition |
ligand_receptor_path | Optional ligand-receptor table |
condition_column | Optional condition field for comparison |
Outputs
- ligand-receptor interaction scores
- heteromeric ligand/receptor component fields and complex-edge flags
- communication probability, specificity score, permutation p-value, and adjusted p-value
- sender/receiver network summaries
- incoming/outgoing sender-receiver role summaries
- pathway aggregation
- cytokine-specific network subset
- ligand activity scores using built-in target priors
- comparative deltas between conditions
- role deltas between compared conditions
- interpretation notes
Ligand activity inference workflow
Use the separate Ligand Activity Inference workflow when the question is not only "which cells may signal to each other?" but "which sender ligands may explain a receiver target-gene program?"
Inputs include expression, metadata, sender cell types, receiver cell type, explicit target genes or a target-gene file, and optional ligand-target priors. Outputs include ligand rankings, ligand-target matrix rows, ligand-receptor-target paths, and interpretation notes. If explicit target genes are not supplied, the pipeline can infer receiver targets from a two-condition comparison.
Reference methods
The implementation is inspired by CellPhoneDB-style ligand-receptor scoring, ligand activity prediction against ligand-target priors, and CellChat-style pathway and role summaries. It is a transparent Python research workflow, not a wrapped R/Bioconductor runtime and not causal signaling proof.