Technical Writing For Engineers - Lab

Technical Writing For Engineers - Lab

Technical Writing For Engineers Thomas A. Knotts Thomas H. Fletcher N. Stanley Harding With help from: Ken A. Solen Larry L. Baxter Richard L. Rowley Randy L. Lewis Why Write? Develops perhaps the single most important

skill in your career. Engineers must be excellent technical writers Conveys important ideas in a lasting way that will preserve your work. Hones your thinking Careful thought Critical analysis Others point of view Rule #1 of Good Writing

Revision, revision, revision!!!! There is no such thing as good writing, only good re-writing. An Effective Report is Logical Technical report logic begins at the word level and extends through the document level.

Document Level Easy to follow (sectioning and structure) Professional appearance (neat, organized) Paragraph Level Coherence in thought (paragraph construction) Makes points quickly (concise) Word/Sentence Level Professional Language (spelling, grammar) Unambiguous wording (precise language) Good technical writing conveys the ideas in such a way that the

reader can easily and quickly understand and is convinced. Document Level Logic SECTIONING AND STRUCTURE Full/Complete Reports Abstract (for the very busy reader) Includes major details of the report. This is the first place you convince the audience. Introduction

(what is this all about?) Problem statement (how did it all start?) Objectives (what needed to be accomplished?) DO NOT discuss methods or results here Full/Complete Report (continued) Theoretical/Analytical Background (what principles apply?) How can the answer be determined? Assumptions!!!

Methods (what did you do?) Results/Analysis/Discussion (what did you get, and what does it mean?) Establish the validity of your results Compare to theory, published data, etc. Error Analysis Summary/Conclusions (tie it all together) Draw and support your conclusions Memo Reports

Most communication done in industry are short! Email 1-2 page memo reports (may be longer) Memo reports contain many of the same elements as longer reports, but the purpose is to give the reader the most important information (results, discussion, conclusions) quickly. Several sections of a full reports are often combined in memo reports

Sections of Memo Reports Heading To: From: Subject: Very abbreviated May not be needed Introduction/Objective Methods/Apparatus/Procedures Results/Discussion

Main focus Conclusions/Recommendations Proposals Common in industry and academia. A document that offers to provide service or a product (for money). Usually written in response to a request for work. Outlines the plans to accomplish the requested work.

Seeks to persuade the reader to choose the submitting person/company to perform the work. Sections of a Proposal Different organizations will have different requirements. It is very important to adhere to the requirements. In general, proposals have the following elements.

Summary Project Description (Technical proposal) Personnel (Management proposal) Budget (Cost proposal) Proposals in ChEn 475 Before beginning any experiment, you are required to submit a proposal, in memo format, outlining your plans. This is a very important part of the process. Think through all the details. Communicate a clear plan to the entire group.

Work out most the analysis problems before you begin. Sections of Proposals in ChEn 475 Overview/Objective (Introduction) Explain the problem background. Clearly define the objectives. Theoretical Analysis Explain the design equations

Experimental Methods Apparatus Details on replicates, conditions, Expected Outcomes Estimate ranges of expected measurements Perform a full sample calculation using estimates Progress Report Brief

update on progress to your boss or sponsor in the middle of your project Very common in industry and academia Components: One paragraph by email One PowerPoint slide attached Content Progress Challenges Needs Preliminary results Word/Sentence Level Logic GRAMMAR TIPS

Agreement in Number Inconsistency in number is possibly the single most common error of capable writers. This data was used in the analysis. These data were used in the analysis. Everyone please take their seat. Everyone please take his or her seat. Each of the valves opened at their designated times. Each of the valves opened at its designated time.

Hyphens The high-temperature tank ruptured. The twenty-five-meter pipe. The blue-green fluid leaked. (compound adjective in this case) OR The leaking fluid was blue green. (predicate modifier in this case and is not hyphenated) The six- or eight-bit A/D converter. The in situ analysis indicates poor mixing. (no hyphen) Units

Abbreviated units that derive from peoples names are capitalized (but spelled out units are not). V, K, and kg; volt, kelvin, and kilogram but degrees Celsius Temperature Celsius not centigrade 45 C, not 45 C, 68 F, 512 R, 325 K 45 is an angle, not a temperature. Values and units are not hyphenated when used as adjectives unless they are spelled out.

3 mm tube or three-millimeter tube, but not 3-mm tube. Use superscripts to be precise in units J mol-1 K-1 not J/mol/K Can use J/mol Case and Tense Matter The assignment came to me and my partner (not my partner and I). My instructor told me he was most impressed.

The two major contributors were my partner and I (not me and my partner). My partner and I were . The author of this report was I (not me). I was the author . The data fit a straight line and are consistent with first-order kinetics.

Dangling Constructions Ensure the subject of introductory sentences agrees with that of the remainder of the sentence. Having studied the costs, several questions arise. Having studied the costs, we posed the following questions. To obtain more precise data, surrogate chemicals were used. To obtain more precise data, investigators used surrogate chemicals. Avoid Split Infinitives

The coal was able to barely burn. The coal was barely able to burn. The tank was too cold for the reaction to significantly proceed. The tank was too cold for the reaction to proceed significantly. Subject Verb Agreement Subject-verb agreement requires attention, particularly when the subject and verb are separated by other words. The thermocouples wired to the A/D board indicate

reactor status. Compound subjects linked by and generally require plural verbs. Temperature and, for non-ideal gases, pressure influence gas enthalpy. Compound subjects linked by or generally require verbs matching the closest noun. A higher reflux ratio or two additional stages produce column performance within specifications. Two additional stages or a higher reflux ratio produces

column performance within specifications. Indefinite pronouns generally require singular verbs. Each of the experiments requires 10 kg of solvent. But: Some of the experiments require hours to conduct. Active vs. Passive Voice Active voice should be used when possible. A loose connection was responsible for voltage spikes that melted the power supply. A loose connection generated voltage spikes,

melting the power supply. Dont avoid passive voice altogether. The pressure was measured using a mercury manometer. A mercury manometer measured the pressure. or We measured the pressure using a mercury manometer. Verbs Subject-verb agreement with

intervening words, match verb to subject, not the closest noun High levels of air pollution damage the respiratory tract. A full set of weights costs five-hundred dollars. The reaction rate expression, together with its parameters, appears in Table 1. (similarly, phrases beginning with as well as, in addition to, accompanied by, and along with do not make a singular noun plural). Capitalization Names of specific items generally

are capitalized. The Constitution (if US constitution is implied) describes three branches of government. The constitution (if any generic constitution is implied) describes elections of officers campus organizations. Figure 7 illustrates model predictions base on Equation 9. The figure illustrates model predictions based on this equation. Word/Sentence Level Logic UNAMBIGUOUS LANGUAGE (WRITING

PRECISELY) Writing Precisely Be Specific Words like big, better, slightly, etc. leave the reader guessing Replace With a tall spray dryer

a 40 foot tall spray dryer a long, thin pipe an 85 ft long, 3 inch diameter pipe results agreed fairly well with predictions results fell within 7% of predictions efficiency was low efficiency was 41%

Corporate Spy at Chemical Plant Vague Abstract This report has been prepared to discuss the results of experimental efforts to determine the conditions for transition from laminar to turbulent flow for water flowing in a cylindrical horizontal tube. In addition, the report will compare the consistency of experimental data used to determine the flow rate from integrating velocity profiles with that obtained from theoretical correlations. (Appendix 1) Summary It was observed that the transition from laminar flow occurred at approximately Re = 1250, where Re = Reynolds

Number. The flow rates obtained from the velocity profiles were within 14% of those obtained experimentally. Results are in fairly good agreement, but it is recommended that Vague Summary The radial finned tube had the highest heat transfer per foot and the highest fin efficiency of the finned tubes. The greatest heat transfer was found at the highest flow rate available with our pump (6.7 gpm). The heat transfer coefficients were internally consistent. The radial and longitudinal fins deviated by only 2% in their coefficients, but the value of the bare pipe might be high. The rusted fins are infeasible even

at one third the cost because of the low amount of transfer. Rusted surfaces have a thermal conductivity of about I BTU/hr ft F compared to II9 BTU/hr ft F for aluminum. The bare pipe had a rather high heat transfer coefficient but the surface area was so small that not enough transfer took place. Vague VI. CONCLUSIONS AND RECOMMENDATIONS 1) Standard heat transfer equations predict the temperature profiles in rods within 10%. 2) The values for thermal conductivity in the literature are accurate. Paragraph Level Logic

WRITING CONCISELY Writing Concisely Look for unnecessary words Go over it many times Replace With during the course of the experiment

during the experiment corrosion which was there because of the acid acid-induced corrosion We were able to measure . . . We measured . . . We found out that the flowrate was... Our biggest problem was . . . This report has been prepared to discuss the results of experimental efforts to determine the conditions for

transition from laminar to turbulent flow The flowrate was . . . [nothing] The transition from laminar to turbulent flow was experimentally determined to be Writing concisely takes time From Abraham Lincoln (reported in the book Lincoln, by Russell Freedman) One of the beauties of his speeches was their eloquent brevity. He agonized over his speeches, revising and

cutting and polishing until the moment he mounted the podium. He couldnt stand folks who were long-winded. Referring to one such person, Lincoln said, That man can compress the most words in the fewest ideas of anyone I ever knew. Conciseness Tips Useless phrases. There was an increase in temperature. The temperature increased from 75 C to 100 C. Redundant

words. The time-temperature history of the particle appears in the figure. The particle temperature history appears in the figure. Conciseness Tips Non-essential Relative Clauses The wires that come from the thermocouple that is in the distillation column require rerouting. The distillation column thermocouple

leads require rerouting. Unnecessary Prepositions The reading of the temperature meter for the hot tank was 214 C. The hot-tank temperature meter read 214 C. Conciseness Tips Minimize prepositions The temperature of the fluid increased

rapidly. The fluid temperature increased rapidly. Especially avoid preposition strings The concentration of benzene in the fluid outside of the tank exceeded EPA limits. The benzene concentration in the external fluid exceeded EPA limits. The external-fluid benzene concentration exceeded EPA limits. Conciseness Tips Empty

Prepositional Phrases Students are required by the university to make payments of their fees at the time of registration. The university requires students to pay registration fees. Vagueness Many students feel anxiety stress when they find themselves in a testing situation. Exams make many students nervous (or anxious). Conciseness Tips Unnecessary

qualifiers It should be noted that the reactor was hot. The reactor was hot. Indirect references The professor in my section of the Unit Operations Laboratory class graded the report. Dr. Rowley graded the report. Wordy

(40 words) The conclusion drawn was that the limiting factor in the experiment was the pH probe. The reaction was much faster at 40C and the probe was very sluggish. The reaction seemed to proceed faster than the probe could read accurately. Better (16 words) Thus, at 40C the reaction proceeded faster than the slowresponse probe could monitor the OH concentration. Wordy APPARATUS and PROCEDURE (131 words)

The holding tank was filled with 300 gallons of water. A fitting or valve was then placed between the manometer leads. Next the pump was turned on and the two pressure gauges on either side of the pump were read to determine the total static pump head (Hp). The water flow rate was varied to give different Hps and the pressure drop across the fitting or valve was measured with the manometer. The hose that discharged the water into the holding tank was then placed in the weighing tank. The Hp was varied again and flow rates were measured by using the weighing scale. After measuring the flow rate the water was returned to the holding tank. A new fitting or valve was put into place and the procedure was repeated. BETTER (65 words) Water from a 300-gallon holding tank was pumped via a Model VIP pump through 3/4 inch schedule 40 steel pipe with the test valve or fitting attached. Pressure gauges at the pump inlet and outlet

provided pump head data. As the pump head was varied, the pressure drop was measured using a manometer, and the flowrate was determined by weighing the water in the collecting tank. Wordy (96 words) (also note problems with tense) At the measuring station, ink is injected into the stream from a thin needle. The position of the needle in the pipe is adjustable, so ink can be injected at different distances from the pipe wall. A distance was marked along the pipe wall so a stopwatch could be used to time the ink flow over the distance. The velocity of the stream at the position of needle tip could be calculated from the

distance, and the elapsed time. By determining the velocity at positions across the pipe radius, a velocity profile could be generated. Better (46 words) At the measuring station, ink was injected into the stream at various distances from the pipe wall via a thin, variable-position needle. The velocity of the ink was determined by measuring the travel time between markers along the pipe, and a velocity profile was then determined. THATS IT!

Recently Viewed Presentations

  • CHI St. Luke's CHNA 2016

    CHI St. Luke's CHNA 2016

    Methodology. This report summarizes the results of both qualitative and quantitative research in the primary service area for CHI St. Luke's Health Memorial Lufkin.
  • PACERS Change Agents Meeting March 19, 2014

    PACERS Change Agents Meeting March 19, 2014

    easy. Pay Web has released the . Learning Tab. ... View Current Payroll Roster. View Current Leave Balances. View History Leave Balances. Hours, Earnings & Deductions (HED) Payroll Calendar. General Ledger Object Codes. ... PACERS Change Agents Meeting March 19,...
  • Tissues Chapter 5 - calhoun.k12.al.us

    Tissues Chapter 5 - calhoun.k12.al.us

    Connective Tissues (cont.) Loose Connective Tissue ("areolar tissue") Cells are some distance apart; separated by gel-like matrix. Forms delicate, thin membranes. Binds skin to underlying organs, fills space between muscles
  • Conceptual Differences Between Cube Analyst and Cube Analyst

    Conceptual Differences Between Cube Analyst and Cube Analyst

    Estimating Multiple User Classes with Fewer Count Sets in Analyst Drive. Screenline Preprocessing. Given multiple matrices to estimate with fewer count sets, Analyst Drive will preprocess the input screenline files to produce an individual count set for each, and run...
  •  long narrative poem  reveals values & history  fact,

    long narrative poem reveals values & history fact,

    Religion: Anglo-Saxons = pagan beliefs Woden - (Odin) - primary god Thunor (Thor) - friend to man; controlled sky; thunder (royals' god) Tiw - north star; war god Freya (Frigg) - goddess of love; feast; beauty Loki - god of...
  • History Alive! Ch. 22-25 Introductions & Summaries

    History Alive! Ch. 22-25 Introductions & Summaries

    The First World War: The Great War?War to End All Wars?Chapters 22-25 History Alive!, Ch. 11 Americans. History Alive! Ch. 22: From Neutrality to War p. 283-291 "Was it in the national interest of the US to stay neutral or...
  • Strategies for Working with Combined Qualitative Longitudinal Data

    Strategies for Working with Combined Qualitative Longitudinal Data

    Emma Davidson, Ros Edwards, Lynn Jamieson, Susie Weller Aim: To investigate the possibilities of scaling-up complex qualitative longitudinal (QL) data, using archived QL projects as example:
  • INCREASING USE OF Anti VEGF IN OCULAR CONDITIONS

    INCREASING USE OF Anti VEGF IN OCULAR CONDITIONS

    It's the disease that is to be cured to prevent hypoxia and its effects. They are a valuable ammunition in our armamentarium but alone are not curative of the condition. They give us time & VALUABLE breathing space during which...