add tutorial for using the system class

various other changes