Skip to content

Commit

Permalink
Documentation/ashg23 (#123)
Browse files Browse the repository at this point in the history
* Update Session 2 and remove old workshops

* Update description
  • Loading branch information
seppinho committed Oct 31, 2023
1 parent 7223e2c commit ce70e78
Show file tree
Hide file tree
Showing 4 changed files with 24 additions and 46 deletions.
38 changes: 15 additions & 23 deletions docs/workshops/ASHG2023.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,27 @@
**Workshop ASHG2023**

# The Michigan Imputation Server
*Data Preparation, Genotype Imputation, and Data Analysis*
# Welcome to the Michigan Imputation Server Workshop!

[Workshop Website](https://www.ashg.org/meetings/2023meeting/2023-ashg-invited-workshop-schedule/)
## Workshop Title
The Michigan Imputation Server: Data Preparation, Genotype Imputation, and Data Analysis

## Topic
Statistical Genetics and Genetic Epidemiology

## Target Audience
Attendees interested in learning how to perform genotype imputation and use imputed genotypes in their research, especially trainees. There are no prerequisites for this workshop. Attendees are expected to follow materials on their personal laptops.

## Workshop Slides
You can download the slides of all workshop sessions [here](https://github.com/genepi/imputationserver-ashg22/raw/master/slides/MIS_Workshop_22.pdf). Please also have a look at the individual sessions below for additional training material.
You can download the slides of all workshop sessions [here](https://github.com/genepi/imputationserver-ashg/raw/main/slides/MIS_Workshop_2023.pdf). Please also have a look at the individual sessions below for additional training material.

## Links
- [Interactive Poll](http://pollev.com/ashg)
- [Workshop Website](https://www.ashg.org/meetings/2023meeting/2023-ashg-invited-workshop-schedule/)

## Workshop Facilitator(s)
- Christian Fuchsberger, christian.fuchsberger@eurac.edu (Eurac Research)
- Sebastian Schönherr, sebastian.schoenherr@i-med.ac.at (Medical University of Innsbruck)
- Lukas Forer, lukas.forer@i-med.ac.at (Medical University of Innsbruck)
- Xueling Sim, ephsx@nus.edu.sg (National University of Singapore)
- Saori Sakaue, ssakaue@broadinstitute.org (Broad Institute)
- Albert Smith, albertvs@umich.edu (University of Michigan)

## Workshop Description (from the program)

Genotype imputation is a key component of modern genetic association studies. The Michigan Imputation Server has thus far helped > 9,600 researchers from around the world to impute > 95 human genomes. This interactive workshop is intended for anyone interested in learning how to impute genotypes and to use the imputed genotypes, highlighting recent reference panels, including the multi-ancestry panel from the TOPMed program and a specialized HLA panel.

A brief overview of imputation and the server will be followed by demonstrations and exercises, including:

1. quality control and preparation of genetic data for use on the MIS with a special focus on diverse ancestries, chromosome X, and the HLA region;

2. tracking runs and use of the application program interface for larger jobs;

3. downloading data from the MIS and preparing data for genetic analysis;

4. performing a GWAS using imputed data and interpreting results, taking into account imputation quality;

5. using the additional features, such as the polygenic risk score calculation.

We encourage participants to ask specific questions about their own projects. Workshop materials, including slides and example data sets, will be made available before the workshop and will remain online at the MIS website. We expect that this workshop will enable participants to generate high-quality imputed data sets and to effectively analyze them.
- Albert Smith, albertvs@umich.edu (University of Michigan)
13 changes: 7 additions & 6 deletions docs/workshops/ASHG2023/Session2.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Welcome to Session 2! In this session you will learn how to submit a job on Mich
## Getting Started
As a quick start, the following video includes all required steps to submit and monitor a job using the graphical web interface.

<iframe width="560" height="315" src="https://www.youtube.com/embed/BLTPHWuMF0Q" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
<iframe width="560" height="315" src="https://www.youtube.com/embed/HMP76DpL_I0?si=GSFsFMbqJQFVUhJj" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>


## Run a job on your own
Expand All @@ -23,17 +23,18 @@ The UI includes several parameters which need to be specified. Our [Getting Star

We are providing two data datasets that can be downloaded from below. In case the unphased dataset is selected, an additional phasing step using Eagle is automatically performed. For this demo, we recommend selecting the **HapMap 2 panel** (Input parameter 'Reference panel') to get your results as quick as possible. Please also have a look at our [supported reference panels](https://imputationserver.readthedocs.io/en/latest/reference-panels/) when using MIS in a production setup.

!!! tip
You can also copy/paste the URL from below and change "File Upload" to "URLs (HTTP)" load the data from a remote server (GitHub in this case).

- [Phased dataset chr20 hg19](https://github.com/genepi/imputationserver-ashg22/raw/master/files/chr20.R50.merged.1.330k.recode.small.vcf.gz)
- [Unphased dataset chr20 hg19](https://github.com/genepi/imputationserver-ashg22/raw/master/files/chr20.R50.merged.1.330k.recode.unphased.small.vcf.gz)
- [Phased dataset chr20 hg19](https://github.com/genepi/imputationserver-ashg/raw/main/files/chr20.R50.merged.1.330k.recode.small.vcf.gz)
- [Unphased dataset chr20 hg19](https://github.com/genepi/imputationserver-ashg/raw/main/files/chr20.R50.merged.1.330k.recode.unphased.small.vcf.gz)

## Submission Page - Submit
After all parameters have been selected and you click 'submit', the job will be added to our Input Validation and QC queue. Please have a look at our [Data Preparation Guide](https://imputationserver.readthedocs.io/en/latest/prepare-your-data) to learn how to prepare your dataset using a pre-imputation tool.

## Monitor Jobs, Download Data
If the job passes the QC step, it will be added to our long-time queue. As soon as your job is finished, you will receive an email with the password to download and encrypt your data. Also checkout our [Pipeline Overview Guide](https://imputationserver.readthedocs.io/en/latest/pipeline/) to learn more about the different internal parameters. The complete source code can also be found on [GitHub](https://imputationserver.sph.umich.edu).

## QC Results
A simple QC report including the frequency plot is available [here](https://htmlpreview.github.io/?https://github.com/genepi/imputationserver-ashg/blob/main/files/qcreport.html).


# Contact
If you have any questions please write [me an email](mailto:sebastian.schoenherr@i-med.ac.at) or contact me on [Twitter](https://twitter.com/seppinho).
2 changes: 2 additions & 0 deletions docs/workshops/ASHG2023/Session5.md
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
**Workshop ASHG2023 > Session 5: HLA Imputation**

- [Example output of the HLA imputation VCF](https://github.com/genepi/imputationserver-ashg/raw/main/files/chr6.dose.vcf.gz)
17 changes: 0 additions & 17 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,23 +21,6 @@ nav:
- "Session 4: Imputation Bot and PGS Server": workshops/ASHG2023/Session4.md
- "Session 5: HLA Imputation": workshops/ASHG2023/Session5.md
- "Session 6: TOPMed Imputation Server": workshops/ASHG2023/Session6.md
- ASHG2022:
- Overview: workshops/ASHG2022.md
- "Session 1: Imputation and the Server": workshops/ASHG2022/Session1.md
- "Session 2: Run a job, Data Preparation and Data Download": workshops/ASHG2022/Session2.md
- "Session 3: Performing GWAS using imputed data": workshops/ASHG2022/Session3.md
- "Session 4: Imputation Bot and PGS Server": workshops/ASHG2022/Session4.md
- "Session 5: HLA Imputation": workshops/ASHG2022/Session5.md
- "Session 6: TOPMed Imputation Server": workshops/ASHG2022/Session6.md
- ASHG2020:
- Overview: workshops/ASHG2020.md
- "Session 1: Imputation and the Server": workshops/ASHG2020/Session1.md
- "Session 2: Run a job, Quality Control and Data Preparation": workshops/ASHG2020/Session2.md
- "Session 3: Tracking runs and downloading data": workshops/ASHG2020/Session3.md
- "Session 4: Performing GWAS using imputed data": workshops/ASHG2020/Session4.md
- "Session 5: Imputation bot": workshops/ASHG2020/Session5.md
- "Session 6: TOPMed Imputation Server": workshops/ASHG2020/Session6.md
- "Session 7: Imputation panels": workshops/ASHG2020/Session7.md
- Contact: contact.md


Expand Down

0 comments on commit ce70e78

Please sign in to comment.