added annotated notebook