prototype for the top-level driver code for the scorecards