Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,95 @@
+---
+library_name: popV
+license: cc-by-4.0
+tags:
+- biology
+- genomics
+- single-cell
+- anndata_version:0.11.1
+- popV
+- 'tissue: Bone_Marrow'
+---
+
+Popular Vote (popV) model for automated cell type annotation of single-cell RNA-seq data. We provide here pretrained models
+for plug-in use in your own analysis.
+Follow our [tutorial](https://github.com/YosefLab/popV/blob/main/tabula_sapiens_tutorial.ipynb) to learn how to use the model for cell type annotation.
+
+# Model description
+
+Tabula Sapiens is a benchmark, first-draft human cell atlas of over 1.1M cells from 28 organs of 24 normal human subjects. This work is the product of the Tabula Sapiens Consortium. Taking the organs from the same individual controls for genetic background, age, environment, and epigenetic effects, and allows detailed analysis and comparison of cell types that are shared between tissues.
+
+**Link to CELLxGENE**:
+Link to the [data](https://cellxgene.cziscience.com/e/4f1555bc-4664-46c3-a606-78d34dd10d92.cxg/) in the CELLxGENE browser for interactive exploration of the data and download of the source data.
+
+**Training Code URL**:
+Not provided by uploader.
+
+# Metrics
+
+We provide here accuracies for each of the experts and the ensemble model. The validation set accuracies are
+computed on a 10% random subset of the data that was not used for training.
+
+| Cell Type | N cells |  celltypist |  knn on bbknn |  knn on harmony |  knn on scvi |  onclass |  scanvi |  svm |  xgboost | Consensus Prediction |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| neutrophil | 855 | 0.95 | 0.96 | 0.95 | 0.92 | 0.00 | 0.92 | 0.93 | 0.93 | 0.97 |
+| CD4-positive, alpha-beta T cell | 304 | 0.86 | 0.87 | 0.86 | 0.80 | 0.00 | 0.83 | 0.79 | 0.86 | 0.88 |
+| CD8-positive, alpha-beta T cell | 239 | 0.82 | 0.83 | 0.80 | 0.68 | 0.00 | 0.78 | 0.72 | 0.82 | 0.83 |
+| monocyte | 208 | 0.73 | 0.75 | 0.79 | 0.74 | 0.00 | 0.71 | 0.64 | 0.72 | 0.79 |
+| B cell | 193 | 0.97 | 0.99 | 0.98 | 0.99 | 0.00 | 0.98 | 0.99 | 0.98 | 0.99 |
+| hematopoietic precursor cell | 180 | 0.80 | 0.83 | 0.79 | 0.81 | 0.00 | 0.82 | 0.83 | 0.84 | 0.87 |
+| plasma cell | 154 | 0.98 | 0.97 | 0.98 | 0.99 | 0.00 | 0.97 | 0.99 | 0.99 | 0.99 |
+| natural killer cell | 102 | 0.93 | 0.93 | 0.91 | 0.82 | 0.00 | 0.87 | 0.92 | 0.91 | 0.94 |
+| erythroid progenitor cell | 108 | 0.73 | 0.79 | 0.77 | 0.76 | 0.00 | 0.75 | 0.79 | 0.86 | 0.86 |
+| hematopoietic stem cell | 81 | 0.78 | 0.83 | 0.84 | 0.84 | 0.00 | 0.91 | 0.86 | 0.89 | 0.87 |
+| granulocyte | 74 | 0.69 | 0.40 | 0.57 | 0.41 | 0.00 | 0.50 | 0.63 | 0.61 | 0.80 |
+| erythrocyte | 45 | 0.61 | 0.62 | 0.68 | 0.67 | 0.00 | 0.59 | 0.78 | 0.82 | 0.77 |
+| common myeloid progenitor | 45 | 0.76 | 0.72 | 0.71 | 0.57 | 0.00 | 0.67 | 0.74 | 0.81 | 0.76 |
+| macrophage | 31 | 0.59 | 0.39 | 0.52 | 0.42 | 0.00 | 0.49 | 0.61 | 0.67 | 0.69 |
+| classical monocyte | 25 | 0.00 | 0.00 | 0.00 | 0.06 | 0.00 | 0.12 | 0.14 | 0.16 | 0.00 |
+| intermediate monocyte | 25 | 0.42 | 0.47 | 0.33 | 0.27 | 0.00 | 0.39 | 0.39 | 0.38 | 0.49 |
+| myeloid dendritic cell | 10 | 0.62 | 0.27 | 0.50 | 0.47 | 0.00 | 0.34 | 0.48 | 0.80 | 0.64 |
+| T cell | 11 | 0.48 | 0.00 | 0.31 | 0.13 | 0.00 | 0.41 | 0.53 | 0.62 | 0.56 |
+| mature NK T cell | 7 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.50 | 0.36 | 0.20 | 0.22 |
+| non-classical monocyte | 9 | 0.00 | 0.00 | 0.33 | 0.00 | 0.00 | 0.11 | 0.27 | 0.13 | 0.20 |
+| basophil | 1 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.11 | 0.00 | 0.00 | 0.00 |
+| regulatory T cell | 0 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 |
+| fibroblast | 1 | 0.00 | 0.00 | 0.00 | 1.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 |
+| plasmacytoid dendritic cell | 4 | 0.00 | 0.00 | 0.40 | 0.40 | 0.00 | 0.80 | 0.00 | 0.40 | 0.00 |
+| endothelial cell | 0 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 |
+
+The train accuracies are computed on the training data.
+
+| Cell Type | N cells |  celltypist |  knn on bbknn |  knn on harmony |  knn on scvi |  onclass |  scanvi |  svm |  xgboost | Consensus Prediction |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| neutrophil | 7822 | 0.95 | 0.95 | 0.97 | 0.97 | 0.00 | 0.96 | 0.94 | 0.95 | 0.98 |
+| CD4-positive, alpha-beta T cell | 2869 | 0.84 | 0.85 | 0.87 | 0.85 | 0.00 | 0.83 | 0.85 | 0.87 | 0.88 |
+| CD8-positive, alpha-beta T cell | 2397 | 0.80 | 0.81 | 0.86 | 0.79 | 0.00 | 0.80 | 0.80 | 0.85 | 0.86 |
+| monocyte | 1832 | 0.74 | 0.78 | 0.84 | 0.82 | 0.00 | 0.76 | 0.79 | 0.85 | 0.88 |
+| B cell | 1626 | 0.98 | 0.99 | 0.99 | 0.99 | 0.00 | 0.99 | 0.99 | 0.99 | 0.99 |
+| hematopoietic precursor cell | 1540 | 0.80 | 0.83 | 0.88 | 0.87 | 0.00 | 0.86 | 0.86 | 0.88 | 0.91 |
+| plasma cell | 1294 | 0.99 | 0.98 | 0.99 | 0.99 | 0.00 | 0.98 | 1.00 | 0.99 | 0.99 |
+| natural killer cell | 997 | 0.92 | 0.91 | 0.94 | 0.87 | 0.00 | 0.89 | 0.94 | 0.95 | 0.97 |
+| erythroid progenitor cell | 863 | 0.71 | 0.74 | 0.78 | 0.84 | 0.00 | 0.86 | 0.90 | 0.94 | 0.94 |
+| hematopoietic stem cell | 711 | 0.78 | 0.82 | 0.87 | 0.87 | 0.00 | 0.88 | 0.93 | 0.94 | 0.92 |
+| granulocyte | 561 | 0.62 | 0.25 | 0.75 | 0.66 | 0.00 | 0.65 | 0.64 | 0.64 | 0.83 |
+| erythrocyte | 408 | 0.65 | 0.67 | 0.78 | 0.83 | 0.00 | 0.91 | 0.94 | 0.95 | 0.92 |
+| common myeloid progenitor | 408 | 0.68 | 0.64 | 0.70 | 0.80 | 0.00 | 0.81 | 0.90 | 0.93 | 0.92 |
+| macrophage | 327 | 0.60 | 0.47 | 0.70 | 0.69 | 0.00 | 0.85 | 0.88 | 0.90 | 0.93 |
+| classical monocyte | 206 | 0.06 | 0.02 | 0.27 | 0.42 | 0.00 | 0.61 | 0.70 | 0.75 | 0.75 |
+| intermediate monocyte | 199 | 0.46 | 0.30 | 0.61 | 0.55 | 0.00 | 0.75 | 0.85 | 0.93 | 0.84 |
+| myeloid dendritic cell | 98 | 0.57 | 0.43 | 0.72 | 0.68 | 0.00 | 0.63 | 0.73 | 0.86 | 0.89 |
+| T cell | 87 | 0.35 | 0.00 | 0.33 | 0.34 | 0.00 | 0.42 | 0.63 | 0.63 | 0.63 |
+| mature NK T cell | 57 | 0.00 | 0.03 | 0.29 | 0.12 | 0.00 | 0.53 | 0.93 | 0.93 | 0.92 |
+| non-classical monocyte | 44 | 0.00 | 0.12 | 0.29 | 0.22 | 0.00 | 0.60 | 0.93 | 0.97 | 0.82 |
+| basophil | 22 | 0.00 | 0.00 | 0.60 | 0.55 | 0.00 | 0.27 | 0.81 | 0.73 | 0.81 |
+| regulatory T cell | 14 | 0.00 | 0.00 | 0.25 | 0.00 | 0.00 | 0.29 | 0.76 | 0.62 | 0.25 |
+| fibroblast | 10 | 0.00 | 0.29 | 0.60 | 0.64 | 0.00 | 0.29 | 0.91 | 0.91 | 0.91 |
+| plasmacytoid dendritic cell | 5 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.25 | 0.91 | 1.00 | 0.91 |
+| endothelial cell | 3 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.80 | 1.00 | 1.00 | 0.80 |
+
+</details>
+
+
+# References
+
+Tabula Sapiens reveals transcription factor expression, senescence effects, and sex-specific features in cell types from 28 human organs and tissues, The Tabula Sapiens Consortium; bioRxiv, doi: https://doi.org/10.1101/2024.12.03.626516