Biologically Guided Variational Inference for Interpretable Multimodal Single-Cell Integration and Discovery#
NetworkVI is a sparse deep generative model designed for the integration and interpretation of multimodal single-cell data. NetworkVI models gene-gene interactions inferred from topological associated domains and utilizes the structure of gene ontology (GO) to aggregate gene embeddings to cell embeddings, enhancing the interpretability at the gene and GO-term level. NetworkVI can be used for modality imputation, reference-to-query mapping and aids in identifying modality- and cell type-specific signatures via interpretability. NetworkVI will support researchers in interpreting cellular disease mechanisms, guiding biomarker discovery, and ultimately aiding the development of targeted therapies in large-scale single-cell multimodal atlases.
Check out the API, Tutorials, and Resources: Download and process biological prior knowledge section for further information.
Reliability guidance for interpretability outputs#
Before drawing biological conclusions from GO importance, TAD importance, or covariate attention scores, consult the Interpretability reliability guide page. It provides a near-formal decision framework covering when results are reliable, known failure modes, sensitivity to annotation incompleteness, and a quick-reference checklist.
Citation#
If you use NetworkVI, please consider citing:
Arnoldt, L., Upmeier zu Belzen, J., Herrmann, L., Nguyen, K., Theis, F.J., Wild, B. , Eils, R., “Biologically Guided Variational Inference for Interpretable Multimodal Single-Cell Integration and Mechanistic Discovery”, bioRxiv, June 2025.
Installation#
Install the latest release of
NetworkVIfrom PyPi:
pip install networkvi
Install the latest development version:
pip install git+https://github.com/LArnoldt/networkvi.git@main
Contents#
- API
- Model
- networkvi.model.NETWORKVI
NETWORKVI- Attributes table
- Methods table
- Attributes
- Methods
NETWORKVI.calculate_covariate_attention()NETWORKVI.convert_legacy_save()NETWORKVI.deregister_manager()NETWORKVI.differential_accessibility()NETWORKVI.differential_expression()NETWORKVI.get_accessibility_estimates()NETWORKVI.get_anndata_manager()NETWORKVI.get_elbo()NETWORKVI.get_from_registry()NETWORKVI.get_go_gene_importances()NETWORKVI.get_latent_representation()NETWORKVI.get_library_size_factors()NETWORKVI.get_marginal_ll()NETWORKVI.get_normalized_expression()NETWORKVI.get_perturbation_go_gene_importances()NETWORKVI.get_protein_foreground_probability()NETWORKVI.get_reconstruction_error()NETWORKVI.get_region_factors()NETWORKVI.load()NETWORKVI.load_query_data()NETWORKVI.load_registry()NETWORKVI.prepare_query_anndata()NETWORKVI.register_manager()NETWORKVI.save()NETWORKVI.setup_anndata()NETWORKVI.to_device()NETWORKVI.train()NETWORKVI.view_anndata_setup()NETWORKVI.view_setup_args()
- networkvi.model.NETWORKVI
- Layers
- networkvi.nn.GeneLayers
GeneLayers- Attributes table
- Methods table
- Attributes
- Methods
GeneLayers.add_module()GeneLayers.apply()GeneLayers.bfloat16()GeneLayers.buffers()GeneLayers.children()GeneLayers.compile()GeneLayers.cpu()GeneLayers.cuda()GeneLayers.double()GeneLayers.eval()GeneLayers.extra_repr()GeneLayers.float()GeneLayers.forward()GeneLayers.get_buffer()GeneLayers.get_extra_state()GeneLayers.get_geneobj()GeneLayers.get_parameter()GeneLayers.get_submodule()GeneLayers.half()GeneLayers.ipu()GeneLayers.load_state_dict()GeneLayers.modules()GeneLayers.mtia()GeneLayers.named_buffers()GeneLayers.named_children()GeneLayers.named_modules()GeneLayers.named_parameters()GeneLayers.parameters()GeneLayers.register_backward_hook()GeneLayers.register_buffer()GeneLayers.register_forward_hook()GeneLayers.register_forward_pre_hook()GeneLayers.register_full_backward_hook()GeneLayers.register_full_backward_pre_hook()GeneLayers.register_load_state_dict_post_hook()GeneLayers.register_load_state_dict_pre_hook()GeneLayers.register_module()GeneLayers.register_parameter()GeneLayers.register_state_dict_post_hook()GeneLayers.register_state_dict_pre_hook()GeneLayers.requires_grad_()GeneLayers.set_extra_state()GeneLayers.set_submodule()GeneLayers.share_memory()GeneLayers.state_dict()GeneLayers.to()GeneLayers.to_empty()GeneLayers.train()GeneLayers.type()GeneLayers.xpu()GeneLayers.zero_grad()
- networkvi.nn.GOLayers
GOLayers- Attributes table
- Methods table
- Attributes
- Methods
GOLayers.add_module()GOLayers.apply()GOLayers.bfloat16()GOLayers.buffers()GOLayers.children()GOLayers.compile()GOLayers.cpu()GOLayers.cuda()GOLayers.double()GOLayers.eval()GOLayers.extra_repr()GOLayers.float()GOLayers.forward()GOLayers.get_buffer()GOLayers.get_ds_terms_and_parents()GOLayers.get_extra_state()GOLayers.get_goobj_info()GOLayers.get_n_parameters()GOLayers.get_neurons_available()GOLayers.get_ordered_gos()GOLayers.get_overflow_info()GOLayers.get_parameter()GOLayers.get_parents()GOLayers.get_sizes_by_level()GOLayers.get_submodule()GOLayers.get_total_size()GOLayers.half()GOLayers.initialize_go_obj()GOLayers.ipu()GOLayers.load_state_dict()GOLayers.modules()GOLayers.mtia()GOLayers.named_buffers()GOLayers.named_children()GOLayers.named_modules()GOLayers.named_parameters()GOLayers.parameters()GOLayers.patch_bup_ontology()GOLayers.register_backward_hook()GOLayers.register_buffer()GOLayers.register_forward_hook()GOLayers.register_forward_pre_hook()GOLayers.register_full_backward_hook()GOLayers.register_full_backward_pre_hook()GOLayers.register_load_state_dict_post_hook()GOLayers.register_load_state_dict_pre_hook()GOLayers.register_module()GOLayers.register_parameter()GOLayers.register_state_dict_post_hook()GOLayers.register_state_dict_pre_hook()GOLayers.requires_grad_()GOLayers.set_ensemblids()GOLayers.set_extra_state()GOLayers.set_layersize()GOLayers.set_layersize_dynamic()GOLayers.set_submodule()GOLayers.set_topnode_and_unknown()GOLayers.share_memory()GOLayers.state_dict()GOLayers.to()GOLayers.to_empty()GOLayers.train()GOLayers.type()GOLayers.xpu()GOLayers.zero_grad()
- networkvi.nn.GeneLayers
- Model
- Tutorials
- Interpretability reliability guide
- Resources: Download and process biological prior knowledge
- Changelog
- References