diff --git a/README.md b/README.md index 396fb025..25e1bf52 100644 --- a/README.md +++ b/README.md @@ -8,19 +8,19 @@ Started in the context of the Human Cell Atlas Consortium, cellxgene hopes to bo ## Features -* **Visualization at scale:** built with [WebGL](https://www.khronos.org/webgl/), [React](https://reactjs.org/) & [Redux](https://redux.js.org/) to handle visualization of at least 1 million cells. +- **Visualization at scale:** built with [WebGL](https://www.khronos.org/webgl/), [React](https://reactjs.org/) & [Redux](https://redux.js.org/) to handle visualization of at least 1 million cells. -* **Interactive exploration:** select, cross-filter, and compare subsets of your data with performant indexing and data handling. - -* **Flexible API:** the cellxgene client-server model is designed to support a range of existing analysis packages for backend computational tasks (eg scanpy), integrated with client-side visualization via a [REST API](https://restfulapi.net/). +- **Interactive exploration:** select, cross-filter, and compare subsets of your data with performant indexing and data handling. +- **Flexible API:** the cellxgene client-server model is designed to support a range of existing analysis packages for backend computational tasks (eg scanpy), integrated with client-side visualization via a [REST API](https://restfulapi.net/). ## Getting Started **Requirements** -- OS: OSX, Windows, Linux -- the developers are currently testing on OSX and Windows (via WSL using Ubuntu). It should work on other platforms but if you are using something different and need help, please let us know. + +- OS: OSX, Windows, Linux -- the developers are currently testing on OSX and Windows (via WSL using Ubuntu). It should work on other platforms but if you are using something different and need help, please let us know. - python 3.6 -- python3 tkinter +- python3 tkinter - npm - Google Chrome @@ -51,6 +51,7 @@ Started in the context of the Human Cell Atlas Consortium, cellxgene hopes to bo **Help** cellxgene --help + _For help with the scanpy engine_ cellxgene scanpy --help @@ -61,15 +62,15 @@ _For help with the scanpy engine_ To prepare your data you will need to format your data into AnnData format using scanpy and calculate PCA and nearest neighbors and save in h5ad format. -1. [Load data into scanpy](https://scanpy.readthedocs.io/en/latest/api/index.html#reading) +1. [Load data into scanpy](https://scanpy.readthedocs.io/en/latest/api/index.html#reading) - - Ensure that `obs`'s index is the cell names: `print(data.obs_names)` should show your cell indices. If it shows gene names, you may need to just call `data.transpose()`. + - Ensure that `obs`'s index is the cell names: `print(data.obs_names)` should show your cell indices. If it shows gene names, you may need to just call `data.transpose()`. -2. Calculate PCA +2. Calculate PCA sc.pp.pca(data) ## sc is scanpy.api -3. Calculate nearest neighbors (depending on layout algorithm) +3. Calculate nearest neighbors (depending on layout algorithm) ``` # For umap layout algorithm, you need to use the "umap" method for neighbors @@ -79,7 +80,7 @@ To prepare your data you will need to format your data into AnnData format using sc.pp.neighbors(data, method="gauss", metric="euclidean", use_rep="X_pca") ``` -4. Save file +4. Save file ``` # cellxgene requires file to be named data.h5ad @@ -87,15 +88,24 @@ To prepare your data you will need to format your data into AnnData format using ``` ## Contributing + We warmly welcome contributions from the community. Please submit any bug reports and feature requests through github issues. Please submit any direct contributions via a branch + pull request. ## Inspiration and collaboration + We’ve been inspired by several other related efforts in this space, including the [UCSC Cell Browswer](http://cells.ucsc.edu/), [Cytoscape](http://www.cytoscape.org/), [Xena](https://xena.ucsc.edu/), [ASAP](https://asap.epfl.ch/), [Gene Pattern](http://genepattern-notebook.org/), & many others; we hope to explore collaborations where useful. ## Help/Contact + Have questions, suggestions, or comments? You can contact us by joining [CZI Science Slack](https://cziscience.slack.com/messages/CCTA8DF1T) and posting in the #cellxgene channel. Please submit any feature requests or bugs as an issue in github. We'd love to hear from you! ## Reuse + This project was started with the sole goal of empowering the scientific community to explore and understand their data. As such, we whole-heartedly encourage other scientific tool builders to adopt the patterns, tools, and code from this project, and reach out to us with ideas or questions using Github Issues or Pull Requests. All code is freely available for reuse under the [MIT license](https://opensource.org/licenses/MIT). -*We thank Alex Wolf for the demo dataset.* +## Acknowledgements + +cellxgene is inspired by many innovative projects. We would like to specifically thank: + +- Alex Wolf for the demo dataset. +- Mike Bostock and the [crossfilter](https://github.com/crossfilter) team for API inspiration.