NetFabric/NetFabric.Numerics / .agents/skills/angles-and-circular-arithmetic
angles-and-circular-arithmetic
VerifiedAbstract math for angle measurement, unit systems, and circular arithmetic. USE FOR: implementing angle types; converting between degrees/radians/gradians/revolutions; reducing angles to canonical range [0, Full); computing reference angles and quadrants; implementing safe modular arithmetic with negative inputs; angle addition and subtraction; classifying angles by sign and size. DO NOT USE FOR: trigonometric functions (use trigonometric-functions); coordinate conversions (use coordinate-system-conversions); interpolation (use interpolation-on-manifolds).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.3 KB |
| references/formulas.md | markdown | 2.4 KB |
| references/numerical-stability.md | markdown | 2.1 KB |
references/formulas.md
View on GitHub# Angles — Formulas & Derivations
## Unit Conversion Derivation
All conversions pass through revolutions as a normalized intermediate:
```
revolutions = θ_source / Full_source
θ_target = revolutions × Full_target
```
Combined: `θ_target = θ_source × (Full_target / Full_source)`
This gives the conversion table in SKILL.md. Example: degrees → radians = 360/2π is wrong;
correct factor is 2π/360 = π/180.
## Modular Reduction — Why Floor Division
The canonical range is [0, Full) (closed at 0, open at Full).
Using truncating division (C `%`, many languages) gives wrong results for negatives:
- `−30 % 360 = −30` ← wrong; should be 330
Using floor division (Python `%`, or explicit formula) is correct:
```
reduced = θ − Full × floor(θ / Full)
```
Mathematical basis: θ mod Full using the floor function maps every real θ to [0, Full).
Proof that result is in [0, Full):
- Let k = floor(θ / Full), then k ≤ θ/Full < k+1
- Multiply by Full: k·Full ≤ θ < (k+1)·Full
- Subtract k·Full: 0 ≤ θ − k·Full < Full ✓
## Degrees-Minutes-Seconds (DMS) Format
```
d° m' s" where 0 ≤ m < 60, 0 ≤ s < 60
```
Conversion to decimal degrees:
```
decimal = d + m/60 + s/3600
```
Conversion from decimal degrees:
```
d = trunc(decimal)
m = trunc((decimal − d) × 60)
s = ((decimal − d) × 60 − m) × 60
```
Validation constraints: m ∈ [0, 60), s ∈ [0, 60). Any value outside this range is invalid.
## Reference Angle — Full Derivation
Given reduced angle θ ∈ [0°, 360°):
| Quadrant | θ range | Reference = shortest arc to x-axis |
|----------|---------|-------------------------------------|
| First | [0°, 90°) | θ itself |
| PositiveY | 90° | 90° (on axis) |
| Second | (90°, 180°) | 180° − θ |
| NegativeX | 180° | 0° (on axis) |
| Third | (180°, 270°) | θ − 180° |
| NegativeY | 270° | 90° (on axis) |
| Fourth | (270°, 360°) | 360° − θ |
Reference angle is always in [0°, 90°].
## Angle Arithmetic
Addition is defined by closure on the unit: `θ₁ + θ₂` stays in the same unit.
The result is NOT automatically reduced; reduction is a separate explicit step.
`θ_sum = θ₁ + θ₂` (unrestricted, may exceed Full or be negative)
Negation: `−θ` is valid (represents opposite direction).
Scalar multiplication: `k × θ` scales the angle magnitude; unit is preserved.
Subtraction: `θ₁ − θ₂` computes the signed difference (may be negative).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |