added some comments to km model