Getting course material

Short version:

1. Install git on linux/Mac or the github tool on Windows
2. Clone the cbs-python repository at github
3. Link your Ipython Notebook to this folder

Lecture Notes

During the course I will be using notebooks for lecture notes. A preview is shown below. The idea is that you can get these lecture notes and you can make your own notes on top of them if you want using IPython Notebook. The instructions for setting up IPython will follow in the first lecture.

Exercises

Some exercises will also be made in notebooks with explaining text and figures encapsulating code blocks that are either partially filled out or empty. The exercise will be for you to fill out these code blocks for the problems to be solved. Some exercises will involve loading data from files that should be put in the correct directories relative to the exercises. Because this is a pilot course still under development, some of the exercise material will be made available during the semester.

Getting the latest versions of lecture notes and exercises

Since the course is still under development lecture notes and exercises are expected to be updated during the semester. To avoid any problems with missing data files or outdated notes I have set up a github repository, which is nothing more than a online folder that you can syncronize to. This way you start each lecture with updating your local files with any changes that might have been made.

To do all this as painless as possible we should start out by setting everything up for the rest of the course.

Installing git

This guide include instructions for

• Mac
• Linux
• Windows

Go to the section that covers your system.

MAC

All you need is git. Go to http://git-scm.com/download/mac and downlaod the dmg installation file. Once downloaded, open it and open the git installer inside. Follow the instructions for installing git.

Once installed open a terminal and navigate to the document folder where you want the course material to be downloaded, eg.

cd /Users/christian/Documents/courses/

now clone the cbs-python github

git clone https://github.com/skjoedt/cbs-python.git

If things worked out as expected you should have a folder called cbs-python from where you called the git clone command. This folder will store all course materials and exercises as they are updated during the semester.

Updating your local files

Before each lectures you should update the files to the newest versions. This is done by simply running

git checkout -f master

and

git pull origin master

from the cbs-python directory.

Linux

All you need is git. If you are running ubuntu or debian you get it by typing

sudo apt-get install git

if you are running fedora you can type

sudo yum install git

Now you need to choose a directory to store the course materials, eg /home/christian/Documents/courses/. Navigate to the folder:

cd /home/christian/Documents/courses

now clone the cbs-python github

git clone https://github.com/skjoedt/cbs-python.git

If things worked out as expected you should have a folder called cbs-python from where you called the git clone command. This folder will store all course materials and exercises as they are updated during the semester.

Updating your local files

Before each lectures you should update the files to the newest versions. This is done by simply running

git checkout -f master

and

git pull origin master

from the cbs-python directory.

Windows

Windows users should download and install the github tool from http://windows.github.com/. Go to the link and click the green download link in the upper right corner.

After the download is complete open the installer and follow the instructions on the screen until you see this window.

Now that the github tool is installed open the Git Shell icon on your desktop.

In the terminal window type in:

git clone https://github.com/skjoedt/cbs-python.git

You should now have a folder in your Documents called GitHub. Inside you will find the repository with the course material.

Updating the local files

To update the local files open the github shell and navigate to the cbs-python directory:

cd cbs-python

Now run these two commands to update your local files:

git checkout -f master
and
git pull origin master