---
name: emcalc-analyzer
description: Skill to analyze and interpret the physics outputs of the emcalc (Energy-Mass Calculator) program.
---

# emcalc_analyzer

Skill to thoroughly explain and contextualize the physics and practical results generated by the `emcalc.py` (Energy-Mass Calculator) program.

## What This Skill Does

When a user runs `emcalc.py` and shares the output, this skill helps the AI:
1. **Break down the physics context** behind the Einstein's $E=mc^2$ equations.
2. **Explain the energy conversion steps** (Theoretical vs Practical vs Electric).
3. **Contextualize the astronomically large numbers** generated (e.g., comparing Joules to real-world equivalents).
4. **Evaluate the efficiency values** entered by the user to ensure they make physical sense.
5. **Provide a tangible interpretation** of the device's run time output.

## When to Use

Use this skill when:
- The user shares results from their `emcalc.py` execution.
- The user asks for help understanding the difference between theoretical and practical energy levels.
- The user inputs extreme numbers (very high mass, or impossible efficiencies like >100%) and needs validation.
- The user wants to understand how their calculated Joules translate into everyday electricity consumption.

## Analysis Framework

### Step 1: Breakdown the Inputs
First, identify the parameters the user provided to the script:
- **Mass (grams):** The amount of matter converted to energy.
- **Conversion Efficiency:** How efficiently mass is converted into raw thermal/kinetic energy.
- **Joule-to-Electricity Efficiency:** How efficiently that raw energy is converted into usable electricity (e.g., representing thermal efficiency of steam turbines in power plants).
- **Device & Power (Watts):** The device being powered and its energy consumption rate.

### Step 2: Contextualize the Physics Outputs
- **Theoretical Energy ($E=mc^2$):** Explain that this is the absolute maximum energy contained within the mass, assuming 100% conversion (such as matter-antimatter annihilation).
- **Practical Energy:** Explain that this accounts for the mass-energy conversion efficiency the user specified. In real life, processes like nuclear fission/fusion convert only a tiny fraction of total mass into energy (mass defect).
- **Electricity Generation:** Explain that turning heat/kinetic energy into electricity involves massive losses, hence the final electrical output calculated by `emcalc` defines the actual device run time.

### Step 3: Sanity Check & Anomalies
- **Efficiencies > 1.0 (100%):** Flags a clear violation of the laws of thermodynamics. Warn the user and recommend correcting to < 1.0.
- **Micro-masses:** Point out that even fractions of a gram generate tremendous energy, to help them grasp the scale.

### Step 4: Real-World Comparison
Help the user grasp the scale of their output!
- $1 \text{ kWh} = 3,600,000 \text{ Joules}$. Convert the Joule output to kWh for an easier everyday comparison.
- Compare the electricity generated to the electricity consumption of an average household (approx. 10,000 kWh / year) or a familiar real-world metric.

## Examples

**Example 1: 1 Gram of Matter**

Input Python Output:
```text
Theoretical energy (at 100% efficiency): 89875517873681 Joules
Practical energy (at 90.00% efficiency): 80887966086313 Joules
--------------------
With the electricity generated from this energy, a 100.0-watt bulb:
Can run for approximately 283107881 seconds.
(This is approximately 78641 hours.)
(This is approximately 3276.71 days.)
(This is approximately 8.98 years.)
```

Analysis:
- **The Scale:** Remind the user that 1 gram is effectively the mass of a paperclip!
- **Theoretical vs. Practical:** Tell them the script simulated a 90% mass-to-energy conversion and assumed a 35% conversion from raw energy to electricity.
- **The Outcome:** Highlight that the sheer magnitude of $E=mc^2$ means a single piece of paperclip could theoretically power a 100W bulb continuously for ~9 years!
- **Recommendation/Insight:** Suggest they try simulating a real nuclear reactor's efficiency, which converts far less mass into energy (typically less than 0.1% mass defect) rather than 90%.

## Common Metrics Reference

- **C ($299,792,458$ m/s):** The speed of light.
- **Joule (J):** Standard unit of energy. $1 \text{ Watt} = 1 \text{ Joule per second}$.
- **Watt (W):** Rate of energy consumption.
- **kWh (Kilowatt-hour):** $3.6 \times 10^6$ Joules. A highly practical unit to explain energy to users.