update vignette and stability to allow different number of models