PP-GE306-1

advertisement
Engineering
Report Writing
SaMeH Ahmed
s.mohamed@mu.edu.sa
1
SaMeH
GE 306
Level 7
College of Engineering
1434/2013
2
SaMeH
Overview: Engineering Reports
Engineering Reports are Technical reports
include various types of "technical"
information. For example, if you need to
report why a machine failed, you'd write a
report about the reasons caused that
frailer. Your report could be short full of
details or something in between.
3
SaMeH
Many report types are classified as technical
reports. You should always determine
what information you need to convey and
who your audience is before you start
writing.
The following are guidelines to help you
writing an Engineering Report. It is similar
to writing a scientific paper or technical
report.
4
SaMeH
Definition of a Technical Report
 Audience
 General Format
 Perspectives on Technical Reports
 Additional Resources
 Example Technical Report

5
SaMeH
But it is important…



6
It is your duty as an engineer to share
your discoveries with others
Your work is understood only from what
you present / publish / introduce
You are evaluated only based on what you
write in your reports, etc.
SaMeH
Remember!


7
It is your work
You want others to feel the excitement you
felt when you invented the solutions
SaMeH
A format where the findings/recommendations
follow the main body






8
Cover sheet
Title page
Abstract
Table of contents
List (Figures, Tables, Abbreviations)
Introduction
SaMeH






9
The body of the report
Conclusion
Recommendations if applicable
References / Bibliography
Glossary (if needed)
Appendices
SaMeH
Format of Reports


Title: Less than about 11 words
Abstract: 200 – 250 words



Introduction





One paragraph – background / history
One paragraph – motivation
One paragraph – your contributions
One paragraph – organization
Formal Problem Statement – some other name

10
Write this at the end
Mention what you have achieved; mention key of expected
results
Mention assumptions of setting under which your solution
applies
SaMeH
Format (contd.)

Background – some other name





Your Solution – in one or more sections
Related Work




11
Describe background necessary to understand the rest of the
document
Optional – point to other documents
Use to fill space if required
cite and briefly discuss other related work
mention how it is different from your work
mention their limitations but be polite
people like to see their work here; so mention anything that
seems related if done by a program committee member!
SaMeH
Format (contd.)

Performance Model


Experiments







12
Use graphs and tables to show results
Refer the graphs / tables in the text: We see in Figure 1 that …
Discuss intuition behind why the graphs are the way they are
Should sound like: Due to these reasons the results are as
expected.
Conclusions


Describe your experimental setup and metrics you used to
evaluate your solution against previous work
Like abstract, but some more technical points like merits of datastructures used, etc. – assume reader has already read thru the
document
Can mention possible future work
Acknowledgements
References
SaMeH
Format of a Report



Sections become chapters
Sub-sections become sections
In addition, it has:




13
a table of contents
list of figures
list of tables
index
SaMeH
Checklist



Do a spell-check
Ensure figure / table / section numbers match those in
text
Look at start and end of each page






14
E.g. A section title should be at the end of some page
Use no indent after figures / tables
Ensure figures / tables are placed where you want them
Give good names for your algorithms / solutions
Use those names to make your title
Take a printout and read thoroughly
SaMeH
Other tips: In writing scientific papers



Use LaTeX
Review lots of good / bad papers; avoid their mistakes
Be ambiguous in your initial abstract


Be picky about how your sentences sound & feel





Like changing a software’s design
Finish a draft of the paper at least a week before the
final deadline

15
Can you write the same thing in a simpler way?
Can you write the same thing in a concise way?
Are you moving back and forth between two concepts?
A different word may be a better fit to explain this?
Expect to change your organization a couple of times


Just mention what you achieve without revealing techniques
Otherwise your chance of acceptance reduces to 20 – 30%
SaMeH
Finally
Writing a Report requires effort, time, an eye
for detail, is addictive, exciting and rewarding.
16
SaMeH
Download