technical report writing
DESCRIPTION
Technical Report Writing. Originally created by J. Ayers Edited by R. Magnusson and J. Chandy, Spring 2011 Edited by M. van Dijk, Fall 2013. ECE 4901. . Technical writing. Journal paper Thesis Dissertation Report Project statement Project specifications Design memo, proposal, report. - PowerPoint PPT PresentationTRANSCRIPT
![Page 1: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/1.jpg)
Technical Report Writing
.
Originally created by J. AyersEdited by R. Magnusson and J. Chandy, Spring 2011
Edited by M. van Dijk, Fall 2013
ECE 4901
![Page 2: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/2.jpg)
Technical writing• Journal paper• Thesis• Dissertation• Report
• Project statement• Project specifications• Design memo, proposal, report
![Page 3: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/3.jpg)
Elements of a Technical Report• Title• Abstract (Executive Summary)• Introduction• Theory and Analysis• Experimental Procedures• Results and Discussion• Conclusion(s)• Acknowledgments• References• Appendix
![Page 4: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/4.jpg)
Writing Mechanics• Check Spelling• Check Grammar• Minimize the use of Acronyms• If Acronyms are necessary, always define them at the first
use• Number all equations, tables, and figures• All tables and figures must have captions.• All figures must have labeled axes• All quantities must have units• Try to avoid footnotes
![Page 5: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/5.jpg)
Writing Style•Depends on the audience•More Lively Writing (usually preferred)
– First Person, Active Voice, Past/Present Tense•More Formal Writing
– Third Person, Passive Voice, Past/Present Tense•Never use slang
![Page 6: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/6.jpg)
Writing Style•Use First-Person, Active Voice, Past Tense or Third-Person, Passive Voice, Past Tense
• Not Recommended: Clean the gallium arsenide substrates by boiling them in trichloroethylene.
• Not Recommended: I clean the gallium arsenide substrates by boiling them in trichloroethylene.
• Acceptable: The gallium arsenide substrates were cleaned by boiling in trichloroethylene.
• Recommended: We cleaned the gallium arsenide substrates by boiling them in trichloroethylene.
![Page 7: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/7.jpg)
Writing Centerhttp://www.writingcenter.uconn.edu/index.php
•Improve your grammar and style– Read “The Science of Scientific Writing”– Quote: “If the reader is to grasp what the writer means,
the writer must understand what the reader needs.”•Organize your paper
– Read “Critical Reading Towards Critical Writing”– Quote: “… ask "How does this text work? How is it
argued? … How does the text reach its conclusions?”
![Page 8: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/8.jpg)
Organization
![Page 9: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/9.jpg)
Writing the Report: An Approach• Results come first
– Your results are the heart of your paper– Begin by analyzing and understanding your data– The results section includes:
• Figures/diagrams/plots (labeled, captioned and titled)• Data you didn’t expect• Your description of your figures• No interpretation or conclusions
Material from J. Stickgold-Sarah
![Page 10: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/10.jpg)
Writing the Report: An Approach• Results section:
– Use tables and graphs– Consider moving large quantities of raw data,
detailed derivations, or code to an appendix– Methods of plotting which produce well
delineated lines should be considered– Results should be critically compared to theory– Consider limitations in the theory and engineering
tolerances
![Page 11: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/11.jpg)
Writing the Report: An Approach• What happens in the discussion?
– The Discussion ties back to the Introduction– Talk about how and why you did or didn’t
confirm your hypothesis– Unexpected results– Speculate here!– Claims are grounded in results and background
material in Introduction
Material from J. Stickgold-Sarah
![Page 12: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/12.jpg)
Writing the Report: An Approach• Now you are ready for the introduction
– Brief background, enough to understand your hypothesis– State your hypothesis and your conclusion– Intro is not a substitute for the report, and so does not
echo the abstract– Here is the place for context, relation to prior work,
general objective, and approach
• Next: title, abstract, conclusions and other sections
Some material borrowed from J. Stickgold-Sarah
![Page 13: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/13.jpg)
Title and Abstract• Title gives understandable label for area of inquiry• Abstract or Executive Summary:
– Abstract is a mini-paper (often around 200 words)– Think of it as a substitute for the report for a busy reader:
what if your reader has only access to the abstract? – Purpose, Findings, Impact
• Sentence One: expand on the title• Sentence Two: why the work was done• Remainder: key results, with numbers as appropriate,
conclusions, recommendations
Some material borrowed from J. Stickgold-Sarah
![Page 14: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/14.jpg)
Sentences that serve the key purposes of an introduction
Example: Savage, S. Eraser: A Dynamic Data Race Detector for Multithreaded Programs. ACM Transactions on Computer Systems, 15 (4) 391-411
Describe your field:Multithreading has become a common programming technique.
Explain why your problem mattersUnfortunately, debugging a multithreaded program can be difficult.
Summarize prior research:The difficulties with using threads are well summarized by John Ousterhout.
Propose your solution:In this article we describe a tool, called Eraser, that dynamically detects data races in multithreaded programs
![Page 15: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/15.jpg)
Conclusion
• Similar to abstract or executive summary• Must be concise• Reinforces key ideas formed in discussion• Includes recommendations for future work,
such as implementation of a design
![Page 16: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/16.jpg)
Theory and Analysis
• Briefly describe the theory relevant to the work• Provide design equations• Include calculations and computer simulation results • Provide values for all key parameters
![Page 17: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/17.jpg)
Experimental Procedures• Describe Apparatus and Materials
– Diagram of apparatus goes here (add a photo)– Open with an overview of the experimental design
• Show test setups• This section should allow any electrical or computer
engineer to duplicate your results:– Repeat experiment– Validate experimental design
Some material borrowed from J. Stickgold-Sarah
![Page 18: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/18.jpg)
Figures and Tables• Every figure must have a caption• All tables must have a title• Figure/tables are placed after they are mentioned in the text
– All must be mentioned/discussed– Summarize their data in the text
• Make figures/tables first, and then insert into the text• Put the figure/table number beside its title, and put this in a
standard location• Don’t start a sentence with an abbreviation: Figure vs. Fig.
![Page 19: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/19.jpg)
Example FiguresD. Andersen, H. Balakrishnan, F. Kaashoek and R. Morris. Resilient Overlay Networks. 18th ACM Symp. On Operating System Principles (SOSP), 2001.
![Page 20: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/20.jpg)
Acknowledgements
• Keep track of those to be acknowledged-keep a diary so that you don’t forget anyone
• Include: your sponsor, outside sources (companies or agencies), other departments on campus, individuals outside of your team who have helped
• Be brief
![Page 21: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/21.jpg)
References
• Various formats have been developed. Pick one you like such as the IEEE Transactions format
• Decide on a sequence, such as the order they appear in the text
• Always give full references such that others may find the item
![Page 22: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/22.jpg)
References (examples)
• [1] A. Student and B. Professor, “Very Important Project,” in Journal of Irreproducable Research, vol. 13, no. 9, pp. 25-31, Nov. 2004.
• [2] C. Dean, The Book of Earth-Shattering Research, Husky Press, Storrs, CT, 2005.
![Page 23: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/23.jpg)
Plagiarism• Never take the work of others without giving proper
credit• Never take verbatim sentences/paragraphs from the
literature• If you feel that you must use verbatim material, use
quotation marks and a reference. Do this sparingly!• There are search engines that can find if verbatim
material has been stolen. Professors fail students who do this. Additional disciplinary action may follow.
![Page 24: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/24.jpg)
#5. “We connected the citrus machine...” Jane Doe, Spring 1999
The names have been changed to protect the innocent.
Top Five Quotes from ECE Engineering Reports.
![Page 25: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/25.jpg)
#4 “The other wildly used configuration of the dc commutator machine is the series field motor.” David Doe, Fall
1999
The names have been changed to protect the innocent.
Top Five Quotes from ECE Engineering Reports.
![Page 26: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/26.jpg)
#3 “…the power rating was doubled by about a factor of 2.5…” Joe Doe,
Spring 2000
The names have been changed to protect the innocent.
Top Five Quotes from ECE Engineering Reports.
![Page 27: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/27.jpg)
#2 “From the result section we see that the transformer was rated at
approximately 20 kHz from 10 kHz to 2 MHz and the results were consistent.”
John Doe, Spring 1999
The names have been changed to protect the innocent.
Top Five Quotes from ECE Engineering Reports.
![Page 28: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/28.jpg)
#1 “A sketch of the setup for both tests depicting relative positions and
connections is featured in showing the relative posit featuring the relative setup of the tests is featured in the following section.” Mr. Doe, Spring
2000The names have been changed to protect the innocent.
Top Five Quotes from ECE Engineering Reports.
![Page 29: Technical Report Writing](https://reader035.vdocuments.mx/reader035/viewer/2022062814/568167da550346895ddd363d/html5/thumbnails/29.jpg)
References– William Strunk and E. B. White, The Elements of Style
(New York: Macmillian, 2000).– H. R. Fowler, The Little, Brown Handbook (Boston:
Little, Brown and Company, 1980).– G. L. Tuve and L. C. Domholdt, Engineering
Experimentation (New York: McGraw-Hill Book Co., 1966).
– Craig Waddell, Basic Prose Style and Mechanics (Troy, NY: Rensselaer Press, 1990).
– Joseph Williams, Style: Ten Lessons in Clarity and Grace (Glenview, IL: Scott, Foresman, 1981).
– ECE Dept, “Engineering Report Writing,” September 2003.