t-davidson / LabResources

LabResources

This repo hosts resources for lab sessions, including all assignment Jupyter notebooks. Clone the repo to a location you'll maintain throughout the course (not inside other course org repos, e.g., not inside your local copy of your course personal repo, named according to your GitHub username). You'll only need to clone this repo once. Afterward, running git pull at the start of each lab session (in a terminal opened to work in your local LabResources folder) will update your local copy of the repo to contain the latest lab content, including the latest assignment.

Assignments will typically be provided as a Jupyter notebook named AssignmentXX.ipynb (where XX is a number) that provides explanatory information along with problem descriptions, and a solutions template, SolutionsXX,ipynb, that contains only the problem descriptions. You should edit a copy of the solutions template (in your own course GitHub org repo) to complete the assignment, as described below.

Assignment submission

Please follow these instructions to work on your assignment solutions and submit them via GitHub. "Your personal repo" here refers to the repo you used to submit the Assignment01 README.md file—the repo named according to your GitHub username.

1. Create a folder in your personal repo named for the assignment, AssignmentXX.

2. After cloning or pulling the latest LabResources repo content, copy the SolutionsXX.ipynb template into the assignment folder in your personal repo. If the assignment uses other resources (e.g., Python modules or data files), copy those as well.

3. Work on the assignment in your repo. For each working session:

   • Open a terminal session with the assignment folder in your repo as the working directory.
   • Activate the bda18 conda environment.
   • Launch the Jupyter notebook server with the command: jupyter noteboook. This should open a tab in your default web browser with the Jupyter notebook interface, displaying content in your local assignment folder.
   • Edit the SolutionsXX.ipynb notebook with your solutions in new cells created below each problem. Feel free to add and commit intermediate stages of your work as often as you like, and to push intermediate stages back to GitHub if you wish.

4. When you are done working on the assignment, be sure to add and commit your final solutions (and any other resources you may have had to edit or create) in your local repo.

5. Push your repo back to the course org using: git push

6. Visit the course org on GitHub to make sure your content was pushed. You won't be able to view the rendered notebook there, but you'll be able to see when the content in the relevant assignment folder in your repo was last updated.