Welcome to STA 313

Lecture 0

Dr. Mine Çetinkaya-Rundel

Duke University
STA 313 - Spring 2024

Course Details

Teaching team

Instructor

Dr. Mine Çetinkaya-Rundel

Old Chem 213

mc301@duke.edu

Teaching assistants

  • Eli Gnesin - Head TA + Lab 2 TA
  • Glenn Palmer
  • Holly Cui - Lab 1 TA
  • Kelsey Brod - Project lead + Lecture TA (Thursdays)
  • Shelby Tisdale - Project support + Lecture TA (Tuesdays)

Timetable

  • Lectures (weekly)
    • Tuesdays, 10:05 - 11:45 pm - LSRC D106
    • Thursdays, 10:05 - 11:45 pm - LSRC D106
  • Labs (weekly)
    • Lab 1: Wednesdays, 1:25 - 2:40 pm - Link Classroom 5
    • Lab 2: Wednesdays, 3:05 - 4:20 pm - Link Classroom 5

Themes: what, why, and how

  • What: the plot
    • Specific types of visualizations for a particular purpose (e.g., maps for spatial data, Sankey diagrams for proportions, etc.)
    • Tooling to produce them (e.g., specific R packages)
  • How: the process
    • Start with a design (sketch + pseudo code)
    • Pre-process data (e.g., wrangle, reshape, join, etc.)
    • Map data to aesthetics
    • Make visual encoding decisions t(e.g., address accessibility concerns)
    • Post-process for visual appeal and annotation
  • Why: the theory
    • Tie together “how” and “what” through the grammar of graphics

But first…

Show and tell

  • Form a small group (2-4 people) with people sitting around you

  • First, introduce yourselves to each other – name (and proper pronunciation of name), year, major, where are you from, etc.

  • Start with the bad graphs – Share your examples of “bad” graphs and why you think they’re bad.

  • Then, share your good graphs – Same deal, share your examples of “good” graphs and why you think they’re good.

  • Finally, choose the one plot from your group that you think is most striking, either because it’s bad or because it’s good, and have one team member share the graph on #general in Slack in the relevant thread.

Course components

Course website

vizdata.org

aka “the one link to rule them all”

Lectures

  • In person

  • Attendance is required

  • A little bit of everything:

    • Traditional lecture
    • Live coding + demos
    • Short exercises + solution discussion

  • Recordings will be posted after class – to be used for review + make-up if you can’t make it to class due to health reasons, they’re not an alternative to class attendance

Labs

  • Attendance is required

  • Opportunity to work on course assignments with TA support

  • Opportunity to work with teammates on projects

Announcements

  • Posted on Canvas (Announcements tool) and sent via email, be sure to check both regularly

  • I’ll assume that you’ve read an announcement by the next “business” day

Diversity and inclusion

It is my intent that students from all diverse backgrounds and perspectives be well-served by this course, that students’ learning needs be addressed both in and out of class, and that the diversity that the students bring to this class be viewed as a resource, strength and benefit.

  • If you have a name that differs from those that appear in your official Duke records, please let me know!

  • Please let me know your preferred pronouns.

  • If you feel like your performance in the class is being impacted by your experiences outside of class, please don’t hesitate to come and talk with me. I want to be a resource for you. If you prefer to speak with someone outside of the course, your advisers and deans are excellent resources.

  • I (like many people) am still in the process of learning about diverse perspectives and identities. If something was said in class (by anyone) that made you feel uncomfortable, please talk to me about it.

Accessibility

  • The Student Disability Access Office (SDAO) is available to ensure that students are able to engage with their courses and related assignments.

  • I am committed to making all course materials accessible and I’m always learning how to do this better. If any course component is not accessible to you in any way, please don’t hesitate to let me know.

Assessments

Attendance + participation (5%)

  • Required throughout the semester in lecture and lab

  • Students who attend at least 80% of the lectures and participate regularly in lecture and/or other course venues (lab + Slack) will receive full credit for this portion of their grade

  • Participation in labs as well as on Slack will also count towards this component

Reading quizzes (10%)

  • Online, individual
  • Cover reading that is due since the previous quiz and up to and including the deadline for the given quiz
  • Due by 10 am ET (beginning of class) on the indicated day on the course schedule
  • Lowest dropped

Homework assignments (45%)

  • Submitted on GitHub, individual
  • Some lab sessions allocated to working on homework / getting feedback from TAs
  • Due by 5 pm ET on the indicated day on the course schedule
  • Lowest dropped

Projects

  • Submitted on GitHub, team-based
  • Interim deadlines, peer review on content, peer evaluation for team contribution
  • Some lab sessions allocated to working on projects, doing peer review, getting feedback from TAs

Teams

  • Team assignments
    • In class exercises and projects
    • Assigned different teams for each project
    • Peer evaluation during teamwork and after completion
  • Expectations and roles
    • Everyone is expected to contribute equal effort
    • Everyone is expected to understand all code turned in
    • Individual contribution evaluated by peer evaluation, commits, etc.

Project 1 (15%)

  • Same/similar data, different results

  • Presentation and write-up

  • Wrapped up before midterms grades are due

Project 2 (25%)

  • The world is your oyster! (and more details TBA)

  • New team

  • Presentation and write-up

  • Wrapped up on the final exam date

Grading

This course is assessed 100% on your coursework (there is no exam). We will be assessing you based on the following assignments,

Assignment Type Value Due
Attendance + participation Individual 5%
Reading quizzes Individual 10% ~ Every other week
Homeworks Individual 45% ~ Every other week
Project 1 Team 15% ~ Week 6 + earlier interim deadlines
Project 2 Team 25% ~ Finals week + earlier interim deadlines

Community participation

This is not required but highly recommended!

  • TidyTuesday - New dataset every week for wrangling, visualizing, modeling
  • I encourage you to participate, or at a minimum, browse others’ contributions on Twitter or Mastodon with #TidyTuesday

Course policies

Late work policy

  • Reading quizzes: Late submissions not accepted

  • Homework assignments:

    • Late, within 24 hours of deadline: -10% of available points

    • Late, within 24-48 hours of deadline: -20% of available points

    • More than 48 hours later: No credit, and we will not provide written feedback

  • Project presentations: Late submissions not accepted

  • Project write-ups:

    • Late, within 24 hours of deadline: -10% of available points

    • Late, within 24-48 hours of deadline: -20% of available points

    • More than 48 hours later: No credit, and we will not provide written feedback

  • Peer evaluation:

    • Late submissions not accepted
    • Must turn in peer evaluation if you want your own score from others

Collaboration policy

  • Only work that is clearly assigned as team work should be completed collaboratively (Projects)

  • Reading quizzes must be completed individually, you may not discuss answers with teammates, clarification questions should only be asked to myself and the TAs

  • Homework assignments must be completed individually. You may not directly share answers / code with others, however you are welcome to discuss the problems in general and ask for advice

Sharing / reusing code policy

  • We are aware that a huge volume of code is available on the web, and many tasks may have solutions posted

  • Unless explicitly stated otherwise, this course’s policy is that you may make use of any online resources (e.g. RStudio Community, StackOverflow, etc.) but you must explicitly cite where you obtained any code you directly use or use as inspiration in your solution(s)

  • Any recycled code that is discovered and is not explicitly cited will be treated as plagiarism, regardless of source

Use of generative artificial intelligence (AI)

  • Treat generative AI, such as ChatGPT, the same as other online resources.

  • Guiding principles:

    • (1) Cognitive dimension: Working with AI should not reduce your ability to think clearly. We will practice using AI to facilitate—rather than hinder—learning.

    • (2) Ethical dimension: Students using AI should be transparent about their use and make sure it aligns with academic integrity.

  • ✅ AI tools for code: You may make use of the technology for coding examples on assignments; if you do so, you must explicitly cite where you obtained the code. See the syllabus for guidelines for citing AI-generated content.

  • ❌ AI tools for narrative: Unless instructed otherwise, you may not use generative AI to write narrative on assignments. In general, you may use generative AI as a resource as you complete assignments but not to answer the exercises for you.

Academic integrity

To uphold the Duke Community Standard:

  • I will not lie, cheat, or steal in my academic endeavors;
  • I will conduct myself honorably in all my endeavors; and
  • I will act if the Standard is compromised.




most importantly:

ask if you’re not sure if something violates a policy!

Support

Office hours

  • Mine:

    • Tuesdays 2:30 - 3:30 pm - Old Chem 213 (+ Zoom upon request)

      • Any exceptions will be announced in class / course announcement

  • TAs: TBA!

  • Office hours start next Tuesday

  • + lots more resources listed on the syllabus!

Wellness

I want to make sure that you learn everything you were hoping to learn from this class. If this requires flexibility, please don’t hesitate to ask.

  • You never owe me personal information about your health (mental or physical) but you’re always welcome to talk to me. If I can’t help, I likely know someone who can.

  • I want you to learn lots of things from this class, but I primarily want you to stay healthy, balanced, and grounded.

Course Tools

RStudio

https://cmgr.oit.duke.edu/containers

  • Browser based RStudio instance(s) provided by Duke OIT

  • Requires internet connection to access

  • Provides consistency in hardware and software environments

  • Local R installations are fine but we will not guarantee support

GitHub

https://github.com/vizdata-s24

  • GitHub organization for the course

  • All of your work and your membership (enrollment) in the organization is private

  • Each assignment is a private repo on GitHub, I distribute the assignments on GitHub and you submit them there

  • Feedback on assignments is given as GitHub issues, scores recorded on Sakai Gradebook

Fill out the Getting to know you survey for collection of your account names, later this week you will be invited to the course organization.

Username advice

in case you don’t yet have a GitHub account…

Some brief advice about selecting your account names (particularly for GitHub),

  • Incorporate your actual name! People like to know who they’re dealing with and makes your username easier for people to guess or remember

  • Reuse your username from other contexts, e.g., Twitter or Slack

  • Pick a username you will be comfortable revealing to your future boss

  • Shorter is better than longer, but be as unique as possible

  • Make it timeless. Avoid highlighting your current university, employer, or place of residence

Slack

  • Online forum for asking and answering questions

  • Private repo in the course organization

  • You will need to join the course organization for access

  • Ask and answer questions related to course logistics, assignment, etc. here

  • Personal questions (e.g., extensions, illnesses, etc.) should be via email to me

  • Once you join, browse the channels to make sure you’re posting questions in the right channel, update your profile with your name, photo/avatar of you that matches your GitHub profile, and your pronouns

  • Unfortunately Slack is not the best place to ask coding questions, but it’s a great place for real-time connection and collaboration

Demo on Tuesday for asking good questions with proper code formatting.

Grammar of graphics

Data visualization

“The simple graph has brought more information to the data analyst’s mind than any other device.” — John Tukey

  • Data visualization is the creation and study of the visual representation of data

  • Many tools for visualizing data – R is one of them

  • Many approaches/systems within R for making data visualizations – ggplot2 is one of them, and that’s what we’re going to use

ggplot2 ∈ tidyverse

  • ggplot2 is tidyverse’s data visualization package

  • gg in “ggplot2” stands for Grammar of Graphics

  • Inspired by the book Grammar of Graphics by Leland Wilkinson

Grammar of Graphics

A grammar of graphics is a tool that enables us to concisely describe the components of a graphic

Hello ggplot2!

  • ggplot() is the main function in ggplot2
  • Plots are constructed in layers
  • Structure of the code for plots can be summarized as
ggplot(data = [dataset], 
       mapping = aes(x = [x-variable], y = [y-variable])) +
   geom_xxx() +
   other options
  • The ggplot2 package comes with the tidyverse
library(tidyverse)

Data: Palmer Penguins

Measurements for penguin species, island in Palmer Archipelago, size (flipper length, body mass, bill dimensions), and sex.

library(palmerpenguins)
glimpse(penguins)
Rows: 344
Columns: 8
$ species           <fct> Adelie, Adelie, Adelie, Adelie, Adelie, Adelie, Adelie, Adelie…
$ island            <fct> Torgersen, Torgersen, Torgersen, Torgersen, Torgersen, Torgers…
$ bill_length_mm    <dbl> 39.1, 39.5, 40.3, NA, 36.7, 39.3, 38.9, 39.2, 34.1, 42.0, 37.8…
$ bill_depth_mm     <dbl> 18.7, 17.4, 18.0, NA, 19.3, 20.6, 17.8, 19.6, 18.1, 20.2, 17.1…
$ flipper_length_mm <int> 181, 186, 195, NA, 193, 190, 181, 195, 193, 190, 186, 180, 182…
$ body_mass_g       <int> 3750, 3800, 3250, NA, 3450, 3650, 3625, 4675, 3475, 4250, 3300…
$ sex               <fct> male, female, female, NA, female, male, female, male, NA, NA, …
$ year              <int> 2007, 2007, 2007, 2007, 2007, 2007, 2007, 2007, 2007, 2007, 20…

Goal

ggplot(
  penguins,
  aes(x = bill_depth_mm, y = bill_length_mm, color = species)
) +
  geom_point() +
  labs(
    title = "Bill depth and length",
    subtitle = "Dimensions for Adelie, Chinstrap, and Gentoo Penguins",
    x = "Bill depth (mm)", y = "Bill length (mm)",
    color = "Species"
  )

An improved goal

ggplot(
  penguins,
  aes(x = bill_depth_mm, y = bill_length_mm, color = species, shape = species)) +
  geom_point(size = 2) +
  labs(
    title = "Bill depth and length",
    subtitle = "Dimensions for Adelie, Chinstrap, and Gentoo Penguins",
    x = "Bill depth (mm)", y = "Bill length (mm)",
    color = "Species",
    shape = "Species",
    caption = "Source: Palmer Station LTER / palmerpenguins package"
  ) +
  theme_minimal() +
  ggthemes::scale_color_colorblind()

Start with the penguins data frame, map bill depth to the x-axis and map bill length to the y-axis.

Represent each observation with a point and map species to the color and shape of each point.

Title the plot “Bill depth and length”, add the subtitle “Dimensions for Adelie, Chinstrap, and Gentoo Penguins”, label the x and y axes as “Bill depth (mm)” and “Bill length (mm)”, respectively, label the legend “Species”, and add a caption for the data source.

Finally, use a discrete color scale that is designed to be perceived by viewers with common forms of color blindness.

Wrap up

Disclaimer

I have a class in the next period in Bio Sci, so I will be rushing out of class each time. I’m always available on Slack and in office hours and happy to make appointments as well!

This week’s tasks

  1. Create a GitHub account if you don’t have one

  2. Read the syllabus

  3. Make sure you can login in to RStudio and reserve a container for STA 313: cmgr.oit.duke.edu/containers

  4. Complete the Getting to know you survey on Canvas – to be posted

  5. Complete the readings

🔗 vizdata.org