From da4a0496fc90868501ba77d06113297594e7f5ab Mon Sep 17 00:00:00 2001 From: njlyon0 Date: Tue, 28 May 2024 10:41:35 -0400 Subject: [PATCH] Added some missing alt text and incremental bullet reveal --- .../slides_1a/execute-results/html.json | 4 +-- materials/slides_1a.qmd | 32 +++++++++++++++++-- 2 files changed, 31 insertions(+), 5 deletions(-) diff --git a/_freeze/materials/slides_1a/execute-results/html.json b/_freeze/materials/slides_1a/execute-results/html.json index 493bd8a..278cd03 100644 --- a/_freeze/materials/slides_1a/execute-results/html.json +++ b/_freeze/materials/slides_1a/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "80b2c8c320efab76155baff3180ec511", + "hash": "4b70acf22f59179a82e8d2af08fffb88", "result": { "engine": "knitr", - "markdown": "---\ntitle: \"Intro to Data Science\"\nauthor: \"Lecture 1 -- Data Science Fundamentals\"\nengine: knitr\nformat: \n revealjs: \n slide-number: c\n scrollable: false\n code-overflow: wrap\n code-line-numbers: false\n code-copy: hover\n theme: [night, slides.scss]\n reference-location: document\n footer: \"[Programming in R for Biologists](https://njlyon0.github.io/teach_r-for-biologists/)\"\n---\n\n\n## A Guide to Your Process\n\n### [Scheduling]{.blue}\n\n### [Learning Objectives]{.purple}\n\n### [Practice]{.pink}\n\n### [Supporting Information]{.orange}\n\n### [Class Discussion]{.gold}\n\n## [Today's Plan]{.blue}\n\n- Introductions\n- Data Science Background\n- Why R?\n- Problem Solving Tips (for Coding)\n- Computer File Paths\n\n## [Today's Learning Objectives]{.purple}\n\nAfter today's session you will be able to:\n \n. . .\n\n- Define \"data science\"\n- Explain why the course is taught in R\n- Identify useful code problem solving techniques\n- Demonstrate comprehension of computer file paths\n\n## [Introductions]{.gold}\n\nTell me a bit about yourselves!\n\n. . .\n\n- What is your preferred name?\n\n- What year are you in school?\n\n- What's a fun fact that brings you joy?\n\n## [Introductions (Continued)]{.gold}\n\n- Why did you sign up for the course?\n\n- What skill(s) are you most excited to learn?\n\n- What previous coding / data science experience do you have?\n - Absolutely fine if this is your first foray into data science!\n\n## [My Goal for You]{.purple}\n\n

\n\"Comic-style\n

\n\n## [Data Science Definition]{.orange} \n\n\\\n\\\n\nData science combines [_programming_]{.purple} and statistics with [_subject matter expertise_]{.purple} to identify patterns and insights hidden in data\n\n## [Why is this Course Taught in R?]{.orange}\n\nR is a programming language that is _awesome_ for environmental data scientists\n\n\\\n\n. . .\n\nBenefits of R:\n\n\\\n\n. . . \n\n| Free | Reproducible | Accessible | Popular | Versatile |\n| :---: | :---: | :---: | :---: | :---: |\n| `Piggy Bank`{=html} | `Repeat`{=html} | `Universal Access`{=html} | `Star`{=html} | `Masks Theater`{=html} |\n\n## [R's Popularity]{.orange}\n\n\n::: {.cell}\n::: {.cell-output-display}\n![](slides_1a_files/figure-revealjs/popularity-ggplot-1.png){width=960}\n:::\n:::\n\n\n:::{.aside}\nData from [Lai _et al._ 2019](https://esajournals.onlinelibrary.wiley.com/doi/full/10.1002/ecs2.2567)\n:::\n\n## [R Data Science Value]{.orange}{.smaller}\n\n:::{.incremental}\n\n::::{.columns}\n:::{.column width=\"50%\"}\n### `Arrows Left Right`{=html} Reproducibility \n\n- R is written in \"[scripts]{.orange}\"\n - Scripts = step-by-step instructions\n- Scripts can be run by _any_ R user\n- Allows perfect replication of process\n- Programs that require clicking buttons are not (as) reproducible\n - Would depend on accompanying written/verbal instructions\n:::\n\n:::{.column width=\"50%\"}\n### Collaboration `Handshake`{=html}\n\n- R scripts can be co-developed!\n- They can then be shared like a paper draft\n- Many tools exist to formalize sharing\n - We'll cover one in this course!\n- Unscripted programs would again require written/verbal instructions\n - Then hoping someone clicks the right buttons in the right way \n:::\n::::\n\n:::\n\n## [Temperature Check]{.purple}\n\n#### How are you Feeling?\n\n

\n\"Comic-style\n

\n\n## [Problem Solving in R]{.orange}\n\n

\n\"Small\n

\n\n## [Problem Solving Methods]{.orange} {.smaller}\n\n- Problem solving is an important life skill generally\n - Also useful for data science!\n\n\\\n\n. . .\n\n- I _do not_ recommend using AI as a problem-solving method\n\n\\\n\n. . .\n\n- Let's discuss some useful strategies:\n 1. 'Rubber duck' method\n 2. Google (seriously!)\n 3. Teamwork\n 4. Take a break\n 5. Whatever methods _you_ use!\n\n## [\"AI\" Aside]{.gold} {.smaller}\n\n- I _strongly_ discourage the use of AI tools in this class\n - E.g., ChatGPT, GitHub CoPilot, etc.\n\n\\\n\n. . .\n\n- Two primary reasons:\n 1. It undermines your learning\n 2. There is an ethical dimension we don't have time to cover in this class\n\n\\\n\n. . .\n\n- However, I'm an educator not a cop\n - I won't be policing you in order to enforce my take on AI\n\n## [Method 1: Rubber Duck]{.orange} {.smaller}\n\n![](images/ducky.png){.absolute top=50 left=800 width=\"20%\"}\n- Get rubber duck / small object\n\n. . . \n\n- Explain each line of your code to the duck\n - Go into as much detail as possible\n - Re-read lines _carefully_ as you explain\n\n. . .\n\n- You'll catch typos/errors that you had missed!\n\n. . .\n\n- Why \"rubber duck\" instead of \"friend\"?\n - Because it would likely be a dull experience for your friend `Face Smile`{=html}\n\n## [Method 2: Google]{.orange} {.smaller}\n\n![](images/logo-google.png){.absolute top=50 left=700 width=\"30%\"}\n\n- This is a serious suggestion!\n - Google is truly an _amazing_ resource for this\n\n\\\n\n- There are forums where where people discuss code issues\n - [StackOverflow](https://stackoverflow.com/), [GitHub Discussions](https://github.com/orgs/community/discussions/categories/programming-help), etc.\n\n\\\n\n- If you get an error:\n 1. Copy the entire error message\n 2. Paste it into Google\n 3. Check the first few links to see how others solved that issue\n\n## [Google Tips]{.orange}\n\n- Use a plus sign (`+`) between search terms\n - E.g., \"R + \\\"\n\n\\\n\n- When specific wording matters, use quotes!\n - E.g., \"I want results with _exactly_ this phrase\"\n\n## [Method 3: Team Up!]{.orange} {.smaller}\n\n- Group work is a classic method of problem solving\n\n\\\n\n- Email/text classmates about errors you're encountering\n - Set up a weekly time to meet and work together\n\n\\\n\n- Group work & assignments\n - I really encourage you to work together to [solve problems]{.blue}\n - _BUT_ assignments should be produced by you alone\n - There are **no group assignments** in this course!\n\n## [Method 4: Take a Break]{.orange}\n\n

\n\"Creature\n

\n\n## [Method 4: Take a Break]{.orange} {.smaller}\n\n- Coding issues can be super frustrating\n - Totally **normal** to feel this way\n\n\\\n\n. . .\n\n- If you are struggling to solve a problem, take a few minutes to step re-set\n - Physically step away and do something active\n - Do one of your hobbies for a few minutes\n - Work on something else\n\n\\\n\n. . .\n\n- Return to the problem an hour or so later and try again!\n\n## [Method 5: Yours!]{.gold}\n\n- As students, you're experienced problem solvers already!\n\n\\\n\n. . . \n\n- Code problems can likely be solved by the strategies you already use!\n\n\\\n\n. . . \n\n- How do you solve problems you encounter in other courses or at work?\n\n## [Temperature Check]{.purple}\n\n#### How are you Feeling?\n\n

\n\"Comic-style\n

\n\n## [Computer File Paths]{.orange} {.smaller}\n\n- Computers store files in \"[folders]{.orange}\"\n - Folders can be _nested_ inside other folders\n\n\\\n\n. . .\n\n- The name of all folders leading to a particular file is that file's \"[file path]{.purple}\"\n - File path starts at the biggest folder (\"top\" folder) and ends at the file\n - Each folder name is separated by slashes (`\\` or `/`)\n\n\n\\\n\n. . .\n\n- For example: _[\\~]{.blue} [/]{.orange} Downloads [/]{.orange} BIO-316_syllabus.docx_\n\n## [File Path Example]{.gold} {.smaller}\n\nWhat is the file path for the **notes** document in this image?\n\n

\n\"Diagram\n

\n\n. . . \n\n_[\\~]{.blue} [/]{.orange} Documents [/]{.orange} BIO 316 [/]{.orange} BIO316-Notes-Week 1.docx_\n\n## [Practice: File Paths]{.pink} {.smaller}\n\n- Pick a file on your computer\n - _Not_ one in the \"Downloads\" folder (file paths are too short)\n\n\\\n\n. . .\n\n- What is that file's path?\n - Hint: _[\\~]{.blue} [/]{.orange} ... [/]{.orange} ... [/]{.orange} ..._\n\n\\\n\n. . .\n\n- When you have it, show me the file and tell me its path\n\n## [Upcoming Due Dates]{.blue} {.smaller}\n\n::::{.columns}\n:::{.column width=\"50%\"}\n### Due before lab\n\n#### Due ASAP\n\n- Install R (see [here](https://cran.r-project.org/))\n- Install RStudio (see [here](https://posit.co/download/rstudio-desktop/))\n- Read the syllabus (esp. point values + assignment descriptions)\n\n#### Due by midnight\n\n- Muddiest Point \\#1\n\n:::\n:::{.column width=\"50%\"}\n### Due before lecture\n\n#### (By midnight)\n\n- Read the British Ecological Society's [Reproducible Code Guide](https://www.britishecologicalsociety.org/publications/better-science/) (p.1-12) \n\n:::\n::::\n", + "markdown": "---\ntitle: \"Intro to Data Science\"\nauthor: \"Lecture 1 -- Data Science Fundamentals\"\nengine: knitr\nformat: \n revealjs: \n slide-number: c\n scrollable: false\n code-overflow: wrap\n code-line-numbers: false\n code-copy: hover\n theme: [night, slides.scss]\n reference-location: document\n footer: \"[Programming in R for Biologists](https://njlyon0.github.io/teach_r-for-biologists/)\"\n---\n\n\n## A Guide to Your Process\n\n### [Scheduling]{.blue}\n\n### [Learning Objectives]{.purple}\n\n### [Practice]{.pink}\n\n### [Supporting Information]{.orange}\n\n### [Class Discussion]{.gold}\n\n## [Today's Plan]{.blue}\n\n- Introductions\n- Data Science Background\n- Why R?\n- Problem Solving Tips (for Coding)\n- Computer File Paths\n\n## [Today's Learning Objectives]{.purple}\n\nAfter today's session you will be able to:\n \n. . .\n\n- Define \"data science\"\n- Explain why the course is taught in R\n- Identify useful code problem solving techniques\n- Demonstrate comprehension of computer file paths\n\n## [Introductions]{.gold}\n\nTell me a bit about yourselves!\n\n. . .\n\n- What is your preferred name?\n\n- What year are you in school?\n\n- What's a fun fact that brings you joy?\n\n## [Introductions (Continued)]{.gold}\n\n- Why did you sign up for the course?\n\n- What skill(s) are you most excited to learn?\n\n- What previous coding / data science experience do you have?\n - Absolutely fine if this is your first foray into data science!\n\n## [My Goal for You]{.purple}\n\n

\n\"Comic-style\n

\n\n## [Data Science Definition]{.orange} \n\n\\\n\\\n\nData science combines [_programming_]{.purple} and statistics with [_subject matter expertise_]{.purple} to identify patterns and insights hidden in data\n\n## [Why is this Course Taught in R?]{.orange}\n\nR is a programming language that is _awesome_ for environmental data scientists\n\n\\\n\n. . .\n\nBenefits of R:\n\n\\\n\n. . . \n\n| Free | Reproducible | Accessible | Popular | Versatile |\n| :---: | :---: | :---: | :---: | :---: |\n| `Piggy Bank`{=html} | `Repeat`{=html} | `Universal Access`{=html} | `Star`{=html} | `Masks Theater`{=html} |\n\n## [R's Popularity]{.orange}\n\n\n::: {.cell}\n::: {.cell-output-display}\n![](slides_1a_files/figure-revealjs/popularity-ggplot-1.png){width=960}\n:::\n:::\n\n\n:::{.aside}\nData from [Lai _et al._ 2019](https://esajournals.onlinelibrary.wiley.com/doi/full/10.1002/ecs2.2567)\n:::\n\n## [R Data Science Value]{.orange}{.smaller}\n\n:::{.incremental}\n\n::::{.columns}\n:::{.column width=\"50%\"}\n### `Arrows Left Right`{=html} Reproducibility \n\n- R is written in \"[scripts]{.orange}\"\n - Scripts = step-by-step instructions\n- Scripts can be run by _any_ R user\n- Allows perfect replication of process\n- Programs that require clicking buttons are not (as) reproducible\n - Would depend on accompanying written/verbal instructions\n:::\n\n:::{.column width=\"50%\"}\n### Collaboration `Handshake`{=html}\n\n- R scripts can be co-developed!\n- They can then be shared like a paper draft\n- Many tools exist to formalize sharing\n - We'll cover one in this course!\n- Unscripted programs would again require written/verbal instructions\n - Then hoping someone clicks the right buttons in the right way \n:::\n::::\n\n:::\n\n## [Temperature Check]{.purple}\n\n#### How are you Feeling?\n\n

\n\"Comic-style\n

\n\n## [Problem Solving in R]{.orange}\n\n

\n\"Small\n

\n\n## [Problem Solving Methods]{.orange} {.smaller}\n\n- Problem solving is an important life skill generally\n - Also useful for data science!\n\n\\\n\n. . .\n\n- I _do not_ recommend using AI as a problem-solving method\n\n\\\n\n. . .\n\n- Let's discuss some useful strategies:\n 1. 'Rubber duck' method\n 2. Google (seriously!)\n 3. Teamwork\n 4. Take a break\n 5. Whatever methods _you_ use!\n\n## [\"AI\" Aside]{.gold} {.smaller}\n\n- I _strongly_ discourage the use of AI tools in this class\n - E.g., ChatGPT, GitHub CoPilot, etc.\n\n\\\n\n. . .\n\n- Two primary reasons:\n 1. It undermines your learning\n 2. There is an ethical dimension we don't have time to cover in this class\n\n\\\n\n. . .\n\n- However, I'm an educator not a cop\n - I won't be policing you in order to enforce my take on AI\n\n## [Method 1: Rubber Duck]{.orange} {.smaller}\n\n![](images/ducky.png){.absolute top=50 left=800 width=\"20%\" fig-alt=\"Image of a rubber duck\"}\n- Get rubber duck / small object\n\n\\\n\n. . . \n\n- Explain each line of your code to the duck\n - Go into as much detail as possible\n - Re-read lines _carefully_ as you explain\n\n\\\n\n. . .\n\n- You'll catch typos/errors that you had missed!\n\n\\\n\n. . .\n\n- Why \"rubber duck\" instead of \"friend\"?\n - Because it would likely be a dull experience for your friend `Face Smile`{=html}\n\n## [Method 2: Google]{.orange} {.smaller}\n\n![](images/logo-google.png){.absolute top=50 left=700 width=\"30%\" fig-alt=\"Google logo\"}\n\n- This is a serious suggestion!\n - Google is truly an _amazing_ resource for this\n\n\\\n\n. . . \n\n- There are forums where where people discuss code issues\n - [StackOverflow](https://stackoverflow.com/), [GitHub Discussions](https://github.com/orgs/community/discussions/categories/programming-help), etc.\n\n\\\n\n. . . \n\n- If you get an error:\n 1. Copy the entire error message\n 2. Paste it into Google\n 3. Check the first few links to see how others solved that issue\n\n## [Google Tips]{.orange} {.smaller}\n\n![](images/logo-google.png){.absolute top=50 left=700 width=\"30%\" fig-alt=\"Google logo\"}\n\n- **Ignore** the \"AI Overview\"\n - This is frequently wrong and/or misleading\n - Click actual links!\n\n\\\n\n. . . \n\n- Use a plus sign (`+`) between search terms\n - E.g., \"R + \\\"\n\n\\\n\n. . . \n\n- When specific wording matters, use quotes!\n - E.g., \"I want results with _exactly_ this phrase\"\n\n## [Method 3: Team Up!]{.orange} {.smaller}\n\n- Group work is a classic method of problem solving\n\n\\\n\n. . . \n\n- Email/text classmates about errors you're encountering\n - Set up a weekly time to meet and work together\n\n\\\n\n. . . \n\n- Group work & assignments\n - I really encourage you to work together to [solve problems]{.blue}\n - _BUT_ assignments should be produced by you alone\n - There are **no group assignments** in this course!\n\n## [Method 4: Take a Break]{.orange}\n\n

\n\"Creature\n

\n\n## [Method 4: Take a Break]{.orange} {.smaller}\n\n- Coding issues can be super frustrating\n - Totally **normal** to feel this way\n\n\\\n\n. . .\n\n- If you are struggling to solve a problem, take a few minutes to step re-set\n - Physically step away and do something active\n - Do one of your hobbies for a few minutes\n - Work on something else\n\n\\\n\n. . .\n\n- Return to the problem an hour or so later and try again!\n\n## [Method 5: Yours!]{.gold}\n\n- As students, you're experienced problem solvers already!\n\n\\\n\n. . . \n\n- Code problems can likely be solved by the strategies you already use!\n\n\\\n\n. . . \n\n- How do you solve problems you encounter in other courses or at work?\n\n## [Temperature Check]{.purple}\n\n#### How are you Feeling?\n\n

\n\"Comic-style\n

\n\n## [Computer File Paths]{.orange} {.smaller}\n\n- Computers store files in \"[folders]{.orange}\"\n - Folders can be _nested_ inside other folders\n\n\\\n\n. . .\n\n- The name of all folders leading to a particular file is that file's \"[file path]{.purple}\"\n - File path starts at the biggest folder (\"top\" folder) and ends at the file\n - Each folder name is separated by slashes (`\\` or `/`)\n\n\n\\\n\n. . .\n\n- For example: _[\\~]{.blue} [/]{.orange} Downloads [/]{.orange} BIO-316_syllabus.docx_\n\n## [File Path Example]{.gold} {.smaller}\n\nWhat is the file path for the **notes** document in this image?\n\n

\n\"Diagram\n

\n\n. . . \n\n_[\\~]{.blue} [/]{.orange} Documents [/]{.orange} BIO 316 [/]{.orange} BIO316-Notes-Week 1.docx_\n\n## [Practice: File Paths]{.pink} {.smaller}\n\n- Pick a file on your computer\n - _Not_ one in the \"Downloads\" folder (file paths are too short)\n\n\\\n\n. . .\n\n- What is that file's path?\n - Hint: _[\\~]{.blue} [/]{.orange} ... [/]{.orange} ... [/]{.orange} ..._\n\n\\\n\n. . .\n\n- When you have it, show me the file and tell me its path\n\n## [Upcoming Due Dates]{.blue} {.smaller}\n\n::::{.columns}\n:::{.column width=\"50%\"}\n### Due before lab\n\n#### Due ASAP\n\n- Install R (see [here](https://cran.r-project.org/))\n- Install RStudio (see [here](https://posit.co/download/rstudio-desktop/))\n- Read the syllabus (esp. point values + assignment descriptions)\n\n#### Due by midnight\n\n- Muddiest Point \\#1\n\n:::\n:::{.column width=\"50%\"}\n### Due before lecture\n\n#### (By midnight)\n\n- Read the British Ecological Society's [Reproducible Code Guide](https://www.britishecologicalsociety.org/publications/better-science/) (p.1-12) \n\n:::\n::::\n", "supporting": [ "slides_1a_files" ], diff --git a/materials/slides_1a.qmd b/materials/slides_1a.qmd index deeace9..d7c6354 100644 --- a/materials/slides_1a.qmd +++ b/materials/slides_1a.qmd @@ -220,19 +220,25 @@ Data from [Lai _et al._ 2019](https://esajournals.onlinelibrary.wiley.com/doi/fu ## [Method 1: Rubber Duck]{.orange} {.smaller} -![](images/ducky.png){.absolute top=50 left=800 width="20%"} +![](images/ducky.png){.absolute top=50 left=800 width="20%" fig-alt="Image of a rubber duck"} - Get rubber duck / small object +\ + . . . - Explain each line of your code to the duck - Go into as much detail as possible - Re-read lines _carefully_ as you explain +\ + . . . - You'll catch typos/errors that you had missed! +\ + . . . - Why "rubber duck" instead of "friend"? @@ -240,30 +246,46 @@ Data from [Lai _et al._ 2019](https://esajournals.onlinelibrary.wiley.com/doi/fu ## [Method 2: Google]{.orange} {.smaller} -![](images/logo-google.png){.absolute top=50 left=700 width="30%"} +![](images/logo-google.png){.absolute top=50 left=700 width="30%" fig-alt="Google logo"} - This is a serious suggestion! - Google is truly an _amazing_ resource for this \ +. . . + - There are forums where where people discuss code issues - [StackOverflow](https://stackoverflow.com/), [GitHub Discussions](https://github.com/orgs/community/discussions/categories/programming-help), etc. \ +. . . + - If you get an error: 1. Copy the entire error message 2. Paste it into Google 3. Check the first few links to see how others solved that issue -## [Google Tips]{.orange} +## [Google Tips]{.orange} {.smaller} + +![](images/logo-google.png){.absolute top=50 left=700 width="30%" fig-alt="Google logo"} + +- **Ignore** the "AI Overview" + - This is frequently wrong and/or misleading + - Click actual links! + +\ + +. . . - Use a plus sign (`+`) between search terms - E.g., "R + \" \ +. . . + - When specific wording matters, use quotes! - E.g., "I want results with _exactly_ this phrase" @@ -273,11 +295,15 @@ Data from [Lai _et al._ 2019](https://esajournals.onlinelibrary.wiley.com/doi/fu \ +. . . + - Email/text classmates about errors you're encountering - Set up a weekly time to meet and work together \ +. . . + - Group work & assignments - I really encourage you to work together to [solve problems]{.blue} - _BUT_ assignments should be produced by you alone