updated vignette and bibliography