Scientific Research Method:: Techniques, Models and Practices Part VI: Writing Scientific & Technical Reports
Scientific Research Method:: Techniques, Models and Practices Part VI: Writing Scientific & Technical Reports
Prof. Vu Duong
Director & Chair of Systems Science
John von Neumann Institute, Vietnam National University Ho Chi Minh City
The Title
For papers that will be published for other scientists to refer to,
the title and abstract are very important.
Other scientists will first notice a paper in the table of
contents of a journal, conference proceedings, and will be
deciding on the basis of the title alone whether to look further
at that paper.
The Title Should be the Fewest Possible Words that
Adequately Describe the Content of Your Paper. [Day 99, p.
8]. In other words, it should be descriptive, and the keyword
here is adequate.
The Abstract
After having been attracted by the title, if other scientists want to go
further, their next step would be likely to read the abstract, and look
at the figures. The qualities of an abstract are best summarized by
Landes (1951):
The abstract is of utmost importance, for it is read by 10 to
500 times more than read the entire article. It should not be
a mere recital of the subjects covered, replete with such
expression as is discussed and is described. It should
be a condensation and concentration os the essential
qualities of the paper.
Although the abstract appears first in the report, it is usually written
last.
The Abstract
An informative abstract is single-spaced and 100-250 words.
It includes the following information: project, method, results,
and conclusions.
It does NOT include citations, acronyms, equations,
abbreviations, background or discussions of future research.
It stands alone; a reader should be able to grasp the key
results of the entire project from reading the abstract.
Abstracts are written for an expert audience; thus they use
more technical language.
Abstracts are placed at the beginning of a document.
Executive Summary?
is just what it says it is: a summary of the entire document directed at
the executive - who may or may not be a technical expert and may
not read the rest of the document but has to be able to understand
the document based on this one page.
Introduction
Illustrations
Figures - Charts, Tables, Diagrams, Photographs, etc - can be
extremely helpful to a scientist to communicate ideas,
observations, or data to others.
Many scientists outline their paper by deciding on what figures,
graphs and tables they need in order to convey their story, and
then fill the text around these figures.
The importance of figures in conveying scientific ideas cannot be
overemphasized (cf. role models).
All figures must be neat a legible, should have a caption, and
should be referenced from within your text of your paper (!!).
If a figure is reproduced or copied or adapted from another source,
that source must be properly acknowledged in the caption, and
listed among other references
10
Conclusions
Discuss your findings in a way that leads logically to your
conclusions.
State the evidence for each conclusion as clearly and concisely
as possible.
Be sure to point out any exceptions to your general conclusions,
discuss the assumptions you have made, and recognize any
unresolved issues or cases.
It is in the conclusions that you discuss whether or not the
observations and information you collected from your
experiments validate the hypotheses you started with,
answering your original questions.
11
References
Where all the references cited in the paper are fully listed.
Often the most important and useful section of a scientific paper.
There are many different formats for reference citations, but
perhaps the simplest is to indicate the authors last name and
the year of publication. Hansen (1991)
Preference: Council of Biology Editors (CBE) Scientific Style,
1994.
Details to be discuss as classroom exercise.
12
References
Council of Biology Editors, 1994, Scientific Style and Format: The
CBE Manual for Authors, Editors, and Publishers. 6th edition,
Cambridge University Press, New York. 825p.
Day, R. A., 1979, How to Write and Publish a Scientific Paper. ISI
Press, Philadelphia, 45p.
Hansen, W.R. (ed), 1991, Suggestions to authors of the Reports of
the US Geological Survey. 7th edition, US Gov. Printing Office,
Washington D.C., 311p.
Landes, K.K.,1951, A Scrutiny of the Abstract, Bulletin of the
American Association of Petroleum Geologists, Vol. 35.
13
Citing References
Should acknowledge a source
Anytime a fact or an idea or any direct quotation is used or
referred to.
Anytime a fact or idea is summarized or paraphrased.
Source to be acknowledged
Not only limited to books, journal and/or conference articles,
but also figures, illustrations, or graphical materials either
directly or in modified form.
Internet sites, computer software, written and e-mail
correspondence shall be used with care.
References shall be in any case traceable i.e. in a way that
other researchers can find the cited references.
Internet sites are not usually edited and maintained for
traceability.
15
Citing References
Three formats:
1. Mention the author(s) by last name(s) in the sentence and should give the
year of publication in parenthesis e.g. Crowley et al (1989) developed the
idea of ridges and peaks as image features. (rule of thumb: more than two
authors, use et al.)
2. Give the facts and ideas mentioned by the author(s) and then attribute
these facts and ideas by putting last names and date in parenthesis eg
Ideas of ridges and peaks were previously developed (Crowley et al,
1989).
3. Quote the author exactly. Be sure to put the quotation between the doublequotes () and then list the names, date, and page number in parenthesis
e.g. Ridges and peaks are image features that can be used as
complement to segments and regions. (Crowley et al, 1989, p. 234).
Page number is needed in direct quoting citation, or if the source is very long
and the cited specific fact or idea can only be found on a specific page.
Direct quotations that are more than four lines long should be set off from the
rest of the paper by the use of narrower margins and single spaced lines.
16
Citing References
Some (unwritten) rules:
No references in abstracts. Abstract must be self-explained but concise
and short (less than 300 words).
Number of authors to be cited:
Less than two: cite all e.g. (Tran-Le and Pham, 2006),
More than two: cite first author and the rest e.g. (Tran-Le et al, 2006).
18
19
20
IEEE
Sequence number>subscript
Separate: comma
Name of author abbreviate
Title not underline
italicize
Page: p (begin-end, total)
Date Format: <Y> [m-d]
21
Guideline
CBE
IEEE
22
Dissertation Writing
Timos Reviews of Research and Dissertation Advice Guides,
Prof. Timo Salmi, 2005,
http://www.uwasa.fi/~ts/opas/intd/resgui.html (May, 2005):
List of good research management guidebooks with Prof
Timos comments. Directed at Doctoral students but also
applicable for MS Thesis phase.
27 reviewed guidebooks including research in educational
and social sciences, economy, business study,
managements, finance, accounting, etc. but few focus on
scientific research. Some recommended reviewed
guidebooks are in Finnish!
23
Draft your story-board - the logical sequence of the story you are going
to tell.
What is the purpose of your paper? What are the key elements constituting
your paper? Are them worth telling?
Whos the intended audience? Information can be represented by an
iceberg, what is the level of water with respect to the depth of the iceberg?
24
An Un-copyrighted Guide
26
Writing Dissertation
All scientist need to communicate discoveries; PhD dissertation
provides training for communication with other scientists.
Writing a dissertation requires a student to think deeply, to
organize technical discussion, to master arguments that will
convince other scientists, and to follow rules for rigorous, formal
presentation of the arguments and discussion.
Writing dissertation is the most important and beneficial
phase of a Doctoral research.
27
To Avoid
To avoid:
To Avoid
Clumsy phrases:
you will read about
I will tell you ; I will describe
We (who we are? Authors and readers? Can use the authors
29
Some advices
Voice: use active constructions, minimize passive mode.
Tense: write in present.
Define negation early, e.g. say no data block waits on the
output queue instead of a data block awaiting output is not on
the queue.
Grammar:
Be careful that the subject of each sentence really does what
the verb says it does.
Saying Programs must make procedure calls using the
X instruction is not the same as saying Programs must
use the X instruction when they call a procedure.
All computer scientists should know the rules of logic. Use
them in writing.
30
General recommendations
Focus on results and not the people or circumstances in which they
were obtained.
Avoid self-assessment (both praise and criticism).
References to published papers, not authors.
Use a singular verb to refer to a paper e.g. Tran-Le and Duong
[1] reports that
Avoid using The authors claim that but The paper states
that
Drawing only warranted conclusions - are them conclusive?
Dont make any abstraction (illusion?) of any commercial success
of a idea/method in scientific research paper/dissertation.
Science is no religion!!
31
Organization (2)
Chapter 4: Experimentation/Simulation
Describe the experimental method used and the environment,
scenarios that test your conceptual model (reproducible).
Describe the results, and discuss the results.
Chapter 5: Analysis of Experimental Results
Usually, experiments either emphasize proof-of-concept or
efficiency (demonstrating that a method/technique provide
better performance than those that exist) - Show the evidence!
Chapter 6: Conclusion and Future Works
Summarize what was learned and how it can be applied. (be
aware of your contributions: are them original and are the work
substantial?)
Recommend future work to make your idea better!
Abstract - Executive Summary (to write last!!)
33
34
Clarity
Contradiction with conciseness?
Structural clarify vs. coherence of relations?
Conciseness
Be short and meaningful. What does it mean? Cut off?
Coherence
Contradicts conciseness for relationships between elements?
Contradicts clarity in terms of style?
Appropriateness
Audience and problem
Context and problem vs audience?
35
Purpose?
Provide info
Give instructions
Persuade
Prohibition
36
Organization
Storyboard
Whats in it?
Hypothesis?
Drafting
Tree structure of topics
37
Revising
Organization
Accuracy
Contents
Completion
38
Collaborative Writing
39
Mechanics
Consistency in:
Capitalization
Italics
Abbreviations
Acronyms
Numbers
Enumeration
Symbols
Equations
Spelling
40
Mechanics: Capitalization
Capitalization :
First words , first sentence in quotations.
Proper name : person, object, place, project, institution,
river, vessel , genus, culture, ethnic group, formal job
title .
Titles of : books, periodicals, published & unpublished
reports, articles, document sections.
References to : figures, tables, chapters, sections,
equations
Rules for capitalizing multiple-word titles and proper
names.
General guidelines for capitalizing scientific terms.
41
Mechanics: Italics
42
Mechanics: Abbreviations
43
Mechanics: Acronyms
44
Mechanics: Numbers
45
Mechanics: Enumeration
Chapter-section Enumeration:
Numerical system
Alphanumerical system
Pagination:
Front matter : lowercase roman numerals
Body -> end matter: Arabic numerals (1 -> n)
Tables & Figures: sequentially
Equations: sequentially
Footnotes, endnotes, reference numbers: cf. Reference standards.
46
Mechanics: Symbols
47
Mechanics: Spelling
48
In the end
Research is vocational!
Use your brain and logics as often as possible.
Rigor is needed in all steps.
The difference between a trivial project and a significant project is
not the amount of work required to carry it out, but the amount of
thought that you apply in the selection and definition of your
problem.
David P. Beach & Torsten K.E. Alvager
Handbook for Scientific and Technical Research, Prentice-Hall, 1992, p. 29
GOOD LUCK!
49