documents functions in core.pyx
update roundtrip for the new TRANSPOSED logic.

the numpy array indices are in correct order.