clarified cis documentation, add vectorized version, and add tests