Difference between revisions of "20.109(S10):Guidelines for writing up your research"

From Course Wiki
Jump to: navigation, search
(New page: {{Template:20.109(S10)}} A formal research article or less formal lab reports are the principal ways scientific data is conveyed to the rest of the scientific community and preserved for ...)
 
m (24 revisions: Transfer 20.109(S10) to HostGator)
 
(23 intermediate revisions by one user not shown)
Line 1: Line 1:
 
{{Template:20.109(S10)}}
 
{{Template:20.109(S10)}}
 +
 +
==Instructions for Writing Specific Sections of a Scientific Paper==
  
 
A formal research article or less formal lab reports are the principal ways scientific data is conveyed to the rest of the scientific community and preserved for future examination.  Each scientific journal has its own idiosyncrasies regarding particulars of the research article's format, but the most common elements of a scientific article, in order of presentation, are:
 
A formal research article or less formal lab reports are the principal ways scientific data is conveyed to the rest of the scientific community and preserved for future examination.  Each scientific journal has its own idiosyncrasies regarding particulars of the research article's format, but the most common elements of a scientific article, in order of presentation, are:
Line 12: Line 14:
 
*References
 
*References
  
The requirements for each section are outlined below. NOTE: This information is given in the order that you might actually write up your research, rather than the order in which the parts are presented in the final article. If you want more information, you can find parts of this text in an on-line collection of instructional materials used in the Purdue University Writing Lab (http://owl.english.purdue.edu). Other parts are inspired by Robert A. Day’s book, “How to Write and Publish a Scientific Paper” from Oryx Press, a copy of which can be borrowed from the teaching faculty.
+
The requirements for each section are outlined below. If you want more information, you can find parts of this text in an on-line collection of instructional materials used in the Purdue University Writing Lab (http://owl.english.purdue.edu). Other parts are inspired by Robert A. Days book, How to Write and Publish a Scientific Paper from Oryx Press, a copy of which can be borrowed from the teaching faculty. Still other content is based on the research and teaching experiences of 20.109 instructors [http://openwetware.org/wiki/Natalie_Kuldell ] and [http://openwetware.org/wiki/User:AgiStachowiak | Agi Stachowiak].
  
==Authors==
+
===Title===
This is often the subject of many heated discussions and hurt feelings when only one report can be submitted to describe many people’s work. Since each of you will submit your own report, questions about who the authors will be, in what order, and what responsibilities each will have are moot. However you should list the name of your partner on your report since she contributed to the work. 
+
  
==Figures and tables==
+
The title should be short (about 10 words), interesting, and it should describe what you found. Avoid very broad titles (e.g., 'DNA recombination'), and try to specify your own unique result within the limited space, while still maintaining readability of your title.
 +
 
 +
===List of Authors===
 +
 
 +
Indicate that you are the primary author of the report by underlining your name. Others who substantially contributed to your work, such as your lab partner, should also be listed.
 +
 
 +
===Abstract===
 +
 
 +
The abstract serves as a condensed version (not >250 words) of your report, from motivational background to key results (and how they were found) to implications for the future. By convention, it should be single-spaced and not include citations.
 +
 
 +
The importance of abstracts is increasing as more scientists are using computers to keep up with the literature. Since many search engines can only search for words in a papers title and abstract, these may be the only parts that many people read. The abstract may also be the way a journals editor decides whether to send your paper out for peer review or reject it as uninteresting and not generally relevant. Consequently, a well written abstract is extraordinarily important.
 +
 
 +
===Introduction===
 +
 
 +
The introduction provides a framework for the story you are about to tell, and thus serves two main purposes. For one, you must provide sufficient background information for a reader to understand the forthcoming results. Just as importantly, you must motivate the audience to keep reading! How? Reveal the significance of the work through connections to both prior scientific accomplishments and future applications. You are welcome to use your own creativity and judgement as to what a good introduction should look like; however, you may find the suggested structure below useful.
 +
 
 +
*'''Paragraph 1: most general, "big picture" paragraph.''' Here you should introduce the reader to the broader context of your experiment and motivate why your research is important. Be sure to tell a coherent story, not a dense but unconnected list of facts.
 +
*'''Paragraph 2: "zooming in" somewhat.''' Now that the reader has a frame for thinking about your research, you can present background information in more depth.
 +
*'''Paragraph 3: most specific, a description of your particular investigation.'''
 +
 
 +
===Materials and Methods===
 +
 
 +
The methods section should allow an independent investigator to repeat any of your experiments. Use sub-section headings to allow readers to quickly identify experiments of interest to them (e.g., "Protein conjugation to hydrogels" and "Cell culture and fluorescent labeling"). When commercially available kits were used, it is sufficient to cite the name of the kit and say that it was used according to the manufacturers protocol. The key to a good methods section is developing your judgement for what information is essential and what is extraneous.
 +
 
 +
Note that the methods section should be written in the past tense, since your experiments are completed at the time you are writing your paper. This section should also be written in complete sentences and paragraphs, not in bullet point form.
 +
 
 +
'''You should cite the class wiki at the beginning of this section as follows: "Protocols were according to the 20.109 Spring 2010 lab wiki: URL accessed on January 1, 2020, unless otherwise noted."'''
 +
 
 +
===Results===
 +
 
 +
The purpose of the results section is to present your data in a relatively unbiased way, but with some guiding framework. Begin with a short description of the goal and strategy of your overall experiment, and then delve into specific sub-sections that describe each piece of the work.
 +
 
 +
Titled sub-sections help create a high-level narrative and thus improve readability of dense papers. Effective sub-sections are organized by functional content, not by what you did each day in lab. For example, two successive titles might be "Conjugating lymphoid tissue-associated adhesion proteins to hydrogels" and "T cell migration in protein-coated hydrogels." Less helpful titles for the same content would be "Hydrogel-protein reaction" and "Microscopy and velocity analysis."
 +
 
 +
To write the results section, use the figures and tables as a guide. One approach you might take is to start by outlining, in point form, what you found, going slowly through each part of the figures. Then take the points and group them into paragraphs, and finally order the points within each paragraph.  Present the data as fully as possible, including stuff that does not quite make sense at first glance. Ultimately, each sub-section should begin with an overview sentence that introduces the present experiment and end with a sentence stating the primary conclusion reached from that experiment. (Sub-section headings and figure caption titles can also emphasize said conclusion.) The overview and/or concluding sentences should also provide a transition to the previous/next piece of data when possible. Within a sub-section, be sure to stick to one topic per paragraph; sub-sections will generally require a few paragraphs each.
 +
 
 +
Note that verbs in the results section are usually in the past tense. Only established scientific knowledge is written about in the present tense, the world is round, for example. You cannot presume that your own data are part of the body of established scientific knowledge, and so when you describe your own results, use the past tense, a band of 1.3 kb was seen, for example. There are, however, exceptions to this general rule. It is acceptable to say, Table 3 shows the sizes of the DNA fragments in our preparation. It is also acceptable to say, In a 1991 paper, Ebright and coworkers used PCR to mutagenize DNA.
 +
 
 +
===Discussion===
 +
 
 +
The purpose of the discussion section is to interpret and contextualize your data. You should begin by reiterating the purpose of your research and your major findings. Then you might do any or all of the following: connect your findings to other research (published or that of your peers); describe any ambiguities and sources of error in the data, and suggest future experiments to resolve uncertainties; explain where you expect your work may lead, and suggest specific experiments for extending your findings; describe any conceptual or technical limitations of the research. Finally, you should explain the significance of your findings to basic science and to engineering applications. Like the previous sections, the discussion should have a clear organization and narrative flow, whether or not you use sub-sections.
 +
 
 +
===References===
 +
 
 +
References are generally used in the Introduction and Discussion sections to support any claims that are not common knowledge. Include only those references that pertain to the question at hand. Journals vary considerably in their preferred format for the reference list. For this class, you should list the references alphabetically by the first authors last name. Include all the authors, the papers title, the name of the journal in which it was published, its year of publication, the volume number, and page numbers. Please carefully follow the punctuation and format requirements. A typical reference should look like
 +
 
 +
Pavletich NP, Pabo CO. Zinc finger-DNA recognition: crystal structure of a Zif268-DNA complex at 2.1 A. Science 1991; 252:809-817
 +
 
 +
In the body of your report, this article would be cited as follows:
 +
The crystal structure of the Zif268-DNA complex has been solved (Pavletich 1991).
 +
 
 +
If two or more articles can be cited for this finding, then they are listed alphabetically, separated by a comma.
 +
 
 +
===Figures and tables===
 
Some readers begin by scanning the figures first. The figures, with the legends, should provide a self-explanatory overview of your data. Decide what the data show, then create figures which highlight the most important points of your paper.
 
Some readers begin by scanning the figures first. The figures, with the legends, should provide a self-explanatory overview of your data. Decide what the data show, then create figures which highlight the most important points of your paper.
  
Line 25: Line 79:
  
 
   Temperature Repeats Cortical Cells Ion Flow
 
   Temperature Repeats Cortical Cells Ion Flow
   24°C         5 +            +
+
   24C         5 +            +
   24°C         5 -            -
+
   24C         5 -            -
  
The information in Table 1 could be presented in one sentence, such as: “In ten experiments carried out at 24°C, ion flow was detected only in the presence of cortical cells.This is a clearer and more concise way to present the information. In addition, all tables and figures must have numbers, titles and legends.  
+
The information in Table 1 could be presented in one sentence, such as: In ten experiments carried out at 24C, ion flow was detected only in the presence of cortical cells. This is a clearer and more concise way to present the information. In addition, all tables and figures must have numbers, titles and legends.  
  
==Figure and table legends==
+
===Figure and table legends===
Legends to the figures and tables explain the elements that appear in the illustration. Conclusions about the data are NOT included in the legends. As you write your first draft, state in a short simple sentence, what the point of the figure or table is. In later drafts, make sure each element of the figure or table is explained. Your figure legends should be written in the present tense since you are explaining elements that still exist at the time that you are writing the paper.
+
Legends to the figures and tables explain the elements that appear in the illustration. Conclusions about the data are NOT included in the legends. As you write your first draft, you might state in a short simple sentence what the point of the figure or table is. In later drafts, make sure each element of the figure or table is explained. Your figure legends should be written in the present tense since you are explaining elements that still exist at the time that you are writing the paper.
  
==Results==
+
==Recommended Order of Assembly for a Scientific Paper==
To write the results section, use the figures and tables as a guide. Start by outlining, in point form, what you found, going slowly through each part of the figures. Then take the points and group them into paragraphs, and finally order the points within each paragraph. Use titled sub-sections to organize your content into a higher-level narrative and make it more readable (e.g., two successive titles might be "Functionalization of hydrogels with lymphoid tissue-associated adhesion proteins" and "T cell migration in protein-coated hydrogels"). Present the data as fully as possible, including stuff that does not quite make sense at first glance. 
+
  
Verbs in the results section are usually in the past tense. Only established scientific knowledge is written about in the present tense, “the world is round,” for example. You cannot presume that your own data are part of the body of established scientific knowledge, and so when you describe your own results, use the past tense, “a band of 1.3 kb was seen,” for example. There are, however, exceptions to this general rule. It is acceptable to say, “Table 3 shows the sizes of the DNA fragments in our preparation.” It is also acceptable to say, “In a 1991 paper, Ebright and coworkers used PCR to mutagenize DNA.”   
+
Your data (results and figures) is the heart of your paper. Begin by assembling and understanding it as clearly as possible. Then you can write the framing material introduction and discussion, while compiling a few relevant references. (Actually, you will write a draft of the introduction about halfway through the module, once you have begun to develop some understanding of protein engineering. The final revision is best written once you have all your results.) You should generally write the abstract last, once you have a big picture understanding of every element of your investigation. As for the methods section, you might write it in short pieces day-by-day, while the procedures are fresh in your mind.
  
==Materials and methods==
+
==Additional Scientific Writing Tips==
  
This section is like a cooking recipe. Include enough detail so that someone can repeat the experiment. It is important that the reader be able to interpret the results knowing the context in which they were obtained. '''You should cite the class wiki at the beginning of this section as follows: "Protocols were according to the 20.109 Spring 2009 lab wiki: URL accessed on January 1, 2020, unless otherwise noted."'''
+
In my experience, concentrating on the following topics tends to repay student effort.
  
The Materials and Methods section should be written in the past tense, since your experiments are completed at the time you are writing your paper. This section should also be written in complete sentences and paragraphs, not in bullet point form. As in the Results section, titled sub-sections can be very useful in the Methods (e.g., "Protein conjugation to hydrogels" and "Cell culture and fluorescent labeling").
+
===Structure and Repetition===
  
==Discussion==
+
The readability of your paper can be substantially improved by its organization. Well chosen sub-section titles provide the reader with a distillation of the high-level points you want to make. Take the opportunity early and often to summarize major points - if you do this right, you will feel like you are repeating yourself too much! Each major section of the report should be more or less stand-alone, that is, understandable without having read the rest of your paper. Be sure and work from big to small to big (from broad points to details and back) throughout your paper. Finally, limit paragraphs to one topic apiece, splitting up longer linked ideas as needed.
This is the section of the paper for you to show off your understanding of the data. You should summarize what you found. Explain how this relates to what others have found. Explain the implications.
+
  
==Introduction==
+
===Results vs. Discussion===
Introduce what your question is. Explain why someone should find this interesting. Summarize what is currently known about the question. Introduce a little of what you found and how you found it. You should explain any ideas or techniques that are necessary for someone to understand your results section.
+
  
==Abstract==
+
One difficult task for budding scientific writers is determining what goes in a Results vs. a Discussion section. Even at the professional level, different scientific journals may have somewhat different expectations for how much interpretation is appropriate in the Results. A good rule of thumb in most contexts is to draw technical conclusions in the Results, but save scientific conclusions for the Discussion. An alternative framework that should yield similar writing choices is to focus on relatively certain conclusions in the Results, and save more speculative (but still supported!) conclusions for the Discussion.
The abstract is a very short summary (usually around 150-250 words) of what the question is, what you found, and why it may be important.  
+
  
The importance of abstracts is increasing as more scientists are using computers to keep up with the literature. Since many search engines can only search for words in a paper’s title and abstract, these may be the only parts that many people read. The abstract may also be the way a journal’s editor decides whether to send your paper out for peer review or reject it as uninteresting and not generally relevant. Consequently, a well written abstract is extraordinarily important.
+
Example of a technical conclusion: "Sequence alignment revealed that both mutants exhibited mutations in at least one of the expected sites and thus were consistent with the possible nucleotide changes that could occur with the library used."
  
==Title==
+
Example of a scientific conclusion: "A previously reported model proposes that the OmpR-P phosphatase reaction occurs by hydrolysis rather than direct phosphotransfer from H557 (Hsing 1997). Our mutant is consistent with a change to the structure of EnvZ that facilitates this hydrolysis reaction, thus increasing phosphatase activity while concurrently reducing kinase activity."
The title should be short (about 10 words), interesting, and it should describe what you found. Avoid very broad titles (e.g., 'DNA recombination'), and try to specify your own unique result within the limited space, while still maintaining readability of your title.
+
  
==References==
+
===Holistic View of Data===
Include only those references that pertain to the question at hand. Journals vary considerably in their preferred format for the reference list. For this class, you should list the references alphabetically by the first author’s last name. Include all the authors, the paper’s title, the name of the journal in which it was published, its year of publication, the volume number, and page numbers. Please carefully follow the punctuation and format requirements. A typical reference should look like
+
  
Pavletich NP, Pabo CO. Zinc finger-DNA recognition: crystal structure of a Zif268-DNA complex at 2.1 A. Science 1991; 252:809-817
+
What should you do when two independent pieces of data suggest two very different conclusions about your overall experiment? The one thing you should not do is state that both conclusions are correct, in different parts of the paper, and hope that the reader will ignore the discrepancy! As a scientist, you must take a holistic view in your analyses. Is there any way to reconcile the two results? Is one method more trustworthy than the other or is there otherwise an indication to favour one conclusion over the other? If you have no way of determining which result is correct with your present data, can you propose future experiments to conclusively decide?
  
In the body of your report, this article would be cited as follows:
+
===Concision===
“The crystal structure of the Zif268-DNA complex has been solved (Pavletich 1991).”
+
  
If two or more articles can be cited for this finding, then they are listed alphabetically, separated by a comma.
+
Writing concisely takes more effort than writing inefficient prose. It is also results in eminently more readable text that expresses your ideas more powerfully.
 +
 
 +
===Precision and Detail===
 +
 
 +
Being concise is not an invitation to being vague. Be sure to support your claims with specific examples, and to follow through on your ideas with sufficient detail.
  
 
==Evaluation==
 
==Evaluation==
Line 94: Line 145:
 
*All information is correct
 
*All information is correct
 
*Organization is logical
 
*Organization is logical
*Captures any reader’s interest
+
*Captures any readers interest
 
|
 
|
 
*Sufficient information is presented in proper format  
 
*Sufficient information is presented in proper format  
Line 204: Line 255:
 
|
 
|
 
*Concise
 
*Concise
*Says what you mean  
+
*Says what you mean
*Scientific vocabulary used correctly
+
*Vocabulary (scientific and otherwise) used correctly
 +
*Avoid contractions and informal wording
 
|
 
|
 
*Verbose
 
*Verbose
 
*Ambiguous or incorrect
 
*Ambiguous or incorrect
*Scientific vocabulary misused
+
*Scientific or other vocabulary misused
 +
*Informal/colloquial tone
 
|-
 
|-
 
!Fluency
 
!Fluency
 
|
 
|
 
*Sentences and paragraphs well structured
 
*Sentences and paragraphs well structured
 +
*Clear topic for each paragraph and clear transitions between topics
 
*Punctuation correct or only minor errors
 
*Punctuation correct or only minor errors
 
*Grammar correct or minor errors
 
*Grammar correct or minor errors
Line 219: Line 273:
 
|
 
|
 
*Sentences repetitive or awkward
 
*Sentences repetitive or awkward
*Paragraphs not logical
+
*Ideas haphazardly arranged, logic connecting them not clear, paragraphs not focused on one topic each
 
*Periods, commas, colons and semicolons misused.
 
*Periods, commas, colons and semicolons misused.
 
*Significant number of run-on sentences, sentence fragments, misplaced modifiers, subject/verb disagreements
 
*Significant number of run-on sentences, sentence fragments, misplaced modifiers, subject/verb disagreements

Latest revision as of 19:49, 28 July 2015


20.109(S10): Laboratory Fundamentals of Biological Engineering

20.109(S09) frontpg.JPG

Home        People        Schedule Spring 2010        Assignments        Lab Basics        OWW Basics       
RNA Engineering        Protein Engineering        Cell-Biomaterial Engineering              

Instructions for Writing Specific Sections of a Scientific Paper

A formal research article or less formal lab reports are the principal ways scientific data is conveyed to the rest of the scientific community and preserved for future examination. Each scientific journal has its own idiosyncrasies regarding particulars of the research article's format, but the most common elements of a scientific article, in order of presentation, are:

  • Title
  • List of Authors
  • Abstract
  • Introduction
  • Materials and Methods
  • Results, including figures and tables
  • Discussion
  • References

The requirements for each section are outlined below. If you want more information, you can find parts of this text in an on-line collection of instructional materials used in the Purdue University Writing Lab (http://owl.english.purdue.edu). Other parts are inspired by Robert A. Day���s book, ���How to Write and Publish a Scientific Paper��� from Oryx Press, a copy of which can be borrowed from the teaching faculty. Still other content is based on the research and teaching experiences of 20.109 instructors [1] and | Agi Stachowiak.

Title

The title should be short (about 10 words), interesting, and it should describe what you found. Avoid very broad titles (e.g., 'DNA recombination'), and try to specify your own unique result within the limited space, while still maintaining readability of your title.

List of Authors

Indicate that you are the primary author of the report by underlining your name. Others who substantially contributed to your work, such as your lab partner, should also be listed.

Abstract

The abstract serves as a condensed version (not >250 words) of your report, from motivational background to key results (and how they were found) to implications for the future. By convention, it should be single-spaced and not include citations.

The importance of abstracts is increasing as more scientists are using computers to keep up with the literature. Since many search engines can only search for words in a paper���s title and abstract, these may be the only parts that many people read. The abstract may also be the way a journal���s editor decides whether to send your paper out for peer review or reject it as uninteresting and not generally relevant. Consequently, a well written abstract is extraordinarily important.

Introduction

The introduction provides a framework for the story you are about to tell, and thus serves two main purposes. For one, you must provide sufficient background information for a reader to understand the forthcoming results. Just as importantly, you must motivate the audience to keep reading! How? Reveal the significance of the work through connections to both prior scientific accomplishments and future applications. You are welcome to use your own creativity and judgement as to what a good introduction should look like; however, you may find the suggested structure below useful.

  • Paragraph 1: most general, "big picture" paragraph. Here you should introduce the reader to the broader context of your experiment and motivate why your research is important. Be sure to tell a coherent story, not a dense but unconnected list of facts.
  • Paragraph 2: "zooming in" somewhat. Now that the reader has a frame for thinking about your research, you can present background information in more depth.
  • Paragraph 3: most specific, a description of your particular investigation.

Materials and Methods

The methods section should allow an independent investigator to repeat any of your experiments. Use sub-section headings to allow readers to quickly identify experiments of interest to them (e.g., "Protein conjugation to hydrogels" and "Cell culture and fluorescent labeling"). When commercially available kits were used, it is sufficient to cite the name of the kit and say that it was used according to the manufacturer���s protocol. The key to a good methods section is developing your judgement for what information is essential and what is extraneous.

Note that the methods section should be written in the past tense, since your experiments are completed at the time you are writing your paper. This section should also be written in complete sentences and paragraphs, not in bullet point form.

You should cite the class wiki at the beginning of this section as follows: "Protocols were according to the 20.109 Spring 2010 lab wiki: URL accessed on January 1, 2020, unless otherwise noted."

Results

The purpose of the results section is to present your data in a relatively unbiased way, but with some guiding framework. Begin with a short description of the goal and strategy of your overall experiment, and then delve into specific sub-sections that describe each piece of the work.

Titled sub-sections help create a high-level narrative and thus improve readability of dense papers. Effective sub-sections are organized by functional content, not by what you did each day in lab. For example, two successive titles might be "Conjugating lymphoid tissue-associated adhesion proteins to hydrogels" and "T cell migration in protein-coated hydrogels." Less helpful titles for the same content would be "Hydrogel-protein reaction" and "Microscopy and velocity analysis."

To write the results section, use the figures and tables as a guide. One approach you might take is to start by outlining, in point form, what you found, going slowly through each part of the figures. Then take the points and group them into paragraphs, and finally order the points within each paragraph. Present the data as fully as possible, including stuff that does not quite make sense at first glance. Ultimately, each sub-section should begin with an overview sentence that introduces the present experiment and end with a sentence stating the primary conclusion reached from that experiment. (Sub-section headings and figure caption titles can also emphasize said conclusion.) The overview and/or concluding sentences should also provide a transition to the previous/next piece of data when possible. Within a sub-section, be sure to stick to one topic per paragraph; sub-sections will generally require a few paragraphs each.

Note that verbs in the results section are usually in the past tense. Only established scientific knowledge is written about in the present tense, ���the world is round,��� for example. You cannot presume that your own data are part of the body of established scientific knowledge, and so when you describe your own results, use the past tense, ���a band of 1.3 kb was seen,��� for example. There are, however, exceptions to this general rule. It is acceptable to say, ���Table 3 shows the sizes of the DNA fragments in our preparation.��� It is also acceptable to say, ���In a 1991 paper, Ebright and coworkers used PCR to mutagenize DNA.���

Discussion

The purpose of the discussion section is to interpret and contextualize your data. You should begin by reiterating the purpose of your research and your major findings. Then you might do any or all of the following: connect your findings to other research (published or that of your peers); describe any ambiguities and sources of error in the data, and suggest future experiments to resolve uncertainties; explain where you expect your work may lead, and suggest specific experiments for extending your findings; describe any conceptual or technical limitations of the research. Finally, you should explain the significance of your findings to basic science and to engineering applications. Like the previous sections, the discussion should have a clear organization and narrative flow, whether or not you use sub-sections.

References

References are generally used in the Introduction and Discussion sections to support any claims that are not common knowledge. Include only those references that pertain to the question at hand. Journals vary considerably in their preferred format for the reference list. For this class, you should list the references alphabetically by the first author���s last name. Include all the authors, the paper���s title, the name of the journal in which it was published, its year of publication, the volume number, and page numbers. Please carefully follow the punctuation and format requirements. A typical reference should look like

Pavletich NP, Pabo CO. Zinc finger-DNA recognition: crystal structure of a Zif268-DNA complex at 2.1 A. Science 1991; 252:809-817

In the body of your report, this article would be cited as follows: ���The crystal structure of the Zif268-DNA complex has been solved (Pavletich 1991).���

If two or more articles can be cited for this finding, then they are listed alphabetically, separated by a comma.

Figures and tables

Some readers begin by scanning the figures first. The figures, with the legends, should provide a self-explanatory overview of your data. Decide what the data show, then create figures which highlight the most important points of your paper.

Tables are used to present repetitive data that is numerical. Graphs or illustrations, collectively called figures, are used to present numerical trends, raw data (like a picture of a gel), or a model that explains your work.

When you prepare your figures and tables, keep in mind that it is significantly more expensive for journals to publish figures and tables than text, so try to present the data in a way that is worthy of such added expense. The table below is an example of an ineffective table.

 Temperature		Repeats		Cortical Cells		Ion Flow
 24��C		        5		+             		+
 24��C		        5		-             		-

The information in Table 1 could be presented in one sentence, such as: ���In ten experiments carried out at 24��C, ion flow was detected only in the presence of cortical cells.��� This is a clearer and more concise way to present the information. In addition, all tables and figures must have numbers, titles and legends.

Figure and table legends

Legends to the figures and tables explain the elements that appear in the illustration. Conclusions about the data are NOT included in the legends. As you write your first draft, you might state in a short simple sentence what the point of the figure or table is. In later drafts, make sure each element of the figure or table is explained. Your figure legends should be written in the present tense since you are explaining elements that still exist at the time that you are writing the paper.

Recommended Order of Assembly for a Scientific Paper

Your data (results and figures) is the heart of your paper. Begin by assembling and understanding it as clearly as possible. Then you can write the framing material ��� introduction and discussion, while compiling a few relevant references. (Actually, you will write a draft of the introduction about halfway through the module, once you have begun to develop some understanding of protein engineering. The final revision is best written once you have all your results.) You should generally write the abstract last, once you have a big picture understanding of every element of your investigation. As for the methods section, you might write it in short pieces day-by-day, while the procedures are fresh in your mind.

Additional Scientific Writing Tips

In my experience, concentrating on the following topics tends to repay student effort.

Structure and Repetition

The readability of your paper can be substantially improved by its organization. Well chosen sub-section titles provide the reader with a distillation of the high-level points you want to make. Take the opportunity early and often to summarize major points - if you do this right, you will feel like you are repeating yourself too much! Each major section of the report should be more or less stand-alone, that is, understandable without having read the rest of your paper. Be sure and work from big to small to big (from broad points to details and back) throughout your paper. Finally, limit paragraphs to one topic apiece, splitting up longer linked ideas as needed.

Results vs. Discussion

One difficult task for budding scientific writers is determining what goes in a Results vs. a Discussion section. Even at the professional level, different scientific journals may have somewhat different expectations for how much interpretation is appropriate in the Results. A good rule of thumb in most contexts is to draw technical conclusions in the Results, but save scientific conclusions for the Discussion. An alternative framework that should yield similar writing choices is to focus on relatively certain conclusions in the Results, and save more speculative (but still supported!) conclusions for the Discussion.

Example of a technical conclusion: "Sequence alignment revealed that both mutants exhibited mutations in at least one of the expected sites and thus were consistent with the possible nucleotide changes that could occur with the library used."

Example of a scientific conclusion: "A previously reported model proposes that the OmpR-P phosphatase reaction occurs by hydrolysis rather than direct phosphotransfer from H557 (Hsing 1997). Our mutant is consistent with a change to the structure of EnvZ that facilitates this hydrolysis reaction, thus increasing phosphatase activity while concurrently reducing kinase activity."

Holistic View of Data

What should you do when two independent pieces of data suggest two very different conclusions about your overall experiment? The one thing you should not do is state that both conclusions are correct, in different parts of the paper, and hope that the reader will ignore the discrepancy! As a scientist, you must take a holistic view in your analyses. Is there any way to reconcile the two results? Is one method more trustworthy than the other or is there otherwise an indication to favour one conclusion over the other? If you have no way of determining which result is correct with your present data, can you propose future experiments to conclusively decide?

Concision

Writing concisely takes more effort than writing inefficient prose. It is also results in eminently more readable text that expresses your ideas more powerfully.

Precision and Detail

Being concise is not an invitation to being vague. Be sure to support your claims with specific examples, and to follow through on your ideas with sufficient detail.

Evaluation

The following table describes the features of reports that are excellent, good, and that need substantial improvement, respectively from left to right. Your own reports will be evaluated with these features in mind.

Content

Section Goal Evaluation
Title To give content information to reader
  • Engaging
  • Appropriate
  • Not enough content information or too much
Abstract To concisely summarize the experimental question, general methods, major findings, and implications of the experiments in relation to what is known or expected.
  • Key information is presented completely and in a clear, concise way
  • All information is correct
  • Organization is logical
  • Captures any reader���s interest
  • Sufficient information is presented in proper format
  • Would benefit from some reorganization
  • Understandable with some prior knowledge of experiment
  • Some key information is omitted or tangential information is included
  • Some information is misrepresented
  • Some implications are omitted
  • Incorrect format is used
Introduction To identify central experimental questions, and appropriate background information. To present a plausible hypothesis and a means of testing it.
  • Relevant background information is presented in balanced, engaging way
  • Your experimental goals and predictions are clear and seem a logical extension of existing knowledge
  • Writing is easy to read
  • All background information is correctly referenced
  • Relevant background information is presented but could benefit from reorganization
  • Your experiment is well described and a plausible hypothesis is given
  • With some effort, reader can connect your experiments to background information
  • Writing is understandable
  • Background information is correctly referenced
  • Background information is too general, too specific, missing and/or misrepresented
  • Experimental question is incorrectly or not identified
  • No plausible hypothesis is given
  • Writing style is not clear, correct or concise
  • References are not given or properly formatted
Materials & Methods To describe procedures correctly, clearly, and succinctly. Included a correctly formatted citation of the lab manual.
  • Sufficient for another researcher to repeat your experiment
  • Lab manual cited
  • Procedures could be pieced together with some effort
  • Lab manual cited
  • Procedures incorrectly or unclearly described or omitted
  • Lab manual not cited
Results To present your data using text AND figures/tables.
  • Text tells story of your major findings in logical and engaging way
  • Figures and tables are formatted for maximum clarity and ease of interpretation
  • All figures and tables have numbers, titles and legends that are easy for the reader to follow
  • Text presents data but could benefit from reorganization or editing to make story easier for reader
  • Text includes interpretation of results that is better suited for discussion section
  • Figures and tables are formatted to be clear and interpretable
  • All figures and tables have numbers, titles and legends
  • Text omits key findings, inaccurately describes data, or includes irrelevant information
  • Text difficult to read due to style or mechanics of writing
  • Text difficult to read due to logic or organization
  • Figures and tables missing information, improperly formatted or poorly designed
  • Figures and tables have inadequate or missing titles or legends
Discussion To evaluate meaning and importance of major findings
  • Appropriate conclusions drawn from findings
  • Connections made between experimental findings
  • Connections made between findings and background information
  • Future directions considered
  • Writing is compelling
  • Appropriate conclusions drawn from findings
  • Experimental limitations considered
  • Writing is clear
  • Conclusions omitted, incorrectly drawn or not related to hypothesis.
  • Relationship between experimental findings and background information is missing or incorrectly drawn
  • Writing style and mechanics make argument difficult to follow
References To give credit work on which your own is based
  • Complete list of reliable sources, including peer-reviewed journal article(s)
  • Properly formatted in body of report and in reference section
  • Adequate list or reliable sources
  • With minor exceptions, properly formatted in body of report and in reference section
  • List is incomplete or includes sources not cited in body of report
  • List includes inappropriate sources
  • List not properly formatted
  • References not properly cited in body of report

Style

Writing Style and Mechanics Evaluation
Voice
  • Appropriate for audience
  • Consistent passive or active voice
  • Too simple or too advanced
  • Irregular use of passive and active voice
Word Choice
  • Concise
  • Says what you mean
  • Vocabulary (scientific and otherwise) used correctly
  • Avoid contractions and informal wording
  • Verbose
  • Ambiguous or incorrect
  • Scientific or other vocabulary misused
  • Informal/colloquial tone
Fluency
  • Sentences and paragraphs well structured
  • Clear topic for each paragraph and clear transitions between topics
  • Punctuation correct or only minor errors
  • Grammar correct or minor errors
  • Spelling correct
  • Sentences repetitive or awkward
  • Ideas haphazardly arranged, logic connecting them not clear, paragraphs not focused on one topic each
  • Periods, commas, colons and semicolons misused.
  • Significant number of run-on sentences, sentence fragments, misplaced modifiers, subject/verb disagreements
  • Significant number of spelling errors
Scientific Format
  • Past tense for describing new findings
  • Present tense used for accepted scientific knowledge and figure legends.
  • All sections included and properly formatted
  • Misleading verb tenses
  • Some sections missing
  • Abstract not single spaced
  • Figures missing legends
  • References not properly formatted