Added some comments
Some corrections found while making comments
added in a measure of crowding

also noted that both measures here are placeholders, and do not produce the right values