General updates in code and comments

- renamed soft calibration function to 'run_softcal_waterbalance'
- add function description
- minor edit in parameter definition
- change '=' to '<-', to match code style guide
- Update some comments in code