Cleanup code

[matzipan]

• Use pass by reference
• Add set as properties on the algorithm object instead of runtime parameter passing
• Document and answer all the TODOs
• Cleanup particle class