Class GitHub Repository

All of the files that you may need to access for this class will be pushed to the GitHub repository amath584a2016.

Git is a version control system that you might want to use for your own work. You are encouraged to do so! If so, there’s a list of some useful resources at the bottom of this page.

But for the purpose of this class it will primarily be used as an easy way to distribute materials, and you don’t necessarily need to know much more than what’s on this page to use it.

If you are Using SageMathCloud, Git is installed on all your projects automatically and so you should be able to clone the repository with the command below.

If you’re not familiar with Git and/or do not have it installed on your laptop, see Set Up Git on GitHub. Note that GitHub is being used to host the public class repository, but you do not need a GitHub account to clone the repository.

However, you do need Git installed for the commands below to work!

To clone this repository:

git clone https://github.com/rjleveque/amath584a2016.git

This will create a directory amath584a2016.

AM584 environment variable

I suggest you define an environment variable AM584 that points to this repository, e.g. in the bash shell:

export AM584=/full/path/to/amath584a2016

You can put this command in the file ~/.bashrc if you want it to be executed every time you open a new shell.

Then you can do, e.g.

cd $AM584

to change directories to the class repository.

Below and elsewhere in these notes, $AM584 will be used to refer to the full path to the class repository.

To update

If new files have been added to the class repository, you can get them by doing:

cd $AM584
git pull

Your copy of these files

To avoid having to worry about conflicts if you change a file and the same file changes in the repository, I suggest that you never modify the files in this directory. Instead, create another directory for doing your own work, e.g.

cd
mkdir my584
export MY584=/full/path/to/my584

Then copy any files you need to this directory before working with them, e.g.

cp -r $AM584/homeworks/hw0  $MY584/

will recursively copy the directory hw0 to create a new directory $MY584/hw0.

Then modify the files in the new hw0 directory.

Other git references

For this class you don’t need to know more than what’s explained above, but I encourage you to start using it for version control as well.

There are many tutorials and other sources of information available for Git. In particular, see: