added a few utilities and notes