Add documentation for all missing methods and logical calculations

[srimanachanta]

Currently, some complex math and methods are missing Javadocs, which might lead to code misuse. All these methods and code needs documentation.