added some doc strings which probably need to be reformatted