Skip to main content

LIANA+: a one-stop-shop framework for cell-cell communication

Project description

LIANA+: an all-in-one cell-cell communication framework

main GitHub issues Documentation Status codecov Downloads

LIANA+ is a scalable framework that adapts and extends existing methods and knowledge to study cell-cell communication in single-cell, spatially-resolved, and multi-modal omics data. It is part of the scverse ecosystem, and relies on AnnData & MuData objects as input.

Contributions

We welcome suggestions, ideas, and contributions! Please do not hesitate to contact us, open issues, and check the contributions guide.

Vignettes

A set of extensive vignettes can be found in the LIANA+ documentation.

Decision Tree

flowchart TD
    Start[What type of data?] --> Spatial{Spatial<br/>coordinates?}
    Start --> Modal{Multi-modal?}

    %% Spatial branch
    Spatial -->|Yes| SpatialRes{Resolution?}
    SpatialRes -->|Single-cell| Inflow[Inflow Score]
    SpatialRes -->|Spot-based| SpatialType{Analysis type?}
    SpatialType -->|Bivariate| LocalQ{Local<br/>interactions?}
    LocalQ -->|Yes| Local[Local Bivariate Metrics]
    LocalQ -->|No| Global[Global Bivariate Metrics]
    SpatialType -->|Unsupervised| MISTy[Multi-view Learning]

    %% Non-spatial branch
    Spatial -->|No| Compare{Compare across<br/>samples?}
    Compare -->|Yes| Contrast{Specific<br/>contrast?}
    Contrast -->|Yes| Targeted[Differential Contrasts]
    Contrast -->|No| MOFA[MOFA+]
    Contrast -->|No| Tensor[Tensor-cell2cell]
    Tensor --> TensorExt[Extended Tutorials]
    Compare -->|No| Steady[Steady-state LR Inference]

    %% Multi-modal branch
    Modal -->|Spatial| SMA[Multi-Modal Spatial]
    Modal -->|Non-Spatial| SCMulti[Multi-Modal Single-Cell]

    %% Metabolite sub-branch
    SCMulti --> Metab[Metabolite-mediated CCC]

    %% Links (click events)
    click Inflow "https://liana-py.readthedocs.io/en/latest/notebooks/inflow_score.html"
    click Local "https://liana-py.readthedocs.io/en/latest/notebooks/bivariate.html"
    click Global "https://liana-py.readthedocs.io/en/latest/notebooks/bivariate.html"
    click MISTy "https://liana-py.readthedocs.io/en/latest/notebooks/misty.html"
    click Targeted "https://liana-py.readthedocs.io/en/latest/notebooks/targeted.html"
    click MOFA "https://liana-py.readthedocs.io/en/latest/notebooks/mofatalk.html"
    click Tensor "https://liana-py.readthedocs.io/en/latest/notebooks/liana_c2c.html"
    click TensorExt "https://ccc-protocols.readthedocs.io/en/latest/"
    click Steady "https://liana-py.readthedocs.io/en/latest/notebooks/basic_usage.html"
    click SMA "https://liana-py.readthedocs.io/en/latest/notebooks/sma.html"
    click SCMulti "https://liana-py.readthedocs.io/en/latest/notebooks/sc_multi.html"
    click Metab "https://liana-py.readthedocs.io/en/latest/notebooks/sc_multi.html#metabolite-mediated-ccc-from-transcriptomics-data"

API

For further information please check LIANA's API documentation.

Cite LIANA+:

@article {Dimitrov2024,
    author = {Dimitrov, Daniel and Sch{\"a}fer, Philipp Sven Lars and  Farr, Elias and Rodriguez-Mier, Pablo and Lobentanzer, Sebastian and Badia-i-Mompel, Pau and Dugourd, Aurelien and Tanevski, Jovan and Ramirez Flores, Ricardo Omar and Saez-Rodriguez, Julio},
    title = {LIANA+ provides an all-in-one framework for cell--cell communication inference},
    journal = {Nature Cell Biology},
    year = {2024},
    volume = {26},
    number = {9},
    pages = {1613--1622},
    DOI = {10.1038/s41556-024-01469-w},
    URL = {https://doi.org/10.1038/s41556-024-01469-w}
}
@article {Dimitrov2022,
    author = {Dimitrov, Daniel and T{\"u}rei, D{\'e}nes and Garrido-Rodriguez, Martin and Burmedi, Paul L. and Nagai, James S. and Boys, Charlotte and Ramirez Flores, Ricardo O. and Kim, Hyojin and Szalai, Bence and Costa, Ivan G. and Valdeolivas, Alberto and Dugourd, Aur{\'e}lien and Saez-Rodriguez, Julio},
    title = {Comparison of methods and resources for cell-cell communication inference from single-cell RNA-Seq data},
    journal = {Nature Communications},
    year = {2022},
    volume = {13},
    number = {1},
    pages = {3224},
    DOI = {10.1038/s41467-022-30755-0},
    URL = {https://doi.org/10.1038/s41467-022-30755-0}
}

Please also consider citing any of the methods and/or resources that were particularly relevant for your research!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

liana-1.7.3.tar.gz (32.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

liana-1.7.3-py3-none-any.whl (563.9 kB view details)

Uploaded Python 3

File details

Details for the file liana-1.7.3.tar.gz.

File metadata

  • Download URL: liana-1.7.3.tar.gz
  • Upload date:
  • Size: 32.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for liana-1.7.3.tar.gz
Algorithm Hash digest
SHA256 b729826cf97edf56beb9acf0d79a02ac2f928f7b002f1d330140020773a1171e
MD5 8bed389455132275f34a31039ea19c9a
BLAKE2b-256 c8fe7ec370ce3c7c62778ee926101893f86cff458708f1170a541dddd315a971

See more details on using hashes here.

Provenance

The following attestation bundles were made for liana-1.7.3.tar.gz:

Publisher: release.yaml on saezlab/liana-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file liana-1.7.3-py3-none-any.whl.

File metadata

  • Download URL: liana-1.7.3-py3-none-any.whl
  • Upload date:
  • Size: 563.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for liana-1.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6436192bb2858c71f903054d477fd2df3528a9c21e636d881b07716703ae1cb8
MD5 dfe4a5139b8e53adfe1da6455332e227
BLAKE2b-256 c0af8e627d77976f8fa1b75069e320cd2d566955811ca3d3535f56bc2816e50a

See more details on using hashes here.

Provenance

The following attestation bundles were made for liana-1.7.3-py3-none-any.whl:

Publisher: release.yaml on saezlab/liana-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page