gpd-error-propagation

Propagates uncertainties through multi-step physics derivation chains to produce ranked error budgets.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-error-propagation-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-error-propagation
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-error-propagation
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-error-propagation-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, sympy.

What problem does it solve? Physics calculations are chains of transformations where each intermediate result carries uncertainty from its inputs. Without systematic propagation, final error bars are missing or guessed, and effort is wasted improving parameters that barely affect the result. This Skill traces how input uncertainties flow through every intermediate step to the final quantity, producing an explicit error budget that identifies the dominant error source. ## Core Features & Use Cases - Dependency Tree Tracing: Builds the complete derivation chain from leaf input parameters through intermediate results to the target quantity, using state.json depends_on chains and SUMMARY.md provides/requires sections across phases. - Multi-Source Uncertainty Cataloging: Classifies error sources as statistical, systematic, parametric, truncation, numerical, and model uncertainties, including approximation validity-boundary checks and catastrophic cancellation detection. - Sensitivity and Correlation Analysis: Computes analytical or numerical sensitivity coefficients, handles correlated errors via covariance propagation, and supports Monte Carlo cross-checks for non-Gaussian cases. - Use Case: After completing several project phases with tracked intermediate results, run the command with --target on a final observable to generate an ERROR-BUDGET.md ranking each parameter's contribution, showing that e.g. 90% of the uncertainty comes from one input so you know where to invest precision-improvement effort. ## Quick Start Ask the AI to run error propagation on a target quantity, for example: propagate uncertainties through the derivation chain for the coupling constant and produce an error budget identifying the dominant error source.

Frequently Asked Questions about gpd-error-propagation

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

FAQPage Schema
How do I propagate uncertainties through a multi-step calculation?▼

Run the error propagation command with --target set to your final quantity. It traces the dependency tree from input parameters through intermediate results, computes partial derivatives or numerical sensitivities at each step, and combines errors in quadrature or linearly for correlated sources.

How do I identify the dominant source of uncertainty in a physics result?▼

The error budget table ranks every uncertainty source by magnitude and fraction of total variance. It reports the dominant source and the most improvable source, showing how much the total uncertainty would shrink if a given parameter were improved by a factor of two.

How are correlated uncertainties handled in error propagation?▼

Correlated errors from shared upstream dependencies are propagated with the full covariance formula rather than quadrature. If the correlation matrix is unknown, bounds are computed for fully correlated and fully anti-correlated extremes to bracket the true uncertainty.

What happens if the target quantity is not found in project state?▼

The command searches intermediate_results and propagated_uncertainties in state.json, then SUMMARY.md files across phases. If the quantity is still missing, it reports which phases were searched and asks you to specify the location or run the computation first.

When should I use Monte Carlo instead of linear error propagation?▼

Linear propagation assumes Gaussian uncertainties and breaks down when relative errors exceed roughly 10-20 percent or the function is strongly nonlinear. In those cases the workflow supports Monte Carlo propagation with percentile-based asymmetric error bars.

What are the limitations of this error propagation workflow?▼

It requires existing project state with tracked intermediate results, so it cannot run before phases are completed. Numerical sensitivities can diverge near singularities, and model uncertainties are estimated from next-order corrections rather than computed exactly.