Skip to content

Commit

Permalink
format-changes-adding-intro
Browse files Browse the repository at this point in the history
  • Loading branch information
ehumph committed Jan 24, 2024
1 parent ff7d9af commit 21e3a01
Show file tree
Hide file tree
Showing 7 changed files with 324 additions and 15 deletions.
37 changes: 32 additions & 5 deletions 01-intro.Rmd
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# (PART\*) Demo Chapters {-}
# (PART\*) Background {-}


```{r, include = FALSE}
Expand All @@ -7,14 +7,41 @@ ottrpal::set_knitr_image_path()

# Introduction

This is a companion training guide for BioDIGS, a GDSCN project that brings a research experience into the classroom. Visit the BioDIGS (BioDiversity and Informatics for Genomics Scholars) website [here](https://biodigs.org/) for more information about this collaborative, distributed research project!

The GDSCN (Genomics Data Science Community Network) is a consortium of educators who aim to create a world where researchers, educators, and students from diverse backgrounds are able to fully participate in genomic data science research. You can find more information about its mission and initiatives [here](https://www.gdscn.org/home).

## Motivation

One critical aspect of an undergraduate STEM education is hands-on research. Undergraduate research experiences enhance what students learn in the classroom as well as increase a student's interest in pursuing STEM careers ^1. It can also lead to improved scientific reasoning and increased academic performance overall ^2. However, many students at underresourced institutions like community colleges, Historically Black Colleges and Universities (HBCUs), tribal colleges and universities, and Hispanic-serving institutions have limited access to research opportunities compared to their cohorts at larger four-year colleges and R1 institutions. These students are also more likely to belong to groups that are already under-represented in STEM disciplines, particularly genomics and data science ^3 ^4.

The BioDIGS Project aims to be at the intersection of genomics, data science, cloud computing, and education.

## Target Audience

The activities in this guide are written for undergraduate students and beginning graduate students. Some sections require basic understanding of the R programming language, which is indicated at the beginning of the chapter.

## Platform

The activities in this guide are demonstrated on NHGRI's [AnVIL](https://anvilproject.org/) cloud computing platform. AnVIL is the preferred computing platform for the GDSCN. However, all of these activities can be done using your personal installation of R or using the online [Galaxy](usegalaxy.org) portal.

## Data

The data generated by the BioDIGS project is available through the [BioDIGS website](biodigs.org), as well as through an [AnVIL workspace](https://anvilproject.org).
## Who did the soil sampling?

Soil sampling for this project was done by both faculty and student volunteers from schools that aren't traditional R1 research institutions.

## Where is the funding from?

Funding for this project is through Contract # 75N92022P00232 from the National Human Genome Research Institute awarded to Johns Hopkins University.

## References

## Target Audience
1: Russell et al. 2007: https://doi.org/10.1126/science.1140384

The course is intended for ...
2: Buffalari et al. 2020: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC8040836/

## Curriculum
3: Canner et al. 2017: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5398168/

The course covers...
4: GDSCN 2022: https://doi.org/10.1101/gr.276496.121
File renamed without changes.
File renamed without changes.
File renamed without changes.
144 changes: 144 additions & 0 deletions 08-data exploration.Rmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
# (PART\*) Data Exploration {-}


```{r, include = FALSE}
ottrpal::set_knitr_image_path()
```

# Student instructions

Modules aimed at students in a course or workshop.

<br>

## Student Account Setup

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
cow::borrow_chapter(
doc_path = "child/_child_student_create_account.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for cloning a Workspace

These instructions can be customized to a specific workspace by setting certain variables before running `cow::borrow_chapter()`. If these variables have not been set, reasonable defaults are provided (e.g. "ask your instructor").

### With no variables set:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
cow::borrow_chapter(
doc_path = "child/_child_student_workspace_clone.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### With variables set:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
workspace_name = "Example_Workspace",
workspace_link = "http://example.com/",
billing_project = "Example Billing Project"
)
cow::borrow_chapter(
doc_path = "child/_child_student_workspace_clone.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for launching Jupyter

The module below is specially customized for students, allowing you to give more specific instructions on the settings for their Jupyter environment. There are several other general purpose modules that may also be useful for students (e.g. Pausing Jupyter, Deleting Jupyter) that can be found in other chapters of this book.

The following instructions can be customized by setting certain variables before running `cow::borrow_chapter()`. Developers should create these variables as a list `AnVIL_module_settings`. The following variables can be provided:

- `audience` = Defaults to `general`, telling them to use the default Jupyter settings. If `audience` is set to `student`, it gives more specific instructions.
- `docker_image` = Optional, it will tell them how to set the image.
- `startup_script` = Optional, it will tell them how to set the script.

### Using default Jupyter environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student"
)
cow::borrow_chapter(
doc_path = "child/_child_jupyter_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### Using custom Jupyter environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student",
docker_image = "example docker",
startup_script = "example startup script"
)
cow::borrow_chapter(
doc_path = "child/_child_jupyter_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for launching RStudio

The module below is specially customized for students, allowing you to give more specific instructions on the settings for their RStudio environment. There are several other general purpose modules that may also be useful for students (e.g. Pausing RStudio, Deleting RStudio) that can be found in other chapters of this book.

The following instructions can be customized by setting certain variables before running `cow::borrow_chapter()`. Developers should create these variables as a list `AnVIL_module_settings`. The following variables can be provided:

- `audience` = Defaults to `general`, telling them to use the default RStudio settings. If `audience` is set to `student`, it gives more specific instructions.
- `docker_image` = Optional, it will tell them to open the customization dialogue and direct them on how to set the image.
- `startup_script` = Optional, it will tell them to open the customization dialogue and direct them on how to set the script.

### Using default RStudio environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student"
)
cow::borrow_chapter(
doc_path = "child/_child_rstudio_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### Using custom RStudio environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student",
docker_image = "example docker",
startup_script = "example startup script"
)
cow::borrow_chapter(
doc_path = "child/_child_rstudio_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::
144 changes: 144 additions & 0 deletions 08-data_cleaning.Rmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
# (PART\*) Data Cleaning and QC {-}


```{r, include = FALSE}
ottrpal::set_knitr_image_path()
```

# Student instructions

Modules aimed at students in a course or workshop.

<br>

## Student Account Setup

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
cow::borrow_chapter(
doc_path = "child/_child_student_create_account.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for cloning a Workspace

These instructions can be customized to a specific workspace by setting certain variables before running `cow::borrow_chapter()`. If these variables have not been set, reasonable defaults are provided (e.g. "ask your instructor").

### With no variables set:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
cow::borrow_chapter(
doc_path = "child/_child_student_workspace_clone.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### With variables set:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
workspace_name = "Example_Workspace",
workspace_link = "http://example.com/",
billing_project = "Example Billing Project"
)
cow::borrow_chapter(
doc_path = "child/_child_student_workspace_clone.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for launching Jupyter

The module below is specially customized for students, allowing you to give more specific instructions on the settings for their Jupyter environment. There are several other general purpose modules that may also be useful for students (e.g. Pausing Jupyter, Deleting Jupyter) that can be found in other chapters of this book.

The following instructions can be customized by setting certain variables before running `cow::borrow_chapter()`. Developers should create these variables as a list `AnVIL_module_settings`. The following variables can be provided:

- `audience` = Defaults to `general`, telling them to use the default Jupyter settings. If `audience` is set to `student`, it gives more specific instructions.
- `docker_image` = Optional, it will tell them how to set the image.
- `startup_script` = Optional, it will tell them how to set the script.

### Using default Jupyter environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student"
)
cow::borrow_chapter(
doc_path = "child/_child_jupyter_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### Using custom Jupyter environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student",
docker_image = "example docker",
startup_script = "example startup script"
)
cow::borrow_chapter(
doc_path = "child/_child_jupyter_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

## Student instructions for launching RStudio

The module below is specially customized for students, allowing you to give more specific instructions on the settings for their RStudio environment. There are several other general purpose modules that may also be useful for students (e.g. Pausing RStudio, Deleting RStudio) that can be found in other chapters of this book.

The following instructions can be customized by setting certain variables before running `cow::borrow_chapter()`. Developers should create these variables as a list `AnVIL_module_settings`. The following variables can be provided:

- `audience` = Defaults to `general`, telling them to use the default RStudio settings. If `audience` is set to `student`, it gives more specific instructions.
- `docker_image` = Optional, it will tell them to open the customization dialogue and direct them on how to set the image.
- `startup_script` = Optional, it will tell them to open the customization dialogue and direct them on how to set the script.

### Using default RStudio environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student"
)
cow::borrow_chapter(
doc_path = "child/_child_rstudio_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::

### Using custom RStudio environment:

:::: {.borrowed_chunk}
```{r, echo = FALSE, results='asis'}
# Specify variables
AnVIL_module_settings <- list(
audience = "student",
docker_image = "example docker",
startup_script = "example startup script"
)
cow::borrow_chapter(
doc_path = "child/_child_rstudio_launch.Rmd",
repo_name = "jhudsl/AnVIL_Template"
)
```
::::
14 changes: 4 additions & 10 deletions _bookdown.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,10 @@ chapter_name: "Chapter "
repo: https://github.com/jhudsl/AnVIL_Template/
rmd_files: ["index.Rmd",
"01-intro.Rmd",
"02-chapter_of_course.Rmd",
"03-AnVIL_modules.Rmd",
"04-workspace_modules.Rmd",
"05-billing_modules.Rmd",
"06-onboarding_modules.Rmd",
"07-using_platforms_modules.Rmd",
"08-student_modules.Rmd",
"10-user_management_modules.Rmd",
"11-why-anvil.Rmd",
"12-instructor_modules.Rmd",
"03-BioDIGS_project_overview.Rmd",
"04-data_tour.Rmd",
"08-data_cleaning.Rmd",
"08-data_exploration.Rmd",
"About.Rmd",
"References.Rmd"]
new_session: yes
Expand Down

0 comments on commit 21e3a01

Please sign in to comment.