add comments for harmonics methods