This docstring is looking really great. What confuses me a little bit is this abbreviation, log-**PDF**. It might help to expand it at least once in the comment.