singular values for sample are supported now
improve documentation