mirror of
https://github.com/chanzuckerberg/cellxgene.git
synced 2026-09-19 19:08:11 +08:00
95 lines
4.9 KiB
Markdown
95 lines
4.9 KiB
Markdown
---
|
|
layout: default
|
|
title: FAQ
|
|
description: Frequently Asked Questions
|
|
---
|
|
|
|
# Data formatting
|
|
|
|
#### What file formats can I use with _cellxgene_?
|
|
|
|
Currently, you can go straight into `cellxgene launch` with your own analyzed data in h5ad format, after you have performed dimenstionality reduction (tsne, umap) and clustering (louvain).
|
|
|
|
If your data is in a different format, and/or you still need to perform dimensionality reduction and clustering, `cellxgene` can do that for you with the `prepare` command. `cellxgene prepare` runs `scanpy` under the hood and can read in any format that is currently supported by `scanpy` (including mtx, loom, and more listed [here](https://scanpy.readthedocs.io/en/latest/api/index.html#reading)).
|
|
|
|
The output of `cellxgene prepare` is a h5ad file with your computed clusters and tsne/umap projections that can be used in `cellxgene launch`.
|
|
|
|
#### I have a directory of 10X-Genomics data with _mtx_ files and I've never used _scanpy_, can I use _cellxgene_?
|
|
|
|
Yep! This should only take a couple steps. We'll assume your data is in a folder called `data/` and you've successfully installed `cellxgene` with the `louvain` packages as described above. Just run
|
|
|
|
```
|
|
cellxgene prepare data/ --output=data-processed.h5ad --layout=umap
|
|
```
|
|
|
|
Depending on the size of the dataset, this may take some time. Once it's done, call
|
|
|
|
```
|
|
cellxgene launch data-processed.h5ad --layout=umap --open
|
|
```
|
|
|
|
And your web browser should open with an interactive view of your data.
|
|
|
|
#### I have extra metadata that I want to add to my dataset
|
|
|
|
Currently this is not supported directly, but you should be able to do this yourself using `scanpy`. For example, this [notebook](https://github.com/falexwolf/fun-analyses/blob/master/tabula_muris/tabula_muris.ipynb) shows adding the contents of a `csv` file with metadata to an `anndata` object. For now, you could do this manually on your data in the same way and then save out the result before loading into `cellxgene`.
|
|
|
|
#### What part of the _anndata_ objects does cellxgene pull in for visualization?
|
|
|
|
- `.obs` and `.var` annotations are use to extract metadata for filtering
|
|
- `.X` is used to display expression (histograms, scatterplot & colorscale) and to compute differential expression
|
|
- `.obsm` is used for layout
|
|
|
|
# Algorithms
|
|
|
|
#### How are you computing and sorting differential expression results?
|
|
|
|
We use a [Welch's _t_-test](https://en.wikipedia.org/wiki/Welch%27s_t-test) implementation including the same variance overestimation correction as used in `scanpy`. We sort the `tscore` to identify the top N genes, and then filter to remove any that fall below a cutoff log fold change value, which can help remove spurious test results. The default threshold is `0.01` and can be changed using the option `--diffexp-lfc-cutoff`.
|
|
|
|
# Problems, errors, & bugs
|
|
|
|
#### How do I create a Python 3.6 environment for _cellxgene_?
|
|
|
|
If you use conda and want to create a [conda environment](https://conda.io/docs/user-guide/tasks/manage-environments.html) for _cellxgene_ you can use the following commands
|
|
|
|
```
|
|
conda create --yes -n cellxgene python=3.6
|
|
conda activate cellxgene
|
|
pip install cellxgene
|
|
```
|
|
|
|
Or you can create a virtual environment by using
|
|
|
|
```
|
|
ENV_NAME=cellxgene
|
|
python3.6 -m venv ${ENV_NAME}
|
|
source ${ENV_NAME}/bin/activate
|
|
pip install cellxgene
|
|
```
|
|
|
|
#### In my _prepare_ command I received the following error `Warning: louvain module is not installed, no clusters will be calculated. To fix this please install cellxgene with the optional feature louvain enabled`
|
|
|
|
Louvain clustering requires additional dependencies, so we don't include them by default. For now, you need to specify that you want these packages by using
|
|
|
|
```
|
|
pip install cellxgene[louvain]
|
|
```
|
|
|
|
#### I ran _prepare_ and I'm getting results that look unexpected
|
|
|
|
You might want to try running one of the preprocessing recipes included with `scanpy` (read more about them [here](https://scanpy.readthedocs.io/en/latest/api/index.html#recipes)). You can specify this with the `--recipe` option, such as
|
|
|
|
```
|
|
cellxgene prepare data/ --output=data-processed.h5ad --recipe=zheng17
|
|
```
|
|
|
|
It should be easy to run `prepare` then call `cellxgene launch` a few times with different settings to explore different behaviors. We may explore adding other preprocessing options in the future.
|
|
|
|
#### I tried to `pip install cellxgene` and got a weird error I don't understand
|
|
|
|
This may happen, especially as we work out bugs in our installation process! Please create a new [Github issue](https://github.com/chanzuckerberg/cellxgene/issues), explain what you did, and include all the error messages you saw. It'd also be super helpful if you call `pip freeze` and include the full output alongside your issue.
|
|
|
|
#### I'm following the developer instructions and get an error about "missing files and directories” when trying to build the client
|
|
|
|
This is likely because you do not have node and npm installed, we recommend using [nvm](https://github.com/creationix/nvm) if you're new to using these tools.
|