From 9c0dd19a3bc30bb188be432c4ce926a2eb992f64 Mon Sep 17 00:00:00 2001
From: ktpolanski <krzysztof_polanski@o2.pl>
Date: Tue, 7 Nov 2023 15:51:05 +0000
Subject: [PATCH] scautoqc plus logo

---
 README.md                         |   4 +-
 docs/api.rst                      |   4 +-
 docs/notebooks/automatic_qc.ipynb |  62 +++++++++++++++++-------------
 docs/notebooks/scautoqc_logo.png  | Bin 0 -> 15583 bytes
 4 files changed, 40 insertions(+), 30 deletions(-)
 create mode 100644 docs/notebooks/scautoqc_logo.png

diff --git a/README.md b/README.md
index 4d29fa5..be1219e 100644
--- a/README.md
+++ b/README.md
@@ -26,4 +26,6 @@ pip install --upgrade pip
 
 ## Usage and Documentation
 
-SCTK's documentation is available [here](https://teichlab.github.io/sctk/), and features a tutorial and API reference for the automated QC workflow.
+SCTK's documentation is available [here](https://teichlab.github.io/sctk/), and features a tutorial and API reference for scAutoQC (an automated QC workflow).
+
+<img src="https://github.com/Teichlab/sctk/tree/master/docs/notebooks/scautoqc_logo.png" alt="scautoqc_logo" width="200"/>
\ No newline at end of file
diff --git a/docs/api.rst b/docs/api.rst
index d7eb2e5..3be4e08 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -1,8 +1,8 @@
 API Reference
 =============
 
-QC pipeline
------------
+scAutoQC
+--------
 .. module:: sctk
 .. autosummary::
    :toctree: modules
diff --git a/docs/notebooks/automatic_qc.ipynb b/docs/notebooks/automatic_qc.ipynb
index f01e918..fdcb084 100644
--- a/docs/notebooks/automatic_qc.ipynb
+++ b/docs/notebooks/automatic_qc.ipynb
@@ -2,16 +2,24 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "mexican-skill",
+   "id": "previous-province",
    "metadata": {},
    "source": [
-    "# Automatic QC workflow tutorial"
+    "# scAutoQC workflow tutorial"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "peripheral-feeling",
+   "metadata": {},
+   "source": [
+    "<img src=\"scautoqc_logo.png\" alt=\"scautoqc_logo\" width=\"200\"/>"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 1,
-   "id": "hindu-treaty",
+   "id": "entitled-cargo",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -23,10 +31,10 @@
   },
   {
    "cell_type": "markdown",
-   "id": "increasing-commercial",
+   "id": "foster-exhibit",
    "metadata": {},
    "source": [
-    "This notebook will show how to apply SCTK's automatic QC workflow. The process has four steps:\n",
+    "This notebook will show how to apply SCTK's automatic QC workflow, scAutoQC. The process has four steps:\n",
     "\n",
     " - `sctk.calculate_qc()` computes QC measures\n",
     " - `sctk.generate_qc_clusters()` creates QC-space clusters of cells\n",
@@ -39,7 +47,7 @@
   {
    "cell_type": "code",
    "execution_count": 2,
-   "id": "identified-costume",
+   "id": "economic-punishment",
    "metadata": {},
    "outputs": [
     {
@@ -61,7 +69,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "electrical-fighter",
+   "id": "streaming-facial",
    "metadata": {},
    "source": [
     "This object features raw counts for some PBMC data, and nothing else for now. We can use `sctk.calculate_qc()` to automatically flag some common technical features (the defaults are human mitochondrial, ribosomal and hemoglobin genes) and subsequently use `sc.pp.calculate_qc_metrics()` to compute their percentages in each cell, along with standard measures like the number of genes and counts."
@@ -70,7 +78,7 @@
   {
    "cell_type": "code",
    "execution_count": 3,
-   "id": "responsible-valentine",
+   "id": "hybrid-riverside",
    "metadata": {},
    "outputs": [
     {
@@ -93,7 +101,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "smoking-forum",
+   "id": "natural-rebound",
    "metadata": {},
    "source": [
     "You can see the `.obs` of the object populated with the QC measures we just generated.\n",
@@ -104,7 +112,7 @@
   {
    "cell_type": "code",
    "execution_count": 4,
-   "id": "internal-tissue",
+   "id": "trained-account",
    "metadata": {},
    "outputs": [
     {
@@ -138,7 +146,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "average-proceeding",
+   "id": "driven-consumption",
    "metadata": {},
    "source": [
     "There's now an `.obs` column called `qc_cluster`, and an embedding called `X_umap_qc`. Let's take a look!"
@@ -147,7 +155,7 @@
   {
    "cell_type": "code",
    "execution_count": 5,
-   "id": "separated-domain",
+   "id": "frozen-learning",
    "metadata": {},
    "outputs": [
     {
@@ -180,16 +188,16 @@
   },
   {
    "cell_type": "markdown",
-   "id": "alpine-friend",
+   "id": "educational-riding",
    "metadata": {},
    "source": [
-    "The next step of the workflow involves determining which of the cells pass QC individually."
+    "The next step of the scAutoQC workflow involves determining which of the cells pass QC individually."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 6,
-   "id": "cutting-pressure",
+   "id": "behind-adjustment",
    "metadata": {},
    "outputs": [
     {
@@ -227,7 +235,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "dominican-thousand",
+   "id": "endless-cooperative",
    "metadata": {},
    "source": [
     "There's now a `cell_passed_qc` column in `.obs` which features per-cell QC calls."
@@ -236,7 +244,7 @@
   {
    "cell_type": "code",
    "execution_count": 7,
-   "id": "capable-gauge",
+   "id": "ceramic-attention",
    "metadata": {},
    "outputs": [
     {
@@ -256,7 +264,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "ranging-knitting",
+   "id": "enhanced-server",
    "metadata": {},
    "source": [
     "Controlling the desired QC thresholds requires a bit of explanation.\n",
@@ -292,7 +300,7 @@
   {
    "cell_type": "code",
    "execution_count": 8,
-   "id": "incredible-parks",
+   "id": "mechanical-sympathy",
    "metadata": {},
    "outputs": [
     {
@@ -323,12 +331,12 @@
   },
   {
    "cell_type": "markdown",
-   "id": "basic-johnson",
+   "id": "square-technique",
    "metadata": {},
    "source": [
     "The gene count filtering is different now, as expected.\n",
     "\n",
-    "The final step of the workflow determines computes a fraction of passing cells for each cluster. If a cluster has a high enough fraction of passing cells (controlled via the `threshold` parameter, default 0.5), it's deemed to be a good QC cluster.\n",
+    "The final step of the scAutoQC workflow determines computes a fraction of passing cells for each cluster. If a cluster has a high enough fraction of passing cells (controlled via the `threshold` parameter, default 0.5), it's deemed to be a good QC cluster.\n",
     "\n",
     "You can use your own per-cell QC calls here rather than the ones provided by `sctk.cellwise_qc()` if desired, just specify which `.obs` column to take via the `cell_qc_key` argument."
    ]
@@ -336,7 +344,7 @@
   {
    "cell_type": "code",
    "execution_count": 9,
-   "id": "lovely-webcam",
+   "id": "southern-highway",
    "metadata": {},
    "outputs": [
     {
@@ -361,7 +369,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "smoking-reaction",
+   "id": "rural-margin",
    "metadata": {},
    "source": [
     "There's now a `cluster_passed_qc` column. Let's take a look how it compares to the cell level QC."
@@ -370,7 +378,7 @@
   {
    "cell_type": "code",
    "execution_count": 10,
-   "id": "dedicated-hungarian",
+   "id": "norwegian-difficulty",
    "metadata": {},
    "outputs": [
     {
@@ -398,7 +406,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "eligible-episode",
+   "id": "economic-satisfaction",
    "metadata": {},
    "source": [
     "We seem to get a nontrivial number of cells individually flagged as poor quality colocating in the top left of the plot, but only a small subset of them remain after cluster membership is leveraged. Let's generate a new set of QC clusters by increasing the resolution parameter value, creating a higher number of smaller clusters as a result."
@@ -407,7 +415,7 @@
   {
    "cell_type": "code",
    "execution_count": 11,
-   "id": "optimum-cathedral",
+   "id": "assumed-westminster",
    "metadata": {},
    "outputs": [
     {
@@ -438,7 +446,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "pleased-superintendent",
+   "id": "expensive-check",
    "metadata": {},
    "source": [
     "The plots align better now.\n",
diff --git a/docs/notebooks/scautoqc_logo.png b/docs/notebooks/scautoqc_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..8018d6d6cbb722ed3bf751085e61688ffae3ba44
GIT binary patch
literal 15583
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

literal 0
HcmV?d00001