Description

The purpose of this assignment is to make sure you have the tools we need you to use for the rest of the class, notably, python, Jupyter notebooks, git/Github, and the core data science modules. The lectures and sections will include a git/Github tutorial and support for getting everything installed.

Tasks / Learning Goals

– Get set up with the required tools (python, Jupyter, and git/Github).
– Software distribution and version control with git.
– Python practice, and get used to the assignment procedures.

Submitting Assignments

You will submit a Jupyter notebook file (.ipynb) to TritonED. Make sure that the file you submit has the following filename, filled in with your unique course ID, where ‘$####’ is the first letter of your last name, followed by the last 4 numbers of your student ID: ‘A1_$####.ipynb’

Grading Rubric

This assignment is worth 12% of your grade (12 points).

There are 2 parts to this assignment, with the following point values:

Part 1: git and Github 6 points
Part 2: Python practice 6 points

Questions have points as specified in the detailed instructions. Make sure all the specified repos and files that you make on Github are public, and that you type your Github username in properly. Automated procedures will be used to check that these repos exist, that the Pull Request was received, and that the submitted Jupyter notebook runs as expected. Note that this assignment is effectively Pass/Fail – as long as you complete all parts, you will receive full points.

Detailed Instructions

Part 0:

1) Read the sections overview (0-Documentation.pdf)

Part 1 (6 points):

1) If you do not already have one, create a Github account.
a) Follow instructions here: https://github.com/ 2) Clone the class repositories.
a) Go to the class organization: https://github.com/COGS108
b) Clone ‘Assignments’, ‘Tutorials’
3) Make a repository on your Github called ‘COGS108_Repo’.
a) Make sure this repository is public.
4) Add a README and a .gitignore to ‘COGS108_Repo’.
a) These can contain anything you want.
5) Make a Pull Request.
a) Fork the COGS108 repo called ‘MyFirstPullRequest’ to your Github account.
i) Go to the COGS108/MyFirstPullRequest on Github. On the top right of the page, click on the ‘Fork’ button and click through to Fork the repository to your Github account.
b) Clone that fork on your computer.
i) On SourceTree, click + New Repository, Clone from URL
c) You are going to add a txt file with a unique identifier, made up of the First Letter of your last name + the last 4 digits of your Student ID. For example, John Smith – A12345678 should submit ‘S5678.txt’. The contents of this file do no matter (it can be empty). Add this file to your cloned repository (the folder on your computer).
d) Push these updates to the cloned repo, on your Github account.
i) SourceTree should notice the updates. Commit them, then Push.
e) Go to Github.com, to ‘/YourAcct/MyFirstPullRequest’ where you should now see your txt file. Create a Pull-Request
i) Click on ‘New Pull Request’
ii) Click on ‘Create Pull Request’ (in green)
iii) Replace the commit message with the same identifier (ex – ‘S5678’) iv) Click ‘Create Pull Request. You’re done!

Part 2 (6 points):

1) Make sure you have a working install of python, and Jupyter notebooks, and have pulled the Assignments folder from the COGS108 Github account.
a) Follow instructions in the ‘00-Introduction’ notebook from the course tutorials on Github to install anything you are missing.
2) Make sure you write in your student ID, course ID, and Github username to the A1 notebook, as specified.
3) Follow the instructions in the notebook to complete the python questions. You will need to write code, directly in the notebook, to answer the python questions.