Description
For nonnegative mass return energyShift=mass*potentialShift.
A mechanics calculation needs a coordinate frame, sign convention, and consistent force, length, mass, and time units. Vector projections, local balance terms, and ideal motion equations describe particular parts of a physical model. They do not automatically establish all equilibrium conditions or the validity of the model.
For nonnegative mass return energyShift=mass*potentialShift.
When to use this tool
Use Gravitational Potential Datum Energy Term when you need this particular projection, balance, frame conversion, or ideal-model component from supplied physical quantities.
How to use the tool and how it works
- Enter mass, potentialShift. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read energyShift. Use the output convention below.
For nonnegative mass return energyShift=mass*potentialShift.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| mass | Mass in a consistent unit for the stated model. | Required. Finite number; minimum 0. |
| potentialShift | Potential Shift | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| energyShift | Energy Shift | Required. Finite number. |
{
"input": {
"mass": 3,
"potentialShift": 20
},
"output": {
"energyShift": 60
}
}Limitations and assumptions
- PotentialShift is a signed gravitational potential change in energy-per-mass units. This changes the energy datum without computing a gravitational field or an observable force.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.
Alternative or Complementary methods
Use a complete force, motion, or energy model when a single contribution is insufficient. Check coordinate frames, idealizations, and dimensional consistency before combining calculated terms.
References
Similar or alternative tools
- Elastic Energy Strain One Mode
Return one linear elastic uniaxial mode energy, excluding plasticity and multiaxial coupling.
- Harmonic Oscillator Phase Space Energy
For positive mass and nonnegative angularFrequency return kinetic=mass*velocity^2/2, potential=mass*(angularFrequency*position)^2/2, and energy=kinetic+potential.