Guidelines for Writing Reports for Basic Electrical Engineering

advertisement
Middle East Technical University
Department of Electrical and Electronics Engineering
Guidelines for Writing Reports for
Basic Electrical Engineering (EE213) and Basic Electronics (EE214)
Laboratory Courses
under METU Electrical and Electronics Engineering
As prospective engineers, you will usually document your design, results of your research, field work,
a project proposal or other activities under your responsibility. The report is often the only concrete evidence
of your work and you will be required to write well either in industry or academia. Our main aim is to train you
to write well by the time you have passed these courses and eventually you have graduated.
EE213 – EE214 courses provide several occasions to gain experience on writing reports. There will be
three types of reports you are required to write during these courses:
-
-
-
Pre-reports will present how well you are prepared for an experiment. You will be asked to answer
some background questions that are given in the experiment manual. In addition, you will simulate
some circuits that you will build during that experiment and present your results. The preliminary work
aims to ease your work during laboratory hours and reinforce what you are expected to learn from
that experiment. How you present your preliminary work is as important as how much effort you put
on it, so we expect your preliminary report to meet certain criteria that will be given in the following
sections of this guideline.
Laboratory reports will be written during experiments and must be submitted to your own assistant
at the end of that specific experiment. You are expected to present the results of the steps you
complete and interpret them and compare with the expected results. Reporting your results is also as
important as conducting the experiment and a sloppy report significantly deducts from the value of
the results. The format of the lab report and especially the rules you must obey for graphical results
will also be given in the following sections.
Project reports have a broad scope where you should explain your design for the course project with
background information, simulation and experimental results as well as the power and cost analysis.
As several figures, equations and tables will be included in project reports, knowing the general rules
for writing an engineering report is extremely important and useful.
This document is divided into four parts. The first part provides fundamental guidelines and tips for
writing reports, which apply to all three report formats. The second through fourth parts provide detailed
formatting and guidelines for each of the report types listed above.
A. FUNDAMENTALS
1. Tools
First of all, although there are no certain rules or predefined software packages you must use, you
need to know very well how to use
-
a word processor
an equation editor
a drawing editor
some computer simulation packages.
You must become proficient at using you word processor so that you are able prepare a report with
proper page layout, page numbering, well-placed graphs, images and tables. In addition, you must be able to
use Greek symbols and superscripts/subscripts whenever necessary. Microsoft Office tools are available for
1
Middle East Technical University
Department of Electrical and Electronics Engineering
METU members so that you can use Microsoft Word as your word processor (Please check this link to see the
licensed software that are available to METU members). On the other hand, you are also highly encouraged
to learn and use Latex, which is a document preparation system for high-quality typesetting and very useful
for scientific document preparation.
You must use an equation editor to insert any formula into your report. Equations or formulas in the
form of included images are inacceptable. You may use the built-in equation editor in Word by using the
“insert” option.
When you need to include a circuit diagram or a flow chart, please use a drawing editor rather than
using the screenshot of the diagram in simulation software. You may use any drawing editor you are used to
or Microsoft Visio, which is also available in the given link.
You may use any simulation software for your preliminary works or project. We recommended LTSpice
IV in EE213 course since it is not only available for free on their website, but also used for the EE313 Analog
Electronics Laboratory course. The way you should present your simulation results will be covered in the
following sections.
2. Format
Every report should include an informative title, the name(s) and ID number(s) of the student(s) who
submit the report, name of the instructor and submission date.
Staple your reports in the upper left corner whenever applicable.
Reports will be written on A4 size papers with proper margins. The text should be evenly distributed
between the margins. If the report is supposed to be typed, use a sans-serif font (Times New Roman, Arial or
Calibri) with point size 11.
Although the documents are sometimes prepared single-sided and double-spaced in order to leave
enough space to get feedback, we expect double-sided and single spaced reports.
Page numbers should be placed at the bottom of the page on all pages except the cover page,
whenever applicable.
Equations should be centered and all of the equations in your report should be numbered. Equation
numbers should be placed in ( ) and right justified. All the variables used in the equation should be explained
in the text. Do the either of followings when referring to equations: “Equation (1) represents the Fourier
transform“, or “Fourier Transform of (1) is a complex-valued function of frequency“.
+∞
𝑋(𝑗𝜔) = ∫−∞ 𝑥(𝑡)𝑒 −𝑗𝜔𝑡 𝑑𝑡
(1)
Tables should be generated using the word processor and centered on the page. There must be a
heading and caption for each table with appropriate table number and they should be placed above each
table; for example, “Table 2: Quantity and cost of components used in the project”. All tables in the document
must be discussed inside the text including the observations and comments. When referring to a table, do the
following: “According to the Table 2, overall cost …”
Figures should also be accompanied by proper number and captions that are centered beneath the
figure. Similar to tables, you should also comment on the figures inside the text and referring to figures may
be achieved in the same way you do for tables. Do not forget to capitalize “Table” and “Figure” when they are
used with a specific table or figure number.
2
Middle East Technical University
Department of Electrical and Electronics Engineering
Use a spreadsheet software or Matlab in order to plot graphs for your report. Do not forget to put
labels and units on the axes and, if appropriate, place the origin. Left justify the origin if the graph represents
the some measurements vs. time. If you graph discrete measurement data, use markers for the real
measurements onto the estimated lines. Include a legend and use different markers when plotting more than
one set of data.
If you need to insert a full page plot/graph/image/table, orient it so that they are read from the right
side of the page.
Use your word processor to insert subscripts, superscripts and Greek symbols for common engineering
quantities such as 𝛼, 𝛽, 𝛾, 𝜃, 𝜇, 𝜌, 𝜏, 𝜔. Spell out one digit numbers except when they are accompanied by units
of measure or refer to tables/figures/page numbers. Use numeral for numbers greater than 10 provided that
they do not begin a sentence. Do not forget to include a leading zero when number’s magnitude is less than
1, i.e., use 0.78 instead of .78 and throw away the insignificant digits. Put a space between numbers and
associated units. Institute of Electrical and Electronics Engineers (IEEE) standard abbreviations for some units
are given in Table 1.
Table 1: Some abbreviations and unit symbols according to IEEE standards
Parameter
Abbreviation
volt
V
ampere
A
second (time)
s
farad
F
henry
H
pico (10-12)
p
-9
nano (10 )
n
micro (10-6)
µ
mili (10-3)
m
kilo (103)
k
mega (106)
M
3. Writing Style and Grammar
You should write in complete, grammatically correct sentences. Note that long sentences with a lot of
clauses confuse the reader; therefore, try to be concise.
Do not be colloquial and do not use jargon. Avoid emotionally loaded words such as wonderful, useless
and lovely. Since sentences in active voice are more concise, try to use active voice; however limit the use of
personal pronouns (I, you, we) and be objective.
Use past tense to describe a procedure/process that was implemented and use present tense for
analyzing the results and making conclusions.
Use technical terms correctly. Learn what they mean, how to use them and how to spell them.
Do not use contractions, such as it’s, isn’t, don’t, can’t and use a spell checker.
4. IEEE Reference Guideline
You must cite all the sources of your information in your report. The list of references should be
included at the end of your report according to IEEE standard. The list is supposed to be arranged in the order
they appear in the text. The number of the reference is put in square brackets when referring to a reference
3
Middle East Technical University
Department of Electrical and Electronics Engineering
in the text. In the reference list at the end of your document, the title of an article should be given in quotation
marks and the title of a journal or book in italics. Basic formats and examples are provided below for some
kind of sources and readers are referred to IEEE Citation Reference for further examples.
Books
Basic Format:
[1] J. K. Author, “Title of chapter in the book,” in Title of His Published Book, xth ed. City of Publisher, Country
if not USA: Abbrev. of Publisher, year, ch. x, sec. x, pp. xxx–xxx.
Examples:
[1] B. Klaus and P. Horn, Robot Vision. Cambridge, MA: MIT Press, 1986.
[2] G. O. Young, “Synthetic structure of industrial plastics,” in Plastics, vol. 3, Polymers of Hexadromicon, J.
Peters, Ed., 2nd ed. New York: McGraw-Hill, 1964, pp. 15-64.
Conference Technical Articles
Basic Format:
[1] J. K. Author, “Title of paper,” in Unabbreviated Name of Conf., City of Conf., Abbrev. State (if given), year,
pp.xxx-xxx.
Resources on web
Basic Format:
[1] J. K. Author. (year, month day). Title (edition) [Type of medium]. Available: http://www.(URL)
Example:
[1] J. Jones. (1991, May 10). Networks (2nd ed.) [Online]. Available: http://www.atm.com
B. PRELIMINARY REPORTS
Each experiment in both laboratory courses require preliminary work which consists of two parts:
background questions and simulation results. You are required to submit a preliminary report when you come
to the laboratory in order to be eligible to attend the experiment. As stated in laboratory regulations, the part
that presents your simulation results is mandatory and you will be given bonus points for the answers of
background questions and the way you present your work.
Each student must do the preliminary work on his/her own. Please note that studying together with
your partner and/or any other student taking this course does not mean submitting the same preliminary
report. You only deceive yourself by submitting the results of the simulation that is not realized by yourself. In
addition, any indication of cheating, such as the exactly same circuit schematics in simulation work, will be
severely punished.
The preliminary report must include
-
The student name and ID on the upper left corner
The section and the submission date of the report, in other words, when the experiment will be done,
on the upper right corner,
The name of the teaching assistant on the upper left corner, beneath the student name,
4
Middle East Technical University
-
Department of Electrical and Electronics Engineering
The number and the title of the experiment in the center.
Whether you submit answers to background questions or not, your report must obey these rules.
If there will be any answers to background questions, it is not mandatory but strongly recommended
that you type your report, in which case you should definitely obey the rules given in the first part of the
guideline.
Moreover, simulation results in your preliminary report must meet certain criteria:
-
Every simulation result must be accompanied by corresponding circuit schematic.
There must be no background color for both figures. You may use Tools
Color Preferences for
changing background, grid or track colors in LTSpice IV.
The axes on the figure where the simulation result is presented must be clearly visible.
You must add labels to the nodes from which you take measurements. In LTSpice IV, use Label Net
option to label the nodes as “Vin” or “Vout” or any other appropriate label.
Include your name, ID, experiment and question number on circuit schematic by the help of Add Text
button.
In LTSpice IV, you may export the selected window using Tools
Copy bitmap to Clipboard option.
Whether you include a screenshot or exported bitmap image, do not forget to number the figure(s)
with proper heading(s) and refer to the figures within the text.
Figure 1: Example preliminary report format
5
Middle East Technical University
Department of Electrical and Electronics Engineering
The illustrations for these options may be found in LTSpice tutorial available on EE213 website. An example
preliminary report is illustrated in Figure 1.
C. LABORATORY REPORTS
At the end of each experiment, each group of two students must submit one report that presents the
results of experimental procedure. The experiment reports must include
-
Name and ID numbers of the students on the upper left corner,
The section and the date when the experiment is done on the upper right corner,
The name of the teaching assistant on the upper left corner, beneath the names of the students,
The number and the title of the experiment in the center.
The format of the experiment reports is illustrated in Figure 2.
Figure 2: Example experiment report format
There should be three main sections in experiment reports:
-
Objectives should represent your understanding of the experiment with your own words in complete
sentences. Please do not directly copy the objective section of the experiment manual.
Results section should present the outcomes of the experiment in a way enhanced by plots and
tabulated data. You are expected to state principal results, compare the measured results with what
is expected form preliminary report and simulations and discuss any differences. It is strongly
recommended that you enrich your results with your comments.
6
Middle East Technical University
Department of Electrical and Electronics Engineering
When the results are supposed to be given as plots, suppose that you present them to someone who
do not know the experimental procedure and do not have the manual. Therefore, plots should be
explanatory as much as possible. Please,




Put an explanatory title. Note that “Input and output voltage waveforms of half-wave rectifier
circuit” explains a lot more than “Vin and Vout vs t”.
Name the horizontal and vertical axes, put indicators corresponding to each unit on the axes
and write the proper units.
Indicate the origin clearly.
Indicate the critical values.
A “good” and a “bad” example for plots of the same data are given in Figure 3. Note that the plot in
Figure 3.b does not have title, axes units and the values corresponding to the units on axes.
0
(a)
(b)
Figure 3:Two different representation of the same data
Another thing to note is that you do not have to center the origin on all your plots, rather, left justified
vertical axis is more appropriate to plot the measurements taken with respect to time.
If you are given a report template as in the most EE 214 experiment manuals, use the spaces provided
for your plots; otherwise, use graphical paper. When you use graphical paper, do not forget to label
figures in order to refer them within the text.
-
Conclusion is the section where you should write what you observed and learned during that
experiment. Instead of only summarizing the experiment, compare the measured results with
expected one and discuss any difference. Comment on the applications areas of the components or
circuitry which is the focus of the experiment.
7
Middle East Technical University
Department of Electrical and Electronics Engineering
D. PROJECT REPORTS
For both EE213 and EE214 courses, a project work must be completed in order to pass these courses.
Project will cover what you are expected to learn throughout the semester and you will propose a solution to
the given engineering problem. Once you have a conceptual design, you are expected to realize simulations in
order to validate your design. Then you will build your design, realize tests and go for small revisions if needed.
You will document all this process and submit two reports. First report should include your conceptual design
with the background information it relies on and the simulation results. After realizing your design and
demonstrating your work, you are expected to submit a final report which presents your final design and
analyses of cost and power consumption.
Both of the reports should include
-
-
A cover page with university and department name, course code and name, term, the name of the
project, name and ID number of students who submit the report, name of the teaching assistant to
whom the report is submitted and the submission date of the report,
A table of contents,
An introduction that provides the necessary background and motivations,
An overall block diagram which summarizes and visualizes your design at a glance,
Description of circuit operation where you explain the duty of each sub-circuit and support them with
theory, basic formulations and circuit schematics,
Simulation results,
Selection of equipment with a clear reasoning,
A conclusion that restates your main objectives, summarizes the laws/theory that your design relies
on and describes some applications of your design and
References if needed.
In addition to these, the final report of the project should also include
-
A cost analysis where you tabulate the number of each different component used for the project with
their unit price,
A power analysis where you state the total power consumption by your design and
Illustrations of the finalized project.
In final report, you are expected to make a complete analysis and justify your design by proper reasoning
of each sub-block and the components used for it. Final report should include the actual values/behaviors and
the target ones so that you can comment on the possible differences.
Either staple your reports in the upper left corner or place them in a plastic binder. There is no need to file
each sheet of the reports separately by using sheet protectors.
8
Download