major update including vignette and plotIAI