CHFEN 4903 WRITING THE REPORT Terry A. Ring Department of Chemical Engineering November 1 & 3, 2004 1 CHFEN 4903 - Report Writing I How To Prepare the Report Materials and Facilities: • Word processor, spreadsheet, drawing and graphing programs • Use spelling and grammar checker, but still proof read. Spelling and grammar checkers are not fool-proof. Use dictionary if necessary • Keep electronic backup copies at every stage • Printer - make sure toner cartridge is not on empty and leave plenty of time to print your report 2 CHFEN 4903 - Report Writing I How To Prepare the Report Early Preparation: • Theory (decide on notation, be consistent) • Introduction (start a rough draft, decide what is important to tell) • Equipment - decide on drawing/sketch, write down important information on major pieces of equipment, i.e. manufacturer, model number. •Figures and Tables (decide on format) Remember Figures: Caption at the bottom Tables: Caption at the top •Do Uncertainty Analysis make sure that it appears on Tables and in Figures 3 CHFEN 4903 - Report Writing I How To Prepare the Report Writing the Memo Report : • Introduction paragraph • Theory Paragraph •Any equations that are to be used should be listed with a reference. You do not list any statistical equations like average, standard deviation, propagation of error, etc. •Apparatus and Procedure Discuss the apparatus diagram/sketches Give a brief step by step procedure •Results and Discussion of Results Discuss tables and figures, do not just show them Give your interpretation of the data and results •Conclusions and Recommendations •Proofread, Proofread, Proofread 4 CHFEN 4903 - Report Writing I How To Prepare the Report Starting is often difficult How I start : • Assemble Figures and Tables in Complete form • List Preliminary Conclusions and Supporting Evidence discuss with your group members • Assemble list of items to be discussed in the report • Prepare an outline of the complete report •Write the easy parts first •Theory •Procedure 5 CHFEN 4903 - Report Writing I How To Prepare the Report Tables: • Number in text using Arabic numerals sequential as referenced if in appendix, may use Table A-1, etc. • Column and row headings must include name of quantity, symbol used, and units • Organize with thought, don’t just copy spreadsheet • Should “stand alone”, self explanatory • Descriptive heading should be at the top!!! 6 CHFEN 4903 - Report Writing I How To Prepare the Report Figures: • Number using Arabic numerals insert after first citation in text sequential as referenced • Figure captions are required descriptive caption at the bottom of each figure captions are complete sentences, text-like • Axis labels (with units) are required name, quantity, dimensions legends are usually helpful if plotting several things 7 CHFEN 4903 - Report Writing I How To Prepare the Report Figures (continued): • Correlation Curves and Error Bars typically do not draw outside data range keep simple, clear, not complicated • Plots with theoretical lines use data symbols for experimental data use lines (solid, dashed, etc.) for theoretical line theoretical lines may be drawn to edge of plot • Use log-log and semi-log plots when appropriate • Flow sheet and piping diagrams, Equipment diagrams, control and computer system diagrams are all figures 8 CHFEN 4903 - Report Writing I Contents of Formal Report (in order of appearance): •Introduction - objective, literature, your approach • Theory - start with basic principles, write equations using an equation editor • Apparatus and Procedure apparatus and instrumentation diagrams are essential discuss accuracy of the instruments and measurements 9 CHFEN 4903 - Report Writing I Contents of Report (in order) - continued: • Results - tell the reader what was observed without bias or interpretation present and discuss data • Discussion of Results Tell the reader what you think the results mean Error analysis - details in an appendix Cite relationships, generalizations Agreement with prior work? Values reasonable? • Conclusions and Recommendations importance of the work- short and sweet summarize evidence for every conclusion give recommendations - be positive, constructive 10 CHFEN 4903 WRITING STYLE 11 CHFEN 4903 - Report Writing Writing Style: • Usually active voice but can use passive. •Passive voice should not be overused •active – •“The drafter improved upon the line quality” •passive – •“The line quality was improved upon by the drafter” • Avoid editorial “we” • Edit frequently - read, revise, read, revise, … 12 CHFEN 4903 - Report Writing Quotation of Material: • Avoid plagiarism - learn to use quoted material Refer to the Student Code on cheating www.admin.utah.edu/ppmanual/8/8-10.html • Short quotations - placed between quotation marks and the source cited • Long quotations - single spaced and indented on the left and right margins. Cite your source. • For this class only - you may use copyrighted material without permission (copy charts/graphs) but you must 13 indicate the source of this material CHFEN 4903 - Report Writing Symbols and Abbreviations: • Define all symbols when first used and/or in a table of nomenclature - see sample report • Abbreviations are frequently overused. Define nonstandard abbreviations in text when first used. Examples: 30’ = 30 feet The new center is called CBI (Center for Biopolymers at Interfaces). 14 SAMPLE Memo REPORT 15 CHFEN 4903 - Report Writing(Day 2) Style, Grammar, Punctuation Tools/ References: • Laboratory Writing Manual by W. M. Learned • “Writing for Technicians” book by Marva T. Barnett • “The Elements of Style” by William Strunk and E. B. White • “The ACS (American Chemical Society) Style Guide” by Janet S. Dodd, Editor • A dictionary, word processor with grammar check 16 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation Style: • Read first section in Learned file, pg. 4-8, 12-14 • Review file - Sample Formal Report 17 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation Grammar & Punctuation: - Read file - “Errors Common to Report Writing and How to Avoid Them” by W. M. Learned 18 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation Grammar & Punctuation: • Voice (Item 1 in Learned Section) Use active as much as possible Passive: A numerical example is now given to illustrate the above example. Active: The following numerical example illustrates this result. 19 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Tense (3) past tense for procedural, narrative parts, calculations - present tense for theory, known facts, and discussing figures, tables and diagrams Past: Early investigations were reviewed. Present: The following numerical example illustrates this result. 20 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Dangling Participle (106) 21 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Dangling Participle (106) A verbal phrase that does not refer clearly and logically to another word or phrase in the sentence. Incorrect: Using the procedure described previously, the partition function can be evaluated. Correct: The partition function can be evaluated by using the procedure described previously. 22 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Wordiness: Be brief and concise. Omit phrases like “it was found that” or “it would appear that”. Wordy: Better: owing to the fact that on the order of at the present time a very limited number of 23 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Wordiness: Be brief and concise. Omit phrases like “it was found that” or “it would appear that”. Wordy: Better: owing to the fact that because (since) on the order of about at the present time now a very limited number of few 24 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Commonly Misused Words: Affect, verb, to influence Heat affects the surface. Effect, verb, to bring about A radical change was effected. Effect, noun The Coriolis effect will be studied Comprise, verb, contains or includes The text comprises all three modes of transfer. Compose, verb, made up of, constituted of The mixture is composed of sand and gravel 25 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Hyphenation (16,17,27): When two or more words modify another word, and the words work as a unit, the hyphen must be used but do not hyphenate most prefixes added to common nouns. Acetic-acid water system bubble-cap tray liquid-gas interface a 20-percent increase a two- or three-year study precooled not pre-cooled nonpolar not non-polar Exceptions: co-worker not coworker 26 co-ion not coion CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Nonsexist Language: Nonsexist language can be accurate and unbiased, and not necessarily awkward. Sexist The effects of compounds A-B were studied in rats and man. 27 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Nonsexist Language: Nonsexist language can be accurate and unbiased, and not necessarily awkward. Sexist The effects of compounds A-B were studied in rats and man. Nonsexist The effects of compounds A-B were studied in rats and humans. 28 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Nonsexist Language: Nonsexist language can be accurate and unbiased, and not necessarily awkward. Sexist The effects of compounds A-B were studied in rats and man. Nonsexist The effects of compounds A-B were studied in rats and humans. Sexist Man’s search for beauty and truth has resulted in some of our greatest accomplishments. 29 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Nonsexist Language: Nonsexist language can be accurate and unbiased, and not necessarily awkward. Sexist The effects of compounds A-B were studied in rats and man. Nonsexist The effects of compounds A-B were studied in rats and humans. Sexist Man’s search for beauty and truth has resulted in some of our greatest accomplishments. Nonsexist The search for beauty and truth has resulted in some of our greatest accomplishments. 30 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Units of Measure: Spell out the unit of measure when no quantity is given several milligrams not several mg Do not use plurals for abbreviated units of measure 50 mg not 50 mgs In ranges and series, retain only the first unit of measure 10-12 mg, between 25 and 50 ml When a sentence starts with a specific quantity, spell it out as well as the unit of measure Twenty-five milliliters of acetone was added. Use the percent symbol with a number, without a space 25% 45-50% 31 CHFEN 4903 - Report Writing II Style, Grammar, Punctuation • Capitalization (31-39): Numbered items should be capitalized when referred to in the text of the report. Write the numbers as figures. …as shown in Figure 1. See Table 2 … as given in Equation (3). But for non-numbered items, do not capitalize …as shown in the figures. Capitalize only the name of the eponym but not the noun Avogadro’s number Lewis acid Non-Newtonian liquid 32 How to Do Figures 6 4 Leach Relative Temperature 2 0 -2 Wet Air Cycle -4 -6 Dry Air Cycle -8 -10 -12 0 20 40 60 80 100 120 140 160 Tim e (hours) Figure 4.3.5-1 Temperature effects during the typical humidity cell weekly cycle showing evaporative effects during the dry air cycle with a temperature drop of 4 C. Note the rise in temperature after most of the water was evaporated. This experiment used 1 liter/min of total gas flow through the humidity cell, which consisted of marble (control cell) ground to the same grain size as the waste rock in this study. The relative temperature is the difference between the cell temperature and the ambient temperature. 33 How to Do Tables Table 1. Chemical Analysis of Selenium-contaminated Wastewater used in the study. Species/Property pH Conductivity Temperature Alkalinity Hardness Total Dissolved Solids Total Suspended Solids Concentration or Value 7.25 2840 micro mho/cm 21 C 303 mg/L 557 mg/L as CaCO3 1670 mg/L Detection Limit <detection 3 mg/L 10 mg/L 5 mg/L 20 mg/L 34 CONCLUSIONS • Writing is a learned skill • Preparing your report takes organization • Tables, figures, references have to be done a certain way • Proofread your reports – grammar, punctuation, style • Follow requirements, turn in the report on time 35 CHFEN 4903 GRADING THE REPORT 36 CHFEN 4903 - Report Writing II Grading A report is not acceptable and must be revised and turned in again if the instructor determines that the report does not meet the minimum standard for senior chemical engineering students Category Score A. Teamwork 10 B. Coherence – Does the report tell a technically coherent story? Are objectives stated and met? 25 C. Technical Accuracy 45 D. Professional Standards – English, Form, Visuals, Citations, Lab operations, Safety, Use of equipment, Cleanup 20 TOTAL 100 37