Source: https://guthlabs.ai/docs/instruments/rotating-unbalance-force-calculator/implementation/

instrument implementation / implementation-contract

# Rotating Unbalance Force Calculator implementation

A source-bound implementation contract for Rotating Unbalance Force Calculator; deployment and executable qualification remain separate.

Status: **VERIFIED_CLEAN**Lifecycle: **implementation-contract**

## Binding contract

This record describes what an executable surface must bind and validate. It does not claim that a public calculator, package, or production route is deployed.

**Record owner**: Guth Instruments

**Lifecycle**: verified-clean

**Evidence ID**: t5-104

**Effect**: Computation or source lookup only

## Input and validation requirements

The ideal undamped resonance input r=1 and ζ=0 produces a zero denominator and an undefined steady-state amplitude. A second hazard is that negative eccentricity has incompatible magnitude-versus-direction interpretations.

## Required corrections

No binding erratum is attached to this unique-name record. Implementers must still preserve the declared units, domain, and failure behavior.

## Inspectable interface fixture

The sample below is evidence for interface and validation tests, not a production implementation.

````
{
  "inputs": {
    "unbalance_mass_kg": 0.02,
    "eccentricity_m": 0.001,
    "omega_rad_s": 100,
    "system_mass_kg": 10,
    "stiffness_N_per_m": 10000,
    "damping_Ns_per_m": 20
  },
  "expected_outputs": {
    "F0_N": 0.2,
    "steady_state_amplitude_X_m": 0.00000222167
  },
  "working": "ω_n=√(k/M)=√(10000/10)=√1000=31.6228 rad/s. r=ω/ω_n=100/31.6228=3.16228, so r²=10. ζ=c/(2Mω_n)=20/(2×10×31.6228)=0.0316228. F0=m_u e ω²=0.02×0.001×100²=0.2 N. Numerator for X=(m_u e/M)r²=(0.02×0.001/10)×10=0.00002 m. Denominator=√[(1−10)²+(2×0.0316228×3.16228)²]=√[81+0.04]=√81.04=9.00222. X=0.00002/9.00222=0.00000222167 m."
}
````

## Other records

[01**Overview**](<https://guthlabs.ai/docs/instruments/rotating-unbalance-force-calculator/>)[02**Mechanism**](<https://guthlabs.ai/docs/instruments/rotating-unbalance-force-calculator/mechanism/>)[04**Qualification**](<https://guthlabs.ai/docs/instruments/rotating-unbalance-force-calculator/qualification/>)

## Sources and evidence

These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.

- `VERIFIED_LEDGER.json`

- `evidence-tranche5/tranche5-results.json`
