Clean up variable naming
add use cases
Mostly cosmetic adding docstrings, cleaning up variable names, etc...