an interactive explorer for single-cell transcriptomics data
This repo contains a fork of CZ CELLxGENE Annotate called CZ CELLxGENE Explorer which is deployed as part of CZ CELLxGENE Discover to enable exploration of datasets published on that platform.
CZ CELLxGENE Explorer (pronounced "cell-by-gene") is an interactive data explorer for single-cell transcriptomics 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 Explorer helps you gain insight into your single-cell data.
- Interactive Exploration: Provides intuitive navigation of 2D matrices with dimensions, allowing users to explore datasets.
- Data Visualization: Offers clear, intuitive visual representations of datasets and related artifacts.
- Spatial Mode with Deep Zoom: Enables seamless zooming in and out of high-resolution images & spatial data (e.g., Slide-seq V2, Visium) to examine fine details.
- Gating/Selection: Allows users to sub-select data and integrate multiple selections.
- Dynamic: Users can create their own gene sets to investigate.
- Analytics: Provides on-demand, interactive analytical tools such as differential expression analysis (gene/var t-tests).
The CZ CELLxGENE documentation is your one-stop-shop for information about CELLxGENE!
CZ CELLxGENE Explorer 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.
We'd love to hear from you!
For questions, suggestions, or accolades, join the #cellxgene-users
channel on the CZI Science Community Slack and say "hi!".
For any errors, report bugs on Github.
Please see our contributing guide and don't hesitate to open an issue or send a pull request to improve CZ CELLxGENE Explorer.
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.
- Set Up Local Dev Environment
- Design Principles
- How to write Tests
- Pull Request Suggestions
- ...and more
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 CZ CELLxGENE Explorer, we encourage you to reach out to us with ideas or questions. It might be possible that an extension could be added directly to the Explorer repo, 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.
If you believe you have found a security issue, we would appreciate notification. Please send email to security@chanzuckerberg.com.
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