finished functions part of vignette