Initial commit
This commit is contained in:
Zhongwei Li
284
skills/hypothesis-generation/SKILL.md
Normal file
284
skills/hypothesis-generation/SKILL.md
Normal file
@@ -0,0 +1,284 @@
|
||||
---
|
||||
name: hypothesis-generation
|
||||
description: "Generate testable hypotheses. Formulate from observations, design experiments, explore competing explanations, develop predictions, propose mechanisms, for scientific inquiry across domains."
|
||||
allowed-tools: [Read, Write, Edit, Bash]
|
||||
---
|
||||
|
||||
# Scientific Hypothesis Generation
|
||||
|
||||
## Overview
|
||||
|
||||
Hypothesis generation is a systematic process for developing testable explanations. Formulate evidence-based hypotheses from observations, design experiments, explore competing explanations, and develop predictions. Apply this skill for scientific inquiry across domains.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
This skill should be used when:
|
||||
- Developing hypotheses from observations or preliminary data
|
||||
- Designing experiments to test scientific questions
|
||||
- Exploring competing explanations for phenomena
|
||||
- Formulating testable predictions for research
|
||||
- Conducting literature-based hypothesis generation
|
||||
- Planning mechanistic studies across scientific domains
|
||||
|
||||
## Visual Enhancement with Scientific Schematics
|
||||
|
||||
**When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**
|
||||
|
||||
If your document does not already contain schematics or diagrams:
|
||||
- Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams
|
||||
- Simply describe your desired diagram in natural language
|
||||
- Nano Banana Pro will automatically generate, review, and refine the schematic
|
||||
|
||||
**For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
|
||||
|
||||
**How to generate schematics:**
|
||||
```bash
|
||||
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
|
||||
```
|
||||
|
||||
The AI will automatically:
|
||||
- Create publication-quality images with proper formatting
|
||||
- Review and refine through multiple iterations
|
||||
- Ensure accessibility (colorblind-friendly, high contrast)
|
||||
- Save outputs in the figures/ directory
|
||||
|
||||
**When to add schematics:**
|
||||
- Hypothesis framework diagrams showing competing explanations
|
||||
- Experimental design flowcharts
|
||||
- Mechanistic pathway diagrams
|
||||
- Prediction decision trees
|
||||
- Causal relationship diagrams
|
||||
- Theoretical model visualizations
|
||||
- Any complex concept that benefits from visualization
|
||||
|
||||
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
|
||||
|
||||
---
|
||||
|
||||
## Workflow
|
||||
|
||||
Follow this systematic process to generate robust scientific hypotheses:
|
||||
|
||||
### 1. Understand the Phenomenon
|
||||
|
||||
Start by clarifying the observation, question, or phenomenon that requires explanation:
|
||||
|
||||
- Identify the core observation or pattern that needs explanation
|
||||
- Define the scope and boundaries of the phenomenon
|
||||
- Note any constraints or specific contexts
|
||||
- Clarify what is already known vs. what is uncertain
|
||||
- Identify the relevant scientific domain(s)
|
||||
|
||||
### 2. Conduct Comprehensive Literature Search
|
||||
|
||||
Search existing scientific literature to ground hypotheses in current evidence. Use both PubMed (for biomedical topics) and general web search (for broader scientific domains):
|
||||
|
||||
**For biomedical topics:**
|
||||
- Use WebFetch with PubMed URLs to access relevant literature
|
||||
- Search for recent reviews, meta-analyses, and primary research
|
||||
- Look for similar phenomena, related mechanisms, or analogous systems
|
||||
|
||||
**For all scientific domains:**
|
||||
- Use WebSearch to find recent papers, preprints, and reviews
|
||||
- Search for established theories, mechanisms, or frameworks
|
||||
- Identify gaps in current understanding
|
||||
|
||||
**Search strategy:**
|
||||
- Begin with broad searches to understand the landscape
|
||||
- Narrow to specific mechanisms, pathways, or theories
|
||||
- Look for contradictory findings or unresolved debates
|
||||
- Consult `references/literature_search_strategies.md` for detailed search techniques
|
||||
|
||||
### 3. Synthesize Existing Evidence
|
||||
|
||||
Analyze and integrate findings from literature search:
|
||||
|
||||
- Summarize current understanding of the phenomenon
|
||||
- Identify established mechanisms or theories that may apply
|
||||
- Note conflicting evidence or alternative viewpoints
|
||||
- Recognize gaps, limitations, or unanswered questions
|
||||
- Identify analogies from related systems or domains
|
||||
|
||||
### 4. Generate Competing Hypotheses
|
||||
|
||||
Develop 3-5 distinct hypotheses that could explain the phenomenon. Each hypothesis should:
|
||||
|
||||
- Provide a mechanistic explanation (not just description)
|
||||
- Be distinguishable from other hypotheses
|
||||
- Draw on evidence from the literature synthesis
|
||||
- Consider different levels of explanation (molecular, cellular, systemic, population, etc.)
|
||||
|
||||
**Strategies for generating hypotheses:**
|
||||
- Apply known mechanisms from analogous systems
|
||||
- Consider multiple causative pathways
|
||||
- Explore different scales of explanation
|
||||
- Question assumptions in existing explanations
|
||||
- Combine mechanisms in novel ways
|
||||
|
||||
### 5. Evaluate Hypothesis Quality
|
||||
|
||||
Assess each hypothesis against established quality criteria from `references/hypothesis_quality_criteria.md`:
|
||||
|
||||
**Testability:** Can the hypothesis be empirically tested?
|
||||
**Falsifiability:** What observations would disprove it?
|
||||
**Parsimony:** Is it the simplest explanation that fits the evidence?
|
||||
**Explanatory Power:** How much of the phenomenon does it explain?
|
||||
**Scope:** What range of observations does it cover?
|
||||
**Consistency:** Does it align with established principles?
|
||||
**Novelty:** Does it offer new insights beyond existing explanations?
|
||||
|
||||
Explicitly note the strengths and weaknesses of each hypothesis.
|
||||
|
||||
### 6. Design Experimental Tests
|
||||
|
||||
For each viable hypothesis, propose specific experiments or studies to test it. Consult `references/experimental_design_patterns.md` for common approaches:
|
||||
|
||||
**Experimental design elements:**
|
||||
- What would be measured or observed?
|
||||
- What comparisons or controls are needed?
|
||||
- What methods or techniques would be used?
|
||||
- What sample sizes or statistical approaches are appropriate?
|
||||
- What are potential confounds and how to address them?
|
||||
|
||||
**Consider multiple approaches:**
|
||||
- Laboratory experiments (in vitro, in vivo, computational)
|
||||
- Observational studies (cross-sectional, longitudinal, case-control)
|
||||
- Clinical trials (if applicable)
|
||||
- Natural experiments or quasi-experimental designs
|
||||
|
||||
### 7. Formulate Testable Predictions
|
||||
|
||||
For each hypothesis, generate specific, quantitative predictions:
|
||||
|
||||
- State what should be observed if the hypothesis is correct
|
||||
- Specify expected direction and magnitude of effects when possible
|
||||
- Identify conditions under which predictions should hold
|
||||
- Distinguish predictions between competing hypotheses
|
||||
- Note predictions that would falsify the hypothesis
|
||||
|
||||
### 8. Present Structured Output
|
||||
|
||||
Generate a professional LaTeX document using the template in `assets/hypothesis_report_template.tex`. The report should be well-formatted with colored boxes for visual organization and divided into a concise main text with comprehensive appendices.
|
||||
|
||||
**Document Structure:**
|
||||
|
||||
**Main Text (Maximum 4 pages):**
|
||||
1. **Executive Summary** - Brief overview in summary box (0.5-1 page)
|
||||
2. **Competing Hypotheses** - Each hypothesis in its own colored box with brief mechanistic explanation and key evidence (2-2.5 pages for 3-5 hypotheses)
|
||||
- **IMPORTANT:** Use `\newpage` before each hypothesis box to prevent content overflow
|
||||
- Each box should be ≤0.6 pages maximum
|
||||
3. **Testable Predictions** - Key predictions in amber boxes (0.5-1 page)
|
||||
4. **Critical Comparisons** - Priority comparison boxes (0.5-1 page)
|
||||
|
||||
Keep main text highly concise - only the most essential information. All details go to appendices.
|
||||
|
||||
**Page Break Strategy:**
|
||||
- Always use `\newpage` before hypothesis boxes to ensure they start on fresh pages
|
||||
- This prevents content from overflowing off page boundaries
|
||||
- LaTeX boxes (tcolorbox) do not automatically break across pages
|
||||
|
||||
**Appendices (Comprehensive, Detailed):**
|
||||
- **Appendix A:** Comprehensive literature review with extensive citations
|
||||
- **Appendix B:** Detailed experimental designs with full protocols
|
||||
- **Appendix C:** Quality assessment tables and detailed evaluations
|
||||
- **Appendix D:** Supplementary evidence and analogous systems
|
||||
|
||||
**Colored Box Usage:**
|
||||
|
||||
Use the custom box environments from `hypothesis_generation.sty`:
|
||||
|
||||
- `hypothesisbox1` through `hypothesisbox5` - For each competing hypothesis (blue, green, purple, teal, orange)
|
||||
- `predictionbox` - For testable predictions (amber)
|
||||
- `comparisonbox` - For critical comparisons (steel gray)
|
||||
- `evidencebox` - For supporting evidence highlights (light blue)
|
||||
- `summarybox` - For executive summary (blue)
|
||||
|
||||
**Each hypothesis box should contain (keep concise for 4-page limit):**
|
||||
- **Mechanistic Explanation:** 1-2 brief paragraphs (6-10 sentences max) explaining HOW and WHY
|
||||
- **Key Supporting Evidence:** 2-3 bullet points with citations (most important evidence only)
|
||||
- **Core Assumptions:** 1-2 critical assumptions
|
||||
|
||||
All detailed explanations, additional evidence, and comprehensive discussions belong in the appendices.
|
||||
|
||||
**Critical Overflow Prevention:**
|
||||
- Insert `\newpage` before each hypothesis box to start it on a fresh page
|
||||
- Keep each complete hypothesis box to ≤0.6 pages (approximately 15-20 lines of content)
|
||||
- If content exceeds this, move additional details to Appendix A
|
||||
- Never let boxes overflow off page boundaries - this creates unreadable PDFs
|
||||
|
||||
**Citation Requirements:**
|
||||
|
||||
Aim for extensive citation to support all claims:
|
||||
- **Main text:** 10-15 key citations for most important evidence only (keep concise for 4-page limit)
|
||||
- **Appendix A:** 40-70+ comprehensive citations covering all relevant literature
|
||||
- **Total target:** 50+ references in bibliography
|
||||
|
||||
Main text citations should be selective - cite only the most critical papers. All comprehensive citation and detailed literature discussion belongs in the appendices. Use `\citep{author2023}` for parenthetical citations.
|
||||
|
||||
**LaTeX Compilation:**
|
||||
|
||||
The template requires XeLaTeX or LuaLaTeX for proper rendering:
|
||||
|
||||
```bash
|
||||
xelatex hypothesis_report.tex
|
||||
bibtex hypothesis_report
|
||||
xelatex hypothesis_report.tex
|
||||
xelatex hypothesis_report.tex
|
||||
```
|
||||
|
||||
**Required packages:** The `hypothesis_generation.sty` style package must be in the same directory or LaTeX path. It requires: tcolorbox, xcolor, fontspec, fancyhdr, titlesec, enumitem, booktabs, natbib.
|
||||
|
||||
**Page Overflow Prevention:**
|
||||
|
||||
To prevent content from overflowing on pages, follow these critical guidelines:
|
||||
|
||||
1. **Monitor Box Content Length:** Each hypothesis box should fit comfortably on a single page. If content exceeds ~0.7 pages, it will likely overflow.
|
||||
|
||||
2. **Use Strategic Page Breaks:** Insert `\newpage` before boxes that contain substantial content:
|
||||
```latex
|
||||
\newpage
|
||||
\begin{hypothesisbox1}[Hypothesis 1: Title]
|
||||
% Long content here
|
||||
\end{hypothesisbox1}
|
||||
```
|
||||
|
||||
3. **Keep Main Text Boxes Concise:** For the 4-page main text limit:
|
||||
- Each hypothesis box: Maximum 0.5-0.6 pages
|
||||
- Mechanistic explanation: 1-2 brief paragraphs only (6-10 sentences max)
|
||||
- Key evidence: 2-3 bullet points only
|
||||
- Core assumptions: 1-2 items only
|
||||
- If content is longer, move details to appendices
|
||||
|
||||
4. **Break Long Content:** If a hypothesis requires extensive explanation, split across main text and appendix:
|
||||
- Main text box: Brief mechanistic overview + 2-3 key evidence points
|
||||
- Appendix A: Detailed mechanism explanation, comprehensive evidence, extended discussion
|
||||
|
||||
5. **Test Page Boundaries:** Before each new box, consider if remaining page space is sufficient. If less than 0.6 pages remain, use `\newpage` to start the box on a fresh page.
|
||||
|
||||
6. **Appendix Page Management:** In appendices, use `\newpage` between major sections to avoid overflow in detailed content areas.
|
||||
|
||||
**Quick Reference:** See `assets/FORMATTING_GUIDE.md` for detailed examples of all box types, color schemes, and common formatting patterns.
|
||||
|
||||
## Quality Standards
|
||||
|
||||
Ensure all generated hypotheses meet these standards:
|
||||
|
||||
- **Evidence-based:** Grounded in existing literature with citations
|
||||
- **Testable:** Include specific, measurable predictions
|
||||
- **Mechanistic:** Explain how/why, not just what
|
||||
- **Comprehensive:** Consider alternative explanations
|
||||
- **Rigorous:** Include experimental designs to test predictions
|
||||
|
||||
## Resources
|
||||
|
||||
### references/
|
||||
|
||||
- `hypothesis_quality_criteria.md` - Framework for evaluating hypothesis quality (testability, falsifiability, parsimony, explanatory power, scope, consistency)
|
||||
- `experimental_design_patterns.md` - Common experimental approaches across domains (RCTs, observational studies, lab experiments, computational models)
|
||||
- `literature_search_strategies.md` - Effective search techniques for PubMed and general scientific sources
|
||||
|
||||
### assets/
|
||||
|
||||
- `hypothesis_generation.sty` - LaTeX style package providing colored boxes, professional formatting, and custom environments for hypothesis reports
|
||||
- `hypothesis_report_template.tex` - Complete LaTeX template with main text structure and comprehensive appendix sections
|
||||
- `FORMATTING_GUIDE.md` - Quick reference guide with examples of all box types, color schemes, citation practices, and troubleshooting tips
|
||||
672
skills/hypothesis-generation/assets/FORMATTING_GUIDE.md
Normal file
672
skills/hypothesis-generation/assets/FORMATTING_GUIDE.md
Normal file
@@ -0,0 +1,672 @@
|
||||
# Hypothesis Generation Report - Formatting Quick Reference
|
||||
|
||||
## Overview
|
||||
|
||||
This guide provides quick reference for using the hypothesis generation LaTeX template and style package. For complete documentation, see `SKILL.md`.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```latex
|
||||
% !TEX program = xelatex
|
||||
\documentclass[11pt,letterpaper]{article}
|
||||
\usepackage{hypothesis_generation}
|
||||
\usepackage{natbib}
|
||||
|
||||
\title{Your Phenomenon Name}
|
||||
\begin{document}
|
||||
\maketitle
|
||||
% Your content
|
||||
\end{document}
|
||||
```
|
||||
|
||||
**Compilation:** Use XeLaTeX or LuaLaTeX for best results
|
||||
```bash
|
||||
xelatex your_document.tex
|
||||
bibtex your_document
|
||||
xelatex your_document.tex
|
||||
xelatex your_document.tex
|
||||
```
|
||||
|
||||
## Color Scheme Reference
|
||||
|
||||
### Hypothesis Colors
|
||||
- **Hypothesis 1**: Deep Blue (RGB: 0, 102, 153) - Use for first hypothesis
|
||||
- **Hypothesis 2**: Forest Green (RGB: 0, 128, 96) - Use for second hypothesis
|
||||
- **Hypothesis 3**: Royal Purple (RGB: 102, 51, 153) - Use for third hypothesis
|
||||
- **Hypothesis 4**: Teal (RGB: 0, 128, 128) - Use for fourth hypothesis (if needed)
|
||||
- **Hypothesis 5**: Burnt Orange (RGB: 204, 85, 0) - Use for fifth hypothesis (if needed)
|
||||
|
||||
### Utility Colors
|
||||
- **Predictions**: Amber (RGB: 255, 191, 0) - For testable predictions
|
||||
- **Evidence**: Light Blue (RGB: 102, 178, 204) - For supporting evidence
|
||||
- **Comparisons**: Steel Gray (RGB: 108, 117, 125) - For critical comparisons
|
||||
- **Limitations**: Coral Red (RGB: 220, 53, 69) - For limitations/challenges
|
||||
|
||||
## Custom Box Environments
|
||||
|
||||
### 1. Executive Summary Box
|
||||
|
||||
```latex
|
||||
\begin{summarybox}[Executive Summary]
|
||||
Content here
|
||||
\end{summarybox}
|
||||
```
|
||||
|
||||
**Use for:** High-level overview at the beginning of the document
|
||||
|
||||
---
|
||||
|
||||
### 2. Hypothesis Boxes (5 variants)
|
||||
|
||||
```latex
|
||||
\begin{hypothesisbox1}[Hypothesis 1: Title]
|
||||
\textbf{Mechanistic Explanation:}
|
||||
[2-3 paragraphs explaining HOW and WHY]
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item Evidence point 1 \citep{ref1}
|
||||
\item Evidence point 2 \citep{ref2}
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item Assumption 1
|
||||
\item Assumption 2
|
||||
\end{enumerate}
|
||||
\end{hypothesisbox1}
|
||||
```
|
||||
|
||||
**Available boxes:** `hypothesisbox1`, `hypothesisbox2`, `hypothesisbox3`, `hypothesisbox4`, `hypothesisbox5`
|
||||
|
||||
**Use for:** Presenting each competing hypothesis with its mechanism, evidence, and assumptions
|
||||
|
||||
**Best practices for 4-page main text:**
|
||||
- Keep mechanistic explanations to 1-2 brief paragraphs only (6-10 sentences max)
|
||||
- Include 2-3 most essential evidence points with citations
|
||||
- List 1-2 most critical assumptions
|
||||
- Ensure each hypothesis is genuinely distinct
|
||||
- All detailed explanations go to Appendix A
|
||||
- **Use `\newpage` before each hypothesis box to prevent overflow**
|
||||
- Each complete hypothesis box should be ≤0.6 pages
|
||||
|
||||
---
|
||||
|
||||
### 3. Prediction Box
|
||||
|
||||
```latex
|
||||
\begin{predictionbox}[Predictions: Hypothesis 1]
|
||||
\textbf{Prediction 1.1:} [Specific prediction]
|
||||
\begin{itemize}
|
||||
\item \textbf{Conditions:} When/where this applies
|
||||
\item \textbf{Expected Outcome:} Specific measurable result
|
||||
\item \textbf{Falsification:} What would disprove it
|
||||
\end{itemize}
|
||||
\end{predictionbox}
|
||||
```
|
||||
|
||||
**Use for:** Testable predictions derived from each hypothesis
|
||||
|
||||
**Best practices for 4-page main text:**
|
||||
- Make predictions specific and quantitative when possible
|
||||
- Clearly state conditions under which prediction should hold
|
||||
- Always specify falsification criteria
|
||||
- Include only 1-2 most critical predictions per hypothesis in main text
|
||||
- Additional predictions go to appendices
|
||||
|
||||
---
|
||||
|
||||
### 4. Evidence Box
|
||||
|
||||
```latex
|
||||
\begin{evidencebox}[Supporting Evidence]
|
||||
Content discussing supporting evidence
|
||||
\end{evidencebox}
|
||||
```
|
||||
|
||||
**Use for:** Highlighting key supporting evidence or literature synthesis
|
||||
|
||||
**Best practices:**
|
||||
- Use sparingly in main text (detailed evidence goes in Appendix A)
|
||||
- Include citations for all evidence
|
||||
- Focus on most compelling evidence
|
||||
|
||||
---
|
||||
|
||||
### 5. Comparison Box
|
||||
|
||||
```latex
|
||||
\begin{comparisonbox}[H1 vs. H2: Key Distinction]
|
||||
\textbf{Fundamental Difference:}
|
||||
[Description of core difference]
|
||||
|
||||
\textbf{Discriminating Experiment:}
|
||||
[Description of experiment]
|
||||
|
||||
\textbf{Outcome Interpretation:}
|
||||
\begin{itemize}
|
||||
\item \textbf{If [Result A]:} H1 supported
|
||||
\item \textbf{If [Result B]:} H2 supported
|
||||
\end{itemize}
|
||||
\end{comparisonbox}
|
||||
```
|
||||
|
||||
**Use for:** Explaining how to distinguish between competing hypotheses
|
||||
|
||||
**Best practices:**
|
||||
- Focus on fundamental mechanistic differences
|
||||
- Propose clear, feasible discriminating experiments
|
||||
- Specify concrete outcome interpretations
|
||||
- Create comparisons for all major hypothesis pairs
|
||||
|
||||
---
|
||||
|
||||
### 6. Limitation Box
|
||||
|
||||
```latex
|
||||
\begin{limitationbox}[Limitations \& Challenges]
|
||||
Discussion of limitations
|
||||
\end{limitationbox}
|
||||
```
|
||||
|
||||
**Use for:** Highlighting important limitations or challenges
|
||||
|
||||
**Best practices:**
|
||||
- Use when limitations are particularly important
|
||||
- Be honest about challenges
|
||||
- Suggest how limitations might be addressed
|
||||
|
||||
---
|
||||
|
||||
## Document Structure
|
||||
|
||||
### Main Text (Maximum 4 Pages - Highly Concise)
|
||||
|
||||
1. **Executive Summary** (0.5-1 page)
|
||||
- Use `summarybox`
|
||||
- Brief phenomenon overview
|
||||
- List all hypotheses in 1 sentence each
|
||||
- Recommended approach
|
||||
|
||||
2. **Competing Hypotheses** (2-2.5 pages)
|
||||
- Use `hypothesisbox1`, `hypothesisbox2`, etc.
|
||||
- One box per hypothesis
|
||||
- Brief mechanistic explanation (1-2 paragraphs) + essential evidence (2-3 points) + key assumptions (1-2)
|
||||
- Target: 3-5 hypotheses
|
||||
- Keep highly concise - details go to appendices
|
||||
|
||||
3. **Testable Predictions** (0.5-1 page)
|
||||
- Use `predictionbox` for each hypothesis
|
||||
- 1-2 most critical predictions per hypothesis only
|
||||
- Very brief - full predictions in appendices
|
||||
|
||||
4. **Critical Comparisons** (0.5-1 page)
|
||||
- Use `comparisonbox` for highest priority comparison only
|
||||
- Show how to distinguish top hypotheses
|
||||
- Additional comparisons in appendices
|
||||
|
||||
**Main text total: Maximum 4 pages - be extremely selective about what goes here**
|
||||
|
||||
### Appendices (Comprehensive, Detailed)
|
||||
|
||||
**Appendix A: Comprehensive Literature Review**
|
||||
- Detailed background (extensive citations)
|
||||
- Current understanding
|
||||
- Evidence for each hypothesis (detailed)
|
||||
- Conflicting findings
|
||||
- Knowledge gaps
|
||||
- **Target: 40-60+ citations**
|
||||
|
||||
**Appendix B: Detailed Experimental Designs**
|
||||
- Full protocols for each hypothesis
|
||||
- Methods, controls, sample sizes
|
||||
- Statistical approaches
|
||||
- Feasibility assessments
|
||||
- Timeline and resource requirements
|
||||
|
||||
**Appendix C: Quality Assessment**
|
||||
- Detailed evaluation tables
|
||||
- Strengths and weaknesses analysis
|
||||
- Comparative scoring
|
||||
- Recommendations
|
||||
|
||||
**Appendix D: Supplementary Evidence**
|
||||
- Analogous mechanisms
|
||||
- Preliminary data
|
||||
- Theoretical frameworks
|
||||
- Historical context
|
||||
|
||||
**References**
|
||||
- **Target: 50+ total references**
|
||||
|
||||
## Citation Best Practices
|
||||
|
||||
### In Main Text
|
||||
- Cite 15-20 key papers
|
||||
- Use `\citep{author2023}` for parenthetical citations
|
||||
- Use `\citet{author2023}` for textual citations
|
||||
- Focus on most important/recent evidence
|
||||
|
||||
### In Appendices
|
||||
- Cite 40-60+ papers total
|
||||
- Comprehensive coverage of relevant literature
|
||||
- Include reviews, primary research, theoretical papers
|
||||
- Cite every claim and piece of evidence
|
||||
|
||||
### Citation Density Guidelines
|
||||
- Main hypothesis boxes: 2-3 citations per box (most essential only)
|
||||
- Main text total: 10-15 citations maximum (keep concise)
|
||||
- Appendix A literature sections: 8-15 citations per subsection
|
||||
- Experimental designs: 2-5 citations for methods/precedents
|
||||
- Quality assessments: Citations as needed for evaluation criteria
|
||||
- Total document: 50+ citations (vast majority in appendices)
|
||||
|
||||
## Tables
|
||||
|
||||
### Professional Table Formatting
|
||||
|
||||
```latex
|
||||
\begin{hypotable}{Caption}
|
||||
\begin{tabular}{|l|l|l|}
|
||||
\hline
|
||||
\tableheadercolor
|
||||
\textcolor{white}{\textbf{Header 1}} & \textcolor{white}{\textbf{Header 2}} \\
|
||||
\hline
|
||||
Data row 1 & Data \\
|
||||
\hline
|
||||
\tablerowcolor % Alternating gray background
|
||||
Data row 2 & Data \\
|
||||
\hline
|
||||
\end{tabular}
|
||||
\caption{Your caption}
|
||||
\end{hypotable}
|
||||
```
|
||||
|
||||
**Best practices:**
|
||||
- Use `\tableheadercolor` for header rows
|
||||
- Alternate `\tablerowcolor` for tables >3 rows
|
||||
- Keep tables readable (not too wide)
|
||||
- Use for quality assessments, comparisons
|
||||
|
||||
## Common Formatting Patterns
|
||||
|
||||
### Hypothesis Section Pattern
|
||||
|
||||
```latex
|
||||
% Use \newpage before hypothesis box to prevent overflow
|
||||
\newpage
|
||||
\subsection*{Hypothesis N: [Concise Title]}
|
||||
|
||||
\begin{hypothesisboxN}[Hypothesis N: [Title]]
|
||||
|
||||
\textbf{Mechanistic Explanation:}
|
||||
|
||||
[1-2 brief paragraphs of explanation - 6-10 sentences max]
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item [Evidence 1] \citep{ref1}
|
||||
\item [Evidence 2] \citep{ref2}
|
||||
\item [Evidence 3] \citep{ref3}
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item [Assumption 1]
|
||||
\item [Assumption 2]
|
||||
\end{enumerate}
|
||||
|
||||
\end{hypothesisboxN}
|
||||
|
||||
\vspace{0.5cm}
|
||||
```
|
||||
|
||||
**Note:** The `\newpage` before the hypothesis box ensures it starts on a fresh page, preventing overflow. This is especially important when boxes contain substantial content.
|
||||
|
||||
### Prediction Section Pattern
|
||||
|
||||
```latex
|
||||
\subsection*{Predictions from Hypothesis N}
|
||||
|
||||
\begin{predictionbox}[Predictions: Hypothesis N]
|
||||
|
||||
\textbf{Prediction N.1:} [Statement]
|
||||
\begin{itemize}
|
||||
\item \textbf{Conditions:} [Conditions]
|
||||
\item \textbf{Expected Outcome:} [Outcome]
|
||||
\item \textbf{Falsification:} [Falsification]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Prediction N.2:} [Statement]
|
||||
[... continue ...]
|
||||
|
||||
\end{predictionbox}
|
||||
```
|
||||
|
||||
### Comparison Section Pattern
|
||||
|
||||
```latex
|
||||
\subsection*{Distinguishing Hypothesis X vs. Hypothesis Y}
|
||||
|
||||
\begin{comparisonbox}[HX vs. HY: Key Distinction]
|
||||
|
||||
\textbf{Fundamental Difference:}
|
||||
|
||||
[Description of core difference]
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\textbf{Discriminating Experiment:}
|
||||
|
||||
[Experiment description]
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\textbf{Outcome Interpretation:}
|
||||
\begin{itemize}
|
||||
\item \textbf{If [Result A]:} HX supported
|
||||
\item \textbf{If [Result B]:} HY supported
|
||||
\item \textbf{If [Result C]:} Both/neither supported
|
||||
\end{itemize}
|
||||
|
||||
\end{comparisonbox}
|
||||
```
|
||||
|
||||
## Spacing and Layout
|
||||
|
||||
### Vertical Spacing
|
||||
- `\vspace{0.3cm}` - Between elements within boxes
|
||||
- `\vspace{0.5cm}` - Between major sections or boxes
|
||||
- `\vspace{1cm}` - After title, before main content
|
||||
|
||||
### Page Breaks and Overflow Prevention
|
||||
|
||||
**CRITICAL: Prevent Content Overflow**
|
||||
|
||||
LaTeX boxes (tcolorbox environments) do not automatically break across pages. Content that exceeds the remaining page space will overflow and cause formatting issues. Follow these guidelines:
|
||||
|
||||
1. **Strategic Page Breaks Before Long Boxes:**
|
||||
```latex
|
||||
\newpage % Start on fresh page if box will be long
|
||||
\begin{hypothesisbox1}[Hypothesis 1: Title]
|
||||
% Substantial content here
|
||||
\end{hypothesisbox1}
|
||||
```
|
||||
|
||||
2. **Monitor Box Content Length:**
|
||||
- Each hypothesis box should be ≤0.7 pages maximum
|
||||
- If mechanistic explanation + evidence + assumptions exceeds ~0.6 pages, content is too long
|
||||
- Solution: Move detailed content to appendices, keep only essentials in main text boxes
|
||||
|
||||
3. **When to Use `\newpage`:**
|
||||
- Before any hypothesis box with >3 subsections or >15 lines of content
|
||||
- Before comparison boxes with extensive experimental descriptions
|
||||
- Between major appendix sections
|
||||
- If less than 0.6 pages remain on current page before starting a new box
|
||||
|
||||
4. **Content Length Guidelines for Main Text:**
|
||||
- Executive summary box: 0.5-0.8 pages max
|
||||
- Each hypothesis box: 0.4-0.6 pages max
|
||||
- Each prediction box: 0.3-0.5 pages max
|
||||
- Each comparison box: 0.4-0.6 pages max
|
||||
|
||||
5. **Breaking Up Long Content:**
|
||||
```latex
|
||||
% GOOD: Concise main text with page break
|
||||
\newpage
|
||||
\begin{hypothesisbox1}[Hypothesis 1: Brief Title]
|
||||
\textbf{Mechanistic Explanation:}
|
||||
Brief overview in 1-2 paragraphs (6-10 sentences).
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item Evidence 1 \citep{ref1}
|
||||
\item Evidence 2 \citep{ref2}
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item Assumption 1
|
||||
\end{enumerate}
|
||||
|
||||
See Appendix A for detailed mechanism and comprehensive evidence.
|
||||
\end{hypothesisbox1}
|
||||
```
|
||||
|
||||
```latex
|
||||
% BAD: Overly long content that will overflow
|
||||
\begin{hypothesisbox1}[Hypothesis 1]
|
||||
\subsection{Very Long Section}
|
||||
Multiple paragraphs...
|
||||
\subsection{Another Long Section}
|
||||
More paragraphs...
|
||||
\subsection{Even More Content}
|
||||
[Content continues beyond page boundary → OVERFLOW!]
|
||||
\end{hypothesisbox1}
|
||||
```
|
||||
|
||||
6. **Page Break Commands:**
|
||||
- `\newpage` - Force new page (recommended before long boxes)
|
||||
- `\clearpage` - Force new page and flush floats (use before appendices)
|
||||
|
||||
### Section Spacing
|
||||
Already handled by style package, but you can adjust:
|
||||
```latex
|
||||
\vspace{0.5cm} % Add extra space if needed
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
**Issue: "File hypothesis_generation.sty not found"**
|
||||
- Solution: Ensure the .sty file is in the same directory as your .tex file, or in your LaTeX path
|
||||
|
||||
**Issue: Boxes don't have colors**
|
||||
- Solution: Compile with XeLaTeX or LuaLaTeX, not pdfLaTeX
|
||||
- Command: `xelatex yourfile.tex`
|
||||
|
||||
**Issue: Citations show as [?]**
|
||||
- Solution: Run bibtex after first xelatex compilation
|
||||
```bash
|
||||
xelatex yourfile.tex
|
||||
bibtex yourfile
|
||||
xelatex yourfile.tex
|
||||
xelatex yourfile.tex
|
||||
```
|
||||
|
||||
**Issue: Fonts not found**
|
||||
- Solution: Comment out font lines in the .sty file if custom fonts aren't installed
|
||||
- Lines to comment: `\setmainfont{...}` and `\setsansfont{...}`
|
||||
|
||||
**Issue: Box titles overlap with content**
|
||||
- Solution: Add more vertical space with `\vspace{0.3cm}` after titles
|
||||
|
||||
**Issue: Tables too wide**
|
||||
- Solution: Use `\small` or `\footnotesize` before tabular, or use `p{width}` column specs
|
||||
|
||||
**Issue: Content overflowing off the page**
|
||||
- **Cause:** Boxes (tcolorbox environments) are too long to fit on remaining page space
|
||||
- **Solution 1:** Add `\newpage` before the box to start it on a fresh page
|
||||
- **Solution 2:** Reduce box content - move detailed information to appendices
|
||||
- **Solution 3:** Break content into multiple smaller boxes
|
||||
- **Prevention:** Keep each hypothesis box to 0.4-0.6 pages maximum; use `\newpage` liberally before boxes with substantial content
|
||||
|
||||
**Issue: Main text exceeds 4 pages**
|
||||
- **Cause:** Boxes contain too much detailed information
|
||||
- **Solution:** Aggressively move content to appendices - main text boxes should contain only:
|
||||
- Brief mechanistic overview (1-2 paragraphs)
|
||||
- 2-3 key evidence bullets
|
||||
- 1-2 core assumptions
|
||||
- All detailed explanations, additional evidence, and comprehensive discussions belong in Appendix A
|
||||
|
||||
### Package Requirements
|
||||
|
||||
Ensure these packages are installed:
|
||||
- `tcolorbox` (with `most` option)
|
||||
- `xcolor`
|
||||
- `fontspec` (for XeLaTeX/LuaLaTeX)
|
||||
- `fancyhdr`
|
||||
- `titlesec`
|
||||
- `enumitem`
|
||||
- `booktabs`
|
||||
- `natbib`
|
||||
|
||||
Install missing packages:
|
||||
```bash
|
||||
# For TeX Live
|
||||
tlmgr install tcolorbox xcolor fontspec fancyhdr titlesec enumitem booktabs natbib
|
||||
|
||||
# For MiKTeX (Windows)
|
||||
# Use MiKTeX Package Manager GUI
|
||||
```
|
||||
|
||||
## Style Consistency Tips
|
||||
|
||||
1. **Color Usage**
|
||||
- Always use the same color for each hypothesis throughout the document
|
||||
- H1 = blue, H2 = green, H3 = purple, etc.
|
||||
- Don't mix colors for the same hypothesis
|
||||
|
||||
2. **Box Usage**
|
||||
- Main text: Hypothesis boxes, prediction boxes, comparison boxes
|
||||
- Appendix: Can use evidence boxes, limitation boxes as needed
|
||||
- Don't overuse boxes - reserve for key content
|
||||
|
||||
3. **Citation Style**
|
||||
- Consistent citation format throughout
|
||||
- Use `\citep{}` for most citations
|
||||
- Group multiple citations: `\citep{ref1, ref2, ref3}`
|
||||
|
||||
4. **Hypothesis Numbering**
|
||||
- Number hypotheses consistently (H1, H2, H3, etc.)
|
||||
- Use same numbering in predictions (P1.1, P1.2 for H1)
|
||||
- Use same numbering in comparisons (H1 vs. H2)
|
||||
|
||||
5. **Language**
|
||||
- Be precise and specific
|
||||
- Avoid vague language ("may", "could", "possibly")
|
||||
- Use active voice when possible
|
||||
- Make predictions quantitative when feasible
|
||||
|
||||
## Quick Checklist
|
||||
|
||||
Before finalizing your document:
|
||||
|
||||
- [ ] Title page has phenomenon name
|
||||
- [ ] **Main text is 4 pages maximum**
|
||||
- [ ] Executive summary is concise (0.5-1 page)
|
||||
- [ ] Each hypothesis in its own colored box
|
||||
- [ ] 3-5 hypotheses presented (not more)
|
||||
- [ ] Each hypothesis has brief mechanistic explanation (1-2 paragraphs)
|
||||
- [ ] Each hypothesis has 2-3 most essential evidence points with citations
|
||||
- [ ] Each hypothesis has 1-2 most critical assumptions
|
||||
- [ ] Predictions boxes with 1-2 key predictions per hypothesis
|
||||
- [ ] Priority comparison box in main text (others in appendix)
|
||||
- [ ] Priority experiments identified
|
||||
- [ ] **Page breaks (`\newpage`) used before long boxes to prevent overflow**
|
||||
- [ ] **No content overflows off page boundaries (check PDF carefully)**
|
||||
- [ ] **Each hypothesis box is ≤0.6 pages (if longer, move details to appendix)**
|
||||
- [ ] Appendix A has comprehensive literature review with detailed evidence
|
||||
- [ ] Appendix B has detailed experimental protocols
|
||||
- [ ] Appendix C has quality assessment tables
|
||||
- [ ] Appendix D has supplementary evidence
|
||||
- [ ] 10-15 citations in main text (selective)
|
||||
- [ ] 50+ total citations in full document
|
||||
- [ ] All boxes use correct colors
|
||||
- [ ] Document compiles without errors
|
||||
- [ ] References formatted correctly
|
||||
- [ ] **Compiled PDF checked visually for overflow issues**
|
||||
|
||||
## Example Minimal Document
|
||||
|
||||
```latex
|
||||
% !TEX program = xelatex
|
||||
\documentclass[11pt,letterpaper]{article}
|
||||
\usepackage{hypothesis_generation}
|
||||
\usepackage{natbib}
|
||||
|
||||
\title{Role of X in Y}
|
||||
|
||||
\begin{document}
|
||||
\maketitle
|
||||
|
||||
\section*{Executive Summary}
|
||||
\begin{summarybox}[Executive Summary]
|
||||
Brief overview of phenomenon and hypotheses.
|
||||
\end{summarybox}
|
||||
|
||||
\section{Competing Hypotheses}
|
||||
|
||||
% Use \newpage before each hypothesis box to prevent overflow
|
||||
\newpage
|
||||
\subsection*{Hypothesis 1: Title}
|
||||
\begin{hypothesisbox1}[Hypothesis 1: Title]
|
||||
\textbf{Mechanistic Explanation:}
|
||||
Brief explanation in 1-2 paragraphs.
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item Evidence point \citep{ref1}
|
||||
\end{itemize}
|
||||
\end{hypothesisbox1}
|
||||
|
||||
\newpage
|
||||
\subsection*{Hypothesis 2: Title}
|
||||
\begin{hypothesisbox2}[Hypothesis 2: Title]
|
||||
\textbf{Mechanistic Explanation:}
|
||||
Brief explanation in 1-2 paragraphs.
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item Evidence point \citep{ref2}
|
||||
\end{itemize}
|
||||
\end{hypothesisbox2}
|
||||
|
||||
\section{Testable Predictions}
|
||||
|
||||
\subsection*{Predictions from Hypothesis 1}
|
||||
\begin{predictionbox}[Predictions: Hypothesis 1]
|
||||
Predictions here.
|
||||
\end{predictionbox}
|
||||
|
||||
\section{Critical Comparisons}
|
||||
|
||||
\subsection*{H1 vs. H2}
|
||||
\begin{comparisonbox}[H1 vs. H2]
|
||||
Comparison here.
|
||||
\end{comparisonbox}
|
||||
|
||||
% Force new page before appendices
|
||||
\appendix
|
||||
\newpage
|
||||
\appendixsection{Appendix A: Literature Review}
|
||||
Detailed literature review here.
|
||||
|
||||
\newpage
|
||||
\bibliographystyle{plainnat}
|
||||
\bibliography{references}
|
||||
|
||||
\end{document}
|
||||
```
|
||||
|
||||
**Key Points:**
|
||||
- `\newpage` used before each hypothesis box to ensure they start on fresh pages
|
||||
- This prevents content overflow issues
|
||||
- Main text boxes kept concise (1-2 paragraphs + bullet points)
|
||||
- Detailed content goes to appendices
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- See `hypothesis_report_template.tex` for complete annotated template
|
||||
- See `SKILL.md` for workflow and methodology guidance
|
||||
- See `references/hypothesis_quality_criteria.md` for evaluation framework
|
||||
- See `references/experimental_design_patterns.md` for design guidance
|
||||
- See treatment-plans skill for additional LaTeX styling examples
|
||||
|
||||
307
skills/hypothesis-generation/assets/hypothesis_generation.sty
Normal file
307
skills/hypothesis-generation/assets/hypothesis_generation.sty
Normal file
@@ -0,0 +1,307 @@
|
||||
% hypothesis_generation.sty
|
||||
% Professional Scientific Hypothesis Generation Report Style
|
||||
% Provides modern, color-coded styling for hypothesis generation documents
|
||||
|
||||
\NeedsTeXFormat{LaTeX2e}
|
||||
\ProvidesPackage{hypothesis_generation}[2025/11/17 Hypothesis Generation Report Style]
|
||||
|
||||
% Required packages
|
||||
\RequirePackage[margin=1in, top=1.2in, bottom=1.2in]{geometry}
|
||||
\RequirePackage{graphicx}
|
||||
\RequirePackage{xcolor}
|
||||
\RequirePackage[most]{tcolorbox}
|
||||
\RequirePackage{tikz}
|
||||
\RequirePackage{fontspec}
|
||||
\RequirePackage{fancyhdr}
|
||||
\RequirePackage{titlesec}
|
||||
\RequirePackage{enumitem}
|
||||
\RequirePackage{booktabs}
|
||||
\RequirePackage{longtable}
|
||||
\RequirePackage{array}
|
||||
\RequirePackage{colortbl}
|
||||
\RequirePackage{hyperref}
|
||||
\RequirePackage{natbib}
|
||||
|
||||
% Color scheme - Distinct colors for each hypothesis plus utility colors
|
||||
\definecolor{hypothesis1}{RGB}{0, 102, 153} % Deep Blue
|
||||
\definecolor{hypothesis2}{RGB}{0, 128, 96} % Forest Green
|
||||
\definecolor{hypothesis3}{RGB}{102, 51, 153} % Royal Purple
|
||||
\definecolor{hypothesis4}{RGB}{0, 128, 128} % Teal
|
||||
\definecolor{hypothesis5}{RGB}{204, 85, 0} % Burnt Orange
|
||||
\definecolor{predictioncolor}{RGB}{255, 191, 0} % Amber
|
||||
\definecolor{evidencecolor}{RGB}{102, 178, 204} % Light Blue
|
||||
\definecolor{comparisoncolor}{RGB}{108, 117, 125} % Steel Gray
|
||||
\definecolor{limitationcolor}{RGB}{220, 53, 69} % Coral Red
|
||||
\definecolor{darkgray}{RGB}{64, 64, 64} % Dark gray for text
|
||||
\definecolor{lightgray}{RGB}{245, 245, 245} % Light background
|
||||
|
||||
% Fonts (if using XeLaTeX/LuaLaTeX)
|
||||
% Comment these out if fonts are not available
|
||||
% \setmainfont{Lato}
|
||||
% \setsansfont{Roboto}
|
||||
|
||||
% Hyperlink setup
|
||||
\hypersetup{
|
||||
colorlinks=true,
|
||||
linkcolor=hypothesis1,
|
||||
citecolor=hypothesis1,
|
||||
urlcolor=evidencecolor,
|
||||
pdfborder={0 0 0}
|
||||
}
|
||||
|
||||
% Header and footer styling
|
||||
\setlength{\headheight}{22pt}
|
||||
\pagestyle{fancy}
|
||||
\fancyhf{}
|
||||
\fancyhead[L]{\color{hypothesis1}\sffamily\small\textbf{Hypothesis Generation Report}}
|
||||
\fancyhead[R]{\color{darkgray}\sffamily\small\thepage}
|
||||
\fancyfoot[C]{\color{darkgray}\small Generated: \today}
|
||||
\renewcommand{\headrulewidth}{2pt}
|
||||
\renewcommand{\headrule}{\hbox to\headwidth{\color{hypothesis1}\leaders\hrule height \headrulewidth\hfill}}
|
||||
\renewcommand{\footrulewidth}{0.5pt}
|
||||
\renewcommand{\footrule}{\hbox to\headwidth{\color{lightgray}\leaders\hrule height \footrulewidth\hfill}}
|
||||
|
||||
% Section styling
|
||||
\titleformat{\section}
|
||||
{\color{hypothesis1}\Large\sffamily\bfseries}
|
||||
{\thesection}{1em}{}
|
||||
[\color{hypothesis1}\titlerule]
|
||||
|
||||
\titleformat{\subsection}
|
||||
{\color{evidencecolor}\large\sffamily\bfseries}
|
||||
{\thesubsection}{1em}{}
|
||||
|
||||
\titleformat{\subsubsection}
|
||||
{\color{darkgray}\normalsize\sffamily\bfseries}
|
||||
{\thesubsubsection}{1em}{}
|
||||
|
||||
% Title page styling
|
||||
\renewcommand{\maketitle}{
|
||||
\begin{tcolorbox}[
|
||||
enhanced,
|
||||
colback=hypothesis1,
|
||||
colframe=hypothesis1,
|
||||
arc=0mm,
|
||||
boxrule=0pt,
|
||||
left=20pt,
|
||||
right=20pt,
|
||||
top=30pt,
|
||||
bottom=30pt,
|
||||
width=\textwidth
|
||||
]
|
||||
\color{white}
|
||||
\begin{center}
|
||||
{\Huge\sffamily\bfseries Scientific Hypothesis\\Generation Report}\\[10pt]
|
||||
{\Large\sffamily\@title}\\[15pt]
|
||||
{\large\sffamily Evidence-Based Competing Hypotheses}\\[8pt]
|
||||
{\normalsize\sffamily\color{evidencecolor}\today}
|
||||
\end{center}
|
||||
\end{tcolorbox}
|
||||
\vspace{1cm}
|
||||
}
|
||||
|
||||
% Custom boxes for hypotheses (5 different colors)
|
||||
\newtcolorbox{hypothesisbox1}[1][Hypothesis 1]{
|
||||
enhanced,
|
||||
colback=hypothesis1!5,
|
||||
colframe=hypothesis1,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=12pt,
|
||||
right=12pt,
|
||||
top=12pt,
|
||||
bottom=12pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis1,
|
||||
attach boxed title to top left={yshift=-3mm, xshift=5mm},
|
||||
boxed title style={arc=2mm}
|
||||
}
|
||||
|
||||
\newtcolorbox{hypothesisbox2}[1][Hypothesis 2]{
|
||||
enhanced,
|
||||
colback=hypothesis2!5,
|
||||
colframe=hypothesis2,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=12pt,
|
||||
right=12pt,
|
||||
top=12pt,
|
||||
bottom=12pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis2,
|
||||
attach boxed title to top left={yshift=-3mm, xshift=5mm},
|
||||
boxed title style={arc=2mm}
|
||||
}
|
||||
|
||||
\newtcolorbox{hypothesisbox3}[1][Hypothesis 3]{
|
||||
enhanced,
|
||||
colback=hypothesis3!5,
|
||||
colframe=hypothesis3,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=12pt,
|
||||
right=12pt,
|
||||
top=12pt,
|
||||
bottom=12pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis3,
|
||||
attach boxed title to top left={yshift=-3mm, xshift=5mm},
|
||||
boxed title style={arc=2mm}
|
||||
}
|
||||
|
||||
\newtcolorbox{hypothesisbox4}[1][Hypothesis 4]{
|
||||
enhanced,
|
||||
colback=hypothesis4!5,
|
||||
colframe=hypothesis4,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=12pt,
|
||||
right=12pt,
|
||||
top=12pt,
|
||||
bottom=12pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis4,
|
||||
attach boxed title to top left={yshift=-3mm, xshift=5mm},
|
||||
boxed title style={arc=2mm}
|
||||
}
|
||||
|
||||
\newtcolorbox{hypothesisbox5}[1][Hypothesis 5]{
|
||||
enhanced,
|
||||
colback=hypothesis5!5,
|
||||
colframe=hypothesis5,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=12pt,
|
||||
right=12pt,
|
||||
top=12pt,
|
||||
bottom=12pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis5,
|
||||
attach boxed title to top left={yshift=-3mm, xshift=5mm},
|
||||
boxed title style={arc=2mm}
|
||||
}
|
||||
|
||||
% Prediction box (amber)
|
||||
\newtcolorbox{predictionbox}[1][Testable Predictions]{
|
||||
enhanced,
|
||||
colback=predictioncolor!10,
|
||||
colframe=predictioncolor!80!black,
|
||||
arc=3mm,
|
||||
boxrule=1.5pt,
|
||||
left=10pt,
|
||||
right=10pt,
|
||||
top=10pt,
|
||||
bottom=10pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries,
|
||||
coltitle=black,
|
||||
colbacktitle=predictioncolor
|
||||
}
|
||||
|
||||
% Evidence/Support box (light blue)
|
||||
\newtcolorbox{evidencebox}[1][Supporting Evidence]{
|
||||
enhanced,
|
||||
colback=evidencecolor!8,
|
||||
colframe=evidencecolor,
|
||||
arc=3mm,
|
||||
boxrule=1.5pt,
|
||||
left=10pt,
|
||||
right=10pt,
|
||||
top=10pt,
|
||||
bottom=10pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries,
|
||||
coltitle=white,
|
||||
colbacktitle=evidencecolor
|
||||
}
|
||||
|
||||
% Comparison box (steel gray)
|
||||
\newtcolorbox{comparisonbox}[1][Critical Comparison]{
|
||||
enhanced,
|
||||
colback=comparisoncolor!8,
|
||||
colframe=comparisoncolor,
|
||||
arc=3mm,
|
||||
boxrule=1.5pt,
|
||||
left=10pt,
|
||||
right=10pt,
|
||||
top=10pt,
|
||||
bottom=10pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries,
|
||||
coltitle=white,
|
||||
colbacktitle=comparisoncolor
|
||||
}
|
||||
|
||||
% Limitation box (coral red)
|
||||
\newtcolorbox{limitationbox}[1][Limitations \& Challenges]{
|
||||
enhanced,
|
||||
colback=limitationcolor!8,
|
||||
colframe=limitationcolor,
|
||||
arc=3mm,
|
||||
boxrule=1.5pt,
|
||||
left=10pt,
|
||||
right=10pt,
|
||||
top=10pt,
|
||||
bottom=10pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries,
|
||||
coltitle=white,
|
||||
colbacktitle=limitationcolor
|
||||
}
|
||||
|
||||
% Executive summary box (using evidence color for consistency)
|
||||
\newtcolorbox{summarybox}[1][Executive Summary]{
|
||||
enhanced,
|
||||
colback=evidencecolor!15,
|
||||
colframe=hypothesis1,
|
||||
arc=3mm,
|
||||
boxrule=2pt,
|
||||
left=15pt,
|
||||
right=15pt,
|
||||
top=15pt,
|
||||
bottom=15pt,
|
||||
title=#1,
|
||||
fonttitle=\sffamily\bfseries\Large,
|
||||
coltitle=white,
|
||||
colbacktitle=hypothesis1
|
||||
}
|
||||
|
||||
% Table styling
|
||||
\newcommand{\tableheadercolor}{\rowcolor{hypothesis1}}
|
||||
\newcommand{\tablerowcolor}{\rowcolor{lightgray}}
|
||||
|
||||
% Custom table environment
|
||||
\newenvironment{hypotable}[1]{
|
||||
\begin{table}[h]
|
||||
\centering
|
||||
\small\sffamily
|
||||
\renewcommand{\arraystretch}{1.3}
|
||||
}{
|
||||
\end{table}
|
||||
}
|
||||
|
||||
% Custom list styling
|
||||
\setlist[itemize,1]{label=\textcolor{hypothesis1}{\textbullet}, leftmargin=*, itemsep=3pt}
|
||||
\setlist[enumerate,1]{label=\textcolor{hypothesis1}{\arabic*.}, leftmargin=*, itemsep=3pt}
|
||||
|
||||
% Appendix styling
|
||||
\newcommand{\appendixsection}[1]{
|
||||
\section*{#1}
|
||||
\addcontentsline{toc}{section}{#1}
|
||||
}
|
||||
|
||||
% Citation styling helper
|
||||
\newcommand{\citehighlight}[1]{\textcolor{evidencecolor}{\citep{#1}}}
|
||||
|
||||
\endinput
|
||||
|
||||
@@ -0,0 +1,572 @@
|
||||
% !TEX program = xelatex
|
||||
\documentclass[11pt,letterpaper]{article}
|
||||
\usepackage{hypothesis_generation}
|
||||
\usepackage{natbib}
|
||||
|
||||
% Document metadata
|
||||
\title{[Phenomenon Name]}
|
||||
\author{Scientific Hypothesis Generation}
|
||||
\date{\today}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\maketitle
|
||||
|
||||
% ============================================================================
|
||||
% EXECUTIVE SUMMARY
|
||||
% ============================================================================
|
||||
% NOTE: Keep main text to 4 pages maximum. All details go to appendices.
|
||||
% Executive Summary: 0.5-1 page
|
||||
|
||||
\section*{Executive Summary}
|
||||
\addcontentsline{toc}{section}{Executive Summary}
|
||||
|
||||
\begin{summarybox}[Executive Summary]
|
||||
\textbf{Phenomenon:} [One paragraph: What was observed? Why is it important?]
|
||||
|
||||
\vspace{0.2cm}
|
||||
\textbf{Key Question:} [Single sentence stating the central question]
|
||||
|
||||
\vspace{0.2cm}
|
||||
\textbf{Competing Hypotheses:}
|
||||
\begin{enumerate}
|
||||
\item \textbf{[H1 Title]:} [One sentence mechanistic summary]
|
||||
\item \textbf{[H2 Title]:} [One sentence mechanistic summary]
|
||||
\item \textbf{[H3 Title]:} [One sentence mechanistic summary]
|
||||
\item \textbf{[Add H4 \& H5 if applicable]}
|
||||
\end{enumerate}
|
||||
|
||||
\vspace{0.2cm}
|
||||
\textbf{Recommended Approach:} [One sentence on priority experiments]
|
||||
|
||||
\end{summarybox}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
% ============================================================================
|
||||
% COMPETING HYPOTHESES
|
||||
% ============================================================================
|
||||
% NOTE: Keep this section to 2-2.5 pages for 3-5 hypotheses
|
||||
% Each hypothesis: 1-2 brief paragraphs + 2-3 key evidence points + 1-2 assumptions
|
||||
% Detailed explanations and additional evidence go to Appendix A
|
||||
|
||||
\section{Competing Hypotheses}
|
||||
|
||||
This section presents [3-5] distinct mechanistic hypotheses. Detailed literature review and comprehensive evidence are in Appendix A.
|
||||
|
||||
\subsection*{Hypothesis 1: [Concise Descriptive Title]}
|
||||
|
||||
\begin{hypothesisbox1}[Hypothesis 1: [Title]]
|
||||
|
||||
\textbf{Mechanistic Explanation:}
|
||||
|
||||
[Provide a BRIEF mechanistic explanation (1-2 paragraphs) of HOW and WHY. Keep concise - main text is limited to 4 pages total. Include only the essential mechanism. All detailed explanations go to Appendix A.
|
||||
|
||||
Example: "This hypothesis proposes that [mechanism X] operates through [pathway Y], resulting in [outcome Z]. The process initiates when [trigger], activating [component A] and ultimately producing the observed [phenomenon] \citep{key-ref}."
|
||||
]
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item [Most essential evidence point 1 \citep{author2023}]
|
||||
\item [Most essential evidence point 2 \citep{author2022}]
|
||||
\item [Most essential evidence point 3 \citep{author2021}]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item [Most critical assumption 1]
|
||||
\item [Most critical assumption 2]
|
||||
\end{enumerate}
|
||||
|
||||
\end{hypothesisbox1}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\subsection*{Hypothesis 2: [Concise Descriptive Title]}
|
||||
|
||||
\begin{hypothesisbox2}[Hypothesis 2: [Title]]
|
||||
|
||||
\textbf{Mechanistic Explanation:}
|
||||
|
||||
[BRIEF mechanistic explanation (1-2 paragraphs) distinct from Hypothesis 1. Keep concise.]
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item [Essential evidence point 1 with citation]
|
||||
\item [Essential evidence point 2 with citation]
|
||||
\item [Essential evidence point 3 with citation]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item [Critical assumption 1]
|
||||
\item [Critical assumption 2]
|
||||
\end{enumerate}
|
||||
|
||||
\end{hypothesisbox2}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\subsection*{Hypothesis 3: [Concise Descriptive Title]}
|
||||
|
||||
\begin{hypothesisbox3}[Hypothesis 3: [Title]]
|
||||
|
||||
\textbf{Mechanistic Explanation:}
|
||||
|
||||
[BRIEF mechanistic explanation (1-2 paragraphs) distinct from previous hypotheses.]
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Key Supporting Evidence:}
|
||||
\begin{itemize}
|
||||
\item [Essential evidence point 1 with citation]
|
||||
\item [Essential evidence point 2 with citation]
|
||||
\item [Essential evidence point 3 with citation]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Core Assumptions:}
|
||||
\begin{enumerate}
|
||||
\item [Critical assumption 1]
|
||||
\item [Critical assumption 2]
|
||||
\end{enumerate}
|
||||
|
||||
\end{hypothesisbox3}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
% Optional: Include Hypothesis 4 and 5 if needed
|
||||
% \subsection*{Hypothesis 4: [Title]}
|
||||
% \begin{hypothesisbox4}[Hypothesis 4: [Title]]
|
||||
% [Content following same structure]
|
||||
% \end{hypothesisbox4}
|
||||
|
||||
% \subsection*{Hypothesis 5: [Title]}
|
||||
% \begin{hypothesisbox5}[Hypothesis 5: [Title]]
|
||||
% [Content following same structure]
|
||||
% \end{hypothesisbox5}
|
||||
|
||||
% ============================================================================
|
||||
% TESTABLE PREDICTIONS
|
||||
% ============================================================================
|
||||
% NOTE: Keep this section to 0.5-1 page
|
||||
% Include only 1-2 most critical predictions per hypothesis
|
||||
% Additional predictions go to Appendix B with experimental designs
|
||||
|
||||
\section{Testable Predictions}
|
||||
|
||||
Key predictions from each hypothesis. Full prediction details and additional predictions in Appendix B.
|
||||
|
||||
\subsection*{Predictions from Hypothesis 1}
|
||||
|
||||
\begin{predictionbox}[Predictions: Hypothesis 1]
|
||||
|
||||
\textbf{Prediction 1.1:} [Most critical prediction]
|
||||
\begin{itemize}
|
||||
\item \textbf{Expected Outcome:} [Specific result with magnitude if possible]
|
||||
\item \textbf{Falsification:} [What would disprove it]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.15cm}
|
||||
|
||||
\textbf{Prediction 1.2:} [Second most critical prediction]
|
||||
\begin{itemize}
|
||||
\item \textbf{Expected Outcome:} [Specific result]
|
||||
\item \textbf{Falsification:} [What would disprove it]
|
||||
\end{itemize}
|
||||
|
||||
\end{predictionbox}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\subsection*{Predictions from Hypothesis 2}
|
||||
|
||||
\begin{predictionbox}[Predictions: Hypothesis 2]
|
||||
|
||||
\textbf{Prediction 2.1:} [Most critical prediction]
|
||||
\begin{itemize}
|
||||
\item \textbf{Expected Outcome:} [Specific result]
|
||||
\item \textbf{Falsification:} [What would disprove it]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.15cm}
|
||||
|
||||
\textbf{Prediction 2.2:} [Second most critical prediction]
|
||||
\begin{itemize}
|
||||
\item \textbf{Expected Outcome:} [Specific result]
|
||||
\item \textbf{Falsification:} [What would disprove it]
|
||||
\end{itemize}
|
||||
|
||||
\end{predictionbox}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\subsection*{Predictions from Hypothesis 3}
|
||||
|
||||
\begin{predictionbox}[Predictions: Hypothesis 3]
|
||||
|
||||
[1-2 most critical predictions only, following same brief structure]
|
||||
|
||||
\end{predictionbox}
|
||||
|
||||
% Add prediction boxes for Hypotheses 4 and 5 if applicable
|
||||
|
||||
% ============================================================================
|
||||
% CRITICAL COMPARISONS
|
||||
% ============================================================================
|
||||
% NOTE: Keep this section to 0.5-1 page
|
||||
% Include only the HIGHEST PRIORITY comparison
|
||||
% Additional comparisons go to Appendix B
|
||||
|
||||
\section{Critical Comparisons}
|
||||
|
||||
Highest priority comparison for distinguishing hypotheses. Additional comparisons in Appendix B.
|
||||
|
||||
\subsection*{Priority Comparison: Hypothesis 1 vs. Hypothesis 2}
|
||||
|
||||
\begin{comparisonbox}[H1 vs. H2: Key Distinction]
|
||||
|
||||
\textbf{Fundamental Difference:} [One sentence on core mechanistic difference]
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Discriminating Experiment:} [Brief description of key experiment to distinguish them]
|
||||
|
||||
\vspace{0.2cm}
|
||||
|
||||
\textbf{Outcome Interpretation:}
|
||||
\begin{itemize}
|
||||
\item \textbf{If [Result A]:} H1 supported
|
||||
\item \textbf{If [Result B]:} H2 supported
|
||||
\end{itemize}
|
||||
|
||||
\end{comparisonbox}
|
||||
|
||||
\vspace{0.3cm}
|
||||
|
||||
\textbf{Highest Priority Test:} [Name of single most important experiment]
|
||||
|
||||
\textbf{Justification:} [2-3 sentences on why this is highest priority considering informativeness and feasibility. Full experimental details in Appendix B.]
|
||||
|
||||
% ============================================================================
|
||||
% APPENDICES
|
||||
% ============================================================================
|
||||
\newpage
|
||||
\appendix
|
||||
|
||||
% ============================================================================
|
||||
% APPENDIX A: COMPREHENSIVE LITERATURE REVIEW
|
||||
% ============================================================================
|
||||
\appendixsection{Appendix A: Comprehensive Literature Review}
|
||||
|
||||
This appendix provides detailed synthesis of existing literature, extensive background context, and comprehensive citations supporting the hypotheses presented in this report.
|
||||
|
||||
\subsection*{A.1 Phenomenon Background and Context}
|
||||
|
||||
[Provide extensive background on the phenomenon. This section should be comprehensive, including:
|
||||
\begin{itemize}
|
||||
\item Historical context and when the phenomenon was first observed
|
||||
\item Detailed description of what is known about the phenomenon
|
||||
\item Why this phenomenon is scientifically important
|
||||
\item Practical or clinical implications if applicable
|
||||
\item Current debates or controversies in the field
|
||||
\end{itemize}
|
||||
|
||||
Include extensive citations throughout. Aim for 10-15 citations in this subsection alone.]
|
||||
|
||||
\subsection*{A.2 Current Understanding and Established Mechanisms}
|
||||
|
||||
[Synthesize what is currently understood about this phenomenon:
|
||||
\begin{itemize}
|
||||
\item Established theories or frameworks that may apply
|
||||
\item Known mechanisms from related systems or analogous phenomena
|
||||
\item Molecular, cellular, or systemic processes that are well-characterized
|
||||
\item Population-level patterns that have been documented
|
||||
\item Computational or theoretical models that have been proposed
|
||||
\end{itemize}
|
||||
|
||||
Include 15-20 citations covering recent reviews, primary research papers, and foundational studies.]
|
||||
|
||||
\subsection*{A.3 Evidence Supporting Hypothesis 1}
|
||||
|
||||
[Provide detailed discussion of all evidence supporting Hypothesis 1. This goes beyond the brief bullet points in the main text:
|
||||
\begin{itemize}
|
||||
\item Detailed findings from key papers
|
||||
\item Mechanistic studies showing relevant pathways
|
||||
\item Data from analogous systems
|
||||
\item Theoretical support
|
||||
\item Any preliminary or indirect evidence
|
||||
\end{itemize}
|
||||
|
||||
Include 8-12 citations specific to this hypothesis.]
|
||||
|
||||
\subsection*{A.4 Evidence Supporting Hypothesis 2}
|
||||
|
||||
[Same structure as A.3, focused on Hypothesis 2. Include 8-12 citations.]
|
||||
|
||||
\subsection*{A.5 Evidence Supporting Hypothesis 3}
|
||||
|
||||
[Same structure as A.3, focused on Hypothesis 3. Include 8-12 citations.]
|
||||
|
||||
% Add A.6, A.7 for Hypotheses 4 and 5 if applicable
|
||||
|
||||
\subsection*{A.6 Conflicting Findings and Unresolved Debates}
|
||||
|
||||
[Discuss contradictions in the literature:
|
||||
\begin{itemize}
|
||||
\item Studies with conflicting results
|
||||
\item Ongoing debates about mechanisms
|
||||
\item Alternative interpretations of existing data
|
||||
\item Methodological issues that complicate interpretation
|
||||
\item Areas where consensus has not been reached
|
||||
\end{itemize}
|
||||
|
||||
Include 5-10 citations highlighting key controversies.]
|
||||
|
||||
\subsection*{A.7 Knowledge Gaps and Limitations}
|
||||
|
||||
[Identify what is still unknown:
|
||||
\begin{itemize}
|
||||
\item Aspects of the phenomenon that lack clear explanation
|
||||
\item Missing data or unstudied conditions
|
||||
\item Limitations of current methods or approaches
|
||||
\item Questions that remain unanswered
|
||||
\item Assumptions that have not been tested
|
||||
\end{itemize}
|
||||
|
||||
Include 3-5 citations discussing limitations or identifying gaps.]
|
||||
|
||||
% ============================================================================
|
||||
% APPENDIX B: DETAILED EXPERIMENTAL DESIGNS
|
||||
% ============================================================================
|
||||
\newpage
|
||||
\appendixsection{Appendix B: Detailed Experimental Designs}
|
||||
|
||||
This appendix provides comprehensive experimental protocols for testing each hypothesis, including methods, controls, sample sizes, statistical approaches, and feasibility assessments.
|
||||
|
||||
\subsection*{B.1 Experiments for Testing Hypothesis 1}
|
||||
|
||||
\subsubsection*{Experiment 1A: [Descriptive Title]}
|
||||
|
||||
\textbf{Design Type:} [e.g., In vitro dose-response / In vivo knockout / Clinical RCT / Observational cohort / Computational model]
|
||||
|
||||
\textbf{Objective:} [What specific aspect of Hypothesis 1 does this experiment test? What question does it answer?]
|
||||
|
||||
\textbf{Detailed Methods:}
|
||||
\begin{itemize}
|
||||
\item \textbf{System/Model:} [What system, organism, cell type, or population will be studied? Include species, strains, patient populations, etc.]
|
||||
\item \textbf{Intervention/Manipulation:} [What will be varied or manipulated? Include specific treatments, genetic modifications, interventions, etc.]
|
||||
\item \textbf{Measurements:} [What outcomes will be measured? Include primary and secondary endpoints, measurement techniques, timing of measurements]
|
||||
\item \textbf{Controls:} [What control conditions will be included? Negative controls, positive controls, vehicle controls, sham procedures, etc.]
|
||||
\item \textbf{Sample Size:} [Estimated n per group with power analysis justification if possible. Include assumptions about effect size and variability.]
|
||||
\item \textbf{Randomization \& Blinding:} [How will subjects be randomized? Who will be blinded?]
|
||||
\item \textbf{Statistical Analysis:} [Specific statistical tests planned, correction for multiple comparisons, significance thresholds]
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Expected Timeline:} [Rough estimate of duration from start to completion]
|
||||
|
||||
\textbf{Resource Requirements:}
|
||||
\begin{itemize}
|
||||
\item \textbf{Equipment:} [Specialized equipment needed]
|
||||
\item \textbf{Materials:} [Key reagents, animals, human subjects]
|
||||
\item \textbf{Expertise:} [Specialized skills or training required]
|
||||
\item \textbf{Estimated Cost:} [Rough cost estimate if applicable]
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Feasibility Assessment:} [High/Medium/Low with justification. Consider technical challenges, resource availability, ethical considerations]
|
||||
|
||||
\textbf{Potential Confounds and Mitigation:}
|
||||
\begin{itemize}
|
||||
\item [Confound 1 and how to address it]
|
||||
\item [Confound 2 and how to address it]
|
||||
\item [Confound 3 and how to address it]
|
||||
\end{itemize}
|
||||
|
||||
\vspace{0.5cm}
|
||||
|
||||
\subsubsection*{Experiment 1B: [Alternative or Complementary Approach]}
|
||||
|
||||
[Follow same detailed structure as Experiment 1A. This should be an alternative method to test the same aspect of Hypothesis 1, or a complementary experiment that tests a different aspect.]
|
||||
|
||||
\vspace{0.5cm}
|
||||
|
||||
\subsection*{B.2 Experiments for Testing Hypothesis 2}
|
||||
|
||||
\subsubsection*{Experiment 2A: [Descriptive Title]}
|
||||
|
||||
[Follow same detailed structure as above]
|
||||
|
||||
\subsubsection*{Experiment 2B: [Alternative or Complementary Approach]}
|
||||
|
||||
[Follow same detailed structure as above]
|
||||
|
||||
\vspace{0.5cm}
|
||||
|
||||
\subsection*{B.3 Experiments for Testing Hypothesis 3}
|
||||
|
||||
[Continue with same structure for all hypotheses]
|
||||
|
||||
\vspace{0.5cm}
|
||||
|
||||
\subsection*{B.4 Discriminating Experiments}
|
||||
|
||||
[Provide detailed protocols for the priority experiments identified in Section 4 that distinguish between hypotheses]
|
||||
|
||||
% ============================================================================
|
||||
% APPENDIX C: QUALITY ASSESSMENT
|
||||
% ============================================================================
|
||||
\newpage
|
||||
\appendixsection{Appendix C: Quality Assessment}
|
||||
|
||||
This appendix provides detailed evaluation of each hypothesis against established quality criteria.
|
||||
|
||||
\subsection*{C.1 Comparative Quality Assessment}
|
||||
|
||||
\begin{hypotable}{Hypothesis Quality Criteria Evaluation}
|
||||
\begin{tabular}{|p{2.5cm}|p{3cm}|p{3cm}|p{3cm}|}
|
||||
\hline
|
||||
\tableheadercolor
|
||||
\textcolor{white}{\textbf{Criterion}} & \textcolor{white}{\textbf{Hypothesis 1}} & \textcolor{white}{\textbf{Hypothesis 2}} & \textcolor{white}{\textbf{Hypothesis 3}} \\
|
||||
\hline
|
||||
\textbf{Testability} & [Strong/Moderate/Weak] [Brief note: why?] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\tablerowcolor
|
||||
\textbf{Falsifiability} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\textbf{Parsimony} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\tablerowcolor
|
||||
\textbf{Explanatory Power} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\textbf{Scope} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\tablerowcolor
|
||||
\textbf{Consistency} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\textbf{Novelty} & [Rating \& note] & [Rating \& note] & [Rating \& note] \\
|
||||
\hline
|
||||
\end{tabular}
|
||||
\caption{Comparative assessment of hypotheses across quality criteria. Strong = meets criterion very well; Moderate = partially meets criterion; Weak = does not meet criterion well.}
|
||||
\end{hypotable}
|
||||
|
||||
\subsection*{C.2 Detailed Evaluation: Hypothesis 1}
|
||||
|
||||
\textbf{Strengths:}
|
||||
\begin{enumerate}
|
||||
\item [Specific strength 1 with explanation of why this is advantageous]
|
||||
\item [Specific strength 2]
|
||||
\item [Specific strength 3]
|
||||
\item [Additional strengths as applicable]
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Weaknesses:}
|
||||
\begin{enumerate}
|
||||
\item [Specific weakness 1 with explanation of the limitation]
|
||||
\item [Specific weakness 2]
|
||||
\item [Specific weakness 3]
|
||||
\item [Additional weaknesses as applicable]
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Overall Assessment:}
|
||||
|
||||
[Provide a comprehensive 1-2 paragraph assessment of Hypothesis 1's quality and viability. Consider:
|
||||
\begin{itemize}
|
||||
\item How well does it balance the various quality criteria?
|
||||
\item What are the key trade-offs?
|
||||
\item Under what conditions would this be the most promising hypothesis?
|
||||
\item What are the major challenges to testing or validating it?
|
||||
\item How does it compare overall to competing hypotheses?
|
||||
\end{itemize}]
|
||||
|
||||
\subsection*{C.3 Detailed Evaluation: Hypothesis 2}
|
||||
|
||||
[Follow same structure as C.2]
|
||||
|
||||
\subsection*{C.4 Detailed Evaluation: Hypothesis 3}
|
||||
|
||||
[Follow same structure as C.2]
|
||||
|
||||
% Add C.5, C.6 for Hypotheses 4 and 5 if applicable
|
||||
|
||||
\subsection*{C.5 Recommendations Based on Quality Assessment}
|
||||
|
||||
[Synthesize the quality assessments to provide recommendations:
|
||||
\begin{itemize}
|
||||
\item Which hypothesis appears most promising overall?
|
||||
\item Which hypothesis should be tested first? Why?
|
||||
\item Are there scenarios where different hypotheses would be preferred?
|
||||
\item Could multiple hypotheses be partially correct?
|
||||
\item What would need to be true for each hypothesis to be viable?
|
||||
\end{itemize}]
|
||||
|
||||
% ============================================================================
|
||||
% APPENDIX D: SUPPLEMENTARY EVIDENCE
|
||||
% ============================================================================
|
||||
\newpage
|
||||
\appendixsection{Appendix D: Supplementary Evidence}
|
||||
|
||||
This appendix provides additional supporting information, including analogous mechanisms, relevant data, and context that further informs the hypotheses.
|
||||
|
||||
\subsection*{D.1 Analogous Mechanisms in Related Systems}
|
||||
|
||||
[Discuss similar mechanisms or phenomena in related systems that provide insight:
|
||||
\begin{itemize}
|
||||
\item How do analogous systems behave?
|
||||
\item What mechanisms operate in those systems?
|
||||
\item How might lessons from related systems apply here?
|
||||
\item What similarities and differences exist?
|
||||
\end{itemize}
|
||||
|
||||
Include citations to relevant comparative studies.]
|
||||
|
||||
\subsection*{D.2 Preliminary Data or Observations}
|
||||
|
||||
[If applicable, discuss any preliminary data, pilot studies, or anecdotal observations that informed hypothesis generation but weren't formally published or well-documented.]
|
||||
|
||||
\subsection*{D.3 Theoretical Frameworks}
|
||||
|
||||
[Discuss broader theoretical frameworks that relate to the hypotheses:
|
||||
\begin{itemize}
|
||||
\item What general principles or theories apply?
|
||||
\item How do the hypotheses fit within established frameworks?
|
||||
\item Are there mathematical or computational models that support any hypothesis?
|
||||
\end{itemize}]
|
||||
|
||||
\subsection*{D.4 Historical Context and Evolution of Ideas}
|
||||
|
||||
[Provide historical perspective on how thinking about this phenomenon has evolved, what previous hypotheses have been proposed and tested, and what lessons have been learned from past attempts to explain the phenomenon.]
|
||||
|
||||
% ============================================================================
|
||||
% REFERENCES
|
||||
% ============================================================================
|
||||
\newpage
|
||||
\bibliographystyle{plainnat}
|
||||
\bibliography{references}
|
||||
|
||||
% Alternatively, manually format references if not using BibTeX:
|
||||
% \begin{thebibliography}{99}
|
||||
%
|
||||
% \bibitem{author2023}
|
||||
% Author1, A.B., \& Author2, C.D. (2023).
|
||||
% Title of paper.
|
||||
% \textit{Journal Name}, \textit{Volume}(Issue), pages.
|
||||
% DOI or URL
|
||||
%
|
||||
% \bibitem{author2022}
|
||||
% [Continue with all references...]
|
||||
%
|
||||
% [Target: 50+ references covering all citations in main text and appendices]
|
||||
%
|
||||
% \end{thebibliography}
|
||||
|
||||
\end{document}
|
||||
|
||||
@@ -0,0 +1,329 @@
|
||||
# Experimental Design Patterns
|
||||
|
||||
## Common Approaches to Testing Scientific Hypotheses
|
||||
|
||||
This reference provides patterns and frameworks for designing experiments across scientific domains. Use these patterns to develop rigorous tests for generated hypotheses.
|
||||
|
||||
**Note on Report Structure:** When generating hypothesis reports, mention only the key experimental approach (e.g., "in vivo knockout study" or "prospective cohort design") in the main text hypothesis boxes. Include comprehensive experimental protocols with full methods, controls, sample sizes, statistical approaches, feasibility assessments, and resource requirements in **Appendix B: Detailed Experimental Designs**.
|
||||
|
||||
## Design Selection Framework
|
||||
|
||||
Choose experimental approaches based on:
|
||||
- **Nature of hypothesis:** Mechanistic, causal, correlational, descriptive
|
||||
- **System studied:** In vitro, in vivo, computational, observational
|
||||
- **Feasibility:** Time, cost, ethics, technical capabilities
|
||||
- **Evidence needed:** Proof-of-concept, causal demonstration, quantitative relationship
|
||||
|
||||
## Laboratory Experimental Designs
|
||||
|
||||
### In Vitro Experiments
|
||||
|
||||
**When to use:** Testing molecular, cellular, or biochemical mechanisms in controlled systems.
|
||||
|
||||
**Common patterns:**
|
||||
|
||||
#### 1. Dose-Response Studies
|
||||
- **Purpose:** Establish quantitative relationship between input and effect
|
||||
- **Design:** Test multiple concentrations/doses of intervention
|
||||
- **Key elements:**
|
||||
- Negative control (no treatment)
|
||||
- Positive control (known effective treatment)
|
||||
- Multiple dose levels (typically 5-8 points)
|
||||
- Technical replicates (≥3 per condition)
|
||||
- Appropriate statistical analysis (curve fitting, IC50/EC50 determination)
|
||||
|
||||
**Example application:**
|
||||
"To test if compound X inhibits enzyme Y, measure enzyme activity at 0, 1, 10, 100, 1000 nM compound X concentrations with n=3 replicates per dose."
|
||||
|
||||
#### 2. Gain/Loss of Function Studies
|
||||
- **Purpose:** Establish causal role of specific component
|
||||
- **Design:** Add (overexpression) or remove (knockout/knockdown) component
|
||||
- **Key elements:**
|
||||
- Wild-type control
|
||||
- Gain-of-function condition (overexpression, constitutive activation)
|
||||
- Loss-of-function condition (knockout, knockdown, inhibition)
|
||||
- Rescue experiment (restore function to loss-of-function)
|
||||
- Measure downstream effects
|
||||
|
||||
**Example application:**
|
||||
"Test if protein X causes phenotype Y by: (1) knocking out X and observing phenotype loss, (2) overexpressing X and observing phenotype enhancement, (3) rescuing knockout with X re-expression."
|
||||
|
||||
#### 3. Time-Course Studies
|
||||
- **Purpose:** Understand temporal dynamics and sequence of events
|
||||
- **Design:** Measure outcomes at multiple time points
|
||||
- **Key elements:**
|
||||
- Time 0 baseline
|
||||
- Early time points (capture rapid changes)
|
||||
- Intermediate time points
|
||||
- Late time points (steady state)
|
||||
- Sufficient replication at each time point
|
||||
|
||||
**Example application:**
|
||||
"Measure protein phosphorylation at 0, 5, 15, 30, 60, 120 minutes after stimulus to determine peak activation timing."
|
||||
|
||||
### In Vivo Experiments
|
||||
|
||||
**When to use:** Testing hypotheses in whole organisms to assess systemic, physiological, or behavioral effects.
|
||||
|
||||
**Common patterns:**
|
||||
|
||||
#### 4. Between-Subjects Designs
|
||||
- **Purpose:** Compare different groups receiving different treatments
|
||||
- **Design:** Randomly assign subjects to treatment groups
|
||||
- **Key elements:**
|
||||
- Random assignment to groups
|
||||
- Appropriate sample size (power analysis)
|
||||
- Control group (vehicle, sham, or standard treatment)
|
||||
- Blinding (single or double-blind)
|
||||
- Standardized conditions across groups
|
||||
|
||||
**Example application:**
|
||||
"Randomly assign 20 mice each to vehicle control or drug treatment groups, measure tumor size weekly for 8 weeks, with experimenters blinded to group assignment."
|
||||
|
||||
#### 5. Within-Subjects (Repeated Measures) Designs
|
||||
- **Purpose:** Each subject serves as own control, reducing inter-subject variability
|
||||
- **Design:** Same subjects measured across multiple conditions/time points
|
||||
- **Key elements:**
|
||||
- Baseline measurements
|
||||
- Counterbalancing (if order effects possible)
|
||||
- Washout periods (for sequential treatments)
|
||||
- Appropriate repeated-measures statistics
|
||||
|
||||
**Example application:**
|
||||
"Measure cognitive performance in same participants at baseline, after training intervention, and at 3-month follow-up."
|
||||
|
||||
#### 6. Factorial Designs
|
||||
- **Purpose:** Test multiple factors and their interactions simultaneously
|
||||
- **Design:** Cross all levels of multiple independent variables
|
||||
- **Key elements:**
|
||||
- Clear main effects and interactions
|
||||
- Sufficient power for interaction tests
|
||||
- Full factorial or fractional factorial as appropriate
|
||||
|
||||
**Example application:**
|
||||
"2×2 design crossing genotype (WT vs. mutant) × treatment (vehicle vs. drug) to test whether drug effect depends on genotype."
|
||||
|
||||
### Computational/Modeling Experiments
|
||||
|
||||
**When to use:** Testing hypotheses about complex systems, making predictions, or when physical experiments are infeasible.
|
||||
|
||||
#### 7. In Silico Simulations
|
||||
- **Purpose:** Model complex systems, test theoretical predictions
|
||||
- **Design:** Implement computational model and vary parameters
|
||||
- **Key elements:**
|
||||
- Well-defined model with explicit assumptions
|
||||
- Parameter sensitivity analysis
|
||||
- Validation against known data
|
||||
- Prediction generation for experimental testing
|
||||
|
||||
**Example application:**
|
||||
"Build agent-based model of disease spread, vary transmission rate and intervention timing, compare predictions to empirical epidemic data."
|
||||
|
||||
#### 8. Bioinformatics/Meta-Analysis
|
||||
- **Purpose:** Test hypotheses using existing datasets
|
||||
- **Design:** Analyze large-scale data or aggregate multiple studies
|
||||
- **Key elements:**
|
||||
- Appropriate statistical corrections (multiple testing)
|
||||
- Validation in independent datasets
|
||||
- Control for confounds and batch effects
|
||||
- Clear inclusion/exclusion criteria
|
||||
|
||||
**Example application:**
|
||||
"Test if gene X expression correlates with survival across 15 cancer datasets (n>5000 patients total), using Cox regression with clinical covariates."
|
||||
|
||||
## Observational Study Designs
|
||||
|
||||
### When Physical Manipulation is Impossible or Unethical
|
||||
|
||||
#### 9. Cross-Sectional Studies
|
||||
- **Purpose:** Examine associations at a single time point
|
||||
- **Design:** Measure variables of interest in population at one time
|
||||
- **Strengths:** Fast, inexpensive, can establish prevalence
|
||||
- **Limitations:** Cannot establish temporality or causation
|
||||
- **Key elements:**
|
||||
- Representative sampling
|
||||
- Standardized measurements
|
||||
- Control for confounding variables
|
||||
- Appropriate statistical analysis
|
||||
|
||||
**Example application:**
|
||||
"Survey 1000 adults to test association between diet pattern and biomarker X, controlling for age, sex, BMI, and physical activity."
|
||||
|
||||
#### 10. Cohort Studies (Prospective/Longitudinal)
|
||||
- **Purpose:** Establish temporal relationships and potentially causal associations
|
||||
- **Design:** Follow group over time, measuring exposures and outcomes
|
||||
- **Strengths:** Can establish temporality, calculate incidence
|
||||
- **Limitations:** Time-consuming, expensive, subject attrition
|
||||
- **Key elements:**
|
||||
- Baseline exposure assessment
|
||||
- Follow-up at defined intervals
|
||||
- Minimize loss to follow-up
|
||||
- Account for time-varying confounders
|
||||
|
||||
**Example application:**
|
||||
"Follow 5000 initially healthy individuals for 10 years, testing if baseline vitamin D levels predict cardiovascular disease incidence."
|
||||
|
||||
#### 11. Case-Control Studies
|
||||
- **Purpose:** Efficiently study rare outcomes by comparing cases to controls
|
||||
- **Design:** Identify cases with outcome, select matched controls, compare exposures
|
||||
- **Strengths:** Efficient for rare diseases, relatively quick
|
||||
- **Limitations:** Recall bias, selection bias, cannot calculate incidence
|
||||
- **Key elements:**
|
||||
- Clear case definition
|
||||
- Appropriate control selection (matching or statistical adjustment)
|
||||
- Retrospective exposure assessment
|
||||
- Control for confounding
|
||||
|
||||
**Example application:**
|
||||
"Compare 200 patients with rare disease X to 400 matched controls without X, testing if early-life exposure Y differs between groups."
|
||||
|
||||
## Clinical Trial Designs
|
||||
|
||||
#### 12. Randomized Controlled Trials (RCTs)
|
||||
- **Purpose:** Gold standard for testing interventions in humans
|
||||
- **Design:** Randomly assign participants to treatment or control
|
||||
- **Key elements:**
|
||||
- Randomization (simple, block, or stratified)
|
||||
- Concealment of allocation
|
||||
- Blinding (participants, providers, assessors)
|
||||
- Intention-to-treat analysis
|
||||
- Pre-registered protocol and analysis plan
|
||||
|
||||
**Example application:**
|
||||
"Double-blind RCT: randomly assign 300 patients to receive drug X or placebo for 12 weeks, measure primary outcome of symptom improvement."
|
||||
|
||||
#### 13. Crossover Trials
|
||||
- **Purpose:** Each participant receives all treatments in sequence
|
||||
- **Design:** Participants crossed over between treatments with washout
|
||||
- **Strengths:** Reduces inter-subject variability, requires fewer participants
|
||||
- **Limitations:** Order effects, requires reversible conditions, longer duration
|
||||
- **Key elements:**
|
||||
- Adequate washout period
|
||||
- Randomized treatment order
|
||||
- Carryover effect assessment
|
||||
|
||||
**Example application:**
|
||||
"Crossover trial: participants receive treatment A for 4 weeks, 2-week washout, then treatment B for 4 weeks (randomized order)."
|
||||
|
||||
## Advanced Design Considerations
|
||||
|
||||
### Sample Size and Statistical Power
|
||||
|
||||
**Key questions:**
|
||||
- What effect size is meaningful to detect?
|
||||
- What statistical test will be used?
|
||||
- What alpha (significance level) and beta (power) are appropriate?
|
||||
- What is expected variability in the measurement?
|
||||
|
||||
**General guidelines:**
|
||||
- Conduct formal power analysis before experiment
|
||||
- For pilot studies, n≥10 per group minimum
|
||||
- For definitive studies, aim for ≥80% power
|
||||
- Account for potential attrition in longitudinal studies
|
||||
|
||||
### Controls
|
||||
|
||||
**Types of controls:**
|
||||
- **Negative control:** No intervention (baseline)
|
||||
- **Positive control:** Known effective intervention (validates system)
|
||||
- **Vehicle control:** Delivery method without active ingredient
|
||||
- **Sham control:** Mimics intervention without active component (surgery, etc.)
|
||||
- **Historical control:** Prior data (weakest, avoid if possible)
|
||||
|
||||
### Blinding
|
||||
|
||||
**Levels:**
|
||||
- **Open-label:** No blinding (acceptable for objective measures)
|
||||
- **Single-blind:** Participants blinded (reduces placebo effects)
|
||||
- **Double-blind:** Participants and experimenters blinded (reduces bias in assessment)
|
||||
- **Triple-blind:** Participants, experimenters, and analysts blinded (strongest)
|
||||
|
||||
### Replication
|
||||
|
||||
**Technical replicates:** Repeated measurements on same sample
|
||||
- Reduce measurement error
|
||||
- Typically 2-3 replicates sufficient
|
||||
|
||||
**Biological replicates:** Independent samples/subjects
|
||||
- Address biological variability
|
||||
- Critical for generalization
|
||||
- Minimum: n≥3, preferably n≥5-10 per group
|
||||
|
||||
**Experimental replicates:** Repeat entire experiment
|
||||
- Validate findings across time, equipment, operators
|
||||
- Gold standard for confirming results
|
||||
|
||||
### Confound Control
|
||||
|
||||
**Strategies:**
|
||||
- **Randomization:** Distribute confounds evenly across groups
|
||||
- **Matching:** Pair similar subjects across conditions
|
||||
- **Blocking:** Group by confound, then randomize within blocks
|
||||
- **Statistical adjustment:** Measure confounds and adjust in analysis
|
||||
- **Standardization:** Keep conditions constant across groups
|
||||
|
||||
## Selecting Appropriate Design
|
||||
|
||||
**Decision tree:**
|
||||
|
||||
1. **Can variables be manipulated?**
|
||||
- Yes → Experimental design (RCT, lab experiment)
|
||||
- No → Observational design (cohort, case-control, cross-sectional)
|
||||
|
||||
2. **What is the system?**
|
||||
- Cells/molecules → In vitro experiments
|
||||
- Whole organisms → In vivo experiments
|
||||
- Humans → Clinical trials or observational studies
|
||||
- Complex systems → Computational modeling
|
||||
|
||||
3. **What is the primary goal?**
|
||||
- Mechanism → Gain/loss of function, dose-response
|
||||
- Causation → RCT, cohort study with good controls
|
||||
- Association → Cross-sectional, case-control
|
||||
- Prediction → Modeling, machine learning
|
||||
- Temporal dynamics → Time-course, longitudinal
|
||||
|
||||
4. **What are the constraints?**
|
||||
- Time limited → Cross-sectional, in vitro
|
||||
- Budget limited → Computational, observational
|
||||
- Ethical concerns → Observational, in vitro
|
||||
- Rare outcome → Case-control, meta-analysis
|
||||
|
||||
## Integrating Multiple Approaches
|
||||
|
||||
Strong hypothesis testing often combines multiple designs:
|
||||
|
||||
**Example: Testing if microbiome affects cognitive function**
|
||||
1. **Observational:** Cohort study showing association between microbiome composition and cognition
|
||||
2. **Animal model:** Germ-free mice receiving microbiome transplants show cognitive changes
|
||||
3. **Mechanism:** In vitro studies showing microbial metabolites affect neuronal function
|
||||
4. **Clinical trial:** RCT of probiotic intervention improving cognitive scores
|
||||
5. **Computational:** Model predicting which microbiome profiles should affect cognition
|
||||
|
||||
**Triangulation approach:**
|
||||
- Each design addresses different aspects/limitations
|
||||
- Convergent evidence from multiple approaches strengthens causal claims
|
||||
- Start with observational/in vitro, then move to definitive causal tests
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
- Insufficient sample size (underpowered)
|
||||
- Lack of appropriate controls
|
||||
- Confounding variables not accounted for
|
||||
- Inappropriate statistical tests
|
||||
- P-hacking or multiple testing without correction
|
||||
- Lack of blinding when subjective assessments involved
|
||||
- Failure to replicate findings
|
||||
- Not pre-registering analysis plans (clinical trials)
|
||||
|
||||
## Practical Application for Hypothesis Testing
|
||||
|
||||
When designing experiments to test hypotheses:
|
||||
|
||||
1. **Match design to hypothesis specifics:** Causal claims require experimental manipulation; associations can use observational designs
|
||||
2. **Start simple, then elaborate:** Pilot with simple design, then add complexity
|
||||
3. **Plan controls carefully:** Controls validate the system and isolate the specific effect
|
||||
4. **Consider feasibility:** Balance ideal design with practical constraints
|
||||
5. **Plan for multiple experiments:** Rarely does one experiment definitively test a hypothesis
|
||||
6. **Pre-specify analysis:** Decide statistical tests before data collection
|
||||
7. **Build in validation:** Independent replication, orthogonal methods, convergent evidence
|
||||
@@ -0,0 +1,198 @@
|
||||
# Hypothesis Quality Criteria
|
||||
|
||||
## Framework for Evaluating Scientific Hypotheses
|
||||
|
||||
Use these criteria to assess the quality and rigor of generated hypotheses. A robust hypothesis should score well across multiple dimensions.
|
||||
|
||||
**Note on Report Structure:** When generating hypothesis reports, provide a brief quality assessment summary in the main text (comparative table with ratings), and include detailed evaluation with strengths, weaknesses, and comprehensive analysis in **Appendix C: Quality Assessment**.
|
||||
|
||||
## Core Criteria
|
||||
|
||||
### 1. Testability
|
||||
|
||||
**Definition:** The hypothesis can be empirically tested through observation or experimentation.
|
||||
|
||||
**Evaluation questions:**
|
||||
- Can specific experiments or observations test this hypothesis?
|
||||
- Are the predicted outcomes measurable?
|
||||
- Can the hypothesis be tested with current or near-future methods?
|
||||
- Are there multiple independent ways to test it?
|
||||
|
||||
**Strong testability examples:**
|
||||
- "Increased expression of protein X will reduce cell proliferation rate by >30%"
|
||||
- "Patients receiving treatment Y will show 50% reduction in symptom Z within 4 weeks"
|
||||
|
||||
**Weak testability examples:**
|
||||
- "This process is influenced by complex interactions" (vague, no specific prediction)
|
||||
- "The mechanism involves quantum effects" (if no method to test quantum effects exists)
|
||||
|
||||
### 2. Falsifiability
|
||||
|
||||
**Definition:** Clear conditions or observations would disprove the hypothesis (Popperian criterion).
|
||||
|
||||
**Evaluation questions:**
|
||||
- What specific observations would prove this hypothesis wrong?
|
||||
- Are the falsifying conditions realistic to observe?
|
||||
- Is the hypothesis stated clearly enough to be disproven?
|
||||
- Can null results meaningfully falsify the hypothesis?
|
||||
|
||||
**Strong falsifiability examples:**
|
||||
- "If we knock out gene X, phenotype Y will disappear" (can be falsified if phenotype persists)
|
||||
- "Drug A will outperform placebo in 80% of patients" (clear falsification threshold)
|
||||
|
||||
**Weak falsifiability examples:**
|
||||
- "Multiple factors contribute to the outcome" (too vague to falsify)
|
||||
- "The effect may vary depending on context" (built-in escape clauses)
|
||||
|
||||
### 3. Parsimony (Occam's Razor)
|
||||
|
||||
**Definition:** Among competing hypotheses with equal explanatory power, prefer the simpler explanation.
|
||||
|
||||
**Evaluation questions:**
|
||||
- Does the hypothesis invoke the minimum number of entities/mechanisms needed?
|
||||
- Are all proposed elements necessary to explain the phenomenon?
|
||||
- Could a simpler mechanism account for the observations?
|
||||
- Does it avoid unnecessary assumptions?
|
||||
|
||||
**Parsimony considerations:**
|
||||
- Simple ≠ simplistic; complexity is justified when evidence demands it
|
||||
- Established mechanisms are "simpler" than novel, unproven ones
|
||||
- Direct mechanisms are simpler than elaborate multi-step pathways
|
||||
- One well-supported mechanism beats multiple speculative ones
|
||||
|
||||
### 4. Explanatory Power
|
||||
|
||||
**Definition:** The hypothesis accounts for a substantial portion of the observed phenomenon.
|
||||
|
||||
**Evaluation questions:**
|
||||
- How much of the observed data does this hypothesis explain?
|
||||
- Does it account for both typical and atypical observations?
|
||||
- Can it explain related phenomena beyond the immediate observation?
|
||||
- Does it resolve apparent contradictions in existing data?
|
||||
|
||||
**Strong explanatory power indicators:**
|
||||
- Explains multiple independent observations
|
||||
- Accounts for quantitative relationships, not just qualitative patterns
|
||||
- Resolves previously puzzling findings
|
||||
- Makes sense of seemingly contradictory results
|
||||
|
||||
**Limited explanatory power indicators:**
|
||||
- Only explains part of the phenomenon
|
||||
- Requires additional hypotheses for complete explanation
|
||||
- Leaves major observations unexplained
|
||||
|
||||
### 5. Scope
|
||||
|
||||
**Definition:** The range of phenomena and contexts the hypothesis can address.
|
||||
|
||||
**Evaluation questions:**
|
||||
- Does it apply only to the specific case or to broader situations?
|
||||
- Can it generalize across conditions, species, or systems?
|
||||
- Does it connect to larger theoretical frameworks?
|
||||
- What are its boundaries and limitations?
|
||||
|
||||
**Broader scope (generally preferable):**
|
||||
- Applies across multiple experimental conditions
|
||||
- Generalizes to related systems or species
|
||||
- Connects phenomenon to established principles
|
||||
|
||||
**Narrower scope (acceptable if explicitly defined):**
|
||||
- Limited to specific conditions or contexts
|
||||
- Requires different mechanisms in different settings
|
||||
- Context-dependent with clear boundaries
|
||||
|
||||
### 6. Consistency with Established Knowledge
|
||||
|
||||
**Definition:** Alignment with well-supported theories, principles, and empirical findings.
|
||||
|
||||
**Evaluation questions:**
|
||||
- Is it consistent with established physical, chemical, or biological principles?
|
||||
- Does it align with or reasonably extend current theories?
|
||||
- If contradicting established knowledge, is there strong justification?
|
||||
- Does it require violating well-supported laws or findings?
|
||||
|
||||
**Levels of consistency:**
|
||||
- **Fully consistent:** Applies established mechanisms in new context
|
||||
- **Mostly consistent:** Extends current understanding in plausible ways
|
||||
- **Partially inconsistent:** Contradicts some findings but has explanatory value
|
||||
- **Highly inconsistent:** Requires rejecting well-established principles (requires exceptional evidence)
|
||||
|
||||
### 7. Novelty and Insight
|
||||
|
||||
**Definition:** The hypothesis offers new understanding beyond merely restating known facts.
|
||||
|
||||
**Evaluation questions:**
|
||||
- Does it provide new mechanistic insight?
|
||||
- Does it challenge assumptions or conventional wisdom?
|
||||
- Does it suggest unexpected connections or relationships?
|
||||
- Does it open new research directions?
|
||||
|
||||
**Novel contributions:**
|
||||
- Proposes previously unconsidered mechanisms
|
||||
- Reframes the problem in a productive way
|
||||
- Connects disparate observations
|
||||
- Suggests non-obvious testable predictions
|
||||
|
||||
**Note:** Novelty alone doesn't make a hypothesis valuable; it must also be testable, parsimonious, and explanatory.
|
||||
|
||||
## Comparative Evaluation
|
||||
|
||||
When evaluating multiple competing hypotheses:
|
||||
|
||||
### Trade-offs and Balancing
|
||||
|
||||
Hypotheses often involve trade-offs:
|
||||
- More parsimonious but less explanatory power
|
||||
- Broader scope but less testable with current methods
|
||||
- Novel insights but less consistent with current knowledge
|
||||
|
||||
**Evaluation approach:**
|
||||
- No hypothesis needs to be perfect on all dimensions
|
||||
- Identify each hypothesis's strengths and weaknesses
|
||||
- Consider which criteria are most important for the specific phenomenon
|
||||
- Note which hypotheses are most immediately testable
|
||||
- Identify which would be most informative if supported
|
||||
|
||||
### Distinguishability
|
||||
|
||||
**Key question:** Can experiments distinguish between competing hypotheses?
|
||||
|
||||
- Identify predictions that differ between hypotheses
|
||||
- Prioritize hypotheses that make distinct predictions
|
||||
- Note which experiments would most efficiently narrow the field
|
||||
- Consider whether hypotheses could all be partially correct
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
### Untestable Hypotheses
|
||||
- Too vague to generate specific predictions
|
||||
- Invoke unobservable or unmeasurable entities
|
||||
- Require technology that doesn't exist
|
||||
|
||||
### Unfalsifiable Hypotheses
|
||||
- Built-in escape clauses ("may or may not occur")
|
||||
- Post-hoc explanations that fit any outcome
|
||||
- No specification of what would disprove them
|
||||
|
||||
### Overly Complex Hypotheses
|
||||
- Invoke multiple unproven mechanisms
|
||||
- Add unnecessary steps or entities
|
||||
- Complexity not justified by explanatory gains
|
||||
|
||||
### Just-So Stories
|
||||
- Plausible narratives without testable predictions
|
||||
- Explain observations but don't predict new ones
|
||||
- Impossible to distinguish from alternative stories
|
||||
|
||||
## Practical Application
|
||||
|
||||
When generating hypotheses:
|
||||
|
||||
1. **Draft initial hypotheses** focusing on mechanistic explanations
|
||||
2. **Apply quality criteria** to identify weaknesses
|
||||
3. **Refine hypotheses** to improve testability and clarity
|
||||
4. **Develop specific predictions** to enhance testability and falsifiability
|
||||
5. **Compare systematically** across all criteria
|
||||
6. **Prioritize for testing** based on distinguishability and feasibility
|
||||
|
||||
Remember: The goal is not a perfect hypothesis, but a set of testable, falsifiable, informative hypotheses that advance understanding of the phenomenon.
|
||||
@@ -0,0 +1,535 @@
|
||||
# Literature Search Strategies
|
||||
|
||||
## Effective Techniques for Finding Scientific Evidence
|
||||
|
||||
Comprehensive literature search is essential for grounding hypotheses in existing evidence. This reference provides strategies for both PubMed (biomedical literature) and general scientific search.
|
||||
|
||||
## Search Strategy Framework
|
||||
|
||||
### Three-Phase Approach
|
||||
|
||||
1. **Broad exploration:** Understand the landscape and identify key concepts
|
||||
2. **Focused searching:** Target specific mechanisms, theories, or findings
|
||||
3. **Citation mining:** Follow references and related articles from key papers
|
||||
|
||||
### Before You Search
|
||||
|
||||
**Clarify search goals:**
|
||||
- What aspects of the phenomenon need evidence?
|
||||
- What types of studies are most relevant (reviews, primary research, methods)?
|
||||
- What time frame is relevant (recent only, or historical context)?
|
||||
- What level of evidence is needed (mechanistic, correlational, causal)?
|
||||
|
||||
## PubMed Search Strategies
|
||||
|
||||
### When to Use PubMed
|
||||
|
||||
Use WebFetch with PubMed URLs for:
|
||||
- Biomedical and life sciences research
|
||||
- Clinical studies and medical literature
|
||||
- Molecular, cellular, and physiological mechanisms
|
||||
- Disease etiology and pathology
|
||||
- Drug and therapeutic research
|
||||
|
||||
### Effective PubMed Search Techniques
|
||||
|
||||
#### 1. Start with Review Articles
|
||||
|
||||
**Why:** Reviews synthesize literature, identify key concepts, and provide comprehensive reference lists.
|
||||
|
||||
**Search strategy:**
|
||||
- Add "review" to search terms
|
||||
- Use PubMed filters: Article Type → Review, Systematic Review, Meta-Analysis
|
||||
- Look for recent reviews (last 2-5 years)
|
||||
|
||||
**Example searches:**
|
||||
- `https://pubmed.ncbi.nlm.nih.gov/?term=wound+healing+diabetes+review`
|
||||
- `https://pubmed.ncbi.nlm.nih.gov/?term=gut+microbiome+cognition+systematic+review`
|
||||
|
||||
#### 2. Use MeSH Terms (Medical Subject Headings)
|
||||
|
||||
**Why:** MeSH terms are standardized vocabulary that captures concept variations.
|
||||
|
||||
**Strategy:**
|
||||
- PubMed auto-suggests MeSH terms
|
||||
- Helps find papers using different terminology for same concept
|
||||
- More comprehensive than keyword-only searches
|
||||
|
||||
**Example:**
|
||||
- Instead of just "heart attack," use MeSH term "Myocardial Infarction"
|
||||
- Captures papers using "MI," "heart attack," "cardiac infarction," etc.
|
||||
|
||||
#### 3. Boolean Operators and Advanced Syntax
|
||||
|
||||
**AND:** Narrow search (all terms must be present)
|
||||
- `diabetes AND wound healing AND inflammation`
|
||||
|
||||
**OR:** Broaden search (any term can be present)
|
||||
- `(Alzheimer OR dementia) AND gut microbiome`
|
||||
|
||||
**NOT:** Exclude terms
|
||||
- `cancer treatment NOT surgery`
|
||||
|
||||
**Quotes:** Exact phrases
|
||||
- `"oxidative stress"`
|
||||
|
||||
**Wildcards:** Variations
|
||||
- `gene*` finds gene, genes, genetic, genetics
|
||||
|
||||
#### 4. Filter by Publication Type and Date
|
||||
|
||||
**Publication types:**
|
||||
- Clinical Trial
|
||||
- Meta-Analysis
|
||||
- Systematic Review
|
||||
- Research Support, NIH
|
||||
- Randomized Controlled Trial
|
||||
|
||||
**Date filters:**
|
||||
- Recent work (last 2-5 years): Cutting-edge findings
|
||||
- Historical work: Foundational studies
|
||||
- Specific time periods: Track development of understanding
|
||||
|
||||
#### 5. Use "Similar Articles" and "Cited By"
|
||||
|
||||
**Strategy:**
|
||||
- Find one highly relevant paper
|
||||
- Click "Similar articles" for related work
|
||||
- Use cited by tools to find newer work building on it
|
||||
|
||||
### PubMed Search Examples by Hypothesis Goal
|
||||
|
||||
**Mechanistic understanding:**
|
||||
```
|
||||
https://pubmed.ncbi.nlm.nih.gov/?term=(mechanism+OR+pathway)+AND+[phenomenon]+AND+(molecular+OR+cellular)
|
||||
```
|
||||
|
||||
**Causal relationships:**
|
||||
```
|
||||
https://pubmed.ncbi.nlm.nih.gov/?term=[exposure]+AND+[outcome]+AND+(randomized+controlled+trial+OR+cohort+study)
|
||||
```
|
||||
|
||||
**Biomarkers and associations:**
|
||||
```
|
||||
https://pubmed.ncbi.nlm.nih.gov/?term=[biomarker]+AND+[disease]+AND+(association+OR+correlation+OR+prediction)
|
||||
```
|
||||
|
||||
**Treatment effectiveness:**
|
||||
```
|
||||
https://pubmed.ncbi.nlm.nih.gov/?term=[intervention]+AND+[condition]+AND+(efficacy+OR+effectiveness+OR+clinical+trial)
|
||||
```
|
||||
|
||||
## General Scientific Web Search Strategies
|
||||
|
||||
### When to Use Web Search
|
||||
|
||||
Use WebSearch for:
|
||||
- Non-biomedical sciences (physics, chemistry, materials, earth sciences)
|
||||
- Interdisciplinary topics
|
||||
- Recent preprints and unpublished work
|
||||
- Grey literature (technical reports, conference proceedings)
|
||||
- Broader context and cross-domain analogies
|
||||
|
||||
### Effective Web Search Techniques
|
||||
|
||||
#### 1. Use Domain-Specific Search Terms
|
||||
|
||||
**Include field-specific terminology:**
|
||||
- Chemistry: "mechanism," "reaction pathway," "synthesis"
|
||||
- Physics: "model," "theory," "experimental validation"
|
||||
- Materials science: "properties," "characterization," "synthesis"
|
||||
- Ecology: "population dynamics," "community structure"
|
||||
|
||||
#### 2. Target Academic Sources
|
||||
|
||||
**Search operators:**
|
||||
- `site:arxiv.org` - Preprints (physics, CS, math, quantitative biology)
|
||||
- `site:biorxiv.org` - Biology preprints
|
||||
- `site:edu` - Academic institutions
|
||||
- `filetype:pdf` - Academic papers (often)
|
||||
|
||||
**Example searches:**
|
||||
- `superconductivity high temperature mechanism site:arxiv.org`
|
||||
- `CRISPR off-target effects site:biorxiv.org`
|
||||
|
||||
#### 3. Search for Authors and Labs
|
||||
|
||||
**When you find a relevant paper:**
|
||||
- Search for the authors' other work
|
||||
- Find their lab website for unpublished work
|
||||
- Identify key research groups in the field
|
||||
|
||||
#### 4. Use Google Scholar Approaches
|
||||
|
||||
**Strategies:**
|
||||
- Use "Cited by" to find newer related work
|
||||
- Use "Related articles" to expand search
|
||||
- Set date ranges to focus on recent work
|
||||
- Use author: operator to find specific researchers
|
||||
|
||||
#### 5. Combine General and Specific Terms
|
||||
|
||||
**Structure:**
|
||||
- Specific phenomenon + general concept
|
||||
- "tomato plant growth" + "bacterial promotion"
|
||||
- "cognitive decline" + "gut microbiome"
|
||||
|
||||
**Boolean logic:**
|
||||
- Use quotes for exact phrases: `"spike protein mutation"`
|
||||
- Use OR for alternatives: `(transmissibility OR transmission rate)`
|
||||
- Combine: `"spike protein" AND (transmissibility OR virulence) AND mutation`
|
||||
|
||||
## Cross-Database Search Strategies
|
||||
|
||||
### Comprehensive Literature Search Workflow
|
||||
|
||||
1. **Start with reviews (PubMed or Web Search):**
|
||||
- Identify key concepts and terminology
|
||||
- Note influential papers and researchers
|
||||
- Understand current state of field
|
||||
|
||||
2. **Focused primary research (PubMed):**
|
||||
- Search for specific mechanisms
|
||||
- Find experimental evidence
|
||||
- Identify methodologies
|
||||
|
||||
3. **Broaden with web search:**
|
||||
- Find related work in other fields
|
||||
- Locate recent preprints
|
||||
- Identify analogous systems
|
||||
|
||||
4. **Citation mining:**
|
||||
- Follow references from key papers
|
||||
- Use "cited by" to find recent work
|
||||
- Track influential studies
|
||||
|
||||
5. **Iterative refinement:**
|
||||
- Add new terms discovered in papers
|
||||
- Narrow if too many results
|
||||
- Broaden if too few relevant results
|
||||
|
||||
## Topic-Specific Search Strategies
|
||||
|
||||
### Mechanisms and Pathways
|
||||
|
||||
**Goal:** Understand how something works
|
||||
|
||||
**Search components:**
|
||||
- Phenomenon + "mechanism"
|
||||
- Phenomenon + "pathway"
|
||||
- Phenomenon + specific molecules/pathways suspected
|
||||
|
||||
**Examples:**
|
||||
- `diabetic wound healing mechanism inflammation`
|
||||
- `autophagy pathway cancer`
|
||||
|
||||
### Associations and Correlations
|
||||
|
||||
**Goal:** Find what factors are related
|
||||
|
||||
**Search components:**
|
||||
- Variable A + Variable B + "association"
|
||||
- Variable A + Variable B + "correlation"
|
||||
- Variable A + "predicts" + Variable B
|
||||
|
||||
**Examples:**
|
||||
- `vitamin D cardiovascular disease association`
|
||||
- `gut microbiome diversity predicts cognitive function`
|
||||
|
||||
### Interventions and Treatments
|
||||
|
||||
**Goal:** Evidence for what works
|
||||
|
||||
**Search components:**
|
||||
- Intervention + condition + "efficacy"
|
||||
- Intervention + condition + "randomized controlled trial"
|
||||
- Intervention + condition + "treatment outcome"
|
||||
|
||||
**Examples:**
|
||||
- `probiotic intervention depression randomized controlled trial`
|
||||
- `exercise intervention cognitive decline efficacy`
|
||||
|
||||
### Methods and Techniques
|
||||
|
||||
**Goal:** How to test hypothesis
|
||||
|
||||
**Search components:**
|
||||
- Method name + application area
|
||||
- "How to measure" + phenomenon
|
||||
- Technique + validation
|
||||
|
||||
**Examples:**
|
||||
- `CRISPR screen cancer drug resistance`
|
||||
- `measure protein-protein interaction methods`
|
||||
|
||||
### Analogous Systems
|
||||
|
||||
**Goal:** Find insights from related phenomena
|
||||
|
||||
**Search components:**
|
||||
- Mechanism + different system
|
||||
- Similar phenomenon + different organism/condition
|
||||
|
||||
**Examples:**
|
||||
- If studying plant-microbe symbiosis: search `nitrogen fixation rhizobia legumes`
|
||||
- If studying drug resistance: search `antibiotic resistance evolution mechanisms`
|
||||
|
||||
## Evaluating Source Quality
|
||||
|
||||
### Primary Research Quality Indicators
|
||||
|
||||
**Strong quality signals:**
|
||||
- Published in reputable journals
|
||||
- Large sample sizes (for statistical power)
|
||||
- Pre-registered studies (reduces bias)
|
||||
- Appropriate controls and methods
|
||||
- Consistent with other findings
|
||||
- Transparent data and methods
|
||||
|
||||
**Red flags:**
|
||||
- No peer review (use cautiously)
|
||||
- Conflicts of interest not disclosed
|
||||
- Methods not clearly described
|
||||
- Extraordinary claims without extraordinary evidence
|
||||
- Contradicts large body of evidence without explanation
|
||||
|
||||
### Review Quality Indicators
|
||||
|
||||
**Systematic reviews (highest quality):**
|
||||
- Pre-defined search strategy
|
||||
- Explicit inclusion/exclusion criteria
|
||||
- Quality assessment of included studies
|
||||
- Quantitative synthesis (meta-analysis)
|
||||
|
||||
**Narrative reviews (variable quality):**
|
||||
- Expert synthesis of field
|
||||
- May have selection bias
|
||||
- Useful for context and framing
|
||||
- Check author expertise and citations
|
||||
|
||||
## Time Management in Literature Search
|
||||
|
||||
### Allocate Search Time Appropriately
|
||||
|
||||
**For straightforward hypotheses (30-60 min):**
|
||||
- 1-2 broad review articles
|
||||
- 3-5 targeted primary research papers
|
||||
- Quick web search for recent developments
|
||||
|
||||
**For complex hypotheses (1-3 hours):**
|
||||
- Multiple reviews for different aspects
|
||||
- 10-15 primary research papers
|
||||
- Systematic search across databases
|
||||
- Citation mining from key papers
|
||||
|
||||
**For contentious topics (3+ hours):**
|
||||
- Systematic review approach
|
||||
- Identify competing perspectives
|
||||
- Track historical development
|
||||
- Cross-reference findings
|
||||
|
||||
### Diminishing Returns
|
||||
|
||||
**Signs you've searched enough:**
|
||||
- Finding the same papers repeatedly
|
||||
- New searches yield mostly irrelevant papers
|
||||
- Sufficient evidence to support/contextualize hypotheses
|
||||
- Multiple independent lines of evidence converge
|
||||
|
||||
**When to search more:**
|
||||
- Major gaps in understanding remain
|
||||
- Conflicting evidence needs resolution
|
||||
- Hypothesis seems inconsistent with literature
|
||||
- Need specific methodological information
|
||||
|
||||
## Documenting Search Results
|
||||
|
||||
### Information to Capture
|
||||
|
||||
**For each relevant paper:**
|
||||
- Full citation (authors, year, journal, title)
|
||||
- Key findings relevant to hypothesis
|
||||
- Study design and methods
|
||||
- Limitations noted by authors
|
||||
- How it relates to hypothesis
|
||||
|
||||
### Organizing Findings
|
||||
|
||||
**Group by:**
|
||||
- Supporting evidence for hypothesis A, B, C
|
||||
- Methodological approaches
|
||||
- Conflicting findings requiring explanation
|
||||
- Gaps in current knowledge
|
||||
|
||||
**Synthesis notes:**
|
||||
- What is well-established?
|
||||
- What is controversial or uncertain?
|
||||
- What analogies exist in other systems?
|
||||
- What methods are commonly used?
|
||||
|
||||
### Citation Organization for Hypothesis Reports
|
||||
|
||||
**For report structure:** Organize citations for two audiences:
|
||||
|
||||
**Main Text (15-20 key citations):**
|
||||
- Most influential papers (highly cited, seminal studies)
|
||||
- Recent definitive evidence (last 2-3 years)
|
||||
- Key papers directly supporting each hypothesis (3-5 per hypothesis)
|
||||
- Major reviews synthesizing the field
|
||||
|
||||
**Appendix A: Comprehensive Literature Review (40-60+ citations):**
|
||||
- **Historical context:** Foundational papers establishing field
|
||||
- **Current understanding:** Recent reviews and meta-analyses
|
||||
- **Hypothesis-specific evidence:** 8-15 papers per hypothesis covering:
|
||||
- Direct supporting evidence
|
||||
- Analogous mechanisms in related systems
|
||||
- Methodological precedents
|
||||
- Theoretical framework papers
|
||||
- **Conflicting findings:** Papers representing different viewpoints
|
||||
- **Knowledge gaps:** Papers identifying limitations or unanswered questions
|
||||
|
||||
**Target citation density:** Aim for 50+ total references to provide comprehensive support for all claims and demonstrate thorough literature grounding.
|
||||
|
||||
**Grouping strategy for Appendix A:**
|
||||
1. Background and context papers
|
||||
2. Current understanding and established mechanisms
|
||||
3. Evidence supporting each hypothesis (separate subsections)
|
||||
4. Contradictory or alternative findings
|
||||
5. Methodological and technical papers
|
||||
|
||||
## Practical Search Workflow
|
||||
|
||||
### Step-by-Step Process
|
||||
|
||||
1. **Define search goals (5 min):**
|
||||
- What aspects of phenomenon need evidence?
|
||||
- What would support or refute hypotheses?
|
||||
|
||||
2. **Broad review search (15-20 min):**
|
||||
- Find 1-3 review articles
|
||||
- Skim abstracts for relevance
|
||||
- Note key concepts and terminology
|
||||
|
||||
3. **Targeted primary research (30-45 min):**
|
||||
- Search for specific mechanisms/evidence
|
||||
- Read abstracts, scan figures and conclusions
|
||||
- Follow most promising references
|
||||
|
||||
4. **Cross-domain search (15-30 min):**
|
||||
- Look for analogies in other systems
|
||||
- Find recent preprints
|
||||
- Identify emerging trends
|
||||
|
||||
5. **Citation mining (15-30 min):**
|
||||
- Follow references from key papers
|
||||
- Use "cited by" for recent work
|
||||
- Identify seminal studies
|
||||
|
||||
6. **Synthesize findings (20-30 min):**
|
||||
- Summarize evidence for each hypothesis
|
||||
- Note patterns and contradictions
|
||||
- Identify knowledge gaps
|
||||
|
||||
### Iteration and Refinement
|
||||
|
||||
**When initial search is insufficient:**
|
||||
- Broaden terms if too few results
|
||||
- Add specific mechanisms/pathways if too many results
|
||||
- Try alternative terminology
|
||||
- Search for related phenomena
|
||||
- Consult review articles for better search terms
|
||||
|
||||
**Red flags requiring more search:**
|
||||
- Only finding weak or indirect evidence
|
||||
- All evidence comes from single lab or source
|
||||
- Evidence seems inconsistent with basic principles
|
||||
- Major aspects of phenomenon lack any relevant literature
|
||||
|
||||
## Common Search Pitfalls
|
||||
|
||||
### Pitfalls to Avoid
|
||||
|
||||
1. **Confirmation bias:** Only seeking evidence supporting preferred hypothesis
|
||||
- **Solution:** Actively search for contradicting evidence
|
||||
|
||||
2. **Recency bias:** Only considering recent work, missing foundational studies
|
||||
- **Solution:** Include historical searches, track development of ideas
|
||||
|
||||
3. **Too narrow:** Missing relevant work due to restrictive terms
|
||||
- **Solution:** Use OR operators, try alternative terminology
|
||||
|
||||
4. **Too broad:** Overwhelmed by irrelevant results
|
||||
- **Solution:** Add specific terms, use filters, combine concepts with AND
|
||||
|
||||
5. **Single database:** Missing important work in other fields
|
||||
- **Solution:** Search both PubMed and general web, try domain-specific databases
|
||||
|
||||
6. **Stopping too soon:** Insufficient evidence to ground hypotheses
|
||||
- **Solution:** Set minimum targets (e.g., 2 reviews + 5 primary papers per hypothesis aspect)
|
||||
|
||||
7. **Cherry-picking:** Citing only supportive papers
|
||||
- **Solution:** Represent full spectrum of evidence, acknowledge contradictions
|
||||
|
||||
## Special Cases
|
||||
|
||||
### Emerging Topics (Limited Literature)
|
||||
|
||||
**When little published work exists:**
|
||||
- Search for analogous phenomena in related systems
|
||||
- Look for preprints (arXiv, bioRxiv)
|
||||
- Find conference abstracts and posters
|
||||
- Identify theoretical frameworks that may apply
|
||||
- Note the limited evidence in hypothesis generation
|
||||
|
||||
### Controversial Topics (Conflicting Literature)
|
||||
|
||||
**When evidence is contradictory:**
|
||||
- Systematically document both sides
|
||||
- Look for methodological differences explaining conflict
|
||||
- Check for temporal trends (has understanding shifted?)
|
||||
- Identify what would resolve the controversy
|
||||
- Generate hypotheses explaining the discrepancy
|
||||
|
||||
### Interdisciplinary Topics
|
||||
|
||||
**When spanning multiple fields:**
|
||||
- Search each field's primary databases
|
||||
- Use field-specific terminology for each domain
|
||||
- Look for bridging papers that cite across fields
|
||||
- Consider consulting domain experts
|
||||
- Translate concepts between disciplines carefully
|
||||
|
||||
## Integration with Hypothesis Generation
|
||||
|
||||
### Using Literature to Inform Hypotheses
|
||||
|
||||
**Direct applications:**
|
||||
- Established mechanisms to apply to new contexts
|
||||
- Known pathways relevant to phenomenon
|
||||
- Similar phenomena in related systems
|
||||
- Validated methods for testing
|
||||
|
||||
**Indirect applications:**
|
||||
- Analogies from different systems
|
||||
- Theoretical frameworks to apply
|
||||
- Gaps suggesting novel mechanisms
|
||||
- Contradictions requiring resolution
|
||||
|
||||
### Balancing Literature Dependence
|
||||
|
||||
**Too literature-dependent:**
|
||||
- Hypotheses merely restate known mechanisms
|
||||
- No novel insights or predictions
|
||||
- "Hypotheses" are actually established facts
|
||||
|
||||
**Too literature-independent:**
|
||||
- Hypotheses ignore relevant evidence
|
||||
- Propose implausible mechanisms
|
||||
- Reinvent already-tested ideas
|
||||
- Inconsistent with established principles
|
||||
|
||||
**Optimal balance:**
|
||||
- Grounded in existing evidence
|
||||
- Extend understanding in novel ways
|
||||
- Acknowledge both supporting and challenging evidence
|
||||
- Generate testable predictions beyond current knowledge
|
||||
Reference in New Issue
Block a user