Skip to main content

Web application for exploration of large scale scRNA-seq datasets

Project description

an interactive explorer for single-cell transcriptomics data

DOI PyPI PyPI - Downloads GitHub last commit Push Tests Compatibility Tests Code Coverage

cellxgene Desktop (pronounced "cell-by-gene") is an interactive data explorer for single-cell datasets, such as those coming from the Human Cell Atlas. Leveraging modern web development techniques to enable fast visualizations of at least 1 million cells, we hope to enable biologists and computational researchers to explore their data.

Whether you need to visualize one thousand cells or one million, cellxgene Desktop helps you gain insight into your single-cell data.

Getting started

The comprehensive guide to cellxgene Desktop

The cellxgene documentation is your one-stop-shop for information about cellxgene Desktop! You may be particularly interested in:

Quick start

To install cellxgene Desktop you need Python 3.6+. We recommend installing cellxgene Desktop into a conda or virtual environment.

Install the package.

pip install cellxgene

Launch cellxgene Desktop with an example anndata file

cellxgene launch https://cellxgene-example-data.czi.technology/pbmc3k.h5ad

To explore more datasets already formatted for cellxgene Desktop, check out the Demo data or see Preparing your data to learn more about formatting your own data for cellxgene Desktop.

Supported browsers

cellxgene Desktop currently supports the following browsers:

  • Google Chrome 61+
  • Edge 15+
  • Firefox 60+

Please file an issue if you would like us to add support for an unsupported browser.

Finding help

We'd love to hear from you! For questions, suggestions, or accolades, join the #cellxgene-users channel on the CZI Science Slack and say "hi!".

For any errors, report bugs on Github.

Developing with cellxgene Desktop

Contributing

We warmly welcome contributions from the community! Please see our contributing guide and don't hesitate to open an issue or send a pull request to improve cellxgene Desktop. Please see the dev_docs for pull request suggestions, unit test details, local documentation preview, and other development specifics.

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to opensource@chanzuckerberg.com.

Reuse

This project was started with the sole goal of empowering the scientific community to explore and understand their data. As such, we encourage other scientific tool builders in academia or industry to adopt the patterns, tools, and code from this project. All code is freely available for reuse under the MIT license.

Before extending cellxgene, we encourage you to reach out to us with ideas or questions. It might be possible that an extension could be directly contributed, which would make it available for a wider audience, or that it's on our roadmap and under active development.

See the cellxgene extensions section of our documentation for examples of community use and cellxgene extensions.

Security

If you believe you have found a security issue, we would appreciate notification. Please send email to security@chanzuckerberg.com.

Inspiration

We've been heavily inspired by several other related single-cell visualization projects, including the UCSC Cell Browser, Cytoscape, Xena, ASAP, GenePattern, and many others. We hope to explore collaborations where useful as this community works together on improving interactive visualization for single-cell data.

We were inspired by Mike Bostock and the crossfilter team for the design of our filtering implementation.

We have been working closely with the scanpy team to integrate with their awesome analysis tools. Special thanks to Alex Wolf, Fabian Theis, and the rest of the team for their help during development and for providing an example dataset.

We are eager to explore integrations with other computational backends such as Seurat or Bioconductor

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

cellxgene-1.1.0.tar.gz (2.9 MB view details)

Uploaded Source

File details

Details for the file cellxgene-1.1.0.tar.gz.

File metadata

  • Download URL: cellxgene-1.1.0.tar.gz
  • Upload date:
  • Size: 2.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for cellxgene-1.1.0.tar.gz
Algorithm Hash digest
SHA256 d07618bbf04e396d440e20d08713adeec88d71908cc178db7917c1454127ffd0
MD5 43be0b6e6473a51eb715c8cf0a859b5b
BLAKE2b-256 346c4382de05ba8dbb3857c425c3388da03986ccbb7893fa551996e708ef9738

See more details on using hashes here.

Provenance

Supported by

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