ForceTailScenario
Robotics scenarios · Implementation: mlsysim/engine/scenario_definitions/robotics/contact.py.
Construct this scenario with keyword inputs. The fields below show the types and defaults declared by this class.
A contact force over trials trials with a benign mean_force and a p99_force tail, against site’s tripwire and structural limit.
Notes
Equation: Subtract the structural limit from the tail force and divide the tail by the mean for scale comparisons.
Assumptions: The caller supplies both mean and p99 force for the stated trials.
Excludes: Estimating quantiles, uncertainty intervals, and a complete force distribution.
References
Derivation: Subtract the structural limit from the tail force and divide the tail by the mean for scale comparisons. Individual property contracts identify the exact accounting expression or reusable calculation. Registry entries supply the scenario inputs; this class does not turn them into measured outcomes.
Examples
Evaluate a named scenario using its declared inputs.
>>> from mlsysim import Scenarios
>>> scenario = Scenarios.LatchForceTail
>>> round(float(scenario.tail_over_limit.magnitude), 4)
15.0Attributes
| Name | Description |
|---|---|
| mean_force | |
| p99_force | |
| site | |
| tail_over_limit | Newtons by which the supplied p99 force exceeds the site’s latch limit; negative values |
| tail_over_mean | Dimensionless ratio of the supplied p99 force to the supplied mean force. |
| trials |
site
Type: Any.
Declared default: required.
trials
Type: int.
Declared default: required.
mean_force
Type: Quantity.
Declared default: required.
p99_force
Type: Quantity.
Declared default: required.
tail_over_limit
engine.scenario_types.ForceTailScenario.tail_over_limit
Newtons by which the supplied p99 force exceeds the site’s latch limit; negative values remain below it.
Equation: (p99_force - site.f_latch_limit).to('N').
tail_over_mean
engine.scenario_types.ForceTailScenario.tail_over_mean
Dimensionless ratio of the supplied p99 force to the supplied mean force.
Equation: (p99_force / mean_force).to('').magnitude.