ported benchmarks and examples back to v1

extract this function from setup()
add a method comment
type the parameters