new graph tool
improved comments and cleanup to new format shim