added description of input requirements to module-level docstring