Project 0: Introduction

Published

May 1, 2020

Walkthrough

Background

Note

We will complete six projects during the semester that each take about two weeks (four days of class). On average, a student will spend 2 hours outside of class per hour in class to complete the assigned readings, submit any Canvas items, and complete the project (for a total of 8 hours per project). The instruction for each project will be structured into sections as written on this page.

This first Background section provides context for the project. Make sure you read the background carefully to see the big picture needs and purpose of the project.

Python and VS Code are tools commonly used in the field of data science. During our first two days of class we will get VS Code prepped for data science programming. Completing Project 0 will set you up for success the rest of the semester.

Data

Note

Every data science project should start with data, and our class projects are no different. Each project will have ‘Download’ and ‘Information’ links like the ones below.

URL: penguins data

penguins = load_penguins()
penguins

Readings

Note

The Readings section will contain links to reading assignments that are required for each project, as well as optional references. Remember that you are reading this material to build skills. Take the time to comprehend the readings and the skills contained within.

We recommend reading through the assigned material once for a general understanding before the first day of each project. You will reread and reference the material multiple times as you complete the project.

The readings listed below are required for the first two days of class.

Optional References

Questions and Tasks

Note

This section lists the questions and tasks that need to be completed for the project. Your work on the project must be compiled into a report, rendered to a HTML file and uploaded in Canvas.

  1. Download this Project0 Template template as has working code for the Penguine data set. You need to finish the project by updating its markdown so that it is a report by completing the following tasks:
    1. Include the tables created from PY4DS: CH2 Data Visualization used to create the above chart
    2. Recreate the example charts from PY4DS: CH2 Data Visualization of the textbook.
    3. Follow the instructions in the submission section below to submit your work

Submission:

Note

When you have completed the report, you will need to follow this process to submit your work:

  1. Have the P0_template open in VS Code and nothing else
  2. Click Preview Button in VS Code in the top right of the screen
    1. This will render the project but also entire course work portfolio into HTML files for review
    2. Confirm everything displas as you would like it to
    3. How you see it will be how it is viewed for grading
    4. If there is an error in any cell of the quarto files, the rendering will stop and you will need to fix the error before rendering again (if you get stuck post your error in Slack)
  3. Once the report is confirmed close the preview and open a VS Code Terminal
    1. click Terminal in the top menu bar and then New Terminal
  4. Type the following in the terminal quarto render
    1. Then drag and drop P0_template.qmd into the terminal this will add the file path to the terminal command
    2. Press Enter
  5. This will render the project into a HTML file in the same location as the .qmd file
  6. To locate the file in VS Code
    1. Right click on the file in the file explorer and select Reveal in File Explorer(Win) or Reveal in Finder(Mac)
  7. Upload HTML file into Canvas

Deliverables:

Note

Deliverables are “the quantifiable goods or services that must be provided upon the completion of a project”. In this class the deliverable for each project is a GitHub published report created using Quarto files. This final section will be the same for each project.

Use this P0_template to submit your Client Report.

  1. The template should include answers to the questions | tasks. Each should include a written description of your results, code cells with comments, charts and/or tables.
  2. Write short summary of work must be submitted in the comments in Canvas wwhen you submit the URL. Rate your own work on a scale of 1-5 (See the Rubric for Details) Include a short description of why you rated your work the way you did.
Note

Your report should be written in quarto markdown files and rendered to an HTML File. Upload the HTML file in Canvas. (Do not submit the .qmd file)

Feedback:

Note

If you submit before the due date, you will recieve feedback and/or coaching notes. You will need to address the feedback, re-render and resubmit the project.

Resubmission:

Note

If you submit before the due date, you will have one opportunity to resubmit the project after you have received feedback. The window for the resubmission will be open through the Wednesday following the due date of the project.

Back to top