skills/scientific-writing/science-figure-guide/SKILL.md
Science (AAAS) figure preparation: resolution (150-300+ DPI), formats (PDF/EPS/TIFF), RGB color, Myriad/Helvetica fonts, strict image manipulation policies including gamma adjustment disclosure.
npx skillsauth add jaechang-hits/scicraft science-figure-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This guide provides the complete specifications for preparing figures for submission to Science journal (published by AAAS). Science has different requirements for initial vs. revised manuscript submissions and requires explicit disclosure of nonlinear image adjustments.
Official reference: https://www.science.org/content/page/instructions-preparing-initial-manuscript
| Image Type | Resolution | |---|---| | All figures | 150-300 DPI |
| Image Type | Minimum Resolution | Notes | |---|---|---| | Line art | 300 DPI+ | At final print size | | Grayscale and color artwork | 300 DPI+ | Higher resolution preferred |
CRITICAL: Upsampling (artificially increasing resolution) is prohibited. The resolution must be native to the image.
from PIL import Image
def check_science_resolution(image_path, stage='initial'):
"""Check image resolution for Science submission.
Args:
image_path: Path to image file
stage: 'initial' (150-300 DPI) or 'revised' (300+ DPI)
"""
img = Image.open(image_path)
dpi = img.info.get('dpi', (72, 72))
min_dpi = 150 if stage == 'initial' else 300
print(f"Stage: {stage} submission")
print(f"DPI: {dpi[0]} x {dpi[1]}")
print(f"Minimum required: {min_dpi} DPI")
if dpi[0] >= min_dpi:
print("PASS: Resolution meets Science requirements")
else:
print(f"FAIL: Need at least {min_dpi} DPI")
return dpi[0] >= min_dpi
| Figure Type | Preferred Formats | |---|---| | Vector illustrations/diagrams | PDF, EPS, Adobe Illustrator (AI) | | Raster illustrations/diagrams | TIFF (300+ DPI) | | Photography/microscopy | TIFF, JPEG, PNG, PSD, EPS, PDF |
.docx or PDF manuscript files| Layout | Width | |---|---| | 1 column | 3.4 inches (86 mm / 20.38 picas) | | 1.5 columns | 5.0 inches | | 2 columns | 7.0-7.3 inches | | Maximum | 6.5 x 8 inches (16.5 x 20 cm) |
Figures should be sized to fit 8.5" x 11" or A4 paper.
import matplotlib.pyplot as plt
SCIENCE_WIDTHS = {
'single': 3.4, # inches
'middle': 5.0,
'double': 7.3,
}
def create_science_figure(layout='single', aspect_ratio=0.75):
"""Create a Matplotlib figure sized for Science journal."""
width = SCIENCE_WIDTHS[layout]
height = min(width * aspect_ratio, 8.0) # max height 8 inches
fig, ax = plt.subplots(figsize=(width, height))
fig.set_dpi(300)
return fig, ax
| Element | Font | Size | Style | |---|---|---|---| | Preferred font | Myriad | — | Sans-serif | | Alternative fonts | Helvetica, Arial | — | Sans-serif | | Panel labels | — | 8 pt | Bold | | Other figure text | — | 5-7 pt | Max 7 pt, min 5 pt |
import matplotlib.pyplot as plt
def set_science_fonts():
"""Configure Matplotlib for Science journal figure fonts."""
plt.rcParams.update({
'font.family': 'sans-serif',
'font.sans-serif': ['Myriad Pro', 'Helvetica', 'Arial'],
'font.size': 7,
'axes.labelsize': 7,
'axes.titlesize': 7,
'xtick.labelsize': 6,
'ytick.labelsize': 6,
'legend.fontsize': 5,
})
def format_science_axis(ax, xlabel, ylabel, x_unit='', y_unit=''):
"""Format axes following Science journal conventions."""
if x_unit:
ax.set_xlabel(f"{xlabel} ({x_unit})", fontsize=7)
else:
ax.set_xlabel(xlabel, fontsize=7)
if y_unit:
ax.set_ylabel(f"{ylabel} ({y_unit})", fontsize=7)
else:
ax.set_ylabel(ylabel, fontsize=7)
ax.tick_params(labelsize=6)
from PIL import Image
import os
def validate_science_figure(image_path, stage='initial'):
"""Full validation of a figure against Science requirements."""
img = Image.open(image_path)
issues = []
# 1. Resolution check
dpi = img.info.get('dpi', (72, 72))
min_dpi = 150 if stage == 'initial' else 300
if dpi[0] < min_dpi:
issues.append(f"Resolution {dpi[0]} DPI below minimum {min_dpi} DPI for {stage} submission")
# 2. Color mode check
if img.mode not in ('RGB', 'RGBA'):
issues.append(f"Color mode is {img.mode}; RGB recommended")
# 3. Dimension check
if dpi[0] > 0:
width_in = img.size[0] / dpi[0]
height_in = img.size[1] / dpi[1]
if width_in > 7.3:
issues.append(f"Width {width_in:.1f}\" exceeds maximum 7.3\"")
if height_in > 8.0:
issues.append(f"Height {height_in:.1f}\" exceeds maximum 8.0\"")
# Report
print(f"=== Science Figure Validation ({stage}) ===")
print(f"Dimensions: {img.size[0]} x {img.size[1]} px")
print(f"DPI: {dpi[0]} x {dpi[1]}")
print(f"Color mode: {img.mode}")
if issues:
print(f"\nISSUES FOUND ({len(issues)}):")
for issue in issues:
print(f" - {issue}")
else:
print("\nAll checks PASSED")
return len(issues) == 0
Science uses different figure requirements for initial vs. revised manuscripts. Initial submissions accept 150-300 DPI figures embedded in the manuscript. Revised manuscripts require separate high-resolution files (300+ DPI) in publication-ready formats. This two-stage approach reduces upfront preparation burden while ensuring final quality.
Science uniquely requires explicit disclosure of nonlinear image adjustments (e.g., gamma corrections) in the figure caption. Linear adjustments (brightness, contrast) applied uniformly need no special disclosure. This distinction is critical — failure to disclose gamma changes can be flagged as data manipulation.
Science enforces strict maximum dimensions: 6.5 x 8 inches (16.5 x 20 cm). Single-column figures are 3.4 inches wide; double-column figures are 7.0-7.3 inches. All figures must fit on standard letter (8.5 x 11 inch) or A4 paper.
What submission stage are you at?
├── Initial submission
│ ├── Embed figures in manuscript (.docx or PDF)
│ └── 150-300 DPI acceptable
└── Revised manuscript
├── Upload separate high-resolution files
├── Vector figures (graphs, diagrams)
│ └── PDF, EPS, or AI format
└── Raster figures (photos, micrographs)
└── TIFF at 300+ DPI
| Scenario | Format | Resolution | Notes | |---|---|---|---| | Initial submission graph | Embedded in .docx | 150-300 DPI | Low bar for initial review | | Revised manuscript graph | PDF or EPS | Vector | Separate upload required | | Photograph (revised) | TIFF | 300+ DPI | Native resolution only | | Micrograph with gamma adjustment | TIFF | 300+ DPI | Disclose gamma in caption | | Diagram or schematic | AI or EPS | Vector | Embed all fonts |
Before submitting figures to Science, verify:
development
Bulk RNA-seq DE with R/Bioconductor DESeq2. Negative binomial GLM, empirical Bayes shrinkage, Wald/LRT tests, multi-factor designs, Salmon tximeta import, apeglm LFC shrinkage, MA/volcano/heatmap viz. R gold standard. Use pydeseq2-differential-expression for Python; use edgeR for TMM normalization.
tools
Guide to quality filtering raw VCF files before computing summary stats (Ts/Tv ratio, variant counts, AF distributions). Covers detecting raw VCFs via FILTER column and QUAL inspection, QUAL-based filtering with bcftools, Ts/Tv interpretation, and when NOT to filter. Read before any variant-level QC task. See bcftools-variant-manipulation for advanced filters, gatk-variant-calling for caller config, samtools-bam-processing for upstream alignment QC.
tools
Annotate and filter VCF variants with SnpEff and SnpSift. SnpEff predicts functional effects (HIGH/MODERATE/LOW/MODIFIER), genes, transcripts, AA changes, HGVS; SnpSift filters and adds ClinVar/dbSNP. Java CLI with Python subprocess integration. Use ANNOVAR for multi-database annotation; Ensembl VEP for REST API; SnpEff for fast CLI with pre-built genomes.
tools
GWAS and population genetics tool. Processes PLINK (.bed/.bim/.fam), VCF, and BGEN; runs QC (MAF, HWE, missingness), IBD estimation, PCA, and linear/logistic regression GWAS. Outputs Manhattan-ready summary stats. Use regenie or SAIGE for biobanks (>100k samples) needing mixed models.