tooluniverse-epidemiological-analysis

Conducts observational epidemiology studies from PECO question to publication-ready statistical report.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-epidemiological-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-epidemiological-analysis
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-epidemiological-analysis
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-epidemiological-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It guides the complete workflow of observational epidemiology analysis, turning a research question into a statistically rigorous, publication-ready report without skipping critical steps like power analysis, confounder adjustment, or sensitivity checks.

Core Features & Use Cases

  • Structured Study Design: Formulates research questions using the PECO framework and matches them to cohort, case-control, or cross-sectional designs.
  • Full Statistical Pipeline: Generates Python code for data download, Table 1 descriptive statistics, sequential regression adjustment, assumption checks (VIF), and sensitivity analyses.
  • Biological Interpretation: Uses ToolUniverse tools (PubMed, pathway, gene-disease, drug mechanism searches) to connect statistical associations to plausible biological mechanisms.
  • Use Case: Analyze NHANES data to test whether a nutrient intake is associated with a disease outcome, producing adjusted odds ratios, stratified forest plots, and a limitations section.

Quick Start

Analyze the association between my exposure and outcome variables in this dataset using a fully adjusted logistic regression with sensitivity analyses and a written report.

Frequently Asked Questions about tooluniverse-epidemiological-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze an observational epidemiology study in Python?

Define the PECO question first, then load data with pandas, build Table 1 descriptive statistics, and fit sequential regression models with statsmodels. Report unadjusted and adjusted odds ratios with 95% confidence intervals, then run sensitivity analyses.

How to adjust for confounders in logistic regression with statsmodels?

Use smf.logit with a formula adding confounders stepwise: exposure only, then demographics, then clinical factors. Exponentiate coefficients with numpy to get odds ratios and compare across models to assess confounding.

Which regression model should I use for different outcome types?

Use smf.ols for continuous outcomes, smf.logit for binary outcomes, OrderedModel for ordinal categories, CoxPHFitter from lifelines for time-to-event data, and smf.poisson or negativebinomial for count data.

Does this workflow handle survey weights like NHANES?

Yes, it notes that surveys such as NHANES, BRFSS, and MEPS require sampling weights for valid inference. Weighted regression can be performed with statsmodels.stats.weightstats or the linearmodels package.

What are the limitations of cross-sectional epidemiology analysis?

Cross-sectional designs cannot establish temporality, so causal claims are not supported. The workflow requires stating this explicitly, along with residual confounding, recall bias in self-reported exposures, and non-response bias.

How do I check multicollinearity before running regression?

Compute variance inflation factors with variance_inflation_factor from statsmodels on the covariate matrix. VIF above 5 is concerning and above 10 indicates severe multicollinearity requiring variable removal or combination.