Issue172 add contact simplify de serialization

Closes #172.
Please merge first PR #171.
Please document this method with Javadoc. The main reason this is useful is because of the semantics in the return values.