mirror of
https://github.com/K-Dense-AI/claude-scientific-skills.git
synced 2026-01-26 16:58:56 +08:00
Add scientific writing skill
This commit is contained in:
242
scientific-thinking/scientific-writing/SKILL.md
Normal file
242
scientific-thinking/scientific-writing/SKILL.md
Normal file
@@ -0,0 +1,242 @@
|
||||
---
|
||||
name: scientific-writing
|
||||
description: Comprehensive toolkit for writing, structuring, and formatting scientific research papers, manuscripts, and academic documents. This skill should be used when drafting or revising scientific manuscripts, structuring research papers using IMRAD format, formatting citations and references, creating effective figures and tables, applying reporting guidelines (CONSORT, STROBE, PRISMA), writing abstracts or specific paper sections, adhering to journal submission requirements, or improving scientific writing clarity and precision. Supports multiple citation styles (APA, AMA, Vancouver, Chicago), provides field-specific reporting standards, and ensures compliance with academic writing conventions across biomedical, life sciences, engineering, and physical sciences disciplines.
|
||||
---
|
||||
|
||||
# Scientific Writing
|
||||
|
||||
## Overview
|
||||
|
||||
Scientific writing is a specialized form of communication that requires precision, clarity, and adherence to established conventions. This skill provides comprehensive guidance for creating high-quality scientific manuscripts, from initial structure to final submission. Whether drafting a research article, review paper, case report, or thesis, this skill ensures writing meets the rigorous standards of academic and scientific publishing.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
Invoke this skill when:
|
||||
- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)
|
||||
- Structuring a research paper using IMRAD or other standard formats
|
||||
- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)
|
||||
- Creating, formatting, or improving figures, tables, and data visualizations
|
||||
- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)
|
||||
- Drafting abstracts that meet journal requirements (structured or unstructured)
|
||||
- Preparing manuscripts for submission to specific journals
|
||||
- Improving writing clarity, conciseness, and precision
|
||||
- Addressing reviewer comments and revising manuscripts
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
### 1. Manuscript Structure and Organization
|
||||
|
||||
**IMRAD Format**: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:
|
||||
- **Introduction**: Establish research context, identify gaps, state objectives
|
||||
- **Methods**: Detail study design, populations, procedures, and analysis approaches
|
||||
- **Results**: Present findings objectively without interpretation
|
||||
- **Discussion**: Interpret results, acknowledge limitations, propose future directions
|
||||
|
||||
For detailed guidance on IMRAD structure, refer to `references/imrad_structure.md`.
|
||||
|
||||
**Alternative Structures**: Support discipline-specific formats including:
|
||||
- Review articles (narrative, systematic, scoping)
|
||||
- Case reports and case series
|
||||
- Meta-analyses and pooled analyses
|
||||
- Theoretical/modeling papers
|
||||
- Methods papers and protocols
|
||||
|
||||
### 2. Section-Specific Writing Guidance
|
||||
|
||||
**Abstract Composition**: Craft concise, standalone summaries (100-250 words) that capture the paper's purpose, methods, results, and conclusions. Support both structured abstracts (with labeled sections) and unstructured single-paragraph formats.
|
||||
|
||||
**Introduction Development**: Build compelling introductions that:
|
||||
- Establish the research problem's importance
|
||||
- Review relevant literature systematically
|
||||
- Identify knowledge gaps or controversies
|
||||
- State clear research questions or hypotheses
|
||||
- Explain the study's novelty and significance
|
||||
|
||||
**Methods Documentation**: Ensure reproducibility through:
|
||||
- Detailed participant/sample descriptions
|
||||
- Clear procedural documentation
|
||||
- Statistical methods with justification
|
||||
- Equipment and materials specifications
|
||||
- Ethical approval and consent statements
|
||||
|
||||
**Results Presentation**: Present findings with:
|
||||
- Logical flow from primary to secondary outcomes
|
||||
- Integration with figures and tables
|
||||
- Statistical significance with effect sizes
|
||||
- Objective reporting without interpretation
|
||||
|
||||
**Discussion Construction**: Synthesize findings by:
|
||||
- Relating results to research questions
|
||||
- Comparing with existing literature
|
||||
- Acknowledging limitations honestly
|
||||
- Proposing mechanistic explanations
|
||||
- Suggesting practical implications and future research
|
||||
|
||||
### 3. Citation and Reference Management
|
||||
|
||||
Apply citation styles correctly across disciplines. For comprehensive style guides, refer to `references/citation_styles.md`.
|
||||
|
||||
**Major Citation Styles:**
|
||||
- **AMA (American Medical Association)**: Numbered superscript citations, common in medicine
|
||||
- **Vancouver**: Numbered citations in square brackets, biomedical standard
|
||||
- **APA (American Psychological Association)**: Author-date in-text citations, common in social sciences
|
||||
- **Chicago**: Notes-bibliography or author-date, humanities and sciences
|
||||
- **IEEE**: Numbered square brackets, engineering and computer science
|
||||
|
||||
**Best Practices:**
|
||||
- Cite primary sources when possible
|
||||
- Include recent literature (last 5-10 years for active fields)
|
||||
- Balance citation distribution across introduction and discussion
|
||||
- Verify all citations against original sources
|
||||
- Use reference management software (Zotero, Mendeley, EndNote)
|
||||
|
||||
### 4. Figures and Tables
|
||||
|
||||
Create effective data visualizations that enhance comprehension. For detailed best practices, refer to `references/figures_tables.md`.
|
||||
|
||||
**When to Use Tables vs. Figures:**
|
||||
- **Tables**: Precise numerical data, complex datasets, multiple variables requiring exact values
|
||||
- **Figures**: Trends, patterns, relationships, comparisons best understood visually
|
||||
|
||||
**Design Principles:**
|
||||
- Make each table/figure self-explanatory with complete captions
|
||||
- Use consistent formatting and terminology across all display items
|
||||
- Label all axes, columns, and rows with units
|
||||
- Include sample sizes (n) and statistical annotations
|
||||
- Follow the "one table/figure per 1000 words" guideline
|
||||
- Avoid duplicating information between text, tables, and figures
|
||||
|
||||
**Common Figure Types:**
|
||||
- Bar graphs: Comparing discrete categories
|
||||
- Line graphs: Showing trends over time
|
||||
- Scatterplots: Displaying correlations
|
||||
- Box plots: Showing distributions and outliers
|
||||
- Heatmaps: Visualizing matrices and patterns
|
||||
|
||||
### 5. Reporting Guidelines by Study Type
|
||||
|
||||
Ensure completeness and transparency by following established reporting standards. For comprehensive guideline details, refer to `references/reporting_guidelines.md`.
|
||||
|
||||
**Key Guidelines:**
|
||||
- **CONSORT**: Randomized controlled trials
|
||||
- **STROBE**: Observational studies (cohort, case-control, cross-sectional)
|
||||
- **PRISMA**: Systematic reviews and meta-analyses
|
||||
- **STARD**: Diagnostic accuracy studies
|
||||
- **TRIPOD**: Prediction model studies
|
||||
- **ARRIVE**: Animal research
|
||||
- **CARE**: Case reports
|
||||
- **SQUIRE**: Quality improvement studies
|
||||
- **SPIRIT**: Study protocols for clinical trials
|
||||
- **CHEERS**: Economic evaluations
|
||||
|
||||
Each guideline provides checklists ensuring all critical methodological elements are reported.
|
||||
|
||||
### 6. Writing Principles and Style
|
||||
|
||||
Apply fundamental scientific writing principles. For detailed guidance, refer to `references/writing_principles.md`.
|
||||
|
||||
**Clarity**:
|
||||
- Use precise, unambiguous language
|
||||
- Define technical terms and abbreviations at first use
|
||||
- Maintain logical flow within and between paragraphs
|
||||
- Use active voice when appropriate for clarity
|
||||
|
||||
**Conciseness**:
|
||||
- Eliminate redundant words and phrases
|
||||
- Favor shorter sentences (15-20 words average)
|
||||
- Remove unnecessary qualifiers
|
||||
- Respect word limits strictly
|
||||
|
||||
**Accuracy**:
|
||||
- Report exact values with appropriate precision
|
||||
- Use consistent terminology throughout
|
||||
- Distinguish between observations and interpretations
|
||||
- Acknowledge uncertainty appropriately
|
||||
|
||||
**Objectivity**:
|
||||
- Present results without bias
|
||||
- Avoid overstating findings or implications
|
||||
- Acknowledge conflicting evidence
|
||||
- Maintain professional, neutral tone
|
||||
|
||||
### 7. Journal-Specific Formatting
|
||||
|
||||
Adapt manuscripts to journal requirements:
|
||||
- Follow author guidelines for structure, length, and format
|
||||
- Apply journal-specific citation styles
|
||||
- Meet figure/table specifications (resolution, file formats, dimensions)
|
||||
- Include required statements (funding, conflicts of interest, data availability, ethical approval)
|
||||
- Adhere to word limits for each section
|
||||
- Format according to template requirements when provided
|
||||
|
||||
### 8. Common Pitfalls to Avoid
|
||||
|
||||
**Top Rejection Reasons:**
|
||||
1. Inappropriate, incomplete, or insufficiently described statistics
|
||||
2. Over-interpretation of results or unsupported conclusions
|
||||
3. Poorly described methods affecting reproducibility
|
||||
4. Small, biased, or inappropriate samples
|
||||
5. Poor writing quality or difficult-to-follow text
|
||||
6. Inadequate literature review or context
|
||||
7. Figures and tables that are unclear or poorly designed
|
||||
8. Failure to follow reporting guidelines
|
||||
|
||||
**Writing Quality Issues:**
|
||||
- Mixing tenses inappropriately (use past tense for methods/results, present for established facts)
|
||||
- Excessive jargon or undefined acronyms
|
||||
- Paragraph breaks that disrupt logical flow
|
||||
- Missing transitions between sections
|
||||
- Inconsistent notation or terminology
|
||||
|
||||
## Workflow for Manuscript Development
|
||||
|
||||
**Stage 1: Planning**
|
||||
1. Identify target journal and review author guidelines
|
||||
2. Determine applicable reporting guideline (CONSORT, STROBE, etc.)
|
||||
3. Outline manuscript structure (usually IMRAD)
|
||||
4. Plan figures and tables as the backbone of the paper
|
||||
|
||||
**Stage 2: Drafting**
|
||||
1. Start with figures and tables (the core data story)
|
||||
2. Write Methods (often easiest to draft first)
|
||||
3. Draft Results (describing figures/tables objectively)
|
||||
4. Compose Discussion (interpreting findings)
|
||||
5. Write Introduction (setting up the research question)
|
||||
6. Craft Abstract (synthesizing the complete story)
|
||||
7. Create Title (concise and descriptive)
|
||||
|
||||
**Stage 3: Revision**
|
||||
1. Check logical flow and "red thread" throughout
|
||||
2. Verify consistency in terminology and notation
|
||||
3. Ensure figures/tables are self-explanatory
|
||||
4. Confirm adherence to reporting guidelines
|
||||
5. Verify all citations are accurate and properly formatted
|
||||
6. Check word counts for each section
|
||||
7. Proofread for grammar, spelling, and clarity
|
||||
|
||||
**Stage 4: Final Preparation**
|
||||
1. Format according to journal requirements
|
||||
2. Prepare supplementary materials
|
||||
3. Write cover letter highlighting significance
|
||||
4. Complete submission checklists
|
||||
5. Gather all required statements and forms
|
||||
|
||||
## Integration with Other Scientific Skills
|
||||
|
||||
This skill works effectively with:
|
||||
- **Data analysis skills**: For generating results to report
|
||||
- **Statistical analysis**: For determining appropriate statistical presentations
|
||||
- **Literature review skills**: For contextualizing research
|
||||
- **Figure creation tools**: For developing publication-quality visualizations
|
||||
|
||||
## References
|
||||
|
||||
This skill includes comprehensive reference files covering specific aspects of scientific writing:
|
||||
|
||||
- `references/imrad_structure.md`: Detailed guide to IMRAD format and section-specific content
|
||||
- `references/citation_styles.md`: Complete citation style guides (APA, AMA, Vancouver, Chicago, IEEE)
|
||||
- `references/figures_tables.md`: Best practices for creating effective data visualizations
|
||||
- `references/reporting_guidelines.md`: Study-specific reporting standards and checklists
|
||||
- `references/writing_principles.md`: Core principles of effective scientific communication
|
||||
|
||||
Load these references as needed when working on specific aspects of scientific writing.
|
||||
@@ -0,0 +1,555 @@
|
||||
# Citation Styles Guide
|
||||
|
||||
## Overview
|
||||
|
||||
Citation styles provide standardized formats for acknowledging sources in scientific writing. Different disciplines prefer different styles, and journals typically specify which style to use. The five most common citation styles in science are AMA, Vancouver, APA, Chicago, and IEEE.
|
||||
|
||||
## Choosing the Right Style
|
||||
|
||||
| Style | Primary Disciplines | In-Text Format |
|
||||
|-------|-------------------|----------------|
|
||||
| AMA | Medicine, health sciences | Superscript numbers¹ |
|
||||
| Vancouver | Biomedical sciences | Numbers in brackets [1] |
|
||||
| APA | Psychology, social sciences, education | Author-date (Smith, 2023) |
|
||||
| Chicago | Humanities, history, some sciences | Notes-bibliography or author-date |
|
||||
| IEEE | Engineering, computer science | Numbers in brackets [1] |
|
||||
| ACS | Chemistry | Superscript numbers¹ or (1) |
|
||||
| NLM | Life sciences, PubMed | Numbers in brackets [1] |
|
||||
|
||||
**Default recommendation**: When in doubt, check the journal's author guidelines. Most biomedical journals use Vancouver or AMA style.
|
||||
|
||||
## AMA Style (American Medical Association)
|
||||
|
||||
### Overview
|
||||
- Used primarily in medical research
|
||||
- Based on the *AMA Manual of Style* (11th edition, 2020)
|
||||
- Numbered citations appearing as superscripts
|
||||
- References listed numerically in order of appearance
|
||||
|
||||
### In-Text Citations
|
||||
|
||||
**Basic format**: Superscript numerals outside periods and commas, inside semicolons and colons.
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
Several studies have demonstrated this effect.¹
|
||||
|
||||
The results were inconclusive,² although Smith et al³ reported otherwise.
|
||||
|
||||
These findings³⁻⁵ suggest a correlation.
|
||||
|
||||
One meta-analysis⁶ found significant heterogeneity; however, the pooled effect was significant.⁷
|
||||
```
|
||||
|
||||
**Multiple citations**: Use commas or hyphens for ranges
|
||||
```
|
||||
Multiple studies¹,³,⁵⁻⁷ have confirmed this.
|
||||
```
|
||||
|
||||
**Same source cited multiple times**: Use the same number throughout
|
||||
|
||||
### Reference List Format
|
||||
|
||||
**Journal Articles:**
|
||||
```
|
||||
1. Author AA, Author BB, Author CC. Title of article. Journal Name. Year;Volume(Issue):Page range. doi:xx.xxxx
|
||||
```
|
||||
|
||||
**Example:**
|
||||
```
|
||||
1. Smith JD, Johnson AB, Williams CD. Effectiveness of cognitive behavioral therapy for anxiety disorders. JAMA Psychiatry. 2023;80(5):456-464. doi:10.1001/jamapsychiatry.2023.0123
|
||||
```
|
||||
|
||||
**Books:**
|
||||
```
|
||||
2. Author AA. Book Title. Edition. Publisher; Year.
|
||||
```
|
||||
|
||||
**Book Chapters:**
|
||||
```
|
||||
3. Chapter Author AA. Chapter title. In: Editor AA, Editor BB, eds. Book Title. Edition. Publisher; Year:Page range.
|
||||
```
|
||||
|
||||
**Online Resources:**
|
||||
```
|
||||
4. Organization Name. Page title. Website name. Published date. Updated date. Accessed date. URL
|
||||
```
|
||||
|
||||
### Special Cases
|
||||
|
||||
**More than 6 authors**: List first 3, then "et al"
|
||||
```
|
||||
Smith JD, Jones AB, Williams CD, et al.
|
||||
```
|
||||
|
||||
**No author**: Begin with title
|
||||
|
||||
**Advance online publication**:
|
||||
```
|
||||
Published online Month Day, Year. doi:xx.xxxx
|
||||
```
|
||||
|
||||
## Vancouver Style
|
||||
|
||||
### Overview
|
||||
- Developed by the International Committee of Medical Journal Editors (ICMJE)
|
||||
- Described in *Recommendations for the Conduct, Reporting, Editing, and Publication of Scholarly Work in Medical Journals*
|
||||
- Also called "author-number style"
|
||||
- Numbered citations in square brackets
|
||||
- References listed numerically
|
||||
|
||||
### In-Text Citations
|
||||
|
||||
**Basic format**: Numbers in square brackets after the relevant text, before periods and commas.
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
Several studies have shown this effect [1].
|
||||
|
||||
The results were inconclusive [2], although Smith et al [3] reported otherwise.
|
||||
|
||||
These findings [3-5] suggest a correlation.
|
||||
|
||||
Multiple studies [1,3,5-7] have confirmed this.
|
||||
```
|
||||
|
||||
### Reference List Format
|
||||
|
||||
**Journal Articles:**
|
||||
```
|
||||
1. Author AA, Author BB, Author CC. Title of article. Journal Name. Year;Volume(Issue):Page range.
|
||||
```
|
||||
|
||||
**Example:**
|
||||
```
|
||||
1. Smith JD, Johnson AB, Williams CD. Effectiveness of cognitive behavioral therapy for anxiety disorders. JAMA Psychiatry. 2023;80(5):456-464.
|
||||
```
|
||||
|
||||
**Books:**
|
||||
```
|
||||
2. Author AA, Author BB. Book title. Edition. Place of publication: Publisher; Year.
|
||||
```
|
||||
|
||||
**Book Chapters:**
|
||||
```
|
||||
3. Chapter Author AA, Chapter Author BB. Chapter title. In: Editor AA, Editor BB, editors. Book title. Edition. Place: Publisher; Year. p. Page range.
|
||||
```
|
||||
|
||||
**Electronic Sources:**
|
||||
```
|
||||
4. Author AA. Title of page [Internet]. Place: Publisher; Date of publication [cited Date of citation]. Available from: URL
|
||||
```
|
||||
|
||||
### Special Cases
|
||||
|
||||
**More than 6 authors**: List first 6, then "et al."
|
||||
|
||||
**Journal title abbreviations**: Use PubMed/Index Medicus abbreviations
|
||||
- *The Journal of the American Medical Association* → *JAMA*
|
||||
- *Nature Medicine* → *Nat Med*
|
||||
|
||||
**No volume or issue**: Use year and page numbers only
|
||||
|
||||
**Article in press**: Use "[Epub ahead of print]" notation
|
||||
|
||||
## APA Style (American Psychological Association)
|
||||
|
||||
### Overview
|
||||
- Widely used in psychology, education, and social sciences
|
||||
- Based on the *Publication Manual of the APA* (7th edition, 2020)
|
||||
- Author-date format for in-text citations
|
||||
- References listed alphabetically by author surname
|
||||
|
||||
### In-Text Citations
|
||||
|
||||
**Basic format**: (Author, Year)
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
One study found significant effects (Smith, 2023).
|
||||
|
||||
Smith (2023) found significant effects.
|
||||
|
||||
Multiple studies (Jones, 2020; Smith, 2023; Williams, 2024) support this conclusion.
|
||||
```
|
||||
|
||||
**Two authors**: Use "&" in parentheses, "and" in narrative
|
||||
```
|
||||
(Smith & Jones, 2023)
|
||||
Smith and Jones (2023) demonstrated...
|
||||
```
|
||||
|
||||
**Three or more authors**: Use "et al." after first author
|
||||
```
|
||||
(Smith et al., 2023)
|
||||
Smith et al. (2023) reported...
|
||||
```
|
||||
|
||||
**Multiple works by same author(s) in same year**: Add letters
|
||||
```
|
||||
(Smith, 2023a, 2023b)
|
||||
```
|
||||
|
||||
**Direct quotations**: Include page numbers
|
||||
```
|
||||
(Smith, 2023, p. 45)
|
||||
"Quote text" (Smith, 2023, p. 45).
|
||||
Smith (2023) stated, "Quote text" (p. 45).
|
||||
```
|
||||
|
||||
### Reference List Format
|
||||
|
||||
**Journal Articles:**
|
||||
```
|
||||
Author, A. A., Author, B. B., & Author, C. C. (Year). Title of article. Journal Name, Volume(Issue), page range. https://doi.org/xx.xxxx
|
||||
```
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Smith, J. D., Johnson, A. B., & Williams, C. D. (2023). Effectiveness of cognitive behavioral therapy for anxiety disorders. JAMA Psychiatry, 80(5), 456-464. https://doi.org/10.1001/jamapsychiatry.2023.0123
|
||||
```
|
||||
|
||||
**Books:**
|
||||
```
|
||||
Author, A. A. (Year). Book title: Subtitle (Edition). Publisher. https://doi.org/xx.xxxx
|
||||
```
|
||||
|
||||
**Book Chapters:**
|
||||
```
|
||||
Chapter Author, A. A., & Chapter Author, B. B. (Year). Chapter title. In E. E. Editor & F. F. Editor (Eds.), Book title (pp. page range). Publisher.
|
||||
```
|
||||
|
||||
**Websites:**
|
||||
```
|
||||
Author, A. A. (Year, Month Day). Page title. Website Name. URL
|
||||
```
|
||||
|
||||
### Capitalization Rules
|
||||
- Sentence case for article and book titles (capitalize only first word and proper nouns)
|
||||
- Title case for journal names (capitalize all major words)
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Smith, J. D. (2023). Effects of stress on cognitive performance: A meta-analysis. Journal of Experimental Psychology: General, 152(3), 456-478.
|
||||
```
|
||||
|
||||
### Special Cases
|
||||
|
||||
**No author**: Move title to author position
|
||||
```
|
||||
Title of work. (Year). Journal Name...
|
||||
```
|
||||
|
||||
**No date**: Use (n.d.)
|
||||
```
|
||||
Smith, J. D. (n.d.). Title...
|
||||
```
|
||||
|
||||
**Up to 20 authors**: List all authors with "&" before last
|
||||
**21 or more authors**: List first 19, then "...", then final author
|
||||
|
||||
## Chicago Style
|
||||
|
||||
### Overview
|
||||
- Based on *The Chicago Manual of Style* (17th edition, 2017)
|
||||
- Two systems: Notes-Bibliography and Author-Date
|
||||
- Notes-Bibliography common in humanities
|
||||
- Author-Date common in sciences
|
||||
|
||||
### Notes-Bibliography System
|
||||
|
||||
**In-Text**: Superscript numbers for footnotes or endnotes
|
||||
```
|
||||
One study demonstrated this effect.¹
|
||||
```
|
||||
|
||||
**Note format:**
|
||||
```
|
||||
1. John D. Smith, Alice B. Johnson, and Carol D. Williams, "Effectiveness of Cognitive Behavioral Therapy for Anxiety Disorders," JAMA Psychiatry 80, no. 5 (2023): 456-64.
|
||||
```
|
||||
|
||||
**Bibliography format:**
|
||||
```
|
||||
Smith, John D., Alice B. Johnson, and Carol D. Williams. "Effectiveness of Cognitive Behavioral Therapy for Anxiety Disorders." JAMA Psychiatry 80, no. 5 (2023): 456-64.
|
||||
```
|
||||
|
||||
### Author-Date System
|
||||
|
||||
**In-Text**: Similar to APA
|
||||
```
|
||||
(Smith, Johnson, and Williams 2023)
|
||||
Smith, Johnson, and Williams (2023) found...
|
||||
```
|
||||
|
||||
**Reference list**: Similar to APA but with different punctuation
|
||||
```
|
||||
Smith, John D., Alice B. Johnson, and Carol D. Williams. 2023. "Effectiveness of Cognitive Behavioral Therapy for Anxiety Disorders." JAMA Psychiatry 80 (5): 456-64.
|
||||
```
|
||||
|
||||
### Special Features
|
||||
- Full names in bibliography (not just initials)
|
||||
- Uses "and" not "&"
|
||||
- Different punctuation from APA
|
||||
|
||||
## IEEE Style
|
||||
|
||||
### Overview
|
||||
- Used in engineering, computer science, and technology
|
||||
- Published by the Institute of Electrical and Electronics Engineers
|
||||
- Numbered citations in square brackets
|
||||
- References listed numerically
|
||||
|
||||
### In-Text Citations
|
||||
|
||||
**Format**: Numbers in square brackets
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
Several studies have demonstrated this effect [1].
|
||||
|
||||
The algorithm was described by Smith [2] and later improved [3], [4].
|
||||
|
||||
Multiple implementations [1]-[4] have been proposed.
|
||||
```
|
||||
|
||||
### Reference List Format
|
||||
|
||||
**Journal Articles:**
|
||||
```
|
||||
[1] A. A. Author, B. B. Author, and C. C. Author, "Title of article," Journal Name, vol. X, no. X, pp. XX-XX, Month Year.
|
||||
```
|
||||
|
||||
**Example:**
|
||||
```
|
||||
[1] J. D. Smith, A. B. Johnson, and C. D. Williams, "Effectiveness of cognitive behavioral therapy for anxiety disorders," JAMA Psychiatry, vol. 80, no. 5, pp. 456-464, May 2023.
|
||||
```
|
||||
|
||||
**Books:**
|
||||
```
|
||||
[2] A. A. Author, Book Title, Edition. City, State: Publisher, Year.
|
||||
```
|
||||
|
||||
**Conference Papers:**
|
||||
```
|
||||
[3] A. A. Author, "Paper title," in Proc. Conference Name, City, State, Year, pp. XX-XX.
|
||||
```
|
||||
|
||||
**Online Sources:**
|
||||
```
|
||||
[4] A. A. Author. "Title." Website. URL (accessed Mon. Day, Year).
|
||||
```
|
||||
|
||||
### Special Features
|
||||
- Abbreviated first and middle names
|
||||
- Uses "and" before last author (not comma)
|
||||
- Month abbreviations (Jan., Feb., etc.)
|
||||
- "vol." and "no." before volume and issue
|
||||
- "pp." before page range
|
||||
|
||||
## Additional Styles
|
||||
|
||||
### ACS Style (American Chemical Society)
|
||||
|
||||
**In-Text**: Superscript numbers or numbers in parentheses
|
||||
```
|
||||
This reaction has been well studied.¹
|
||||
This reaction has been well studied (1).
|
||||
```
|
||||
|
||||
**Reference format:**
|
||||
```
|
||||
(1) Smith, J. D.; Johnson, A. B.; Williams, C. D. Title of Article. J. Am. Chem. Soc. 2023, 145, 1234-1245.
|
||||
```
|
||||
|
||||
**Features:**
|
||||
- Semicolons between authors
|
||||
- Abbreviated journal names
|
||||
- Year in bold
|
||||
- No issue numbers
|
||||
|
||||
### NLM Style (National Library of Medicine)
|
||||
|
||||
**Very similar to Vancouver**, used by PubMed/MEDLINE
|
||||
|
||||
**Key differences:**
|
||||
- Uses PubMed journal abbreviations
|
||||
- Specific format for electronic publications
|
||||
- PMID or PMCID can be included
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Smith JD, Johnson AB, Williams CD. Effectiveness of cognitive behavioral therapy for anxiety disorders. JAMA Psychiatry. 2023 May;80(5):456-64. doi: 10.1001/jamapsychiatry.2023.0123. PMID: 12345678.
|
||||
```
|
||||
|
||||
## General Citation Best Practices
|
||||
|
||||
### Across All Styles
|
||||
|
||||
**When to cite:**
|
||||
- Direct quotations
|
||||
- Paraphrased ideas from others
|
||||
- Statistics, data, or figures from other sources
|
||||
- Theories, models, or frameworks developed by others
|
||||
- Information that is not common knowledge
|
||||
|
||||
**Citation density:**
|
||||
- Introduction: Cite liberally to establish context
|
||||
- Methods: Cite when referencing established protocols or instruments
|
||||
- Results: Rarely cite (focus on your own findings)
|
||||
- Discussion: Cite frequently when comparing to prior work
|
||||
|
||||
**Source quality:**
|
||||
- Prefer peer-reviewed journal articles
|
||||
- Cite original sources when possible (not secondary citations)
|
||||
- Use recent sources (within 5-10 years for active fields)
|
||||
- Ensure sources are reputable and relevant
|
||||
|
||||
**Common mistakes to avoid:**
|
||||
- Inconsistent formatting
|
||||
- Missing required elements (DOI, page numbers, etc.)
|
||||
- Citing sources not actually read (citation chaining)
|
||||
- Over-reliance on review articles instead of primary sources
|
||||
- Including uncited references or missing cited references
|
||||
- Incorrect author names or initials
|
||||
- Wrong year of publication
|
||||
- Truncated titles
|
||||
|
||||
### Managing Citations
|
||||
|
||||
**Reference Management Software:**
|
||||
- **Zotero**: Free, open-source, browser integration
|
||||
- **Mendeley**: Free, PDF annotation, social features
|
||||
- **EndNote**: Commercial, powerful, institutional support
|
||||
- **RefWorks**: Web-based, institutional subscriptions
|
||||
|
||||
**Software benefits:**
|
||||
- Automatic formatting in multiple styles
|
||||
- In-text citation insertion
|
||||
- Reference list generation
|
||||
- PDF organization
|
||||
- Sharing capabilities
|
||||
|
||||
### Verifying Citations
|
||||
|
||||
**Before submission, check:**
|
||||
1. Every in-text citation has a corresponding reference
|
||||
2. Every reference is cited in text
|
||||
3. Formatting is consistent throughout
|
||||
4. Author names and initials are correct
|
||||
5. Titles are accurate
|
||||
6. Journal names match required abbreviations
|
||||
7. Volume, issue, and page numbers are correct
|
||||
8. DOIs are included (when required)
|
||||
9. URLs are functional (for web sources)
|
||||
10. Citations appear in correct order (numerical styles)
|
||||
|
||||
## DOI (Digital Object Identifier)
|
||||
|
||||
### What is a DOI?
|
||||
A unique alphanumeric string identifying digital content permanently.
|
||||
|
||||
**Format:**
|
||||
```
|
||||
doi:10.1001/jamapsychiatry.2023.0123
|
||||
or
|
||||
https://doi.org/10.1001/jamapsychiatry.2023.0123
|
||||
```
|
||||
|
||||
### When to include:
|
||||
- Required by most journals for recent publications
|
||||
- Preferred over URLs because DOIs don't change
|
||||
- Look up DOIs at https://www.crossref.org/ if not provided
|
||||
|
||||
### Style-specific formatting:
|
||||
- **AMA**: `doi:10.xxxx/xxxxx`
|
||||
- **APA**: `https://doi.org/10.xxxx/xxxxx`
|
||||
- **Vancouver**: Often omitted or added at journal's discretion
|
||||
- **Chicago**: `https://doi.org/10.xxxx/xxxxx`
|
||||
|
||||
## Quick Reference: Journal Article Format
|
||||
|
||||
| Style | Format |
|
||||
|-------|--------|
|
||||
| **AMA** | Author AA, Author BB. Title of article. *Journal*. Year;Vol(Iss):pp. doi:xx |
|
||||
| **Vancouver** | Author AA, Author BB. Title of article. Journal. Year;Vol(Iss):pp. |
|
||||
| **APA** | Author, A. A., & Author, B. B. (Year). Title of article. *Journal*, Vol(Iss), pp. https://doi.org/xx |
|
||||
| **Chicago A-D** | Author, A. A., and B. B. Author. Year. "Title." *Journal* Vol (Iss): pp. |
|
||||
| **IEEE** | A. A. Author and B. B. Author, "Title," *Journal*, vol. X, no. X, pp. XX-XX, Mon. Year. |
|
||||
|
||||
## Common Abbreviations
|
||||
|
||||
### Journal Abbreviations
|
||||
Follow the journal's specified system (usually Index Medicus or ISO):
|
||||
- *The Journal of Biological Chemistry* → *J Biol Chem*
|
||||
- *Proceedings of the National Academy of Sciences* → *Proc Natl Acad Sci USA*
|
||||
- *Nature Medicine* → *Nat Med*
|
||||
|
||||
### Month Abbreviations
|
||||
- Jan., Feb., Mar., Apr., May, June, July, Aug., Sept., Oct., Nov., Dec.
|
||||
- Some styles use three-letter abbreviations without periods
|
||||
|
||||
### Edition Abbreviations
|
||||
- 1st ed., 2nd ed., 3rd ed., etc.
|
||||
- Or: 1st edition, 2nd edition
|
||||
|
||||
## Special Publication Types
|
||||
|
||||
### Preprints
|
||||
```
|
||||
APA: Author, A. A. (Year). Title [Preprint]. Repository Name. https://doi.org/xx.xxxx
|
||||
```
|
||||
|
||||
### Theses and Dissertations
|
||||
```
|
||||
APA: Author, A. A. (Year). Title [Doctoral dissertation, University Name]. Repository Name. URL
|
||||
```
|
||||
|
||||
### Conference Proceedings
|
||||
```
|
||||
IEEE: A. A. Author, "Title," in Proc. Conf. Name, City, Year, pp. XX-XX.
|
||||
```
|
||||
|
||||
### Software/Code
|
||||
```
|
||||
APA: Author, A. A. (Year). Title (Version X.X) [Computer software]. Publisher. URL
|
||||
```
|
||||
|
||||
### Datasets
|
||||
```
|
||||
APA: Author, A. A. (Year). Title of dataset (Version X) [Data set]. Repository. https://doi.org/xx.xxxx
|
||||
```
|
||||
|
||||
## Transitioning Between Styles
|
||||
|
||||
When converting between citation styles:
|
||||
|
||||
1. **Use reference management software** for automatic conversion
|
||||
2. **Check these elements** that vary by style:
|
||||
- In-text citation format (numbered vs. author-date)
|
||||
- Author name format (initials vs. full names)
|
||||
- Title capitalization (sentence case vs. title case)
|
||||
- Journal name formatting (abbreviated vs. full)
|
||||
- Punctuation (periods, commas, semicolons)
|
||||
- Use of italics and bold
|
||||
- Order of elements
|
||||
3. **Manually verify** after automatic conversion
|
||||
4. **Check journal guidelines** for specific requirements
|
||||
|
||||
## Resources for Citation Styles
|
||||
|
||||
### Official Manuals
|
||||
- AMA: https://www.amamanualofstyle.com/
|
||||
- Vancouver/ICMJE: http://www.icmje.org/
|
||||
- APA: https://apastyle.apa.org/
|
||||
- Chicago: https://www.chicagomanualofstyle.org/
|
||||
- IEEE: https://ieeeauthorcenter.ieee.org/
|
||||
|
||||
### Quick Reference Guides
|
||||
- Purdue OWL: https://owl.purdue.edu/
|
||||
- Citation Machine: https://www.citationmachine.net/
|
||||
- EasyBib: https://www.easybib.com/
|
||||
|
||||
### Reference Management
|
||||
- Zotero: https://www.zotero.org/
|
||||
- Mendeley: https://www.mendeley.com/
|
||||
- EndNote: https://endnote.com/
|
||||
@@ -0,0 +1,677 @@
|
||||
# Figures and Tables Best Practices
|
||||
|
||||
## Overview
|
||||
|
||||
Figures and tables are essential components of scientific papers, serving to display data patterns, summarize results, and provide evidence for conclusions. Effective visual displays enhance comprehension and can sustain reader interest while illustrating trends, patterns, and relationships not easily conveyed through text alone.
|
||||
|
||||
A recent Nature Cell Biology checklist (2025) emphasizes that creating clear and engaging scientific figures is crucial for communicating complex data with clarity, accessibility, and design excellence.
|
||||
|
||||
## When to Use Tables vs. Figures
|
||||
|
||||
### Use Tables When:
|
||||
- Presenting precise numerical values that readers need to reference
|
||||
- Comparing exact measurements across multiple variables
|
||||
- Showing detailed statistical outputs
|
||||
- Data cannot be adequately summarized in 1-2 sentences
|
||||
- Readers need access to specific data points
|
||||
- Displaying demographic or baseline characteristics
|
||||
- Presenting multiple related statistical tests
|
||||
|
||||
**Example use cases:**
|
||||
- Baseline participant characteristics (age, sex, diagnosis, etc.)
|
||||
- Detailed statistical model outputs (coefficients, p-values, confidence intervals)
|
||||
- Dose-response data with exact values
|
||||
- Gene expression levels for specific genes
|
||||
- Chemical compositions or concentrations
|
||||
|
||||
### Use Figures When:
|
||||
- Showing trends over time
|
||||
- Displaying relationships or correlations
|
||||
- Comparing groups visually
|
||||
- Illustrating distributions
|
||||
- Demonstrating patterns not easily seen in numbers
|
||||
- Showing images (microscopy, radiography, etc.)
|
||||
- Displaying workflows, diagrams, or schematics
|
||||
|
||||
**Example use cases:**
|
||||
- Growth curves or time series
|
||||
- Dose-response curves
|
||||
- Scatter plots showing correlations
|
||||
- Bar graphs comparing treatment groups
|
||||
- Histograms showing distributions
|
||||
- Heatmaps displaying patterns across conditions
|
||||
- Microscopy images or Western blots
|
||||
|
||||
### General Decision Rule
|
||||
|
||||
**Can the information be conveyed in 1-2 sentences of text?**
|
||||
- Yes → Use text only
|
||||
- No, and precise values are needed → Use a table
|
||||
- No, and patterns/trends are most important → Use a figure
|
||||
|
||||
## Core Design Principles
|
||||
|
||||
### 1. Self-Explanatory Display Items
|
||||
|
||||
**Each figure or table must stand alone without requiring the main text.**
|
||||
|
||||
**Essential elements:**
|
||||
- Complete, descriptive caption
|
||||
- All abbreviations defined (in caption or footnote)
|
||||
- Units of measurement clearly indicated
|
||||
- Sample sizes (n) reported
|
||||
- Statistical significance annotations explained
|
||||
- Legend included (for figures with multiple data series)
|
||||
|
||||
**Example of self-explanatory caption:**
|
||||
```
|
||||
Figure 1. Mean systolic blood pressure (SBP) over 12 weeks in intervention and control groups.
|
||||
Error bars represent standard error of the mean (SEM). Asterisks indicate significant
|
||||
differences between groups at each time point (*p < 0.05, **p < 0.01, ***p < 0.001,
|
||||
two-tailed t-tests). n = 48 per group. BP = blood pressure; SEM = standard error of mean.
|
||||
```
|
||||
|
||||
### 2. Avoid Redundancy
|
||||
|
||||
**Do not duplicate information between text, tables, and figures.**
|
||||
|
||||
**Bad practice:**
|
||||
```
|
||||
"Mean age was 45.2 years in Group A and 47.8 years in Group B. Mean BMI was 26.3 in
|
||||
Group A and 28.1 in Group B. Mean systolic blood pressure was 132 mmHg in Group A..."
|
||||
[Also shown in Table 1]
|
||||
```
|
||||
|
||||
**Good practice:**
|
||||
```
|
||||
"Baseline characteristics were similar between groups (Table 1), with no significant
|
||||
differences in age, BMI, or blood pressure (all p > 0.15)."
|
||||
[Details in Table 1]
|
||||
```
|
||||
|
||||
**Key principle:** Text should highlight key findings from tables/figures, not repeat all data.
|
||||
|
||||
### 3. Consistency
|
||||
|
||||
**Maintain uniform formatting across all display items:**
|
||||
- Font types and sizes
|
||||
- Color schemes
|
||||
- Terminology and abbreviations
|
||||
- Axis labels and units
|
||||
- Statistical annotation methods
|
||||
- Figure styles (all line graphs should look similar)
|
||||
|
||||
**Example of inconsistency to avoid:**
|
||||
- Figure 1 uses "standard error" while Figure 2 uses "SE"
|
||||
- Figure 1 has blue/red color scheme while Figure 2 uses green/yellow
|
||||
- Table 1 reports p-values as "p = 0.023" while Table 2 uses "p-value = .023"
|
||||
|
||||
### 4. Optimal Quantity
|
||||
|
||||
**Follow the "one display item per 1000 words" guideline.**
|
||||
|
||||
**Typical manuscript:**
|
||||
- 3000-4000 words → 3-4 tables/figures total
|
||||
- 5000-6000 words → 5-6 tables/figures total
|
||||
|
||||
**Quality over quantity:** A few well-designed, information-rich displays are better than many redundant or poorly designed ones.
|
||||
|
||||
### 5. Clarity and Simplicity
|
||||
|
||||
**Avoid cluttered or overly complex displays:**
|
||||
- Don't include too many variables in one figure
|
||||
- Use clear, readable fonts (minimum 8-10 pt in final size)
|
||||
- Provide adequate spacing between elements
|
||||
- Use high contrast (especially for color-blind accessibility)
|
||||
- Remove unnecessary grid lines, borders, or decoration
|
||||
- Maximize data-ink ratio (Tufte principle: minimize non-data ink)
|
||||
|
||||
## Figure Types and When to Use Them
|
||||
|
||||
### Bar Graphs
|
||||
|
||||
**Best for:**
|
||||
- Comparing discrete categories or groups
|
||||
- Showing counts or frequencies
|
||||
- Displaying mean values with error bars
|
||||
|
||||
**Design guidelines:**
|
||||
- Start y-axis at zero (unless showing small differences in large values)
|
||||
- Order bars logically (by size, alphabetically, or temporally)
|
||||
- Use error bars (SD, SEM, or CI) consistently
|
||||
- Include sample sizes
|
||||
- Avoid 3D effects (they distort perception)
|
||||
|
||||
**Common mistakes:**
|
||||
- Not starting at zero (can exaggerate differences)
|
||||
- Too many categories (consider table instead)
|
||||
- Missing error bars
|
||||
|
||||
**Example applications:**
|
||||
- Mean gene expression across tissue types
|
||||
- Treatment group comparisons
|
||||
- Frequency of adverse events
|
||||
|
||||
### Line Graphs
|
||||
|
||||
**Best for:**
|
||||
- Showing trends over continuous variables (usually time)
|
||||
- Displaying multiple groups on same axes
|
||||
- Illustrating dose-response relationships
|
||||
|
||||
**Design guidelines:**
|
||||
- Use different line styles or colors for groups
|
||||
- Include data point markers for sparse data
|
||||
- Show error bars or shaded confidence intervals
|
||||
- Label axes clearly with units
|
||||
- Use consistent intervals on x-axis
|
||||
|
||||
**Common mistakes:**
|
||||
- Connecting discrete data points that shouldn't be connected
|
||||
- Too many lines making graph unreadable
|
||||
- Inconsistent time intervals without indication
|
||||
|
||||
**Example applications:**
|
||||
- Growth curves
|
||||
- Time course experiments
|
||||
- Survival curves (Kaplan-Meier plots)
|
||||
- Pharmacokinetic profiles
|
||||
|
||||
### Scatter Plots
|
||||
|
||||
**Best for:**
|
||||
- Showing relationships between two continuous variables
|
||||
- Displaying correlations
|
||||
- Identifying outliers
|
||||
|
||||
**Design guidelines:**
|
||||
- Include trend line or regression line with equation and R²
|
||||
- Report correlation coefficient and p-value
|
||||
- Use semi-transparent points if data overlap
|
||||
- Consider logarithmic scales for wide ranges
|
||||
- Mark outliers if relevant
|
||||
|
||||
**Common mistakes:**
|
||||
- Not showing individual data points
|
||||
- Using scatter plots for categorical data
|
||||
- Missing correlation statistics
|
||||
|
||||
**Example applications:**
|
||||
- Correlation between biomarkers
|
||||
- Relationship between dose and response
|
||||
- Method comparison (Bland-Altman plots)
|
||||
|
||||
### Box Plots (Box-and-Whisker Plots)
|
||||
|
||||
**Best for:**
|
||||
- Showing distributions and spread
|
||||
- Comparing distributions across groups
|
||||
- Identifying outliers
|
||||
|
||||
**Design guidelines:**
|
||||
- Clearly define box elements (median, quartiles, whiskers)
|
||||
- Show or note outliers explicitly
|
||||
- Consider violin plots for small sample sizes
|
||||
- Overlay individual data points when n < 20
|
||||
|
||||
**Common mistakes:**
|
||||
- Not defining what whiskers represent
|
||||
- Using for very small samples without showing raw data
|
||||
- Not marking outliers
|
||||
|
||||
**Example applications:**
|
||||
- Comparing distributions across treatment groups
|
||||
- Showing variability in measurements
|
||||
- Quality control data
|
||||
|
||||
### Heatmaps
|
||||
|
||||
**Best for:**
|
||||
- Displaying matrices of data
|
||||
- Showing patterns across many conditions
|
||||
- Representing clustering or grouping
|
||||
|
||||
**Design guidelines:**
|
||||
- Use color scales that are perceptually uniform
|
||||
- Include color scale bar with units
|
||||
- Consider hierarchical clustering for rows/columns
|
||||
- Use appropriate color scheme (diverging vs. sequential)
|
||||
- Make axes labels readable
|
||||
|
||||
**Common mistakes:**
|
||||
- Poor color choice (rainbow scales are often misleading)
|
||||
- Too many rows/columns making labels unreadable
|
||||
- No color scale bar
|
||||
|
||||
**Example applications:**
|
||||
- Gene expression across samples
|
||||
- Correlation matrices
|
||||
- Time-series data across multiple variables
|
||||
|
||||
### Images (Microscopy, Gels, Blots)
|
||||
|
||||
**Best for:**
|
||||
- Showing representative examples
|
||||
- Demonstrating morphology or localization
|
||||
- Presenting gel electrophoresis or Western blots
|
||||
|
||||
**Design guidelines:**
|
||||
- Include scale bars (not magnification in caption)
|
||||
- Show representative images with quantification in separate panel
|
||||
- Label important features with arrows or labels
|
||||
- Ensure adequate resolution (usually 300+ dpi)
|
||||
- Show full, unmanipulated images with cropping noted
|
||||
- Include all relevant controls
|
||||
|
||||
**Common mistakes:**
|
||||
- No scale bar
|
||||
- Over-processed or manipulated images
|
||||
- Cherry-picking best images without quantification
|
||||
- Insufficient resolution
|
||||
|
||||
**Example applications:**
|
||||
- Histological sections
|
||||
- Immunofluorescence
|
||||
- Western blots
|
||||
- Gel electrophoresis
|
||||
|
||||
### Forest Plots
|
||||
|
||||
**Best for:**
|
||||
- Displaying meta-analysis results
|
||||
- Showing effect sizes with confidence intervals
|
||||
- Comparing multiple studies or subgroups
|
||||
|
||||
**Design guidelines:**
|
||||
- Include point estimates and CI for each study
|
||||
- Show overall pooled estimate clearly
|
||||
- Include line of no effect (typically at 1.0 or 0)
|
||||
- List study details or weights
|
||||
|
||||
**Example applications:**
|
||||
- Meta-analyses
|
||||
- Systematic reviews
|
||||
- Subgroup analyses
|
||||
|
||||
### Flow Diagrams
|
||||
|
||||
**Best for:**
|
||||
- Study participant flow (CONSORT diagrams)
|
||||
- Systematic review search process (PRISMA diagrams)
|
||||
- Experimental workflows
|
||||
|
||||
**Design guidelines:**
|
||||
- Follow reporting guideline templates (CONSORT, PRISMA)
|
||||
- Use consistent shapes and connectors
|
||||
- Include numbers at each stage
|
||||
- Clearly show inclusions and exclusions
|
||||
|
||||
## Table Design Guidelines
|
||||
|
||||
### Structure
|
||||
|
||||
**Basic anatomy:**
|
||||
1. **Table number and title** (above table)
|
||||
2. **Column headers** (with units)
|
||||
3. **Row labels**
|
||||
4. **Data cells** (with appropriate precision)
|
||||
5. **Footnotes** (below table for abbreviations, statistics, notes)
|
||||
|
||||
### Formatting Best Practices
|
||||
|
||||
**Column headers:**
|
||||
- Use clear, concise labels
|
||||
- Include units in parentheses
|
||||
- Use abbreviations sparingly (define in footnote)
|
||||
|
||||
**Data presentation:**
|
||||
- Align decimal points in columns
|
||||
- Use consistent decimal places (usually 1-2 for means)
|
||||
- Report same precision across rows/columns
|
||||
- Use en-dash (–) for "not applicable"
|
||||
- Use appropriate precision (don't over-report)
|
||||
|
||||
**Statistical annotations:**
|
||||
- Use superscript letters (ᵃ, ᵇ, ᶜ) or symbols (*, †, ‡) for footnotes
|
||||
- Define p-value thresholds clearly
|
||||
- Report exact p-values when possible (p = 0.032, not p < 0.05)
|
||||
|
||||
**Footnotes:**
|
||||
- Define all abbreviations
|
||||
- Explain statistical tests used
|
||||
- Note any missing data
|
||||
- Indicate data source if not original
|
||||
|
||||
### Example Table Format
|
||||
|
||||
```
|
||||
Table 1. Baseline Characteristics of Study Participants
|
||||
|
||||
Characteristic Intervention (n=50) Control (n=48) p-value
|
||||
─────────────────────────────────────────────────────────────────────────
|
||||
Age, years 45.3 ± 8.2 47.1 ± 9.1 0.28
|
||||
Male sex, n (%) 28 (56) 25 (52) 0.71
|
||||
BMI, kg/m² 26.3 ± 3.8 27.1 ± 4.2 0.32
|
||||
Current smoker, n (%) 12 (24) 15 (31) 0.42
|
||||
Systolic BP, mmHg 132 ± 15 134 ± 18 0.54
|
||||
─────────────────────────────────────────────────────────────────────────
|
||||
|
||||
Data presented as mean ± SD or n (%). p-values from independent t-tests for
|
||||
continuous variables and χ² tests for categorical variables. BMI = body mass
|
||||
index; BP = blood pressure; SD = standard deviation.
|
||||
```
|
||||
|
||||
### Common Table Mistakes
|
||||
|
||||
1. **Excessive complexity** (too many rows/columns)
|
||||
2. **Insufficient context** (missing units, unclear abbreviations)
|
||||
3. **Over-precision** (reporting 5 decimal places for p-values)
|
||||
4. **Missing sample sizes**
|
||||
5. **No statistical comparisons when appropriate**
|
||||
6. **Inconsistent formatting** across multiple tables
|
||||
7. **Duplicate information** with figures or text
|
||||
|
||||
## Statistical Presentation in Figures and Tables
|
||||
|
||||
### Reporting Requirements
|
||||
|
||||
**For each comparison, report:**
|
||||
1. **Point estimate** (mean, median, proportion)
|
||||
2. **Measure of variability** (SD, SEM, CI)
|
||||
3. **Sample size** (n)
|
||||
4. **Test statistic** (t, F, χ², etc.)
|
||||
5. **p-value** (exact when p > 0.001)
|
||||
6. **Effect size** (when appropriate)
|
||||
|
||||
### Error Bars
|
||||
|
||||
**Choose the appropriate measure:**
|
||||
|
||||
| Measure | Meaning | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| **SD (Standard Deviation)** | Variability in the data | Showing data spread |
|
||||
| **SEM (Standard Error of Mean)** | Precision of mean estimate | Showing measurement precision |
|
||||
| **95% CI (Confidence Interval)** | Range likely to contain true mean | Showing statistical significance |
|
||||
|
||||
**Key rule:** Always state which measure is shown.
|
||||
|
||||
**Example caption:**
|
||||
```
|
||||
"Error bars represent 95% confidence intervals."
|
||||
NOT: "Error bars represent standard error."
|
||||
```
|
||||
|
||||
**Recommendation:** 95% CI preferred because non-overlapping CIs indicate significant differences.
|
||||
|
||||
### Significance Indicators
|
||||
|
||||
**Common notation:**
|
||||
```
|
||||
* p < 0.05
|
||||
** p < 0.01
|
||||
*** p < 0.001
|
||||
n.s. or NS = not significant
|
||||
```
|
||||
|
||||
**Alternative:** Show exact p-values in table or caption
|
||||
|
||||
**Best practice:** Define significance indicators in every figure caption or table footnote.
|
||||
|
||||
## Accessibility Considerations
|
||||
|
||||
### Color-Blind Friendly Design
|
||||
|
||||
**Recommendations:**
|
||||
- Use color palettes designed for color-blind accessibility
|
||||
- Don't rely on color alone (add patterns, shapes, or labels)
|
||||
- Test figures in grayscale
|
||||
- Avoid red-green combinations
|
||||
|
||||
**Color-blind safe palettes:**
|
||||
- Blue-Orange
|
||||
- Purple-Yellow
|
||||
- Colorbrewer2.org palettes
|
||||
- Viridis, Plasma, Inferno (for heatmaps)
|
||||
|
||||
### High Contrast
|
||||
|
||||
**Ensure readability:**
|
||||
- Dark text on light background (or vice versa)
|
||||
- Avoid low-contrast color combinations (gray on gray)
|
||||
- Use thick enough lines (minimum 0.5-1 pt)
|
||||
- Large enough text (minimum 8-10 pt after scaling)
|
||||
|
||||
### Screen and Print Compatibility
|
||||
|
||||
**Design for both media:**
|
||||
- Use vector formats when possible (PDF, EPS, SVG)
|
||||
- Minimum 300 dpi for raster images (TIFF, PNG)
|
||||
- Test appearance at final print size
|
||||
- Ensure color figures work in grayscale if printed
|
||||
|
||||
## Technical Requirements
|
||||
|
||||
### File Formats
|
||||
|
||||
**Vector formats** (preferred for graphs and diagrams):
|
||||
- **PDF**: Universal, preserves quality
|
||||
- **EPS**: Encapsulated PostScript, publishing standard
|
||||
- **SVG**: Scalable vector graphics, web-friendly
|
||||
|
||||
**Raster formats** (for photos and images):
|
||||
- **TIFF**: Uncompressed, high quality, large files
|
||||
- **PNG**: Lossless compression, good for screen
|
||||
- **JPEG**: Lossy compression, avoid for data figures
|
||||
|
||||
**Avoid:**
|
||||
- Low-resolution screenshots
|
||||
- Figures copied from presentations (usually too low resolution)
|
||||
- Heavily compressed JPEGs (artifacts)
|
||||
|
||||
### Resolution Requirements
|
||||
|
||||
**Minimum standards:**
|
||||
- **Line art** (graphs, diagrams): 300-600 dpi
|
||||
- **Halftones** (photos, grayscale): 300 dpi
|
||||
- **Combination** (images with labels): 300-600 dpi
|
||||
|
||||
**Best practice:** Create figures at final size and resolution.
|
||||
|
||||
### Dimensions
|
||||
|
||||
**Check journal requirements:**
|
||||
- **Single column**: typically 8-9 cm (3-3.5 inches) wide
|
||||
- **Double column**: typically 17-18 cm (6.5-7 inches) wide
|
||||
- **Full page**: varies by journal
|
||||
|
||||
**Recommendation:** Design figures to fit single column when possible.
|
||||
|
||||
### Image Manipulation
|
||||
|
||||
**Allowed:**
|
||||
- Brightness/contrast adjustment applied to entire image
|
||||
- Color balance adjustment
|
||||
- Cropping (with notation)
|
||||
- Rotation
|
||||
|
||||
**NOT allowed:**
|
||||
- Selective editing (e.g., enhancing bands in gels)
|
||||
- Removing background artifacts
|
||||
- Splicing images without clear indication
|
||||
- Any manipulation that obscures, eliminates, or misrepresents data
|
||||
|
||||
**Ethical requirement:** Report all image adjustments in Methods section.
|
||||
|
||||
## Figure and Table Numbering
|
||||
|
||||
### Numbering System
|
||||
|
||||
**Figures:**
|
||||
- Number consecutively in order of first mention in text
|
||||
- Use Arabic numerals: Figure 1, Figure 2, Figure 3...
|
||||
- Supplementary figures: Figure S1, Figure S2...
|
||||
|
||||
**Tables:**
|
||||
- Number separately from figures
|
||||
- Use Arabic numerals: Table 1, Table 2, Table 3...
|
||||
- Supplementary tables: Table S1, Table S2...
|
||||
|
||||
### In-Text References
|
||||
|
||||
**Format:**
|
||||
```
|
||||
"Results are shown in Figure 1."
|
||||
"Participant characteristics are presented in Table 2."
|
||||
"Multiple analyses confirmed this finding (Figures 3-5)."
|
||||
```
|
||||
|
||||
**NOT:**
|
||||
```
|
||||
"Figure 1 below shows..." (avoid "above" or "below" - pagination may change)
|
||||
"The figure shows..." (always use specific number)
|
||||
```
|
||||
|
||||
## Captions
|
||||
|
||||
### Caption Structure
|
||||
|
||||
**For figures:**
|
||||
```
|
||||
Figure 1. [One-sentence title]. [Additional description sentences providing context,
|
||||
defining abbreviations, explaining panels, describing statistical tests, and noting
|
||||
sample sizes].
|
||||
```
|
||||
|
||||
**For tables:**
|
||||
```
|
||||
Table 1. [Descriptive Title]
|
||||
[Table contents]
|
||||
[Footnotes defining abbreviations, statistical methods, and providing additional context]
|
||||
```
|
||||
|
||||
### Caption Content
|
||||
|
||||
**Essential information:**
|
||||
1. What is being shown (brief title)
|
||||
2. Detailed description of content
|
||||
3. Definition of all abbreviations and symbols
|
||||
4. Sample sizes
|
||||
5. Statistical tests used
|
||||
6. Meaning of error bars or annotations
|
||||
7. Panel labels explained (if multiple panels)
|
||||
|
||||
**Example comprehensive caption:**
|
||||
```
|
||||
Figure 3. Cognitive performance improves with treatment over 12 weeks. (A) Mean Mini-Mental
|
||||
State Examination (MMSE) scores at baseline, 6 weeks, and 12 weeks for treatment (blue) and
|
||||
placebo (gray) groups. (B) Individual participant trajectories for treatment group. Error bars
|
||||
represent 95% confidence intervals. Asterisks indicate significant between-group differences
|
||||
(*p < 0.05, **p < 0.01, ***p < 0.001; repeated measures ANOVA with Bonferroni correction).
|
||||
n = 42 treatment, n = 40 placebo. MMSE scores range from 0-30, with higher scores indicating
|
||||
better cognitive function.
|
||||
```
|
||||
|
||||
## Journal-Specific Requirements
|
||||
|
||||
### Before Creating Figures/Tables
|
||||
|
||||
**Check journal guidelines for:**
|
||||
- Preferred file formats
|
||||
- Resolution requirements
|
||||
- Color specifications (RGB vs. CMYK)
|
||||
- Maximum number of display items
|
||||
- Dimension requirements
|
||||
- Font restrictions
|
||||
- Whether to embed figures in manuscript or submit separately
|
||||
|
||||
### During Submission
|
||||
|
||||
**Prepare checklist:**
|
||||
- [ ] All figures/tables numbered correctly
|
||||
- [ ] All cited in text in order
|
||||
- [ ] Captions complete and self-explanatory
|
||||
- [ ] Abbreviations defined
|
||||
- [ ] Correct file format and resolution
|
||||
- [ ] Appropriate size/dimensions
|
||||
- [ ] High enough quality for print
|
||||
- [ ] Color-blind friendly (if using color)
|
||||
- [ ] Permissions obtained (if adapting from others' work)
|
||||
|
||||
## Common Pitfalls to Avoid
|
||||
|
||||
### Content Issues
|
||||
1. **Duplication** between text, tables, and figures
|
||||
2. **Insufficient context** (unclear what is shown)
|
||||
3. **Too much information** in one display
|
||||
4. **Missing key information** (sample sizes, units, statistics)
|
||||
5. **Cherry-picking** data without showing full picture
|
||||
|
||||
### Design Issues
|
||||
6. **Poor color choices** (not color-blind friendly)
|
||||
7. **Inconsistent formatting** across displays
|
||||
8. **Cluttered or busy designs**
|
||||
9. **Too small text** at final size
|
||||
10. **Misleading visualizations** (truncated axes, 3D distortions)
|
||||
|
||||
### Technical Issues
|
||||
11. **Insufficient resolution** (pixelated when printed)
|
||||
12. **Wrong file format** (lossy compression, non-vector graphs)
|
||||
13. **Improper image manipulation** (undeclared editing)
|
||||
14. **Missing scale bars** on images
|
||||
15. **Figures that don't work in grayscale** (if journal prints in B&W)
|
||||
|
||||
## Tools for Creating Figures
|
||||
|
||||
### Graphing Software
|
||||
- **R (ggplot2)**: Highly customizable, publication-quality, reproducible
|
||||
- **Python (matplotlib, seaborn)**: Flexible, programmable, widely used
|
||||
- **GraphPad Prism**: User-friendly, statistics integrated, common in life sciences
|
||||
- **Origin**: Advanced graphing, popular in physics/engineering
|
||||
- **Excel**: Basic graphs, widely available, limited customization
|
||||
- **MATLAB**: Technical computing, good for complex visualizations
|
||||
|
||||
### Image Processing
|
||||
- **ImageJ/Fiji**: Free, powerful, widely used in microscopy
|
||||
- **Adobe Photoshop**: Professional standard, extensive tools
|
||||
- **GIMP**: Free alternative to Photoshop
|
||||
- **Adobe Illustrator**: Vector graphics, figure assembly
|
||||
- **Inkscape**: Free vector graphics editor
|
||||
|
||||
### Best Practices for Software Choice
|
||||
- Use tools that produce vector output for graphs
|
||||
- Learn one tool well rather than many superficially
|
||||
- Script your figure generation for reproducibility
|
||||
- Save original data files separately from figure files
|
||||
|
||||
## Checklist for Final Review
|
||||
|
||||
### Before Submission
|
||||
|
||||
**For every figure:**
|
||||
- [ ] High enough resolution (300+ dpi)?
|
||||
- [ ] Correct file format per journal requirements?
|
||||
- [ ] Self-explanatory caption with all abbreviations defined?
|
||||
- [ ] All symbols/colors explained in caption or legend?
|
||||
- [ ] Error bars included and defined?
|
||||
- [ ] Sample sizes noted?
|
||||
- [ ] Statistical tests described?
|
||||
- [ ] Axes labeled with units?
|
||||
- [ ] Readable text at final print size?
|
||||
- [ ] Works in grayscale or color-blind friendly?
|
||||
- [ ] Referenced in text in correct order?
|
||||
|
||||
**For every table:**
|
||||
- [ ] Clear, descriptive title?
|
||||
- [ ] Column headers include units?
|
||||
- [ ] Appropriate numerical precision?
|
||||
- [ ] Abbreviations defined in footnotes?
|
||||
- [ ] Statistical methods explained?
|
||||
- [ ] Sample sizes included?
|
||||
- [ ] Consistent formatting with other tables?
|
||||
- [ ] Referenced in text in correct order?
|
||||
|
||||
**Overall:**
|
||||
- [ ] Appropriate number of display items (~1 per 1000 words)?
|
||||
- [ ] No duplication between text, figures, and tables?
|
||||
- [ ] Consistent formatting across all display items?
|
||||
- [ ] All display items necessary (each tells important part of story)?
|
||||
@@ -0,0 +1,523 @@
|
||||
# IMRAD Structure Guide
|
||||
|
||||
## Overview
|
||||
|
||||
IMRAD (Introduction, Methods, Results, And Discussion) is the predominant organizational structure for scientific journal articles of original research. Adopted as the majority format since the 1970s, it is now the standard in medical, health, biological, chemical, engineering, and computer sciences.
|
||||
|
||||
## Why IMRAD?
|
||||
|
||||
The IMRAD structure mirrors the scientific method:
|
||||
- **Introduction**: What question did you ask?
|
||||
- **Methods**: How did you study it?
|
||||
- **Results**: What did you find?
|
||||
- **Discussion**: What does it mean?
|
||||
|
||||
This logical flow makes scientific papers easier to write, read, and evaluate.
|
||||
|
||||
## Complete Manuscript Components
|
||||
|
||||
A full scientific manuscript typically includes these sections in order:
|
||||
|
||||
1. **Title**
|
||||
2. **Abstract**
|
||||
3. **Introduction**
|
||||
4. **Methods** (also called Materials and Methods, Methodology)
|
||||
5. **Results**
|
||||
6. **Discussion** (sometimes combined with Results)
|
||||
7. **Conclusion** (sometimes part of Discussion)
|
||||
8. **Acknowledgments**
|
||||
9. **References**
|
||||
10. **Supplementary Materials** (if applicable)
|
||||
|
||||
## Title
|
||||
|
||||
### Purpose
|
||||
Attract readers and accurately represent the paper's content.
|
||||
|
||||
### Guidelines
|
||||
- Be concise yet descriptive (typically 10-15 words)
|
||||
- Include key variables and the relationship studied
|
||||
- Avoid abbreviations, jargon, and question formats (unless the journal allows)
|
||||
- Make it specific enough to distinguish from other studies
|
||||
- Include key search terms for discoverability
|
||||
|
||||
### Examples
|
||||
- Good: "Effects of High-Intensity Interval Training on Cardiovascular Function in Older Adults"
|
||||
- Too vague: "Exercise and Health"
|
||||
- Too detailed: "A Randomized Controlled Trial Examining the Effects of High-Intensity Interval Training Compared to Moderate Continuous Training on Cardiovascular Function Measured by VO2 Max in Adults Aged 60-75 Years"
|
||||
|
||||
## Abstract
|
||||
|
||||
### Purpose
|
||||
Provide a complete, standalone summary enabling readers to decide if the full paper is relevant to them.
|
||||
|
||||
### Structure
|
||||
Most journals now require **structured abstracts** with labeled sections:
|
||||
|
||||
**Background/Objective**: Why was the study needed? What was the aim?
|
||||
- 1-2 sentences
|
||||
- State the research problem and objective
|
||||
|
||||
**Methods**: How was it done?
|
||||
- 2-4 sentences
|
||||
- Study design, participants, key procedures, analysis methods
|
||||
|
||||
**Results**: What was found?
|
||||
- 3-5 sentences
|
||||
- Main findings with key statistics
|
||||
- Present the most important numerical data
|
||||
|
||||
**Conclusions**: What does it mean?
|
||||
- 1-2 sentences
|
||||
- Interpretation and implications
|
||||
- Avoid overstating or adding new information
|
||||
|
||||
### Length
|
||||
- Typically 100-250 words (check journal requirements)
|
||||
- Some journals allow up to 300 words
|
||||
|
||||
### Key Rules
|
||||
- Write the abstract **last** (after completing all other sections)
|
||||
- Make it fully understandable without reading the paper
|
||||
- Do not cite references in the abstract
|
||||
- Avoid abbreviations or define them at first use
|
||||
- Use past tense for methods and results, present tense for conclusions
|
||||
- Include key quantitative results with statistical measures
|
||||
|
||||
### Example Structure
|
||||
```
|
||||
Background: Hospital-acquired infections remain a major cause of morbidity. This study
|
||||
evaluated the effectiveness of a new disinfection protocol in reducing infection rates.
|
||||
|
||||
Methods: We conducted a 12-month before-after study in a 500-bed teaching hospital.
|
||||
Environmental surfaces were cultured monthly, and infection rates were tracked via
|
||||
surveillance data. The intervention involved UV-C disinfection added to standard cleaning.
|
||||
|
||||
Results: Post-intervention, surface contamination decreased by 47% (95% CI: 38-56%,
|
||||
p<0.001), and catheter-associated urinary tract infections declined from 3.2 to 1.8
|
||||
per 1000 catheter-days (RR=0.56, 95% CI: 0.38-0.83, p=0.004). No adverse effects were
|
||||
observed.
|
||||
|
||||
Conclusions: UV-C disinfection significantly reduced environmental contamination and
|
||||
infection rates. This intervention may be a valuable addition to hospital infection
|
||||
control programs.
|
||||
```
|
||||
|
||||
## Introduction
|
||||
|
||||
### Purpose
|
||||
Convince readers that the research addresses an important question using an appropriate approach.
|
||||
|
||||
### Structure and Content
|
||||
|
||||
**Paragraph 1: The Big Picture**
|
||||
- Establish the broad research area
|
||||
- Explain why this topic matters
|
||||
- Use present tense for established facts
|
||||
- Keep it accessible to non-specialists
|
||||
|
||||
**Paragraphs 2-3: Narrowing Down**
|
||||
- Review relevant prior research
|
||||
- Show what is already known
|
||||
- Identify controversies or limitations in existing work
|
||||
- Create a logical progression toward the gap
|
||||
|
||||
**Paragraph 4: The Gap**
|
||||
- Explicitly identify what remains unknown
|
||||
- Explain why this knowledge gap is problematic
|
||||
- Connect the gap to the big picture importance
|
||||
|
||||
**Final Paragraph: This Study**
|
||||
- State the specific research question or hypothesis
|
||||
- Describe the overall approach briefly
|
||||
- Explain how this study addresses the gap
|
||||
- Optional: Preview key findings (some journals discourage this)
|
||||
|
||||
### Length
|
||||
- Typically 1.5-2 pages (depending on journal)
|
||||
- Usually 4-5 paragraphs
|
||||
- Shorter for letters/brief communications
|
||||
|
||||
### Verb Tense
|
||||
- **Present tense**: Established facts ("Exercise improves cardiovascular health")
|
||||
- **Past tense**: Previous studies and their findings ("Smith et al. found that...")
|
||||
- **Present/past tense**: Your study aims ("This study investigates..." or "This study investigated...")
|
||||
|
||||
### Common Mistakes to Avoid
|
||||
- Starting too broad (e.g., "Since the beginning of time...")
|
||||
- Exhaustive literature review (save for review articles)
|
||||
- Citing irrelevant or outdated references
|
||||
- Failing to identify a clear gap
|
||||
- Weak justification for the study
|
||||
- Not stating a clear research question or hypothesis
|
||||
- Including methods or results (these belong in later sections)
|
||||
|
||||
### Key Questions to Answer
|
||||
1. What do we know about this topic?
|
||||
2. What don't we know? (the gap)
|
||||
3. Why does this gap matter?
|
||||
4. What did this study aim to find out?
|
||||
|
||||
## Methods
|
||||
|
||||
### Purpose
|
||||
Provide sufficient detail for others to replicate the study and evaluate its validity.
|
||||
|
||||
### Key Principle
|
||||
Another expert in the field should be able to repeat your experiment exactly as you performed it.
|
||||
|
||||
### Standard Subsections
|
||||
|
||||
#### Study Design
|
||||
- State the overall design (e.g., randomized controlled trial, cohort study, cross-sectional survey)
|
||||
- Justify the design choice if not obvious
|
||||
- Mention blinding, randomization, or controls if applicable
|
||||
|
||||
#### Participants/Subjects/Sample
|
||||
- Define the population of interest
|
||||
- Describe inclusion and exclusion criteria precisely
|
||||
- Report sample size and how it was determined (power analysis)
|
||||
- Explain recruitment methods and setting
|
||||
- For animals: specify species, strain, age, sex, housing conditions
|
||||
|
||||
#### Materials and Equipment
|
||||
- List all materials, reagents, and equipment used
|
||||
- Include manufacturer names and locations (in parentheses)
|
||||
- Specify catalog numbers for specialized items
|
||||
- Report software names and versions
|
||||
|
||||
#### Procedures
|
||||
- Describe what was done in chronological order
|
||||
- Include sufficient detail for replication
|
||||
- Use subheadings to organize complex procedures
|
||||
- Specify timing (e.g., "incubated for 2 hours at 37°C")
|
||||
- For surveys/interviews: describe instruments, validation, administration
|
||||
|
||||
#### Measurements and Outcomes
|
||||
- Define all variables measured
|
||||
- Specify primary and secondary outcomes
|
||||
- Describe measurement instruments and their validity
|
||||
- Include units of measurement
|
||||
|
||||
#### Statistical Analysis
|
||||
- Name all statistical tests used
|
||||
- Justify test selection
|
||||
- State significance level (typically α = 0.05)
|
||||
- Report power analysis for sample size
|
||||
- Name statistical software with version
|
||||
- Describe handling of missing data
|
||||
- Mention adjustments for multiple comparisons if applicable
|
||||
|
||||
#### Ethical Considerations
|
||||
- State IRB/ethics committee approval (with approval number)
|
||||
- Mention informed consent procedures
|
||||
- For human studies: state adherence to Helsinki Declaration
|
||||
- For animal studies: state adherence to relevant guidelines (e.g., ARRIVE)
|
||||
|
||||
### Length
|
||||
- Typically 2-4 pages
|
||||
- Proportional to study complexity
|
||||
|
||||
### Verb Tense
|
||||
- **Past tense** for actions you performed ("We measured...", "Participants completed...")
|
||||
- **Present tense** for established procedures ("PCR amplifies...", "The questionnaire contains...")
|
||||
|
||||
### Common Mistakes
|
||||
- Insufficient detail for replication
|
||||
- Methods appearing for the first time in Results
|
||||
- Including results or discussion
|
||||
- Missing statistical tests
|
||||
- Undefined abbreviations
|
||||
- Lack of ethical approval statement
|
||||
|
||||
## Results
|
||||
|
||||
### Purpose
|
||||
Present the findings objectively without interpretation.
|
||||
|
||||
### Key Principle
|
||||
Show, don't interpret. Save interpretation for the Discussion.
|
||||
|
||||
### Structure and Content
|
||||
|
||||
**Opening Paragraph**
|
||||
- Describe the participants/sample characteristics
|
||||
- Report recruitment flow (e.g., screened, enrolled, completed)
|
||||
- Consider including a CONSORT-style flow diagram
|
||||
|
||||
**Subsequent Paragraphs**
|
||||
- Present results in logical order (usually primary outcome first)
|
||||
- Follow the order of objectives stated in Introduction
|
||||
- Organize by theme or by chronology, depending on what's clearest
|
||||
- Reference figures and tables by number
|
||||
|
||||
**Each Finding Should Include:**
|
||||
- The observed result
|
||||
- The direction of the effect
|
||||
- The magnitude of the effect
|
||||
- The statistical significance
|
||||
- The confidence interval
|
||||
|
||||
**Example**: "Mean systolic blood pressure decreased by 12 mmHg in the intervention group compared to 3 mmHg in controls (difference: 9 mmHg, 95% CI: 4-14 mmHg, p=0.002)."
|
||||
|
||||
### Integration with Figures and Tables
|
||||
|
||||
**When to Use:**
|
||||
- **Figures**: Trends, patterns, distributions, comparisons, relationships
|
||||
- **Tables**: Precise values, demographic data, multiple variables
|
||||
|
||||
**How to Reference:**
|
||||
- "Figure 1 shows the distribution of..." (not "Figure 1 below")
|
||||
- "Table 2 presents baseline characteristics..."
|
||||
- Don't repeat all table data in text; highlight key findings
|
||||
- Each figure/table should be referenced in text
|
||||
|
||||
### Figures and Tables Guidelines
|
||||
- Number consecutively in order of mention
|
||||
- Include complete, standalone captions
|
||||
- Define all abbreviations in caption or footnote
|
||||
- Report sample sizes (n)
|
||||
- Indicate statistical significance (*, p-values)
|
||||
- Use consistent formatting
|
||||
|
||||
### Statistical Reporting
|
||||
|
||||
**Required Elements:**
|
||||
- Test statistic (t, F, χ², etc.)
|
||||
- Degrees of freedom
|
||||
- p-value (exact if p > 0.001, otherwise report as "p < 0.001")
|
||||
- Effect size and confidence interval
|
||||
- Sample sizes
|
||||
|
||||
**Example**: "Groups differed significantly on test performance (t(48) = 3.21, p = 0.002, Cohen's d = 0.87, 95% CI: 0.34-1.40)."
|
||||
|
||||
### Length
|
||||
- Typically 2-4 pages
|
||||
- Roughly equivalent to Methods length
|
||||
|
||||
### Verb Tense
|
||||
- **Past tense** for your findings ("The mean was...", "Participants showed...")
|
||||
|
||||
### Common Mistakes
|
||||
- Interpreting results (save for Discussion)
|
||||
- Repeating all table/figure data in text
|
||||
- Presenting new methods
|
||||
- Insufficient statistical detail
|
||||
- Inconsistent units or notation
|
||||
- Not addressing negative or unexpected findings
|
||||
- Selective reporting (all tested hypotheses should be reported)
|
||||
|
||||
### Organization Strategies
|
||||
|
||||
**By Objective:**
|
||||
```
|
||||
Effect of intervention on primary outcome
|
||||
Effect of intervention on secondary outcome A
|
||||
Effect of intervention on secondary outcome B
|
||||
```
|
||||
|
||||
**By Analysis Type:**
|
||||
```
|
||||
Descriptive statistics
|
||||
Univariate analyses
|
||||
Multivariate analyses
|
||||
```
|
||||
|
||||
**Chronological:**
|
||||
```
|
||||
Baseline characteristics
|
||||
Short-term outcomes (1 month)
|
||||
Long-term outcomes (6 months)
|
||||
```
|
||||
|
||||
## Discussion
|
||||
|
||||
### Purpose
|
||||
Interpret findings, relate them to existing knowledge, acknowledge limitations, and propose future directions.
|
||||
|
||||
### Structure and Content
|
||||
|
||||
**Paragraph 1: Summary of Main Findings**
|
||||
- Restate the primary objective or hypothesis
|
||||
- Summarize the principal findings in 2-4 sentences
|
||||
- Avoid repeating details from Results
|
||||
- State clearly whether the hypothesis was supported
|
||||
|
||||
**Paragraphs 2-4: Interpretation in Context**
|
||||
- Compare your findings with previous research
|
||||
- Explain agreements and disagreements with prior work
|
||||
- Propose mechanisms or explanations for findings
|
||||
- Discuss unexpected results
|
||||
- Consider alternative explanations
|
||||
- Address whether findings support or refute existing theories
|
||||
|
||||
**Paragraph 5: Strengths and Limitations**
|
||||
- Acknowledge study limitations honestly
|
||||
- Explain how limitations might affect interpretation
|
||||
- Mention study strengths (design, sample, methods)
|
||||
- Avoid generic limitations ("larger sample needed")—be specific
|
||||
|
||||
**Paragraph 6: Implications**
|
||||
- Clinical implications (for medical research)
|
||||
- Practical applications
|
||||
- Policy implications
|
||||
- Theoretical contributions
|
||||
|
||||
**Final Paragraph: Conclusions and Future Directions**
|
||||
- Summarize the take-home message
|
||||
- Suggest specific future research to address gaps or limitations
|
||||
- End with a strong concluding statement
|
||||
|
||||
### Length
|
||||
- Typically 3-5 pages
|
||||
- Usually the longest section
|
||||
|
||||
### Verb Tense
|
||||
- **Past tense**: Your study findings ("We found that...", "The results showed...")
|
||||
- **Present tense**: Established facts and your interpretations ("This suggests that...", "These findings indicate...")
|
||||
- **Future tense**: Implications and future research ("Future studies should investigate...")
|
||||
|
||||
### Discussion Strategies
|
||||
|
||||
**Comparing to Prior Work:**
|
||||
```
|
||||
"Our finding of a 30% reduction in symptoms aligns with Smith et al. (2023), who
|
||||
reported a 28% reduction using a similar intervention. However, Jones et al. (2022)
|
||||
found no significant effect, possibly due to their use of a less intensive protocol."
|
||||
```
|
||||
|
||||
**Proposing Mechanisms:**
|
||||
```
|
||||
"The observed improvement in cognitive function may result from increased cerebral
|
||||
blood flow, as evidenced by the concurrent increase in functional MRI signals in the
|
||||
prefrontal cortex. This interpretation is consistent with the vascular hypothesis of
|
||||
cognitive enhancement."
|
||||
```
|
||||
|
||||
**Acknowledging Limitations:**
|
||||
```
|
||||
"The cross-sectional design prevents causal inference. Additionally, the convenience
|
||||
sample from a single academic medical center may limit generalizability to community
|
||||
settings. Self-reported measures may introduce recall bias, though we attempted to
|
||||
minimize this through structured interviews."
|
||||
```
|
||||
|
||||
### Common Mistakes
|
||||
- Simply repeating results without interpretation
|
||||
- Over-interpreting findings or claiming causation without warrant
|
||||
- Ignoring inconsistent or negative findings
|
||||
- Failing to compare with existing literature
|
||||
- Introducing new data or methods
|
||||
- Generic or superficial discussion of limitations
|
||||
- Overgeneralization beyond the study population
|
||||
- Missing the "so what?"—failing to explain significance
|
||||
|
||||
### Key Questions to Answer
|
||||
1. What do these findings mean?
|
||||
2. How do they compare to prior research?
|
||||
3. Why might differences exist?
|
||||
4. What are alternative explanations?
|
||||
5. What are the limitations?
|
||||
6. What are the practical implications?
|
||||
7. What should future research investigate?
|
||||
|
||||
## Conclusion
|
||||
|
||||
### Purpose
|
||||
Provide a concise summary of key findings and their significance.
|
||||
|
||||
### Placement
|
||||
- May be a separate section or the final paragraph of Discussion (check journal requirements)
|
||||
|
||||
### Content
|
||||
- 1-2 paragraphs maximum
|
||||
- Restate the main finding(s)
|
||||
- Emphasize the significance or implications
|
||||
- End with a strong, memorable statement
|
||||
- Do NOT introduce new information
|
||||
|
||||
### Example
|
||||
```
|
||||
This randomized trial demonstrates that a 12-week mindfulness intervention significantly
|
||||
reduces anxiety symptoms in college students, with effects persisting at 6-month follow-up.
|
||||
These findings support the integration of mindfulness-based programs into university mental
|
||||
health services. Given the scalability and cost-effectiveness of group-based mindfulness
|
||||
training, this approach offers a promising strategy to address the growing mental health
|
||||
crisis in higher education.
|
||||
```
|
||||
|
||||
## Additional Sections
|
||||
|
||||
### Acknowledgments
|
||||
- Thank funding sources (with grant numbers)
|
||||
- Acknowledge substantial contributions not qualifying for authorship
|
||||
- Thank those who provided materials, equipment, or assistance
|
||||
- Declare any conflicts of interest
|
||||
|
||||
### References
|
||||
- Format according to journal style (see `citation_styles.md`)
|
||||
- Verify all citations are accurate
|
||||
- Ensure all citations appear in text and vice versa
|
||||
- Typical range: 20-50 references for original research
|
||||
|
||||
### Supplementary Materials
|
||||
- Additional figures, tables, or data sets
|
||||
- Detailed protocols or questionnaires
|
||||
- Video or audio files
|
||||
- Large datasets or code repositories
|
||||
|
||||
## Tense Usage Summary
|
||||
|
||||
| Section | Verb Tense |
|
||||
|---------|-----------|
|
||||
| Abstract - Background | Present (established facts) or past (prior studies) |
|
||||
| Abstract - Methods | Past |
|
||||
| Abstract - Results | Past |
|
||||
| Abstract - Conclusions | Present |
|
||||
| Introduction - General background | Present |
|
||||
| Introduction - Prior studies | Past |
|
||||
| Introduction - Your objectives | Present or past |
|
||||
| Methods | Past (your actions), present (general procedures) |
|
||||
| Results | Past |
|
||||
| Discussion - Your findings | Past |
|
||||
| Discussion - Interpretations | Present |
|
||||
| Discussion - Prior work | Present or past |
|
||||
| Conclusion | Present |
|
||||
|
||||
## IMRAD Variations
|
||||
|
||||
### Combined Results and Discussion
|
||||
- Some journals allow or require this format
|
||||
- Interweaves presentation and interpretation
|
||||
- Each result is presented then immediately discussed
|
||||
- Useful for complex studies with multiple experiments
|
||||
|
||||
### IMRaD without separate Conclusion
|
||||
- Conclusion integrated into final Discussion paragraph
|
||||
- Common in many journals
|
||||
|
||||
### Extended IMRAD (ILMRaD)
|
||||
- Adds "Literature Review" as separate section
|
||||
- More common in theses and dissertations
|
||||
|
||||
## Adapting IMRAD to Different Study Types
|
||||
|
||||
### Clinical Trials
|
||||
- Add CONSORT flow diagram in Results
|
||||
- Include trial registration number in Methods
|
||||
- Report adverse events in Results
|
||||
|
||||
### Systematic Reviews/Meta-Analyses
|
||||
- Methods describes search strategy and inclusion criteria
|
||||
- Results includes PRISMA flow diagram and synthesis
|
||||
- May have additional sections (risk of bias assessment)
|
||||
|
||||
### Case Reports
|
||||
- Introduction: background on the condition
|
||||
- Case Presentation: replaces Methods and Results
|
||||
- Discussion: relates case to literature
|
||||
|
||||
### Observational Studies
|
||||
- Follow STROBE guidelines
|
||||
- Careful attention to potential confounders in Methods
|
||||
- Discussion addresses causality limitations
|
||||
@@ -0,0 +1,659 @@
|
||||
# Reporting Guidelines for Scientific Studies
|
||||
|
||||
## Overview
|
||||
|
||||
Reporting guidelines are evidence-based recommendations for what information should be included when reporting specific types of research studies. They provide checklists and flow diagrams to ensure complete, accurate, and transparent reporting, which is essential for readers to assess study validity and for other researchers to replicate the work.
|
||||
|
||||
The EQUATOR Network (Enhancing the QUAlity and Transparency Of health Research) maintains a comprehensive library of reporting guidelines. Using appropriate reporting guidelines improves manuscript quality and increases the likelihood of publication acceptance.
|
||||
|
||||
## Why Use Reporting Guidelines?
|
||||
|
||||
### Benefits
|
||||
|
||||
**For authors:**
|
||||
- Ensures nothing important is forgotten
|
||||
- Increases acceptance rates
|
||||
- Improves manuscript organization
|
||||
- Reduces reviewer requests for additional information
|
||||
|
||||
**For readers and reviewers:**
|
||||
- Enables critical appraisal of study validity
|
||||
- Facilitates systematic reviews and meta-analyses
|
||||
- Improves understanding of what was actually done
|
||||
|
||||
**For science:**
|
||||
- Enhances reproducibility
|
||||
- Reduces research waste
|
||||
- Improves transparency
|
||||
- Enables better evidence synthesis
|
||||
|
||||
### When to Use
|
||||
|
||||
- **During study design**: Many guidelines include protocol versions (e.g., SPIRIT for trial protocols)
|
||||
- **During manuscript drafting**: Use checklist to ensure all items are covered
|
||||
- **Before submission**: Verify adherence and often submit checklist with manuscript
|
||||
- **Many journals require**: Reporting guideline checklists as part of submission
|
||||
|
||||
## Major Reporting Guidelines by Study Type
|
||||
|
||||
### CONSORT - Randomized Controlled Trials
|
||||
|
||||
**Full name:** Consolidated Standards of Reporting Trials
|
||||
|
||||
**When to use:** Any randomized controlled trial (RCT), including pilot and feasibility trials
|
||||
|
||||
**Latest version:** CONSORT 2010 (updated statement)
|
||||
|
||||
**Key components:**
|
||||
- **Checklist**: 25 items covering title, abstract, introduction, methods, results, discussion
|
||||
- **Flow diagram**: Participant flow through enrollment, allocation, follow-up, and analysis
|
||||
|
||||
**Main checklist items:**
|
||||
1. Title identifies study as randomized trial
|
||||
2. Structured abstract
|
||||
3. Scientific background and rationale
|
||||
4. Specific objectives and hypotheses
|
||||
5. Trial design description (parallel, crossover, factorial, etc.)
|
||||
6. Eligibility criteria for participants
|
||||
7. Settings and locations of data collection
|
||||
8. Interventions described in sufficient detail for replication
|
||||
9. Primary and secondary outcomes defined
|
||||
10. Sample size determination and power calculation
|
||||
11. Randomization sequence generation
|
||||
12. Allocation concealment mechanism
|
||||
13. Blinding implementation
|
||||
14. Statistical methods
|
||||
15. Participant flow with reasons for dropouts
|
||||
16. Recruitment dates and follow-up dates
|
||||
17. Baseline characteristics table
|
||||
18. Analysis results for each outcome
|
||||
19. Harms and adverse events
|
||||
20. Trial limitations
|
||||
21. Generalizability
|
||||
22. Interpretation consistent with results
|
||||
23. Trial registration number
|
||||
24. Full protocol access
|
||||
25. Funding sources
|
||||
|
||||
**Extensions for specific designs:**
|
||||
- CONSORT for cluster randomized trials
|
||||
- CONSORT for non-inferiority and equivalence trials
|
||||
- CONSORT for pragmatic trials
|
||||
- CONSORT for crossover trials
|
||||
- CONSORT for N-of-1 trials
|
||||
- CONSORT for stepped wedge designs
|
||||
|
||||
**Where to access:** http://www.consort-statement.org/
|
||||
|
||||
### STROBE - Observational Studies
|
||||
|
||||
**Full name:** Strengthening the Reporting of Observational Studies in Epidemiology
|
||||
|
||||
**When to use:** Cohort studies, case-control studies, and cross-sectional studies
|
||||
|
||||
**Latest version:** STROBE 2007 (widely adopted standard)
|
||||
|
||||
**Key study designs covered:**
|
||||
- **Cohort**: Follow exposed and unexposed groups forward in time
|
||||
- **Case-control**: Compare exposure history between cases and controls
|
||||
- **Cross-sectional**: Measure exposure and outcome simultaneously
|
||||
|
||||
**Main checklist items (22 items):**
|
||||
1. Title and abstract indicate study design
|
||||
2. Background and rationale
|
||||
3. Objectives
|
||||
4. Study design with rationale
|
||||
5. Setting, locations, and dates
|
||||
6. Eligibility criteria and selection methods
|
||||
7. Variables clearly defined (outcomes, exposures, confounders)
|
||||
8. Data sources and measurement methods
|
||||
9. Bias management strategies
|
||||
10. Study size justification
|
||||
11. Handling of quantitative variables
|
||||
12. Statistical methods including confounding and interactions
|
||||
13. Sensitivity analyses
|
||||
14. Participant flow with reasons for non-participation
|
||||
15. Descriptive data including follow-up time
|
||||
16. Outcome data
|
||||
17. Main results with unadjusted and adjusted estimates
|
||||
18. Other analyses (subgroups, sensitivity analyses)
|
||||
19. Key results summary
|
||||
20. Limitations with potential bias discussion
|
||||
21. Interpretation and generalizability
|
||||
22. Funding sources and role
|
||||
|
||||
**Extensions:**
|
||||
- STROBE-ME (Molecular Epidemiology)
|
||||
- RECORD (Routinely collected health data)
|
||||
- STROBE-RDS (Respondent-driven sampling)
|
||||
|
||||
**Where to access:** https://www.strobe-statement.org/
|
||||
|
||||
### PRISMA - Systematic Reviews and Meta-Analyses
|
||||
|
||||
**Full name:** Preferred Reporting Items for Systematic Reviews and Meta-Analyses
|
||||
|
||||
**When to use:** Systematic reviews with or without meta-analysis
|
||||
|
||||
**Latest version:** PRISMA 2020 (significant update)
|
||||
|
||||
**Key components:**
|
||||
- **Checklist**: 27 items covering all sections
|
||||
- **Flow diagram**: Study selection process
|
||||
|
||||
**Main sections:**
|
||||
1. **Title**: Identify as systematic review/meta-analysis
|
||||
2. **Abstract**: Structured summary
|
||||
3. **Introduction**: Rationale and objectives
|
||||
4. **Methods**:
|
||||
- Eligibility criteria
|
||||
- Information sources (databases, dates)
|
||||
- Search strategy (full strategy for at least one database)
|
||||
- Selection process
|
||||
- Data collection process
|
||||
- Data items extracted
|
||||
- Risk of bias assessment
|
||||
- Effect measures
|
||||
- Synthesis methods
|
||||
- Reporting bias assessment
|
||||
- Certainty assessment (e.g., GRADE)
|
||||
5. **Results**:
|
||||
- Study selection flow diagram
|
||||
- Study characteristics
|
||||
- Risk of bias assessment results
|
||||
- Synthesis results (meta-analysis if applicable)
|
||||
- Reporting biases
|
||||
- Certainty of evidence
|
||||
6. **Discussion**:
|
||||
- Limitations
|
||||
- Interpretation
|
||||
- Implications
|
||||
|
||||
**Extensions:**
|
||||
- PRISMA for Abstracts
|
||||
- PRISMA for Protocols (PRISMA-P)
|
||||
- PRISMA for Network Meta-Analyses
|
||||
- PRISMA for Scoping Reviews (PRISMA-ScR)
|
||||
- PRISMA for Individual Patient Data
|
||||
- PRISMA for Diagnostic Test Accuracy
|
||||
- PRISMA for Equity-focused reviews
|
||||
|
||||
**Where to access:** http://www.prisma-statement.org/
|
||||
|
||||
### SPIRIT - Study Protocols for Clinical Trials
|
||||
|
||||
**Full name:** Standard Protocol Items: Recommendations for Interventional Trials
|
||||
|
||||
**When to use:** Protocols for randomized trials and other planned intervention studies
|
||||
|
||||
**Latest version:** SPIRIT 2013
|
||||
|
||||
**Purpose:** Ensure trial protocols contain complete descriptions before trial begins
|
||||
|
||||
**Main checklist items (33 items):**
|
||||
- Administrative information (title, trial registration, funding)
|
||||
- Introduction (background, rationale, objectives)
|
||||
- Methods: Trial design
|
||||
- Study setting
|
||||
- Eligibility criteria
|
||||
- Interventions in detail
|
||||
- Outcomes (primary and secondary)
|
||||
- Participant timeline
|
||||
- Sample size calculation
|
||||
- Recruitment strategy
|
||||
- Allocation and randomization
|
||||
- Blinding
|
||||
- Data collection methods
|
||||
- Data management
|
||||
- Statistical methods
|
||||
- Monitoring (data monitoring committee)
|
||||
- Harms reporting
|
||||
- Auditing
|
||||
- Ethics and dissemination
|
||||
- Ethics approval
|
||||
- Consent procedures
|
||||
- Confidentiality
|
||||
- Dissemination plans
|
||||
|
||||
**Where to access:** https://www.spirit-statement.org/
|
||||
|
||||
### STARD - Diagnostic Accuracy Studies
|
||||
|
||||
**Full name:** Standards for Reporting of Diagnostic Accuracy Studies
|
||||
|
||||
**When to use:** Studies evaluating diagnostic test accuracy
|
||||
|
||||
**Latest version:** STARD 2015
|
||||
|
||||
**Main checklist items (30 items):**
|
||||
1. Study design identification
|
||||
2. Background information and objectives
|
||||
3. Study design description
|
||||
4. Participant selection criteria and recruitment
|
||||
5. Data collection methods
|
||||
6. Index test description and execution
|
||||
7. Reference standard description
|
||||
8. Rationale for choosing reference standard
|
||||
9. Test result definition and cutoffs
|
||||
10. Flow of participants with timing
|
||||
11. Baseline demographic and clinical characteristics
|
||||
12. Cross-tabulation of index test results by reference standard
|
||||
13. Estimates of diagnostic accuracy with confidence intervals
|
||||
14. Handling of indeterminate results
|
||||
15. Adverse events from testing
|
||||
|
||||
**Flow diagram:** Shows participant flow and test results
|
||||
|
||||
**Where to access:** https://www.equator-network.org/reporting-guidelines/stard/
|
||||
|
||||
### TRIPOD - Prediction Model Studies
|
||||
|
||||
**Full name:** Transparent Reporting of a multivariable prediction model for Individual Prognosis Or Diagnosis
|
||||
|
||||
**When to use:** Studies developing, validating, or updating prediction models
|
||||
|
||||
**Latest version:** TRIPOD 2015
|
||||
|
||||
**Types of studies:**
|
||||
- Model development only
|
||||
- Model development with validation
|
||||
- External validation of existing model
|
||||
- Model update
|
||||
|
||||
**Main checklist items (22 items):**
|
||||
1. Title identifies study as prediction model study
|
||||
2. Abstract summarizes key elements
|
||||
3. Background and objectives
|
||||
4. Data source and participants
|
||||
5. Outcome definition
|
||||
6. Predictors (candidate and selected)
|
||||
7. Sample size justification
|
||||
8. Missing data handling
|
||||
9. Model building procedure
|
||||
10. Model specification (equation or algorithm)
|
||||
11. Model performance measures
|
||||
12. Risk groups if used
|
||||
13. Participant flow diagram
|
||||
14. Model development results
|
||||
15. Model performance
|
||||
16. Model updating if applicable
|
||||
|
||||
**Where to access:** https://www.tripod-statement.org/
|
||||
|
||||
### ARRIVE - Animal Research
|
||||
|
||||
**Full name:** Animal Research: Reporting of In Vivo Experiments
|
||||
|
||||
**When to use:** All in vivo animal studies
|
||||
|
||||
**Latest version:** ARRIVE 2.0 (2020 update)
|
||||
|
||||
**Two sets of items:**
|
||||
|
||||
**ARRIVE Essential 10** (minimum requirements):
|
||||
1. Study design
|
||||
2. Sample size calculation
|
||||
3. Inclusion and exclusion criteria
|
||||
4. Randomization
|
||||
5. Blinding
|
||||
6. Outcome measures
|
||||
7. Statistical methods
|
||||
8. Experimental animals (species, strain, sex, age)
|
||||
9. Experimental procedures
|
||||
10. Results and interpretation
|
||||
|
||||
**ARRIVE Recommended Set** (additional items for full reporting):
|
||||
- Abstract, background, objectives
|
||||
- Ethics statement
|
||||
- Housing and husbandry
|
||||
- Animal care and monitoring
|
||||
- Interpretation and generalizability
|
||||
- Protocol registration
|
||||
- Data access
|
||||
|
||||
**Where to access:** https://arriveguidelines.org/
|
||||
|
||||
### CARE - Case Reports
|
||||
|
||||
**Full name:** CAse REport Guidelines
|
||||
|
||||
**When to use:** Case reports and case series
|
||||
|
||||
**Latest version:** CARE 2013
|
||||
|
||||
**Main checklist items (13 items):**
|
||||
1. Title with "case report"
|
||||
2. Abstract summarizing case
|
||||
3. Introduction with case background
|
||||
4. Patient information (demographics, primary concern)
|
||||
5. Clinical findings
|
||||
6. Timeline of events
|
||||
7. Diagnostic assessment
|
||||
8. Therapeutic intervention
|
||||
9. Follow-up and outcomes
|
||||
10. Discussion with strengths and limitations
|
||||
11. Patient perspective
|
||||
12. Informed consent
|
||||
|
||||
**Where to access:** https://www.care-statement.org/
|
||||
|
||||
### SQUIRE - Quality Improvement Studies
|
||||
|
||||
**Full name:** Standards for QUality Improvement Reporting Excellence
|
||||
|
||||
**When to use:** Healthcare quality improvement reports
|
||||
|
||||
**Latest version:** SQUIRE 2.0 (2015)
|
||||
|
||||
**Main sections (18 items):**
|
||||
1. Title and abstract
|
||||
2. Introduction (problem description, available knowledge, rationale, objectives)
|
||||
3. Methods (context, intervention, study design, measures, analysis, ethical review)
|
||||
4. Results (intervention, outcomes)
|
||||
5. Discussion (summary, interpretation, limitations, conclusions)
|
||||
6. Other information (funding)
|
||||
|
||||
**Where to access:** http://www.squire-statement.org/
|
||||
|
||||
### CHEERS - Economic Evaluations
|
||||
|
||||
**Full name:** Consolidated Health Economic Evaluation Reporting Standards
|
||||
|
||||
**When to use:** Health economic evaluations
|
||||
|
||||
**Latest version:** CHEERS 2022 (major update from 2013)
|
||||
|
||||
**Main checklist items (28 items):**
|
||||
1. Title identification as economic evaluation
|
||||
2. Abstract
|
||||
3. Background and objectives
|
||||
4. Target population and subgroups
|
||||
5. Setting and location
|
||||
6. Study perspective
|
||||
7. Comparators
|
||||
8. Time horizon
|
||||
9. Discount rate
|
||||
10. Selection of outcomes
|
||||
11. Measurement of effectiveness
|
||||
12. Measurement and valuation of costs
|
||||
13. Currency and price adjustments
|
||||
14. Choice of model
|
||||
15. Assumptions
|
||||
16. Analytical methods
|
||||
|
||||
**Where to access:** https://www.equator-network.org/reporting-guidelines/cheers/
|
||||
|
||||
### SRQR - Qualitative Research
|
||||
|
||||
**Full name:** Standards for Reporting Qualitative Research
|
||||
|
||||
**When to use:** Qualitative and mixed methods research
|
||||
|
||||
**Latest version:** SRQR 2014
|
||||
|
||||
**Main sections:**
|
||||
- Title and abstract
|
||||
- Introduction (problem formulation, purpose)
|
||||
- Methods (qualitative approach, researcher characteristics, context, sampling strategy, ethical issues, data collection, data analysis, trustworthiness)
|
||||
- Results (synthesis and interpretation, links to empirical data)
|
||||
- Discussion (limitations, implications)
|
||||
|
||||
**Alternative:** COREQ (Consolidated criteria for reporting qualitative research) for interviews and focus groups
|
||||
|
||||
**Where to access:** https://www.equator-network.org/reporting-guidelines/srqr/
|
||||
|
||||
## How to Use Reporting Guidelines
|
||||
|
||||
### During Study Planning
|
||||
|
||||
1. **Identify relevant guideline** based on study design
|
||||
2. **Review checklist items** that require planning (e.g., randomization, blinding)
|
||||
3. **Design study** to ensure all required elements will be captured
|
||||
4. **Consider protocol guidelines** (e.g., SPIRIT for trials)
|
||||
|
||||
### During Manuscript Drafting
|
||||
|
||||
1. **Download checklist** from guideline website
|
||||
2. **Work through each item** systematically
|
||||
3. **Note where each item is addressed** in manuscript (page/line numbers)
|
||||
4. **Revise manuscript** to include missing items
|
||||
5. **Use flow diagrams** as appropriate
|
||||
|
||||
### Before Submission
|
||||
|
||||
1. **Complete formal checklist** with page numbers
|
||||
2. **Review all items** are adequately addressed
|
||||
3. **Include checklist** with submission if journal requires
|
||||
4. **Note guideline adherence** in cover letter or methods
|
||||
|
||||
### Example Checklist Entry
|
||||
|
||||
```
|
||||
Item 7: Eligibility criteria for participants, and the settings and locations where the data were collected
|
||||
Page 6, lines 112-125: "Participants were community-dwelling adults aged 60-85 years with mild cognitive impairment (MCI) as defined by Petersen criteria. Exclusion criteria included dementia diagnosis, major psychiatric disorders, or unstable medical conditions. Recruitment occurred from three memory clinics in Boston, MA, between January 2022 and December 2023."
|
||||
```
|
||||
|
||||
## Finding the Right Guideline
|
||||
|
||||
### EQUATOR Network Search
|
||||
|
||||
**Website:** https://www.equator-network.org/
|
||||
|
||||
**How to use:**
|
||||
1. Select your study design from the wizard
|
||||
2. Browse by health research category
|
||||
3. Search for specific keywords
|
||||
4. Filter by guideline status (development stage)
|
||||
|
||||
### By Study Design
|
||||
|
||||
| If your study is a... | Use this guideline |
|
||||
|----------------------|-------------------|
|
||||
| Randomized controlled trial | CONSORT |
|
||||
| Cohort, case-control, or cross-sectional study | STROBE |
|
||||
| Systematic review or meta-analysis | PRISMA |
|
||||
| Protocol for a trial | SPIRIT |
|
||||
| Diagnostic accuracy study | STARD |
|
||||
| Prediction model study | TRIPOD |
|
||||
| Animal study | ARRIVE |
|
||||
| Case report | CARE |
|
||||
| Quality improvement study | SQUIRE |
|
||||
| Economic evaluation | CHEERS |
|
||||
| Qualitative research | SRQR or COREQ |
|
||||
|
||||
### Multiple Guidelines
|
||||
|
||||
**Some studies may require multiple guidelines:**
|
||||
|
||||
**Example 1:** Pilot RCT with qualitative component
|
||||
- CONSORT for quantitative arm
|
||||
- SRQR for qualitative component
|
||||
|
||||
**Example 2:** Systematic review of diagnostic tests
|
||||
- PRISMA for review methods
|
||||
- STARD considerations for included studies
|
||||
|
||||
## Extensions and Adaptations
|
||||
|
||||
Many reporting guidelines have extensions for specific contexts:
|
||||
|
||||
### CONSORT Extensions (examples)
|
||||
|
||||
- **CONSORT for Abstracts**: Structured abstracts for RCT reports
|
||||
- **CONSORT for Harms**: Reporting adverse events
|
||||
- **CONSORT-EHEALTH**: eHealth interventions
|
||||
- **CONSORT-SPI**: Social and psychological interventions
|
||||
|
||||
### PRISMA Extensions (examples)
|
||||
|
||||
- **PRISMA-P**: Protocols for systematic reviews
|
||||
- **PRISMA for Abstracts**: Conference abstracts
|
||||
- **PRISMA-NMA**: Network meta-analyses
|
||||
- **PRISMA-IPD**: Individual patient data reviews
|
||||
- **PRISMA-S**: Search strategies
|
||||
- **PRISMA-DTA**: Diagnostic test accuracy reviews
|
||||
|
||||
### STROBE Extensions (examples)
|
||||
|
||||
- **STROBE-ME**: Molecular epidemiology
|
||||
- **RECORD**: Routinely collected health data
|
||||
|
||||
## Creating Flow Diagrams
|
||||
|
||||
### CONSORT Flow Diagram
|
||||
|
||||
**Four stages:**
|
||||
1. **Enrollment**: Assessed for eligibility
|
||||
2. **Allocation**: Randomly assigned to groups
|
||||
3. **Follow-up**: Received intervention, lost to follow-up
|
||||
4. **Analysis**: Included in analysis
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Assessed for eligibility (n=250)
|
||||
↓
|
||||
Excluded (n=50)
|
||||
• Did not meet criteria (n=30)
|
||||
• Declined to participate (n=15)
|
||||
• Other reasons (n=5)
|
||||
↓
|
||||
Randomized (n=200)
|
||||
├─────────────────┬─────────────────┐
|
||||
↓ ↓ ↓
|
||||
Allocated to Allocated to Allocated to
|
||||
Intervention A Intervention B Control
|
||||
(n=67) (n=66) (n=67)
|
||||
↓ ↓ ↓
|
||||
Lost to follow-up Lost to follow-up Lost to follow-up
|
||||
(n=3) (n=5) (n=2)
|
||||
↓ ↓ ↓
|
||||
Analyzed Analyzed Analyzed
|
||||
(n=64) (n=61) (n=65)
|
||||
```
|
||||
|
||||
### PRISMA Flow Diagram
|
||||
|
||||
**Stages:**
|
||||
1. **Identification**: Records from databases and registers
|
||||
2. **Screening**: Records screened, excluded
|
||||
3. **Included**: Studies included in review and synthesis
|
||||
|
||||
**New features in PRISMA 2020:**
|
||||
- Separate tracking for database and register searches
|
||||
- Tracking of duplicate removal
|
||||
- Clear distinction between reports and studies
|
||||
|
||||
## Common Mistakes and How to Avoid Them
|
||||
|
||||
### Mistake 1: Not Using Guidelines at All
|
||||
|
||||
**Impact:** Missing critical information, lower chance of acceptance
|
||||
|
||||
**Solution:** Identify and use appropriate guideline from study planning stage
|
||||
|
||||
### Mistake 2: Using Guidelines Only After Manuscript is Complete
|
||||
|
||||
**Impact:** May realize key data were not collected or documented
|
||||
|
||||
**Solution:** Review guidelines during study design and data collection
|
||||
|
||||
### Mistake 3: Incomplete Checklist Completion
|
||||
|
||||
**Impact:** Missed items remain unreported
|
||||
|
||||
**Solution:** Systematically address every single checklist item
|
||||
|
||||
### Mistake 4: Using Outdated Guidelines
|
||||
|
||||
**Impact:** Missing recent improvements in reporting standards
|
||||
|
||||
**Solution:** Always check for latest version on official guideline website
|
||||
|
||||
### Mistake 5: Using Wrong Guideline for Study Design
|
||||
|
||||
**Impact:** Important design-specific elements not reported
|
||||
|
||||
**Solution:** Carefully match study design to appropriate guideline
|
||||
|
||||
### Mistake 6: Not Submitting Checklist When Required
|
||||
|
||||
**Impact:** Editorial desk rejection or delays
|
||||
|
||||
**Solution:** Check journal submission guidelines and include checklist
|
||||
|
||||
### Mistake 7: Generic Reporting Without Specificity
|
||||
|
||||
**Impact:** Insufficient detail for replication or appraisal
|
||||
|
||||
**Solution:** Provide specific, detailed information for each item
|
||||
|
||||
## Journal Requirements
|
||||
|
||||
### Many Journals Now Require:
|
||||
|
||||
1. **Statement of adherence** to reporting guidelines in Methods
|
||||
2. **Completed checklist** uploaded as supplementary file
|
||||
3. **Page/line numbers** on checklist indicating where items are addressed
|
||||
4. **Flow diagrams** as figures in manuscript
|
||||
|
||||
### Example Methods Statement:
|
||||
|
||||
```
|
||||
"This study is reported in accordance with the Strengthening the Reporting of
|
||||
Observational Studies in Epidemiology (STROBE) statement. A completed STROBE
|
||||
checklist is provided as Supplementary File 1."
|
||||
```
|
||||
|
||||
### Journals with Strong Requirements:
|
||||
|
||||
- PLOS journals (require checklists for specific designs)
|
||||
- BMJ (requires CONSORT, PRISMA, and others)
|
||||
- The Lancet (requires adherence statements)
|
||||
- JAMA and JAMA Network journals (require checklists)
|
||||
- Nature portfolio journals (encourage guidelines)
|
||||
|
||||
## Resources
|
||||
|
||||
### Official Guideline Websites
|
||||
|
||||
- **EQUATOR Network**: https://www.equator-network.org/
|
||||
- **CONSORT**: http://www.consort-statement.org/
|
||||
- **STROBE**: https://www.strobe-statement.org/
|
||||
- **PRISMA**: http://www.prisma-statement.org/
|
||||
- **SPIRIT**: https://www.spirit-statement.org/
|
||||
- **ARRIVE**: https://arriveguidelines.org/
|
||||
- **CARE**: https://www.care-statement.org/
|
||||
|
||||
### Training Materials
|
||||
|
||||
- EQUATOR Network provides webinars and training resources
|
||||
- Many guidelines have explanatory papers published in medical journals
|
||||
- Universities often provide workshops on reporting guidelines
|
||||
|
||||
### Software Tools
|
||||
|
||||
- **Some reference managers** can insert reporting guideline citations
|
||||
- **Covidence, RevMan** for systematic review reporting
|
||||
- **PRISMA flow diagram generator**: http://prisma.thetacollaborative.ca/
|
||||
|
||||
## Checklist: Using Reporting Guidelines
|
||||
|
||||
**Before starting your study:**
|
||||
- [ ] Identified appropriate reporting guideline(s)
|
||||
- [ ] Reviewed checklist items requiring prospective planning
|
||||
- [ ] Designed study to capture all required elements
|
||||
- [ ] Registered protocol if applicable
|
||||
|
||||
**During manuscript drafting:**
|
||||
- [ ] Downloaded latest version of guideline checklist
|
||||
- [ ] Systematically addressed each checklist item
|
||||
- [ ] Created required flow diagram
|
||||
- [ ] Noted where each item is addressed (page/line)
|
||||
|
||||
**Before submission:**
|
||||
- [ ] Completed formal checklist with page numbers
|
||||
- [ ] Verified all items adequately addressed
|
||||
- [ ] Included adherence statement in Methods
|
||||
- [ ] Prepared checklist as supplementary file if required
|
||||
- [ ] Checked journal-specific requirements
|
||||
- [ ] Mentioned guideline adherence in cover letter
|
||||
@@ -0,0 +1,730 @@
|
||||
# Scientific Writing Principles
|
||||
|
||||
## Overview
|
||||
|
||||
Effective scientific writing requires mastering fundamental principles that ensure clarity, precision, and impact. Unlike creative or narrative writing, scientific writing prioritizes accuracy, conciseness, and objectivity. This guide covers the core principles that distinguish good scientific writing from poor writing and provides practical strategies for improvement.
|
||||
|
||||
## The Three Pillars of Scientific Writing
|
||||
|
||||
### 1. Clarity
|
||||
|
||||
**Definition:** Writing that is immediately understandable to the intended audience without ambiguity or confusion.
|
||||
|
||||
**Why it matters:** Science is complex enough without unclear writing adding confusion. Readers should focus on understanding the science, not deciphering the prose.
|
||||
|
||||
#### Strategies for Clarity
|
||||
|
||||
**Use precise, unambiguous language:**
|
||||
```
|
||||
Poor: "The drug seemed to help quite a few patients."
|
||||
Better: "The drug reduced symptoms in 68% (32/47) of patients."
|
||||
```
|
||||
|
||||
**Define technical terms at first use:**
|
||||
```
|
||||
"We measured brain-derived neurotrophic factor (BDNF), a protein involved in
|
||||
neuronal survival and plasticity."
|
||||
```
|
||||
|
||||
**Maintain logical flow within and between paragraphs:**
|
||||
- Each paragraph should have one main idea
|
||||
- Topic sentence introduces the paragraph's focus
|
||||
- Supporting sentences develop that focus
|
||||
- Transition sentences connect paragraphs
|
||||
|
||||
**Use active voice when it improves clarity:**
|
||||
```
|
||||
Passive (less clear): "The samples were analyzed by the researchers."
|
||||
Active (clearer): "Researchers analyzed the samples."
|
||||
```
|
||||
|
||||
However, passive voice is acceptable and often preferred in Methods when the action is more important than the actor:
|
||||
```
|
||||
"Blood samples were collected at baseline and after 6 weeks."
|
||||
```
|
||||
|
||||
**Break up long, complex sentences:**
|
||||
```
|
||||
Poor: "The results of our study, which involved 200 participants recruited from
|
||||
three hospitals and followed for 12 months with assessments every 4 weeks using
|
||||
validated questionnaires, showed significant improvements in the intervention
|
||||
group."
|
||||
|
||||
Better: "Our study involved 200 participants recruited from three hospitals.
|
||||
Participants were followed for 12 months with assessments every 4 weeks using
|
||||
validated questionnaires. The intervention group showed significant improvements."
|
||||
```
|
||||
|
||||
**Use specific verbs:**
|
||||
```
|
||||
Weak: "The study looked at depression in adolescents."
|
||||
Stronger: "The study examined factors contributing to depression in adolescents."
|
||||
```
|
||||
|
||||
#### Common Clarity Problems
|
||||
|
||||
**Ambiguous pronouns:**
|
||||
```
|
||||
Poor: "Group A received the drug and Group B received placebo. They showed
|
||||
improvement."
|
||||
(Who is "they"?)
|
||||
|
||||
Better: "Group A received the drug and Group B received placebo. The drug-treated
|
||||
group showed improvement."
|
||||
```
|
||||
|
||||
**Misplaced modifiers:**
|
||||
```
|
||||
Poor: "We measured blood pressure in patients using an automated monitor."
|
||||
(Are the patients using the monitor, or are we?)
|
||||
|
||||
Better: "Using an automated monitor, we measured blood pressure in patients."
|
||||
```
|
||||
|
||||
**Unclear referents:**
|
||||
```
|
||||
Poor: "The increase in expression was accompanied by decreased proliferation, which
|
||||
was unexpected."
|
||||
(What was unexpected—the decrease, the accompaniment, or both?)
|
||||
|
||||
Better: "The increase in expression was accompanied by decreased proliferation.
|
||||
This inverse relationship was unexpected."
|
||||
```
|
||||
|
||||
### 2. Conciseness
|
||||
|
||||
**Definition:** Expressing ideas in the fewest words necessary without sacrificing clarity or completeness.
|
||||
|
||||
**Why it matters:** Concise writing respects readers' time. Every unnecessary word is a missed opportunity for clarity and impact. As the principle states: "We value concise writing because we value time."
|
||||
|
||||
#### Strategies for Conciseness
|
||||
|
||||
**Eliminate redundant words and phrases:**
|
||||
|
||||
| Wordy | Concise |
|
||||
|-------|---------|
|
||||
| "due to the fact that" | "because" |
|
||||
| "in order to" | "to" |
|
||||
| "it is important to note that" | [delete] |
|
||||
| "a total of 50 participants" | "50 participants" |
|
||||
| "completely eliminate" | "eliminate" |
|
||||
| "has been shown to be" | "is" |
|
||||
| "in the event that" | "if" |
|
||||
| "at the present time" | "now" or "currently" |
|
||||
| "conduct an investigation into" | "investigate" |
|
||||
| "give consideration to" | "consider" |
|
||||
|
||||
**Avoid throat-clearing phrases:**
|
||||
```
|
||||
Wordy: "It is interesting to note that the results of our study demonstrate that..."
|
||||
Concise: "Our results demonstrate that..." or "The results show that..."
|
||||
```
|
||||
|
||||
**Use strong verbs instead of noun+verb combinations:**
|
||||
|
||||
| Wordy | Concise |
|
||||
|-------|---------|
|
||||
| "make a decision" | "decide" |
|
||||
| "perform an analysis" | "analyze" |
|
||||
| "conduct a study" | "study" or "studied" |
|
||||
| "make an assessment" | "assess" |
|
||||
| "provide information about" | "inform" |
|
||||
|
||||
**Eliminate unnecessary intensifiers:**
|
||||
```
|
||||
Wordy: "The results were very significant."
|
||||
Concise: "The results were significant." (p-value conveys the degree)
|
||||
```
|
||||
|
||||
**Avoid repeating information unnecessarily:**
|
||||
```
|
||||
Redundant: "The results showed that participants in the intervention group, who
|
||||
received the treatment intervention, had better outcomes."
|
||||
Concise: "The intervention group had better outcomes."
|
||||
```
|
||||
|
||||
**Favor shorter constructions:**
|
||||
```
|
||||
Wordy: "In spite of the fact that the sample size was small..."
|
||||
Concise: "Although the sample size was small..."
|
||||
```
|
||||
|
||||
#### Acceptable Length vs. Unnecessary Length
|
||||
|
||||
**Not all long sentences are bad:**
|
||||
```
|
||||
This detailed sentence is fine: "We analyzed blood samples using liquid
|
||||
chromatography-tandem mass spectrometry (LC-MS/MS) with a Waters Acquity UPLC
|
||||
system coupled to a Xevo TQ-S mass spectrometer (Waters Corporation, Milford, MA)."
|
||||
|
||||
Why? Because each element is necessary information.
|
||||
```
|
||||
|
||||
**The key question:** Can any word be removed without losing meaning or precision? If yes, remove it.
|
||||
|
||||
### 3. Accuracy
|
||||
|
||||
**Definition:** Precise, correct representation of data, methods, and interpretations.
|
||||
|
||||
**Why it matters:** Scientific credibility depends on accuracy. Inaccurate reporting undermines the entire scientific enterprise.
|
||||
|
||||
#### Strategies for Accuracy
|
||||
|
||||
**Report exact values with appropriate precision:**
|
||||
```
|
||||
Poor: "The mean was about 25."
|
||||
Better: "The mean was 24.7 ± 3.2 (SD)."
|
||||
```
|
||||
|
||||
**Match precision to measurement capability:**
|
||||
```
|
||||
Inappropriate: "Mean age was 45.237 years" (implies false precision)
|
||||
Appropriate: "Mean age was 45.2 years"
|
||||
```
|
||||
|
||||
**Use consistent terminology throughout:**
|
||||
```
|
||||
Inconsistent: Introduction calls it "cognitive function," Methods call it "mental
|
||||
performance," Results call it "intellectual ability."
|
||||
|
||||
Consistent: Use "cognitive function" throughout, or define explicitly: "cognitive
|
||||
function (also termed mental performance)"
|
||||
```
|
||||
|
||||
**Distinguish observations from interpretations:**
|
||||
```
|
||||
Observation: "Mean blood pressure decreased from 145 to 132 mmHg (p=0.003)."
|
||||
Interpretation: "This suggests the intervention effectively lowers blood pressure."
|
||||
```
|
||||
|
||||
**Be specific about uncertainty:**
|
||||
```
|
||||
Vague: "There may be some error in these measurements."
|
||||
Specific: "Measurements have a standard error of ±2.5 mmHg based on instrument
|
||||
specifications."
|
||||
```
|
||||
|
||||
**Use correct statistical language:**
|
||||
```
|
||||
Incorrect: "The correlation was highly significant (p=0.03)."
|
||||
Correct: "The correlation was statistically significant (p=0.03)."
|
||||
(p=0.03 is not "highly" significant; that's reserved for p<0.001)
|
||||
```
|
||||
|
||||
**Verify all numbers:**
|
||||
- Check that numbers in text match tables/figures
|
||||
- Verify that n values sum correctly
|
||||
- Confirm percentages are correctly calculated
|
||||
- Double-check all statistics
|
||||
|
||||
#### Common Accuracy Problems
|
||||
|
||||
**Overgeneralization:**
|
||||
```
|
||||
Poor: "Exercise prevents depression."
|
||||
Better: "In our sample, participants randomized to the exercise intervention showed
|
||||
fewer depressive symptoms than controls (mean difference 3.2 points on the BDI-II,
|
||||
95% CI: 1.5-4.9, p<0.001)."
|
||||
```
|
||||
|
||||
**Unwarranted causal claims:**
|
||||
```
|
||||
Poor (from observational study): "Vitamin D supplementation reduces cancer risk."
|
||||
Better: "Vitamin D levels were inversely associated with cancer incidence in this
|
||||
cohort (HR=0.82, 95% CI: 0.71-0.95)."
|
||||
```
|
||||
|
||||
**Imprecise numerical descriptions:**
|
||||
```
|
||||
Vague: "Many participants dropped out."
|
||||
Precise: "15/50 (30%) participants withdrew before study completion."
|
||||
```
|
||||
|
||||
## Additional Key Principles
|
||||
|
||||
### 4. Objectivity
|
||||
|
||||
**Definition:** Presenting information impartially without bias, exaggeration, or unsupported opinion.
|
||||
|
||||
**Strategies:**
|
||||
|
||||
**Present results without bias:**
|
||||
```
|
||||
Biased: "As expected, our superior method performed better."
|
||||
Objective: "Method A showed higher accuracy than Method B (87% vs. 76%, p=0.02)."
|
||||
```
|
||||
|
||||
**Acknowledge conflicting evidence:**
|
||||
```
|
||||
"Our findings contrast with Smith et al. (2022), who reported no significant effect.
|
||||
This discrepancy may result from differences in intervention intensity or population
|
||||
characteristics."
|
||||
```
|
||||
|
||||
**Avoid emotional or evaluative language:**
|
||||
```
|
||||
Subjective: "The results were disappointing and concerning."
|
||||
Objective: "The intervention did not significantly reduce symptoms (p=0.42)."
|
||||
```
|
||||
|
||||
**Distinguish fact from speculation:**
|
||||
```
|
||||
"The observed decrease in cell viability was accompanied by increased caspase-3
|
||||
activity, suggesting that apoptosis may be the primary mechanism of cell death."
|
||||
(Uses "suggesting" and "may be" to indicate interpretation)
|
||||
```
|
||||
|
||||
### 5. Consistency
|
||||
|
||||
**Maintain consistency throughout the manuscript:**
|
||||
|
||||
**Terminology:**
|
||||
- Use the same term for the same concept (not synonyms for variety)
|
||||
- Define abbreviations at first use and use consistently thereafter
|
||||
- Use standard nomenclature for genes, proteins, chemicals
|
||||
|
||||
**Notation:**
|
||||
- Statistical notation (p-value format, CI presentation)
|
||||
- Units of measurement
|
||||
- Number formatting (decimal places)
|
||||
|
||||
**Tense:**
|
||||
- Past tense for your specific study actions
|
||||
- Present tense for established facts
|
||||
- See detailed tense guide in IMRAD structure reference
|
||||
|
||||
**Style:**
|
||||
- Follow journal guidelines consistently
|
||||
- Citation format
|
||||
- Heading capitalization
|
||||
- Number vs. word for numerals
|
||||
|
||||
### 6. Logical Organization
|
||||
|
||||
**Create a clear "red thread" through the manuscript:**
|
||||
|
||||
**Paragraph structure:**
|
||||
1. Topic sentence (main idea)
|
||||
2. Supporting sentences (evidence, explanation)
|
||||
3. Concluding/transition sentence (link to next idea)
|
||||
|
||||
**Section flow:**
|
||||
- Each section builds logically on the previous
|
||||
- Questions raised in Introduction are answered in Results
|
||||
- Findings presented in Results are interpreted in Discussion
|
||||
|
||||
**Signposting:**
|
||||
```
|
||||
"First, we examined..."
|
||||
"Next, we investigated..."
|
||||
"Finally, we assessed..."
|
||||
```
|
||||
|
||||
**Parallelism:**
|
||||
```
|
||||
Not parallel: "Aims were to (1) measure blood pressure, (2) assessment of
|
||||
cognitive function, and (3) we wanted to evaluate mood."
|
||||
|
||||
Parallel: "Aims were to (1) measure blood pressure, (2) assess cognitive
|
||||
function, and (3) evaluate mood."
|
||||
```
|
||||
|
||||
## Verb Tense in Scientific Writing
|
||||
|
||||
### General Guidelines
|
||||
|
||||
**Present tense** for:
|
||||
- Established facts and general truths
|
||||
- "DNA is composed of nucleotides."
|
||||
- Conclusions you are drawing
|
||||
- "These findings suggest that..."
|
||||
- Referring to figures and tables
|
||||
- "Figure 1 shows the distribution..."
|
||||
|
||||
**Past tense** for:
|
||||
- Specific findings from completed research (yours and others')
|
||||
- "Smith et al. (2022) found that..."
|
||||
- "We observed a significant decrease..."
|
||||
- Methods you performed
|
||||
- "Participants completed questionnaires at baseline."
|
||||
|
||||
**Present perfect** for:
|
||||
- Recent developments with current relevance
|
||||
- "Recent studies have demonstrated..."
|
||||
- Research area background
|
||||
- "Several approaches have been proposed..."
|
||||
|
||||
### Section-Specific Tense
|
||||
|
||||
| Section | Primary Tense | Examples |
|
||||
|---------|---------------|----------|
|
||||
| **Abstract - Background** | Present or present perfect | "Depression affects millions" / "Research has shown..." |
|
||||
| **Abstract - Methods** | Past | "We recruited 100 participants" |
|
||||
| **Abstract - Results** | Past | "The intervention reduced symptoms" |
|
||||
| **Abstract - Conclusions** | Present | "These findings suggest..." |
|
||||
| **Introduction - Background** | Present (facts), present perfect (research) | "Exercise is beneficial" / "Studies have shown..." |
|
||||
| **Introduction - Gap** | Present or present perfect | "However, little is known..." |
|
||||
| **Introduction - This study** | Past or present | "We investigated..." / "This study investigates..." |
|
||||
| **Methods** | Past | "We collected samples..." |
|
||||
| **Results** | Past | "Mean age was 45 years" |
|
||||
| **Discussion - Your findings** | Past | "We found that..." |
|
||||
| **Discussion - Interpretation** | Present | "This suggests..." |
|
||||
| **Discussion - Prior work** | Past or present | "Smith found..." / "Previous work demonstrates..." |
|
||||
|
||||
## Common Writing Pitfalls
|
||||
|
||||
### 1. Jargon Overload
|
||||
|
||||
**Problem:** Excessive use of technical terms without definition
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Poor: "We utilized qRT-PCR to quantify mRNA expression via SYBR-Green-based
|
||||
fluorescence detection following cDNA synthesis from total RNA using oligo-dT primers."
|
||||
|
||||
Better: "We quantified mRNA expression using quantitative reverse transcription PCR
|
||||
(qRT-PCR). Total RNA was reverse transcribed to complementary DNA (cDNA) using
|
||||
oligo-dT primers, then amplified with SYBR Green fluorescent detection."
|
||||
```
|
||||
|
||||
### 2. Nominalization
|
||||
|
||||
**Problem:** Turning verbs into nouns, making writing heavy and indirect
|
||||
|
||||
**Examples:**
|
||||
|
||||
| Nominalized | Direct |
|
||||
|-------------|--------|
|
||||
| "give consideration to" | "consider" |
|
||||
| "make an assumption" | "assume" |
|
||||
| "perform an investigation" | "investigate" |
|
||||
| "conduct an examination" | "examine" |
|
||||
| "achieve a reduction" | "reduce" |
|
||||
|
||||
### 3. Hedging Excessively or Insufficiently
|
||||
|
||||
**Excessive hedging** (sounds uncertain):
|
||||
```
|
||||
"It could perhaps be possible that the intervention might possibly have some effect
|
||||
on symptoms under certain conditions."
|
||||
```
|
||||
|
||||
**Insufficient hedging** (overstates conclusions):
|
||||
```
|
||||
"The intervention cures depression."
|
||||
```
|
||||
|
||||
**Appropriate hedging:**
|
||||
```
|
||||
"The intervention significantly reduced depressive symptoms in this sample,
|
||||
suggesting it may be effective for treating mild to moderate depression."
|
||||
```
|
||||
|
||||
**Hedging words to use appropriately:**
|
||||
- Suggests, indicates, implies (not proves, demonstrates for correlational data)
|
||||
- May, might, could (possibilities)
|
||||
- Appears to, seems to (observations needing confirmation)
|
||||
- Likely, probably, possibly (degrees of certainty)
|
||||
|
||||
### 4. Anthropomorphism
|
||||
|
||||
**Problem:** Attributing human characteristics to non-human entities
|
||||
|
||||
**Examples:**
|
||||
|
||||
| Anthropomorphic | Scientific |
|
||||
|----------------|-----------|
|
||||
| "The study wanted to examine..." | "We aimed to examine..." or "The study examined..." |
|
||||
| "The data suggest they want..." | "The data suggest that..." |
|
||||
| "This paper will prove..." | "This paper demonstrates..." |
|
||||
| "Table 1 tells us..." | "Table 1 shows..." |
|
||||
|
||||
### 5. Abbreviation Abuse
|
||||
|
||||
**Problems:**
|
||||
- Too many abbreviations burden the reader
|
||||
- Abbreviating terms used only once or twice
|
||||
- Not defining abbreviations at first use
|
||||
|
||||
**Guidelines:**
|
||||
- Only abbreviate terms used ≥3-4 times
|
||||
- Define at first use in abstract (if used in abstract)
|
||||
- Define at first use in main text
|
||||
- Don't abbreviate in title
|
||||
- Limit to 3-4 new abbreviations per paper when possible
|
||||
- Use standard abbreviations (DNA, RNA, HIV, etc.) without definition
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Poor: "We measured Brain-Derived Neurotrophic Factor (BDNF) at baseline. BDNF
|
||||
levels were elevated."
|
||||
(Only used twice, abbreviation unnecessary)
|
||||
|
||||
Better: "We measured brain-derived neurotrophic factor at baseline. Levels were
|
||||
elevated."
|
||||
```
|
||||
|
||||
## Specific Sentence-Level Issues
|
||||
|
||||
### Dangling Modifiers
|
||||
|
||||
**Problem:**
|
||||
```
|
||||
"After incubating for 2 hours, we measured absorbance."
|
||||
(The sentence suggests "we" were incubated)
|
||||
|
||||
Better: "After incubating samples for 2 hours, we measured absorbance."
|
||||
Or: "After 2-hour incubation, we measured absorbance."
|
||||
```
|
||||
|
||||
### Misplaced Commas
|
||||
|
||||
**Common errors:**
|
||||
|
||||
**Between subject and verb:**
|
||||
```
|
||||
Wrong: "The participants in the intervention group, showed improvement."
|
||||
Right: "The participants in the intervention group showed improvement."
|
||||
```
|
||||
|
||||
**In compound predicates:**
|
||||
```
|
||||
Wrong: "We measured blood pressure, and recorded symptoms."
|
||||
Right: "We measured blood pressure and recorded symptoms."
|
||||
(No comma before "and" when it doesn't join independent clauses)
|
||||
```
|
||||
|
||||
### Pronoun Agreement
|
||||
|
||||
```
|
||||
Wrong: "Each participant completed their questionnaire."
|
||||
Right: "Each participant completed his or her questionnaire."
|
||||
Or better: "Participants completed their questionnaires."
|
||||
```
|
||||
|
||||
### Subject-Verb Agreement
|
||||
|
||||
```
|
||||
Wrong: "The group of participants were heterogeneous."
|
||||
Right: "The group of participants was heterogeneous."
|
||||
(Subject is "group" [singular], not "participants")
|
||||
|
||||
But: "The participants were heterogeneous." (Plural subject)
|
||||
```
|
||||
|
||||
## Word Choice
|
||||
|
||||
### Commonly Confused Words in Scientific Writing
|
||||
|
||||
| Often Misused | Correct Usage |
|
||||
|---------------|---------------|
|
||||
| **affect / effect** | Affect (verb): influence; Effect (noun): result; Effect (verb): bring about |
|
||||
| **among / between** | Among: three or more; Between: two |
|
||||
| **continual / continuous** | Continual: repeated; Continuous: uninterrupted |
|
||||
| **data is / data are** | Data are (plural); datum is (singular) |
|
||||
| **fewer / less** | Fewer: countable items; Less: continuous quantities |
|
||||
| **i.e. / e.g.** | i.e. (that is): restatement; e.g. (for example): examples |
|
||||
| **imply / infer** | Imply: suggest; Infer: deduce |
|
||||
| **parameter / variable** | Parameter: population value; Variable: measured characteristic |
|
||||
| **principal / principle** | Principal: main; Principle: rule or concept |
|
||||
| **significant** | Reserve for statistical significance, not importance |
|
||||
| **that / which** | That: restrictive clause; Which: nonrestrictive clause |
|
||||
|
||||
### Words to Avoid or Use Carefully
|
||||
|
||||
**Avoid informal language:**
|
||||
- "a lot of" → "many" or "substantial"
|
||||
- "got" → "obtained" or "became"
|
||||
- "showed up" → "appeared" or "was evident"
|
||||
|
||||
**Avoid vague quantifiers:**
|
||||
- "some" → specify how many
|
||||
- "often" → specify frequency
|
||||
- "recently" → specify timeframe
|
||||
|
||||
**Avoid unnecessary modifiers:**
|
||||
- "very significant" → "significant" (p-value shows degree)
|
||||
- "quite large" → "large" or specify size
|
||||
- "rather interesting" → delete or explain why
|
||||
|
||||
## Numbers and Units
|
||||
|
||||
### When to Use Numerals vs. Words
|
||||
|
||||
**Use numerals for:**
|
||||
- All numbers ≥10
|
||||
- Numbers with units (5 mg, 3 mL)
|
||||
- Statistical values (p=0.03, t=2.14)
|
||||
- Ages, dates, times
|
||||
- Scores and scales
|
||||
- Percentages (15%)
|
||||
|
||||
**Use words for:**
|
||||
- Numbers <10 when not connected to units (five participants)
|
||||
- Numbers beginning a sentence (spell out or restructure)
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
"Five participants withdrew" OR "There were 5 withdrawals"
|
||||
(NOT: "5 participants withdrew")
|
||||
|
||||
"We tested 15 samples at 3 time points"
|
||||
"Mean age was 45 years"
|
||||
```
|
||||
|
||||
### Units and Formatting
|
||||
|
||||
**Guidelines:**
|
||||
- Space between number and unit (5 mg, not 5mg)
|
||||
- No period after units (mg not mg.)
|
||||
- Use SI units unless field convention differs
|
||||
- Be consistent in decimal places
|
||||
- Use commas for thousands in text (12,500 not 12500)
|
||||
|
||||
**Ranges:**
|
||||
- Use en-dash (–) for ranges: 15–20 mg
|
||||
- Include unit only after second number: 15–20 mg (not 15 mg–20 mg)
|
||||
|
||||
## Paragraph Structure
|
||||
|
||||
### Ideal Paragraph Length
|
||||
|
||||
**Guidelines:**
|
||||
- 3-7 sentences typically
|
||||
- One main idea per paragraph
|
||||
- Too short (<2 sentences): may indicate idea needs development or combining
|
||||
- Too long (>10 sentences): may need splitting
|
||||
|
||||
### Paragraph Coherence
|
||||
|
||||
**Techniques:**
|
||||
|
||||
**1. Topic sentence:**
|
||||
```
|
||||
"Exercise training improves cardiovascular function through multiple mechanisms.
|
||||
[Following sentences explain these mechanisms]"
|
||||
```
|
||||
|
||||
**2. Transitional phrases:**
|
||||
- First, second, third, finally
|
||||
- Furthermore, moreover, in addition
|
||||
- However, nevertheless, conversely
|
||||
- Therefore, thus, consequently
|
||||
- For example, specifically, particularly
|
||||
|
||||
**3. Repetition of key terms:**
|
||||
```
|
||||
"...this mechanism of action. This mechanism may explain..."
|
||||
(Not: "...this mechanism. This process may explain...")
|
||||
```
|
||||
|
||||
**4. Parallel structure:**
|
||||
```
|
||||
"Group A received the drug. Group B received placebo. Group C received no treatment."
|
||||
(Not: "Group A received the drug. Placebo was given to Group B. No treatment was
|
||||
provided to the third group.")
|
||||
```
|
||||
|
||||
## Revision Checklist
|
||||
|
||||
### Content Level
|
||||
|
||||
- [ ] Does every sentence add value?
|
||||
- [ ] Are claims supported by data?
|
||||
- [ ] Is the logic clear and sound?
|
||||
- [ ] Are interpretations warranted by results?
|
||||
|
||||
### Paragraph Level
|
||||
|
||||
- [ ] Does each paragraph have one main idea?
|
||||
- [ ] Are paragraphs in logical order?
|
||||
- [ ] Are transitions smooth?
|
||||
- [ ] Is there a clear "red thread"?
|
||||
|
||||
### Sentence Level
|
||||
|
||||
- [ ] Are sentences clear and concise?
|
||||
- [ ] Is sentence structure varied?
|
||||
- [ ] Are there no dangling modifiers?
|
||||
- [ ] Do subjects and verbs agree?
|
||||
|
||||
### Word Level
|
||||
|
||||
- [ ] Is word choice precise?
|
||||
- [ ] Are technical terms defined?
|
||||
- [ ] Is terminology consistent?
|
||||
- [ ] Are abbreviations necessary and defined?
|
||||
- [ ] Are numbers formatted correctly?
|
||||
|
||||
### Grammar and Mechanics
|
||||
|
||||
- [ ] Is verb tense correct and consistent?
|
||||
- [ ] Are commas used correctly?
|
||||
- [ ] Do pronouns agree with antecedents?
|
||||
- [ ] Is punctuation correct?
|
||||
- [ ] Is spelling correct (including technical terms)?
|
||||
|
||||
## Tools for Improving Writing
|
||||
|
||||
### Grammar and Style Checkers
|
||||
|
||||
- **Grammarly**: Grammar, style, clarity
|
||||
- **ProWritingAid**: In-depth writing analysis
|
||||
- **Hemingway Editor**: Readability, simplification
|
||||
- **LanguageTool**: Open-source grammar checker
|
||||
|
||||
**Caution:** These tools don't understand scientific writing conventions. Use them as a starting point, not final arbiter.
|
||||
|
||||
### Readability Metrics
|
||||
|
||||
**Flesch Reading Ease:**
|
||||
- 60-70: acceptable for scientific papers
|
||||
- <60: may be too complex
|
||||
|
||||
**Caution:** Don't sacrifice precision for readability scores designed for general audiences.
|
||||
|
||||
### Peer Review
|
||||
|
||||
**Most valuable tool:**
|
||||
- Ask colleagues to read and provide feedback
|
||||
- Identify unclear passages
|
||||
- Check logical flow
|
||||
- Verify interpretations are warranted
|
||||
|
||||
## Additional Resources
|
||||
|
||||
### Books on Scientific Writing
|
||||
|
||||
- *The Elements of Style* by Strunk & White (classic on clear writing)
|
||||
- *On Writing Well* by William Zinsser
|
||||
- *Scientific Writing: A Reader and Writer's Guide* by Jean-Luc Lebrun
|
||||
- *How to Write a Scientific Paper* by George M. Whitesides
|
||||
- *Style: Lessons in Clarity and Grace* by Joseph Williams
|
||||
|
||||
### Online Resources
|
||||
|
||||
- **Academic Phrasebank** (University of Manchester): Common academic phrases
|
||||
- **Purdue OWL**: Grammar, punctuation, style
|
||||
- **Nature Masterclasses**: Scientific writing courses
|
||||
- **WritingCenters**: Many universities provide free online resources
|
||||
|
||||
### University Writing Centers
|
||||
|
||||
Most research universities offer:
|
||||
- Individual consultations
|
||||
- Workshops on scientific writing
|
||||
- Online resources and handouts
|
||||
- Support for non-native English speakers
|
||||
|
||||
## Final Thoughts
|
||||
|
||||
Effective scientific writing is a skill developed through practice. Key principles:
|
||||
|
||||
1. **Clarity** trumps complexity
|
||||
2. **Conciseness** respects readers' time
|
||||
3. **Accuracy** builds credibility
|
||||
4. **Objectivity** maintains scientific integrity
|
||||
5. **Consistency** aids comprehension
|
||||
6. **Logical organization** guides readers
|
||||
|
||||
**Remember:** The goal is not to impress readers with vocabulary or complexity, but to communicate your science clearly and precisely so readers can understand, evaluate, and build upon your work.
|
||||
Reference in New Issue
Block a user