Mathematics Clinic Mathematics Clinic Handbook 2019 Copyright © 2019 Department of Mathematics, Harvey Mudd College. This material is provided for the sole use of participants in Harvey Mudd College’s Mathematics Clinic program. Any other usage requires prior permission from the Department. 2019 Edition; Revision 1.0. (April 30, 2019) Calendar Note that dates and deadlines are subject to change. Date Description Page September 4 (Tue) Student Orientation Day (4:15 p.m.–5:30 p.m.; 5 Sprague 3) September 4 (Tue) Project Managers Meeting (5:30 p.m.–6:30 p.m. in Sprague 3) September 6–18 Marathon Push (Including Preparation of Your 8 Statement of Work) September 6 (Thu) Clinic/Sponsor Orientation Day (11:00 a.m.– 6 1:00 p.m.; Sprague 3 workrooms) Be prepared to ask your liaisons questions. September 7 (Fri) All Forms Due by 4:00 p.m. to Molly Reeves 5 (SCTL 2404) September Site Visits with Sponsor (Arranged by Teams and 9 Sponsors) September 11 (Tue) Professional Development: Teleconference and 10 Site Visit Etiquette (11:00–12:15 p.m.; Galileo McAlister; Combined with CS) September 18 (Tue) Statement of Work Peer Review (11:00–12:15 p.m.; 8 Sprague 3) Bring Advisor-Previewed Draft. September 18 (Tue) Project Managers Meeting (11:00–12:15 p.m.; Sprague 3) September 20 (Thu) Engineering Career Fair September 21 (Fri) Peer Reviews of Statement of Work Due to Team 8 September 24 (Mon) Advisor-Previewed Project Budget Due to Clinic 53 Director September 25 (Tue) Review Statement of Work According to Slides 10 on Project Management & Planning Sent by Weiqing Gu (11:00–12:15 p.m.; Sprague 3) September 28 (Fri) Advisor-Previewed Statement of Work Due to 8 Clinic Director October Statement of Work Negotiations and Approval 8 from Liaison October 9 (Tue) Project Managers Meeting (11:00 a.m.–12:15 p.m.; Sprague 3) October 11 (Thu) STEM Career Fair October 22–23 Fall Break continued on following page Date Description Page October 30 (Tue) Learn About and Discuss Effective Presentations 10 & Posters Using Slides Sent by Weiqing Gu November 13 (Tue) Project Managers Meeting (11:00–12:15 p.m.; Sprague 3) November 20 (Tue) Informal Practice Presentations and Lunch 9 (11:00 a.m.–1:00 p.m.; Sprague 3) November 21–23 Thanksgiving Break November 28 (Wed) Advisor-Previewed Midyear Report Draft Due to 10 Clinic Director December 14 (Fri) Final Version of Midyear Report Due to Clinic 10 Director and Coordinator (by 4:00 p.m.) December 14 (Fri) Individual and Team Self-Evaluation Due to Clinic 13 Coordinator (by 4:00 p.m.) December 22–January 20 Winter Break January 24–January 28 Workrooms Used for Mathematics Contest in Mod- 10 eling January 29 (Tentative) Formal Presentations for Spring Semester Begin 9 (All Clinics—Attendance Is Mandatory) TBD Spring Career Fair March 18–22 Spring Break April Site Visits with Sponsor (Arranged by Teams and 9 Sponsors) April 5 (Fri) Advisor-Previewed Poster Draft Due to Clinic Di- 11 rector and Clinic Coordinator by 4:00 p.m. April 15 (Mon) Draft of Final Report Due to Advisor 11 April 16 (Tue) Liaison-Approved Final Poster Completed and 11 Submitted for Printing to Molly Reeves and Dru- Ann Thomas by 4:00 p.m. April 24 (Wed) Advisor-Previewed Draft of Final Report Due to 11 Clinic Director April 26 (Fri) Individual and Team Self-Evaluation Due to 13 Clinic Coordinator and cc’d to Clinic Director (by 4:00 PM) May 3 (Fri) Poster session on Alumni Weekend (1:30 p.m.– 11 2:30 p.m.; Shanahan 3481) Posters need to be hung by 1:20 p.m. May 7 (Tue) Projects Day and Formal Dinner with Liaisons 11 continued on following page Date Description Page May 10 (Fri) Final Report Due to Advisor and Clinic Director 11, 94 May 10 (Fri) Printed Final Reports and cd-roms Turned In and 93, 94, 94, 95, Closing Checklist Completed and Delivered to 98 DruAnn Thomas; E-Mail PDF of Report to DruAnn Thomas (by 4:00 p.m.) May 10 (Fri) Final Work Products Archived Electronically (Re- 11, 95, 97 port to Molly Reeves) May 10 (Fri) Senior Dinner (Clinic & Thesis) May 10 (Fri) - Final Report due; Archive and submit all work products Deliver printed Final Report and a hard-drive with all the clinic team’s work (just zip all clinic related files and save onto the hard drive) including data, weekly conference call slides, meeting notes if any, code, other methods tried, all .tex files with figures, references etc. that generate the .pdf files for midterm, final reports, conference slides, and posters. (Note: the other methods are those the students tried but may not work, however, not working results are also results since the next clinic team does not have to retry it again.) The team will also prepare a thumb drive for the final working results and corresponding code, final report and poster including the .tex files for liaison(s) together with a read-me or a diagram to explain the files included. Contact Information Computing Help Contact the department’s information technology analyst at [email protected]. People Name Office Extension E-Mail Address Weiqing Gu, Director SCTL 3420 18929/18570 [email protected] DruAnn Thomas, Clinic Coordinator Olin 1257 18570 [email protected] Lisette de Pillis, Chair SCTL 3410 18975/18023 [email protected] Jocelyn Olds-McSpadden, Math Ad- SCTL 3428 18023 [email protected] ministrative Aide Molly Reeves, Information Technol- SCTL 2404 18754 [email protected] ogy Analyst A/V Support (CIS) Sprague 5 77777 [email protected] Facilities Name Room Number Notes Sprague Third Floor† π (east) Conference phone: (909) 607-4665 e (west) Conference phone: (909) 607-4685 Clinic 1 Computers; conference phone: (909) 607-3219 Clinic 2 Computers; conference phone: (909) 607-8419 Clinic 3 Computers; conference phone: (909) 607-8409 Math Workroom SCTL 3433 Networked copier; color laser printer; fax machine: (909) 621-8366 † Requires card-key access through F&M; see DruAnn Thomas for access. Websites Website URL Mathematics Clinic https://www.math.hmc.edu/clinic/ Clinic Participants https://www.math.hmc.edu/clinic/participants/ Clinic Forms https://www.math.hmc.edu/clinic/participants/forms/ Math Computing https://www.math.hmc.edu/computing/ Clinic LATEX Class https://www.math.hmc.edu/computing/support/tex/classes/hmcclinic/ hmcmath BibTEX Style https://www.math.hmc.edu/computing/support/tex/bibliography-styles/ Sample Clinic Report https://www.math.hmc.edu/computing/support/tex/sample-report/ Clinic Calendar on Google https://www.math.hmc.edu/clinic/participants/calendar/ Contents Acknowledgments xix 1 The Clinic Program 1 1.1 Teamwork . .1 1.1.1 Project Management . .2 1.1.2 Your Faculty Advisor . .3 1.1.3 The Clinic Director . .3 1.1.4 Your Sponsor’s Liaison . .3 1.2 Clinic Problems . .4 1.3 History . .4 2 Project Events and Milestones 5 2.1 Orientation . .5 2.2 Assembling and Negotiating the Statement of Work . .7 2.3 Sponsor Site Visits . .9 2.4 Presentations . .9 2.5 Workshops . 10 2.6 Your Midyear Report . 10 2.7 A Break: Lab Priority Given to the Mathematics Contest in Modeling . 10 2.8 Wrapping It All Up: Projects Day and Beyond . 11 2.8.1 Final Report . 11 2.8.2 Poster . 12 2.8.3 Projects Day Presentations . 12 2.8.4 Archiving Work Products . 13 2.9 Self and Peer Evaluations . 13 2.10 Redefining Success . 13 viii Contents 3 Computing Resources 15 3.1 Computing Support . 15 3.2 Accounts . 15 3.3 Clinic Lab Systems . 16 3.3.1 Operating Systems and Software . 16 3.4 Shared Machines . 17 3.5 Printers . 18 3.6 Storage (Disk) Space and Backups . 18 3.6.1 The “/home/clinic” Directory . 18 3.6.2 Home Directories . 18 3.6.3 Backups . 19 3.7 Electronic Mail . 19 3.7.1 Clinic Mailing Lists . 19 3.7.2 Other Mailing Lists . 20 3.8 Github Repositories . 21 3.9 Other Off-Campus Computing Resources . 21 3.10 Additional Equipment, Software, or Other Resources . 22 3.10.1 Use of Purchased Hardware or Software . 22 3.10.1.1 Sponsor-Supplied or Hosted Software . 23 3.10.1.2 Sponsor-Supplied or Hosted Hardware . 23 4 Doing the Work 25 4.1 Meetings . 25 4.1.1 Class Meeting . 25 4.1.2 Team Meetings . 26 4.1.3 Project Manager Meetings . 26 4.2 Work Sessions . 26 4.3 Sharing Your Schedules . 27 4.4 Medical Conditions . 27 4.5 Recording and Communicating Your Work . 27 4.5.1 Work Journal or Research Notebook . 28 4.5.2 Electronic Mailing Lists . 28 4.5.3 Liaison Teleconferences . 28 4.5.4 Personal Telephones . 28 4.5.5 Other Communications Tools . 29 4.6 Working Together . 29 4.7 Library Resources . 29 4.8 Using Version Control . 30 4.8.1 Git Resources . 31 Contents ix 4.8.2 VCS Tools . 32 4.8.3 Provided Repositories . 33 4.8.4 What Goes in the Repository? . 34 4.8.4.1 Things to Check In . 34 4.8.4.2 Things to Exclude . 34 4.8.4.3 .gitignore and exclude Files . 35 4.8.5 The Working-Copy Model . 36 4.8.6 Git Workflow . 36 4.8.6.1 Branching and Merging . 37 4.8.7 Writing Good Commit Messages . 38 5 Preparing Your Project’s Statement of Work 41 5.1 What Is a Statement of Work? . 41 5.2 The Marathon Push .