Updated documentation
Aded a new sampling API method