add function description
more explanations
clean pfaffian2; fix and error in comment