adding samples

simple functions, adding usage samples.