syllabus.Rmd

---
title: "Syllabus"
output:
  html_document:
    toc: true
    toc_float: true
---

```{r child = file.path("child", "setup.Rmd")}
```

# Course Information

<div style="width:550px">
Instructor | Course
---|---
<i class="fas fa-user"></i> John Paul Helveston | <i class="far fa-calendar"></i> `r settings$weekday`
<i class="fas fa-university"></i> Science & Engineering Hall, Office 2830 | <i class="fa fa-map-marker-alt"></i> [`r settings$room`](`r settings$room_url`)
<i class="fas fa-phone"></i> +1 (202) 994-7173 | <i class="far fa-calendar-alt"></i> `r settings$dates`
<i class="fas fa-envelope"></i> [jpg@gwu.edu](mailto:jph@gwu.edu) | <i class="far fa-clock"></i> `r settings$time`
<i class="fab fa-twitter"></i> [\@JohnHelveston](https://twitter.com/JohnHelveston) | <i class="fab fa-slack"></i> [Slack](`r settings$slack`)
</div>

**Overview of online mode**

- All synchronous class periods will be held online during the designated class time: Tuesdays from 12:45PM - 03:15PM EST.
- All class periods will be recorded and available via the class [slack](`r settings$slack`).
- Students are encouraged to stream or download the recordings for personal use only and are not permitted to post or share the recordings.
- We will hold multiple online study sessions every week.
- All quizzes and exams will be held online during the designated class periods.

# Course Description

```{r child = file.path("child", "description.Rmd")}
```

## Prerequisites

```{r child = file.path("child", "prerequisites.Rmd")}
```

# Learning Objectives

```{r child = file.path("child", "learning-objectives.Rmd")}
```

# Pep Talk!

Learning a programming language can be as challenging as learning a new spoken language. Hadley Wickham - the chief data scientist at RStudio, and author of many amazing R packages you'll be using - [made this wise observation](https://r-posts.com/advice-to-young-and-old-programmers-a-conversation-with-hadley-wickham/):

> It's easy when you start out programming to get really frustrated and think, "Oh it's me, I'm really stupid," or, "I'm not made out to program." But, that is absolutely not the case. Everyone gets frustrated. I still get frustrated occasionally when writing R code. It's just a natural part of programming. So, it happens to everyone and gets less and less over time. Don't blame yourself. Just take a break, do something fun, and then come back and try again later.

If you're finding yourself taking way too long hitting your head against a wall and not understanding, take a break, talk to classmates, ask questions in [slack](`r settings$slack`), e-mail me, etc.

I promise, you can do this.

# Required Texts & Materials

All texts and software for this course is freely available on the web. This includes:

## Software

- R (version 4.0.2 or later), which can be downloaded from [The Comprehensive R Archive Network (CRAN)](https://cloud.r-project.org)
- RStudio (Desktop Version), a free IDE for R, which can be downloaded from [RStudio](https://rstudio.com/products/rstudio/download/)

## Texts / Other Useful Resources

This course does not require any textbooks. All learning materials and resources are freely available on the web. See the course [references page](refereneces.html) for a list of useful resources.

# Assignments

## Homework Assignments

Homework assignments contain a mix of coding exercises and written exercises. They assess the material taught the week(s) they are assigned, and should take several hours to complete. **Start homeworks early**.

Read the [Collaboration Policy](#collaboration-policy) about collaborating with fellow students on homeworks. While most problems must be worked on individually, some will be marked as "collaborative"; on these problems (and _only_ these problems), you may work on code with other students.

Homeworks will be graded based on style (modularity, readability, commenting, etc.) and functionality (correctness on a series of tests). Your code should be properly annotated with comments that are well-placed, concise, and informative. Your assignments will be graded by an automated grader and the instructional team.

## Readings

In addition to weekly homework assignments, students are expected to read through the assigned weekly reading to prepare for the next class. Check the [schedule](schedule.html) for the reading assignments.

## Quizzes

There will be seven quizzes given about once every two weeks immediately at the beginning of class. Quizzes cover material presented in previous classes and assignments during the weeks since the most-recent quiz. Quizzes are **short** (~5 minutes) and are designed to identify areas where additional study is needed. **Quizzes are low-stakes** - your worst one is dropped, and the rest count for just 12% of your final grade. If you do poorly on one, use that as feedback on where you need additional improvement.

> **Why quiz at all?** Research shows that giving small quizzes throughout a class can dramatically help with *retention*. It's a phenomenon known as the "retrieval effect" - basically, you have to _practice_ remembering things, otherwise your brain won't remember them. The phenomenon and research on it is explained in detail in the book ["Make It Stick: The Science of Successful Learning,"](https://www.hup.harvard.edu/catalog.php?isbn=9780674729018) by Brown, Roediger, and McDaniel.

## Exams

There will be one midterm exam covering the first 6 weeks of class, and a standard final exam during the final exam period at the end of the semester covering material from the entire semester. See the [schedule](schedule.html) for details.

# Grading

## Standard Grading

Final grades will be calculated as follows:

<div style="width:500px">
Component                  | Weight | Notes
---------------------------|--------|----------------
Homeworks & Readings (12x) | 55%    | Lowest 1 dropped
Quizzes (7x)               | 15%    | Lowest 2 dropped
Midterm Exam               | 10%    |
Final Exam                 | 20%    |
</div>

Here's a visual breakdown by category:

```{r grade-breakdown, echo=FALSE, fig.height=3, fig.align='left'}
library(viridis)
library(ggrepel)

data.frame(
    category = c(
      'Homeworks & Readings', 'Quizzes', 'Midterm', 'Final'),
    percent = c(55, 15, 10, 20)) %>%
    arrange(desc(percent)) %>%
    mutate(
      cumpercent = cumsum(percent),
      label_y = cumpercent - (percent / 2),
      category = fct_reorder(category, percent)) %>% 
    ggplot() +
    geom_col(
      aes(x = "", y = percent, fill = category),
      width = 1.1, alpha = 0.8) +
    geom_label(
      aes(x = "", y = label_y, label = category)) +
    coord_flip() +
    scale_y_continuous(expand = expansion(mult = c(0, 0.05))) +
    scale_fill_viridis(discrete = TRUE) +
    theme_minimal_vgrid() +
    theme(legend.position = 'none') +
    labs(y = 'Percent of final grade', x = NULL)
```

## AMG Grading

An Alternative Minimum Grading (AMG) policy is available to everybody, but is designed specifically for students who struggle in the first part of the course, and then through sustained hard work and dedication manage to elevate their performance in the latter part of the course to a level that merits passing with a C (even if their Standard Grade might be lower than that).

Student cannot "sign up" for AMG grading. Every student will be considered both for Standard Grading and AMG, and the instructor can choose to assign the AMG grade if a student's effort merits it. To qualify for AMG you must put forth sustained effort, which means meeting the following requirements:

- You attend all class periods (with excused exceptions)
- You complete all assignments
- You do not violate the Collaboration Policy

To compute your AMG score, first use the following to compute your raw score. If the resulting score is higher than a C, set it back to a C.

<div style="width:300px">
Course Component   | Weight
-------------------|----
Best 10 Homeworks  | 40%
Best 4 Quizzes     | 10%
Midterm Exam       | 10%
Final Exam         | 40%
</div>

## Grading Scale

<div style="width:350px">
Grade  | Range       | Grade | Range
-------|-------------|-------|------------
A      | 94 - 100%   | C     | 74 - 76.99%
A-     | 90 - 93.99% | C-    | 70 - 73.99%
B+     | 87 - 89.99% | D+    | 67 - 69.99%
B      | 84 - 86.99% | D     | 64 - 66.99%
B-     | 80 - 83.99% | D-    | 60 - 63.99%
C+     | 77 - 79.99% | F     | < 60%
</div>

The course instructors may choose to change the scales at their discretion. You are guaranteed that your letter grade will never become worse as a result of changing scales.

## Rounding

**I do not round final grades**. Rather, I grade generously throughout the semester. For example, if you give a quiz your best shot and completely fail it, you will likely get a 50% instead of a 0%. The 50% is for trying (if you simply don't take it, you'll get a 0%). As a result, I will not modify or round your final score, even if you're very close to a different letter grade (e.g., a 93.98 is an "A-" and will not be rounded up to an "A").

# Getting Help

This class can be challenging - **do not suffer in silence!** We have lots of ways to get help.

## Slack

All course communication will be managed through [Slack](`r settings$slack`). A link to sign up for the course slack page can be found on the one (and only) announcement on Blackboard.

**You can use Slack to**:

- Ask general questions.
- Ask for help with an assignment.
- Send direct, private messages to each other or the instructors (just like email...but better!)

**Asking for help on Slack**:

You can post questions on slack and receive quick responses. This also enables other students to see answers to common questions. Be specific - if your code has an error you don't understand, **include the code and the error message** in your question.

## Office hours

Scheduling a time to answer questions is hard, so rather than hold regular office hours, you can use [this link](https://jhelvy.appointlet.com/b/professor-helveston) to schedule a zoom call with me most days of the week.

## Tutoring hours

Your class tutors will each hold a dedicated period of time each week for zoom tutoring hours. Please don't make your tutors sit and do emails for two hours - come by and ask for help!

## Library Services

While the University Library is not a stand in for TAs, you can schedule a consultation for general help with Coding, Programming, Data, Statistical, and GIS. See more at https://academiccommons.gwu.edu/writing-research-help

# Course Policies

## [tl;dr](https://whatis.techtarget.com/definition/tldr-TLDR)

- **BE NICE. BE HONEST. DON'T CHEAT.**
- Write your own code - don't look at others' code & don't let others look at your code.
- Homework due dates are "soft"; if you submit an assignment, it will be graded (up until Oct. 20 for homeworks 1-6, and Dec. 8 for homeworks 7-12).

## Late Policy

Due dates are "soft" for homeworks 1-8. Any assignments submitted before March 10 (the midterm) will be graded for full credit.

For homeworks 9-12, the late policy is as follows:

- Any homeworks submitted by 6am on the due date will be graded for full credit.
- Homeworks submitted by 6am on the following Monday (3 days late) for up to 50% credit.
- Homeworks submitted more than 3 days past the due date will not be graded (i.e. a 0).

## Collaboration Policy

<!-- This policy is mostly copied from the course 15-112 at Carnegie Mellon University -->

Learning how to program is like learning how to ride a bicycle - to get better, you must practice writing code **yourself**. Therefore, we have a set of strict rules regarding what kind of collaboration is allowed, what counts as over-collaboration, and what counts as cheating.

### Good Collaboration

- Discussing which general concepts might be useful in solving a problem (conditionals, loops, etc.).
- Asking for debugging help with code.
- Sketch out algorithms on a whiteboard together.
- To avoid copying the code, you should write up the solution together, discuss it, then erase the solution, wait a few minutes, and write up solutions individually.
- Help each other debug specific parts of assignment code.
- General discussion of course concepts.
- Detailed explanations of example code on the course website.
- Collaboratively solving a practice problem, with any level of co-writing code and co-debugging.

### Over-collaboration

Over-collaboration results in a warning on the first offense, and a penalty on later offenses. Examples include:

- Explaining to a friend how to solve a problem in high-level terms by going through your own program line-by-line.
- Helping a friend debug code by suggesting they use your own approach to the problem.
- Collaborating with a student on an assignment and then _not_ including their name as a collaborator in the assignment writeup.
- In the case that you have taken this course before, copying your own code from the previous time you took the course.

### Cheating

Cheating results in a penalty on the first offense, and failing the course on the second offense. Cheating on assignments can include:

- Copying or stealing any amount of code from someone currently in the class or someone who has taken the class before.
- NOTE: Copying is never okay, whether the code is provided electronically, visually, audibly, or on paper.
- Providing code you have written for an assignment to anyone else in the class.
- Finding code online and using it in the assignment. One exception: you may use code from the course website.
- Putting code solutions from the course assignments online.
- Receiving code-level assistance from any person not associated with the course.
- Getting someone else to write the assignment code for you.
- Asking questions about the assignments on any online services outside of the course office hours / [slack](`r settings$slack`).

Cheating on quizzes, assignments, or the final project can include:

- Referring to any external resources while completing the assignment (phones, notes, etc.).
- Copying part of an answer off of another student's paper, even if it is very small.
- Using solutions provided by students who previously took the course.

### Penalties

Penalties are decided by the course instructors, and can vary based on the severity of the offense. Possible penalties include:

- Receiving a 0 on the assignment/quiz in question.
- Receiving a -100 on the assignment/quiz in question.
- Receiving a full letter grade deduction in the course.
- Automatically failing the course.

Penalties may also be accompanied by a letter to the Dean of Student Affairs, again at the instructors' discretion. This can lead to university-level penalties, such as being suspended or expelled.

### Plagiarism Detection

Programs are naturally structured, which makes them **very easy** to compare for plagiarism. Automated plagiarism detection systems make this process even easier. [Watch this video](http://www.kosbie.net/cmu/spring-13/15-112/automated-plagiarism-detector-demo.mp4) showing plagiarism detection software in action (this example is using Python code, but this also works for R code).

**In short, if you copy code, we will know - don't copy code!**

### Grace Period

College is a time when you do a lot of learning. Sometimes, you might make bad decisions or mistakes. The most important thing for you to do is to learn from your mistakes, to constantly grow, and become a better person.

Sometimes, students panic and copy code right before the deadline, then regret what they did afterwards. Therefore, you may rescind any homework submission for up to 24 hours after the deadline with no questions asked. Simply email the course instructors asking to delete the submission in question, and we will do so. Deleted submissions will not be considered during plagiarism detection, though of course they will also not be graded. However, it will always be better to get a 0 (or partial credit) on an assignment than to get a cheating violation!

## Lauren's Promise

<!-- Policy copied from Andrew Heiss's class -->
<!-- https://evalsp20.classes.andrewheiss.com/syllabus/ -->

**I will listen and believe you if someone is threatening you.**

Lauren McCluskey, a 21-year-old honors student athlete, [was murdered on October 22, 2018 by a man she briefly dated on the University of Utah campus](https://www.sltrib.com/opinion/commentary/2019/02/10/commentary-failing-lauren/). If you are in immediate danger, call 911 or GWU police at 202-994-6111 (GWPD). If you are experiencing sexual assault, domestic violence, or stalking, if you report it to me I will listen and connect you to resources or call GWU's [Counseling and Psychological Services](https://healthcenter.gwu.edu/counseling-and-psychological-services) (202-994-5300).

Any form of sexual harassment or violence will not be excused or tolerated at GWU. GWU has instituted procedures to respond to violations of these laws and standards, programs aimed at the prevention of such conduct, and intervention on behalf of the victims. GWU Police officers will treat victims of sexual assault, domestic violence, and stalking with respect and dignity. Advocates on campus and in the community can help with victims' physical and emotional health, reporting options, and academic concerns.

## Use of Course Materials

All course materials available on the course website are developed open source - you are welcome to post and share them following the licensing guidelines listed in the [license](LICENSE.html) page.

However, all **solutions** to assignments and quizzes are proprietary. Don't post them online or try to sell them - this would violate the GWU [student code of conduct](https://studentconduct.gwu.edu/code-student-conduct).

Students are encouraged to use electronic course materials, including recorded class sessions, for private personal use in connection with their academic program of study. Electronic course materials and recorded class sessions should not be shared or used for non-course related purposes unless express permission has been granted by the instructor. Students who impermissibly share any electronic course materials are subject to discipline under the Student Code of Conduct. Please contact the instructor if you have questions regarding what constitutes permissible or impermissible use of electronic course materials and/or recorded class sessions. Please contact [Disability Support Services](https://disabilitysupport.gwu.edu/) if you have questions or need assistance in accessing electronic course materials.

## What To Do if the Instructor Does Not Arrive

Wait **20 minutes**, after that you're free to leave. One member of the class should be selected to notify the EMSE Department of the Instructor's absence by calling the EMSE Department 202-994-4892 on next business day.

# University Policies

## University Policy on Religious Holidays

In accordance with University Policy, students should notify faculty during the first week of the semester of their intention to be absent from class on their day(s) of religious observance. Official university policy here: https://students.gwu.edu/accommodations-religious-holidays

- Students should notify faculty during the first week of the semester of their intention to be absent from class on their day(s) of religious observance.
- Faculty should extend to these students the courtesy of absence without penalty on such occasions, including permission to make up examinations.
- Faculty who intend to observe a religious holiday should arrange at the beginning of the semester to reschedule missed classes or to make other provisions for their course-related activities.

## Support for Students Outside the Classroom

**Disability Support Services (DSS)**:
Any student who may need an accommodation based on the potential impact of a disability should contact the Disability Support Services office at 202-994-8250 in the Rome Hall, Suite 102, to establish eligibility and to coordinate reasonable accommodations. For additional information please refer to: https://disabilitysupport.gwu.edu/

**Mental Health Services (202-994-5300)**:
The University's Mental Health Services offers 24/7 assistance and referral to address students' personal, social, career, and study skills problems. Services for students include: crisis and emergency mental health consultations confidential assessment, counseling services (individual and small group), and referrals. https://healthcenter.gwu.edu/counseling-and-psychological-services

## Academic Integrity Code

Academic dishonesty is defined as cheating of any kind, including misrepresenting one's own work, taking credit for the work of others without crediting them and without appropriate authorization, and the fabrication of information. For the remainder of the code, see: https://studentconduct.gwu.edu/code-academic-integrity

In addition to the formal code of academic integrity, the instructor expects that students will treat this course with the level of professionalism required in the workplace. Remember that real firms are sponsoring student projects throughout the semester; in a workplace setting, these firms would be paying clients for the analyses being conducted. This course prepares students to succeed in the workplace, and maintaining a high degree of professionalism is expected.

# Cute Animals

<div class = "row">

<div class = "col-md-4">
<img src="images/cute_penguin.gif">
</div>

<div class = "col-md-8">

Once you have read this entire syllabus and viewed the [course schedule](schedule.html), please send me a _cute_ picture of your favorite animal in a direct message on [slack](`r settings$slack`).

For real.

Brownie points if it's animated.

</div>
</div>

---

**Page sources**:

Some content on this page is inspired by and / or modified from other sources:

- The "Pep Talk" and "Cute Animals" sections are inspired by [Andrew Heiss's courses](https://www.andrewheiss.com/teaching/).
- The collaboration policy is mostly copied from the course [15-112](http://www.kosbie.net/cmu/fall-19/15-112/) at Carnegie Mellon University