Data for your capstone project

Author
Affiliation

Lars Schöbitz

ETH Zurich

Step 1: Create a new repository on GitHub & clone to Posit Cloud

  1. Open the GitHub Organisation for the course
  2. To right of the field “Find a repository”, click on the green “New” button.

  1. In the “Repository name” field write project-username. Replace username with your GitHub username. Avoid using spaces. For example: project-rainbow-train for the user with the username rainbow-train

  1. Scroll down on the same page, and click “Create repository”.

  1. In the “Quick setup” field, click on the clipboard next to the HTTPs URL

  1. Open the ds4owd workspace on posit.cloud
  2. Click New Project > New Project from Git Repository
  3. Paste the HTTPS URL from GitHub into the “URL of your Git Repository” field.
  4. Wait until the project is deployed.

Step 2: Create new folders

  1. Navigate to the Files tab in the bottom right window of RStudio.
  2. Click on the “Folder” button.

  1. Enter the name “data” in field and click OK.

  1. Click on the new data folder in the bottom right window.

  1. Click on the “Folder” button.

  1. Enter the name “raw” in field and click OK.

  1. Click on the new raw folder in the bottom right window.

Step 3: Upload the data

Pre-requisite: Module 4 Data Assessment

Before uploading your data, you must have completed Module 4 Assignment 1: Identify and assess data for your capstone project. This assignment helps you select a suitable dataset and assess it for privacy concerns.

If you haven’t completed Module 4 Assignment 1 yet:

  • Complete the Module 4 data assessment first
  • Your dataset should be suitable for public sharing (CSV, Excel, or JSON format)
  • It should not contain personal identifiers, GPS coordinates, or sensitive information unless properly anonymized
  • Use the GitHub issue tracker in your md-04-assignments-USERNAME repository to discuss your dataset with instructors

If you’re still finalizing your dataset selection:

You can skip this step for now and continue with Steps 4-6. You must complete Steps 4-6 even without having uploaded your data. Return to upload your data once it’s ready, and push the updated files to GitHub. To fully complete this homework assignment, you will eventually need to upload your data.

  1. Use the Files tab in the bottom right window to upload your selected dataset into the raw folder.

  1. Choose the file from the place you have saved it on your computer.

Step 4: Describe your data and goals

  1. Navigate back to the root of your project folder by a click on the blue R cube.

  1. Create a new folder “docs” in the root of your project folder.

  1. Click on the docs folder

  1. Create a new Quarto document and save it as index.qmd inside the docs folder.

  1. In the index.qmd file, write a short description of your analysis goals and the data you have uploaded.

  1. Add a code chunk and write library(tidyverse) to load the R packages you have learned to work with.
```{r}
library(tidyverse)
```
  1. Import your data by writing the following inside another code chunk (in this example we are using a CSV file):
read_csv(here::here("data/raw/your-file-name.csv"))
The here R package

We recommend using the here R package to refer to files in your project. The here R package helps with finding the correct file path to your data. We will discuss file paths and the package itself in another module.

Step 5: Commit and push your changes

  1. Navigate to the Git pane in the top-right window of RStudio
  2. Check the box next to all files to stage them for a commit
  3. Click on the “Commit” button
  4. Enter a commit message in the “Commit message” field
  5. Click on the “Commit” button
  6. Click on the “Push” button
  7. Enter your GitHub username and GitHub Personal Access Token (PAT) in the “Username” and “Password” fields
Do not use your GitHub password

You need to enter the GitHub Personal Access Token (PAT) you created in an earlier module to push your changes back to GitHub.

Step 6: Open an issue on GitHub

  1. Open github.com in your browser.
  2. Navigate to the GitHub organisation for the course.
  3. Find the repository project- that ends with your GitHub username.
  4. Click on the “Issues” tab.
  5. Click on the green “New issue” button.
  6. In the “Title” field write: “Identify project data and describe analysis goals.”.
  7. In the “Leave a comment” field, tag the course instructors @seawaR @massarin @larnsce
  8. Scroll down the page and click the green Create button.