Description
For positive period compute angle=2*pi*(value-origin)/period and return its sine and cosine.
Normalization depends on the supplied center, scale, norm, range, reference distribution, or denominator. A zero spread and a missing denominator need an explicit policy, and clipping differs from fitting a scaler. Evaluating one scalar or derivative term does not estimate every parameter or establish a distributional improvement.
For positive period compute angle=2*pi*(value-origin)/period and return its sine and cosine.
When to use this tool
Use Cyclic Feature Sinecosine Pair when you already have the required normalization parameters and need this local scalar, range, policy, or derivative term.
How to use the tool and how it works
- Enter value, period, origin. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read sine, cosine. Use the output convention below.
For positive period compute angle=2*pi*(value-origin)/period and return its sine and cosine.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| value | Supplied scalar or returned value under the stated operation. | Required. Finite number. |
| period | Period | Required. Finite number; strictly above 0. |
| origin | Origin | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| sine | Sine | Required. Finite number. |
| cosine | Cosine | Required. Finite number. |
{
"input": {
"value": 6,
"period": 24,
"origin": 0
},
"output": {
"sine": 1,
"cosine": 6.123233995736766e-17
}
}Limitations and assumptions
- Value, origin, and period need one cyclic coordinate unit. The phase is not reduced before arithmetic, so extreme values can lose accuracy or cause range errors; the pair does not infer a period or recover a unique unwrapped value.
- 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. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Fit or verify the intended scaler parameters and statistical model separately. Check units, zero policies, missingness, clipping, inverse conventions, and whether supplied norms or denominators belong to the same data.
References
Similar or alternative tools
- Lens Axis Wrapped Angle
Wrap an explicitly supplied unoriented research axis to a half-turn coordinate; no prescription is generated.
- Optical Axis Reference Gap
For suppliedReferenceGap within zero through 90 degrees reduce secondAxisDegrees-firstAxisDegrees modulo 180 and return unorientedGap=min(wrapped,180-wrapped) and residual=unorientedGap-suppliedReferenceGap.