improve api inline docs
add simple interface to get all numerics from a source