add wrapper for correlation.coerce() for multiple valid combination conditions

add method documentation
version bump