Skip to content

Commit

Permalink
Merge pull request #5631 from nomadscientist/update_ak_histories_spoc
Browse files Browse the repository at this point in the history
Update answer key histories to be archived
  • Loading branch information
nomadscientist authored Jan 14, 2025
2 parents 01a133a + 0395bb5 commit 518b172
Show file tree
Hide file tree
Showing 9 changed files with 56 additions and 16 deletions.
30 changes: 19 additions & 11 deletions topics/single-cell/tutorials/EBI-retrieval/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,13 +28,23 @@ answer_histories:
- label: "EBI SCXA retrieval tool (UseGalaxy.eu)"
history: https://singlecell.usegalaxy.eu/u/j.jakiela/h/ebi-scxa---anndata-scanpy-or-seurat-object-1
date: 2024-01-10
- label: "EBI SCXA retrieval tool (UseGalaxy.eu)-ARCHIVED"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/ebi-scxa---anndata-scanpy-or-seurat-object
date: 2024-12-10
- label: "HCA Downloader (UseGalaxy.eu)"
history: https://singlecell.usegalaxy.eu/u/j.jakiela/h/hca-downloader---example-files-1
date: 2024-09-08
- label: "HCA Downloader (UseGalaxy.eu)-ARCHIVED"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/hca-downloader---example-files
date: 2024-12-10

input_histories:
- label: "UseGalaxy.eu"
history: https://singlecell.usegalaxy.eu/u/j.jakiela/h/input-history-ebi-scxa---anndata-scanpy-or-seurat-object
- label: "UseGalaxy.eu-ARCHIVED"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/input-history-ebi-scxa---anndata-scanpy-or-seurat-object
date: 2024-12-10


requirements:
-
Expand Down Expand Up @@ -64,9 +74,7 @@ tags:

---

# Introduction

Public single cell datasets seem to accumulate by the second. Well annotated, quality datasets are slightly trickier to find, which is why projects like the [Single Cell Expression Atlas](https://www.ebi.ac.uk/gxa/sc/home) (SCXA) exist - to curate datasets for public use. Here, we will guide you through transforming data imported from the SCXA repository into the input file required for the [Filter, Plot, Explore tutorial]({% link topics/single-cell/tutorials/scrna-case_basic-pipeline/tutorial.md %}) and we will also show how to use the public atlases for your own research.
Public single cell datasets seem to accumulate by the second. Well annotated, quality datasets are slightly trickier to find, which is why projects like the [Single Cell Expression Atlas](https://www.ebi.ac.uk/gxa/sc/home) (SCXA) exist - to curate datasets for public use. Here, we will guide you through transforming data imported from the SCXA repository into the input file required for the [Filter, Plot, Explore tutorial]({% link topics/single-cell/tutorials/scrna-case_basic-pipeline/tutorial.md %}) and we will also show how to use the public atlases for your own research.

> <agenda-title></agenda-title>
>
Expand All @@ -88,7 +96,7 @@ Galaxy has a specific tool for importing data from the SCXA ({% cite Moreno2020.
> ![Arrow pointing to the website URL where you can find experiment ID.](../../images/scrna-data/exp_id.jpg "Where to find experiment ID on the EBI Single Cell Expression Atlas website.")
>
> Once you know the experiment ID, you can use EBI SCXA Data Retrieval tool in Galaxy!
>
>
{: .details}


Expand Down Expand Up @@ -298,7 +306,7 @@ Even though this tutorial was designed specifically to modify the AnnData object
> 3. Rename {% icon galaxy-pencil %} output `Seurat object`
>
> You can also choose if you want to create Seurat object, Loom or Single Cell Experiment by selecting your option in *"Choose the format of the output"*.
>
>
{: .hands_on}

## Conclusion
Expand All @@ -309,20 +317,20 @@ And you're there! You now have a usable Seurat object for analysis with Seurat t

<!---
HCA doesn't work well for other datasets for now...
https://github.com/galaxyproject/training-material/issues/4567
https://github.com/galaxyproject/training-material/issues/4567
-->

# Human Cell Atlas Matrix Downloader

Another public atlas that you can use to access the datasets is [Human Cell Atlas data portal](https://data.humancellatlas.org/). We will show you the tool in Galaxy which allows to retrieve expression matrices and metadata for any public experiment available in that repository.
Another public atlas that you can use to access the datasets is [Human Cell Atlas data portal](https://data.humancellatlas.org/). We will show you the tool in Galaxy which allows to retrieve expression matrices and metadata for any public experiment available in that repository.

To use it, simply set the project title, project label or project UUID, which can be found at the [HCA data browser](https://data.humancellatlas.org/explore/projects), and select the desired matrix format (Matrix Market or Loom).

![Image showing project UUID as a final fragment of link address, project title (self-explanatory) and project label as an entry in the box on the right side of the page.](../../images/scrna-data/HCA.jpg "Where to find project title, project label and project UUID")

For projects that have more than one organism, one needs to be specified. Otherwise, there is no need to set the species.

Let's use the suggested example of the project *Single cell transcriptome analysis of human pancreas*. If you check this project in HCA, you'll find out that it's actually its label. But it should work well if you enter the title or UUID!
Let's use the suggested example of the project *Single cell transcriptome analysis of human pancreas*. If you check this project in HCA, you'll find out that it's actually its label. But it should work well if you enter the title or UUID!

> <hands-on-title>Create AnnData object</hands-on-title>
>
Expand All @@ -334,7 +342,7 @@ Let's use the suggested example of the project *Single cell transcriptome analys
> <warning-title>Errors that you might encounter</warning-title>
> If your dataset turns red, there might be several reasons for that, for example:
> - "There are too many connected users" - please be patient and re-run the step later, as it is advised
> - "Project identifier was not found in the database" - double check the spelling, try entering project title, project label or project UUID.
> - "Project identifier was not found in the database" - double check the spelling, try entering project title, project label or project UUID.
>
{: .warning}

Expand All @@ -351,7 +359,7 @@ Let's use the suggested example of the project *Single cell transcriptome analys
>
{: .details}

If you chose **Loom** format and you need to convert your file to other datatype, you can use {% tool [SCEasy](toolshed.g2.bx.psu.edu/repos/iuc/sceasy_convert/sceasy_convert/0.0.7+galaxy1) %} (more details in the next section). If you chose **Matrix Market** format, you can then transform the output to AnnData or Seurat, as shown in the EBI SCXA example above. Below, you will find an example of transforming the output to AnnData object.
If you chose **Loom** format and you need to convert your file to other datatype, you can use {% tool [SCEasy](toolshed.g2.bx.psu.edu/repos/iuc/sceasy_convert/sceasy_convert/0.0.7+galaxy1) %} (more details in the next section). If you chose **Matrix Market** format, you can then transform the output to AnnData or Seurat, as shown in the EBI SCXA example above. Below, you will find an example of transforming the output to AnnData object.


> <hands-on-title>Create AnnData object</hands-on-title>
Expand All @@ -375,4 +383,4 @@ If you chose **Loom** format and you need to convert your file to other datatype
> - Including a dash is important to identify mitochondrial genes (eg. **MT-**)
{: .tip}

You can have a look at the [answer history](https://singlecell.usegalaxy.eu/u/j.jakiela/h/hca-downloader---example-files-1) of performing those three quick steps.
You can have a look at the [answer history](https://singlecell.usegalaxy.eu/u/j.jakiela/h/hca-downloader---example-files-1) of performing those three quick steps.
Original file line number Diff line number Diff line change
Expand Up @@ -47,10 +47,17 @@ answer_histories:
- label: "usegalaxy.eu"
history: https://usegalaxy.eu/u/camila-goclowski/h/seurattool-based-fpe
date: 2024-06-03
- label: "usegalaxy.eu - ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/tool-based-fpe
date: 2024-12-10

input_histories:
- label: "usegalaxy.eu"
history: https://usegalaxy.eu/u/camila-goclowski/h/tool-based-seurat-fpe-input-data
- label: "usegalaxy.eu-ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/tool-based-seurat-fpe-input-data
date: 2024-12-10


---

Expand All @@ -77,7 +84,7 @@ We’ll provided you with experimental data to analyse from a mouse dataset of f
## Get Data onto Galaxy
To start, let's get our dataset loaded into Galaxy.

{% include _includes/cyoa-choices.html option1="EBI Data Retrieval" option2="Importing from a history" option3="Uploading from Zenodo" default="EBI-Data-Retrieval" text="There are multiple ways in which to collect the data for this tutorial. I find it easiest to do so via the EBI Data Retrieval." %}
{% include _includes/cyoa-choices.html option1="EBI Data Retrieval" option2="Importing from a history" option3="Uploading from Zenodo" default="EBI Data Retrieval" text="There are multiple ways in which to collect the data for this tutorial. I find it easiest to do so via the EBI Data Retrieval." %}

<div class='EBI-Data-Retrieval' markdown='1'>
> <hands-on-title>EBI Data Retrieval</hands-on-title>
Expand Down Expand Up @@ -803,4 +810,3 @@ If we look at the differences between genotypes alone (so the pseudo-bulk), we c
Ultimately, there are quite a lot ways to analyse your single-cell data, both within the confines of this tutorial (the many parameters that could be changed throughout) and outside of it (batch correction, sub-clustering, cell-cycle scoring, inferred trajectories, etc.) Most analyses will still yield the same general output, though: there are fewer knockout cells in the mature T-cell population, suggesting some sort of abberant development of T-cells in the Igf2-p0 hets.
{% icon congratulations %} Congratulations! You have interpreted your plots in several important ways! You might want to consult your results with this [control history](https://singlecell.usegalaxy.eu/u/camila-goclowski/h/seurattool-based-fpe), and check out the [workflow](./workflows/) for this tutorial.
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,19 @@ answer_histories:
- label: "UseGalaxy.eu"
history: https://usegalaxy.eu/u/j.jakiela/h/combining-datasets-key-history
date: 2024-03-26
- label: "UseGalaxy.eu - ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/combining-datasets-400k-key-history
date: 2024-12-10
- label: "All total samples - processed after Alevin into single object (UseGalaxy.eu)"
history: https://usegalaxy.eu/u/j.jakiela/h/all-total-samples-processed-after-alevin-into-single-object
date: 2024-03-26

input_histories:
- label: "UseGalaxy.eu"
history: https://usegalaxy.eu/u/j.jakiela/h/combining-datasets-input
- label: "UseGalaxy.eu - ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/combining-datasets-input
date: 2024-12-10
- label: "UseGalaxy.org"
history: https://usegalaxy.org/u/juliajot/h/combining-datasets-input

Expand Down
4 changes: 4 additions & 0 deletions topics/single-cell/tutorials/scrna-case_alevin/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,13 @@ answer_histories:
- label: UseGalaxy.eu
history: https://usegalaxy.eu/u/j.jakiela/h/generating-a-single-cell-matrix-alevin
date: 2024-03-22
- label: UseGalaxy.eu - ARCHIVED
history: https://usegalaxy.eu/u/wendi.bacon.training/h/generating-a-single-cell-matrix-using-alevin
date: 2024-12-10
- label: Older Alevin version
history: https://humancellatlas.usegalaxy.eu/u/wendi.bacon.training/h/cs1pre-processing-with-alevin---answer-key
date: 2024-01-01

input_histories:
- label: UseGalaxy.eu
history: https://humancellatlas.usegalaxy.eu/u/wendi.bacon.training/h/cs1pre-processing-with-alevin---input-1
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,9 @@ answer_histories:
- label: "UseGalaxy.eu"
history: https://usegalaxy.eu/u/j.jakiela/h/filter-plot-and-explore-single-cell-rna-seq-data-updated
date: 2023-10-10
- label: "UseGalaxy.eu - ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/filter-plot-and-explore-single-cell-rna-seq-data
date: 2024-12-10
- label: "Older version"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/cs3filter-plot-and-explore-single-cell-rna-seq-data---answer-key-2
date: 2024-02-28
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,16 @@ answer_histories:
- label: "UseGalaxy.eu (includes AnnData to CDS conversion)"
history: https://humancellatlas.usegalaxy.eu/u/j.jakiela/h/monoce3-tutorial-workflow
date: 2024-03-04
- label: "UseGalaxy.eu (includes AnnData to CDS conversion)-ARCHIVED"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/monocle3-tutorial-workflow
date: 2024-12-10

input_histories:
- label: "CDS file (UseGalaxy.eu)"
history: https://usegalaxy.eu/u/j.jakiela/h/cds-input-file-for-monocle3-tutorial
- label: "CDS file (UseGalaxy.eu) - ARCHIVED"
history: https://usegalaxy.eu/u/wendi.bacon.training/h/cds-input-file-for-monocle3-tutorial
date: 2024-12-10

questions:
- How can I prepare input files for Monocle starting from an AnnData object?
Expand All @@ -40,10 +46,7 @@ requirements:
type: "internal"
topic_name: single-cell
tutorials:
- scrna-case_alevin
- scrna-case_alevin-combine-datasets
- scrna-case_basic-pipeline
- scrna-case_JUPYTER-trajectories
- scrna-data-ingest
tags:
- 10x
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ answer_histories:
- label: "UseGalaxy.eu"
history: https://humancellatlas.usegalaxy.eu/u/marisa_jl/h/inferring-trajectories-using-scanpy---example-history
date: 2023-12-14
- label: "UseGalaxy.eu-ARCHIVED"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/inferring-trajectories-using-scanpy---example-history
date: 2024-10-12

input_histories:
- label: "UseGalaxy.eu"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,12 @@ recordings:

answer_histories:
- label: "UseGalaxy.org"
history: https://usegalaxy.org/u/wendi_bacon/h/pre-processing-of-10x-single-cell-rna-datasets
date: 2024-12-10
- label: "UseGalaxy.org - unarchived"
history: https://usegalaxy.org/u/videmp/h/pre-processing-of-10x-single-cell-rna-datasets
date: 2024-10-04

---


Expand Down
3 changes: 3 additions & 0 deletions topics/single-cell/tutorials/scrna-scanpy-pbmc3k/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,9 @@ answer_histories:
- label: "Scanpy_1.10.2_Anndata_0.10.9"
history: https://singlecell.usegalaxy.eu/u/videmp/h/clustering-of-3k-pbmcs-tutorial-from-workflow-october-2024
date: 2024-10-04
- label: "UseGalaxy.eu - Archived"
history: https://singlecell.usegalaxy.eu/u/wendi.bacon.training/h/clustering-of-3k-pbmcs-tutorial-from-workflow-october-2024
date: 2024-12-10
---


Expand Down

0 comments on commit 518b172

Please sign in to comment.