All indices are signed integers now

- specifies the exact length of the indices in misc/types.hpp
- makes all indices signed integers
- minor documentation improvements
- added hdf5 requirement to cmake