documentation and example for Frequency