omni_torus
Calculate torus volume, surface area, inner hole diameter, and outer diameter from major and minor radii for exact geometry results.
Instructions
Torus Volume & Surface Area (Donut) Calculator. Calculate donut torus volume and surface area using Pappus's Centroid Theorems from major radius R and minor radius r. Discipline: GEOMETRY. Governing mathematical model / formula: Volume = 2π² · R · r² | Surface Area = 4π² · R · r.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of torus_volume (Torus Volume), torus_surface_area (Total Surface Area), hole_diameter (Inner Hole Diameter (2(R - r))), outer_diameter (Outer Outer Diameter (2(R + r))) using major_radius (Major Radius (R) in units), minor_radius (Minor Radius (r) in units). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
SIBLING ROUTING: Use this dedicated specialist tool for 'Torus Volume & Surface Area (Donut) Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "torus"
category (string): "geometry"
name (string): "Torus Volume & Surface Area (Donut) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.torus_volume (Torus Volume): Formatted display string (e.g. '1,776.5288 units³')
metrics.torus_surface_area (Total Surface Area): Formatted display string (e.g. '1,184.3525 units²')
metrics.hole_diameter (Inner Hole Diameter (2(R - r))): Formatted display string (e.g. '14.0000 units')
metrics.outer_diameter (Outer Outer Diameter (2(R + r))): Formatted display string (e.g. '26.0000 units')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_torus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| major_radius | No | Major Radius (R) (units). Distance from center of hole to center of tube (R > r). Default: 10. Min: 1. Max: 1000. | |
| minor_radius | No | Minor Radius (r) (units). Radius of the revolving tube cross-section. Default: 3. Min: 0.1. Max: 500. |