Soi Handoff Hysteresis
Apply caller-defined sphere-of-influence handoff hysteresis to a sampled trajectory; boundaries are not universal force-dominance limits.
Description
Sphere-of-influence handoffs can oscillate when successive sampled distances hover near one boundary.
Sphere-of-influence handoffs can oscillate when successive sampled distances hover near one boundary. Hysteresis uses a tighter entry threshold and a wider exit threshold to make the decision depend on the previous state.1
Apply caller-defined sphere-of-influence handoff hysteresis to a sampled trajectory; boundaries are not universal force-dominance limits.
When to use Soi Handoff Hysteresis
Use this tool to apply caller-defined sphere-of-influence handoff hysteresis to a sampled trajectory; boundaries are not universal force-dominance limits.
Prepare the orbital state or model parameters in one reference frame. Use compatible distance/time units and the stated angular and gravitational-parameter conventions.
How to use Soi Handoff Hysteresis and understand its results
- Prepare the orbital state or model parameters in one reference frame. Use compatible distance/time units and the stated angular and gravitational-parameter conventions.
- Enter currentDistance, entryBoundary, exitBoundary, previouslyInside using the field table and calculation rules, then run the tool.
- Read nowInside, transition. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| currentDistance | Current distance | number | Required |
| entryBoundary | Entry boundary | number | Required |
| exitBoundary | Exit boundary | number | Required |
| previouslyInside | Previously inside | boolean | Required |
Enter a nonnegative sampled distance, a positive entry boundary, an exit boundary at least as large, and the previous inside flag. An outside state enters only below the entry boundary; an inside state remains inside through equality with the exit boundary. The tool reports nowInside and transition enter, exit or none. Equal entry/exit boundaries are accepted but retain the different equality rules.
nowInside = previouslyInside ? distance ≤ exitBoundary : distance < entryBoundary Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| nowInside | Now inside | boolean |
| transition | Transition | string |
{
"input": {
"currentDistance": 105,
"entryBoundary": 100,
"exitBoundary": 110,
"previouslyInside": true
},
"output": {
"nowInside": true,
"transition": "none"
}
}Limitations and assumptions
The thresholds are caller-defined operational choices, not universal force-dominance surfaces. It does not propagate a trajectory, locate a crossing between samples or calculate the boundaries from masses. All distances must use the same unit.
Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.
Alternative or Complementary methods
Use Triangular Lagrange Linear Stability: Evaluate the Routh criterion μ(1−μ)<1/27 for linear L4/L5 stability in the planar circular restricted model. For a complementary task, use Specific Orbital Energy: Evaluate specific two-body orbital energy v²/2−μ/r in consistent units; this does not determine angular momentum or collision safety.
References
-
Soi Handoff Hysteresis — tool.io
Similar or alternative tools
- Triangular Lagrange Linear Stability
Evaluate the Routh criterion μ(1−μ)<1/27 for linear L4/L5 stability in the planar circular restricted model.
- Specific Orbital Energy
Evaluate specific two-body orbital energy v²/2−μ/r in consistent units; this does not determine angular momentum or collision safety.