README.md

---
title: Projectile Motion — Deterministic + One-Sentence LLM
emoji: 🎯
colorFrom: purple
colorTo: green
sdk: gradio
sdk_version: "4.44.0"
app_file: app.py
pinned: false
---

# Projectile Motion — Deterministic Calculator + One-Sentence Explanation

A **first-principles projectile motion** calculator (no air resistance) that returns:
- All **inputs** with units: `v₀` [m/s], `θ` [deg], `y₀` [m], `g` [m/s²], and **ball weight** [kg]
- **Derived results**: `t_apex` [s], `max height` [m], `time of flight` [s], `range` [m], `impact speed` [m/s]
- A **one-sentence, LLM-generated explanation** grounded strictly in the computed values.

## Scope & Assumptions
- Constant gravity `g`
- Flat landing surface at `y = 0`
- Neglects air resistance

## UI
- Sliders for inputs with validation ranges
- Two panels: (i) **All values (inputs + derived)**; (ii) **One-sentence explanation**
- ≥3 representative examples

## Notes
Educational demo; not for safety-critical use. The explainer uses a template-like prompt and the structured JSON only (no made-up numbers).