physbound 0.1.0__tar.gz

physbound-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Secrets
+.env
+.env.*
+*.key
+*.pem
+
+# Tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.secrets.baseline
+
+# IDE
+.idea/
+.vscode/
+
+# Private project docs (not for public repo)
+claude.md
+CLAUDE.md
+.claude/

physbound-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-added-large-files
+        args: ['--maxkb=100']
+      - id: check-merge-conflict
+      - id: detect-private-key
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

physbound-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

physbound-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Jones
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

physbound-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: physbound
+Version: 0.1.0
+Summary: Physical Layer Linter — validates RF and physics calculations against hard physical limits
+Project-URL: Homepage, https://github.com/JonesRobM/physbound
+Project-URL: Repository, https://github.com/JonesRobM/physbound
+Project-URL: Issues, https://github.com/JonesRobM/physbound/issues
+Author-email: Robert Jones <jonesrobm@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.12
+Requires-Dist: fastmcp==2.14.5
+Requires-Dist: numpy==2.2.3
+Requires-Dist: pint==0.25.2
+Requires-Dist: pydantic<3,>=2.10
+Requires-Dist: scipy==1.15.2
+Provides-Extra: dev
+Requires-Dist: mypy==1.15.0; extra == 'dev'
+Requires-Dist: pre-commit==4.1.0; extra == 'dev'
+Requires-Dist: pytest-cov==6.0.0; extra == 'dev'
+Requires-Dist: pytest==8.3.5; extra == 'dev'
+Requires-Dist: python-dotenv>=1.1.0; extra == 'dev'
+Requires-Dist: ruff==0.9.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PhysBound
+
+**Physical Layer Linter** — An MCP server that validates RF and physics calculations against hard physical limits. Catches AI hallucinations in engineering workflows.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://img.shields.io/badge/tests-107%20passed-brightgreen.svg)]()
+
+---
+
+## What LLMs Get Wrong
+
+LLMs routinely hallucinate physics. PhysBound catches it:
+
+| # | Category | LLM Hallucination | PhysBound Truth | Verdict |
+|---|----------|-------------------|-----------------|---------|
+| 1 | Shannon-Hartley | "20 MHz 802.11n at 15 dB SNR achieves 500 Mbps" | Shannon limit: **100.6 Mbps** | CAUGHT |
+| 2 | Shannon-Hartley | "100 MHz 5G channel at 20 dB SNR delivers 2 Gbps" | Shannon limit: **665.8 Mbps** | CAUGHT |
+| 3 | Antenna Aperture | "30 cm dish at 1 GHz provides 45 dBi gain" | Aperture limit: **7.4 dBi** | CAUGHT |
+| 4 | Thermal Noise | "Noise floor of -180 dBm/Hz at room temperature" | Actual: **-174.0 dBm/Hz** at 290K | CAUGHT |
+| 5 | Link Budget | "Wi-Fi at 2.4 GHz reaches 10 km at -40 dBm" | Actual RX power: **-94.1 dBm** | CAUGHT |
+| 6 | Link Budget | "1W to GEO with 0 dBi antennas at -80 dBm" | Actual RX power: **-175.1 dBm** | CAUGHT |
+
+*Generated automatically by `pytest tests/test_marketing.py -s`*
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+pip install physbound
+```
+
+### Use with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "physbound": {
+      "command": "uv",
+      "args": ["run", "--from", "physbound", "physbound"]
+    }
+  }
+}
+```
+
+That's it. Claude now has access to physics-validated RF calculations.
+
+---
+
+## Tools
+
+### `rf_link_budget`
+
+Computes a full RF link budget using the Friis transmission equation. Validates antenna gains against aperture limits.
+
+**Example:** *"What's the received power for a 2.4 GHz link at 100 m with 20 dBm TX, 10 dBi TX gain, 3 dBi RX gain?"*
+
+Returns: FSPL, received power, wavelength, and optional aperture limit checks. Rejects antenna gains that violate `G_max = eta * (pi * D / lambda)^2`.
+
+### `shannon_hartley`
+
+Computes Shannon-Hartley channel capacity `C = B * log2(1 + SNR)` and validates throughput claims.
+
+**Example:** *"Can a 20 MHz channel with 15 dB SNR support 500 Mbps?"*
+
+Returns: Theoretical capacity, spectral efficiency, and whether the claim is physically possible. Flags violations with the exact percentage by which the claim exceeds the Shannon limit.
+
+### `noise_floor`
+
+Computes thermal noise power `N = k_B * T * B`, cascades noise figures through multi-stage receivers using the Friis noise formula, and calculates receiver sensitivity.
+
+**Example:** *"What's the noise floor for a 1 MHz receiver at 290K with a two-stage LNA chain?"*
+
+Returns: Thermal noise in dBm and watts, cascaded noise figure, system noise temperature, and receiver sensitivity.
+
+---
+
+## Physics Guarantees
+
+Every calculation is validated against hard physical limits:
+
+- **Speed of light:** `c = 299,792,458 m/s` — no exceptions
+- **Thermal noise floor:** `N = -174 dBm/Hz` at 290K — the IEEE standard reference
+- **Shannon limit:** `C = B * log2(1 + SNR)` — no throughput claim exceeds this
+- **Aperture limit:** `G_max = eta * (pi * D / lambda)^2` — antenna gain is bounded by physics
+
+Violations return structured `PhysicalViolationError` responses with LaTeX explanations, not silent failures.
+
+---
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/JonesRobM/physbound.git
+cd physbound
+uv sync --all-extras
+
+# Run tests
+uv run pytest tests/ -v
+
+# Print hallucination delta table
+uv run pytest tests/test_marketing.py -s
+
+# Start MCP server locally
+uv run physbound
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

physbound-0.1.0/README.md

@@ -0,0 +1,116 @@
+# PhysBound
+
+**Physical Layer Linter** — An MCP server that validates RF and physics calculations against hard physical limits. Catches AI hallucinations in engineering workflows.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://img.shields.io/badge/tests-107%20passed-brightgreen.svg)]()
+
+---
+
+## What LLMs Get Wrong
+
+LLMs routinely hallucinate physics. PhysBound catches it:
+
+| # | Category | LLM Hallucination | PhysBound Truth | Verdict |
+|---|----------|-------------------|-----------------|---------|
+| 1 | Shannon-Hartley | "20 MHz 802.11n at 15 dB SNR achieves 500 Mbps" | Shannon limit: **100.6 Mbps** | CAUGHT |
+| 2 | Shannon-Hartley | "100 MHz 5G channel at 20 dB SNR delivers 2 Gbps" | Shannon limit: **665.8 Mbps** | CAUGHT |
+| 3 | Antenna Aperture | "30 cm dish at 1 GHz provides 45 dBi gain" | Aperture limit: **7.4 dBi** | CAUGHT |
+| 4 | Thermal Noise | "Noise floor of -180 dBm/Hz at room temperature" | Actual: **-174.0 dBm/Hz** at 290K | CAUGHT |
+| 5 | Link Budget | "Wi-Fi at 2.4 GHz reaches 10 km at -40 dBm" | Actual RX power: **-94.1 dBm** | CAUGHT |
+| 6 | Link Budget | "1W to GEO with 0 dBi antennas at -80 dBm" | Actual RX power: **-175.1 dBm** | CAUGHT |
+
+*Generated automatically by `pytest tests/test_marketing.py -s`*
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+pip install physbound
+```
+
+### Use with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "physbound": {
+      "command": "uv",
+      "args": ["run", "--from", "physbound", "physbound"]
+    }
+  }
+}
+```
+
+That's it. Claude now has access to physics-validated RF calculations.
+
+---
+
+## Tools
+
+### `rf_link_budget`
+
+Computes a full RF link budget using the Friis transmission equation. Validates antenna gains against aperture limits.
+
+**Example:** *"What's the received power for a 2.4 GHz link at 100 m with 20 dBm TX, 10 dBi TX gain, 3 dBi RX gain?"*
+
+Returns: FSPL, received power, wavelength, and optional aperture limit checks. Rejects antenna gains that violate `G_max = eta * (pi * D / lambda)^2`.
+
+### `shannon_hartley`
+
+Computes Shannon-Hartley channel capacity `C = B * log2(1 + SNR)` and validates throughput claims.
+
+**Example:** *"Can a 20 MHz channel with 15 dB SNR support 500 Mbps?"*
+
+Returns: Theoretical capacity, spectral efficiency, and whether the claim is physically possible. Flags violations with the exact percentage by which the claim exceeds the Shannon limit.
+
+### `noise_floor`
+
+Computes thermal noise power `N = k_B * T * B`, cascades noise figures through multi-stage receivers using the Friis noise formula, and calculates receiver sensitivity.
+
+**Example:** *"What's the noise floor for a 1 MHz receiver at 290K with a two-stage LNA chain?"*
+
+Returns: Thermal noise in dBm and watts, cascaded noise figure, system noise temperature, and receiver sensitivity.
+
+---
+
+## Physics Guarantees
+
+Every calculation is validated against hard physical limits:
+
+- **Speed of light:** `c = 299,792,458 m/s` — no exceptions
+- **Thermal noise floor:** `N = -174 dBm/Hz` at 290K — the IEEE standard reference
+- **Shannon limit:** `C = B * log2(1 + SNR)` — no throughput claim exceeds this
+- **Aperture limit:** `G_max = eta * (pi * D / lambda)^2` — antenna gain is bounded by physics
+
+Violations return structured `PhysicalViolationError` responses with LaTeX explanations, not silent failures.
+
+---
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/JonesRobM/physbound.git
+cd physbound
+uv sync --all-extras
+
+# Run tests
+uv run pytest tests/ -v
+
+# Print hallucination delta table
+uv run pytest tests/test_marketing.py -s
+
+# Start MCP server locally
+uv run physbound
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

physbound-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "physbound"
+version = "0.1.0"
+description = "Physical Layer Linter — validates RF and physics calculations against hard physical limits"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "Robert Jones", email = "jonesrobm@gmail.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Telecommunications Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Physics",
+]
+dependencies = [
+    "fastmcp==2.14.5",
+    "pint==0.25.2",
+    "scipy==1.15.2",
+    "numpy==2.2.3",
+    "pydantic>=2.10,<3",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest==8.3.5",
+    "pytest-cov==6.0.0",
+    "pre-commit==4.1.0",
+    "ruff==0.9.6",
+    "mypy==1.15.0",
+    "python-dotenv>=1.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/JonesRobM/physbound"
+Repository = "https://github.com/JonesRobM/physbound"
+Issues = "https://github.com/JonesRobM/physbound/issues"
+
+[project.scripts]
+physbound = "physbound.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/physbound"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

physbound-0.1.0/smithery.yaml

@@ -0,0 +1,8 @@
+startCommand:
+  type: stdio
+  configSchema: {}
+  commandFunction: |-
+    (config) => ({
+      command: 'uv',
+      args: ['run', '--from', 'physbound', 'physbound']
+    })

physbound-0.1.0/src/physbound/__init__.py

@@ -0,0 +1,3 @@
+"""PhysBound — Physical Layer Linter for AI hallucination detection."""
+
+__version__ = "0.1.0"

physbound-0.1.0/src/physbound/engines/constants.py

@@ -0,0 +1,25 @@
+"""Physical constants as Pint quantities wrapping SciPy CODATA values.
+
+All downstream modules import the shared UnitRegistry and constants from here.
+No raw floats should leak into engine code — everything carries units.
+"""
+
+import pint
+from scipy import constants as sc
+
+# Single shared registry — import this everywhere
+ureg = pint.UnitRegistry()
+Q_ = ureg.Quantity
+
+# Exact physical constants as Pint quantities (CODATA 2018 exact values)
+SPEED_OF_LIGHT = Q_(sc.speed_of_light, "m/s")  # 299_792_458 m/s (exact)
+BOLTZMANN = Q_(sc.Boltzmann, "J/K")  # 1.380649e-23 J/K (exact)
+PLANCK = Q_(sc.Planck, "J*s")  # 6.62607015e-34 J·s (exact)
+
+# IEEE standard reference temperature
+T_REF = Q_(290, "K")
+
+# Derived: thermal noise floor at T_REF, 1 Hz bandwidth
+# N = k_B * T = 1.380649e-23 * 290 = 4.00388e-21 W/Hz
+# In dBm/Hz: 10 * log10(4.00388e-21 / 1e-3) = -173.977 ≈ -174 dBm/Hz
+THERMAL_NOISE_FLOOR_DBM_PER_HZ = -174.0

physbound-0.1.0/src/physbound/engines/link_budget.py

@@ -0,0 +1,217 @@
+"""RF Link Budget calculator using Friis transmission equation.
+
+Formulas:
+    FSPL = 20*log10(d) + 20*log10(f) + 20*log10(4*pi/c)    (free-space path loss)
+    P_rx = P_tx + G_tx + G_rx - FSPL - L_tx - L_rx          (Friis transmission)
+    G_max = eta * (pi*D/lambda)^2                             (aperture limit)
+"""
+
+import math
+
+from physbound.engines.constants import SPEED_OF_LIGHT
+from physbound.engines.units import linear_to_db
+from physbound.errors import PhysicalViolationError
+from physbound.validators import validate_positive_distance, validate_positive_frequency
+
+# Default aperture efficiency for parabolic dish antennas
+DEFAULT_APERTURE_EFFICIENCY = 0.55
+
+
+def free_space_path_loss_db(frequency_hz: float, distance_m: float) -> float:
+    """Compute free-space path loss in dB.
+
+    FSPL(dB) = 20*log10(d) + 20*log10(f) + 20*log10(4*pi/c)
+
+    Args:
+        frequency_hz: Carrier frequency in Hz.
+        distance_m: Link distance in meters.
+
+    Returns:
+        FSPL in dB (positive value; a loss).
+    """
+    validate_positive_frequency(frequency_hz)
+    validate_positive_distance(distance_m)
+
+    c = SPEED_OF_LIGHT.magnitude  # m/s
+    fspl = (
+        20.0 * math.log10(distance_m)
+        + 20.0 * math.log10(frequency_hz)
+        + 20.0 * math.log10(4.0 * math.pi / c)
+    )
+    return fspl
+
+
+def max_aperture_gain_dbi(
+    diameter_m: float,
+    frequency_hz: float,
+    efficiency: float = DEFAULT_APERTURE_EFFICIENCY,
+) -> float:
+    """Compute maximum antenna gain for a circular aperture.
+
+    G_max = eta * (pi * D / lambda)^2
+
+    Args:
+        diameter_m: Antenna diameter in meters.
+        frequency_hz: Operating frequency in Hz.
+        efficiency: Aperture efficiency (default: 0.55 for parabolic dish).
+
+    Returns:
+        Maximum gain in dBi.
+    """
+    validate_positive_frequency(frequency_hz)
+    if diameter_m <= 0:
+        raise PhysicalViolationError(
+            message=f"Antenna diameter must be positive, got {diameter_m} m",
+            law_violated="Antenna Theory",
+            latex_explanation=r"$D > 0$ required for a physical antenna aperture",
+            claimed_value=diameter_m,
+            unit="m",
+        )
+
+    c = SPEED_OF_LIGHT.magnitude
+    wavelength = c / frequency_hz
+    g_linear = efficiency * (math.pi * diameter_m / wavelength) ** 2
+    return linear_to_db(g_linear)
+
+
+def validate_antenna_gain(
+    claimed_gain_dbi: float,
+    diameter_m: float,
+    frequency_hz: float,
+    label: str = "antenna",
+    efficiency: float = DEFAULT_APERTURE_EFFICIENCY,
+) -> float:
+    """Validate that claimed antenna gain doesn't exceed the aperture limit.
+
+    Args:
+        claimed_gain_dbi: Claimed antenna gain in dBi.
+        diameter_m: Antenna diameter in meters.
+        frequency_hz: Operating frequency in Hz.
+        label: Human label for error messages (e.g., "TX antenna").
+        efficiency: Aperture efficiency (default: 0.55).
+
+    Returns:
+        The computed G_max in dBi.
+
+    Raises:
+        PhysicalViolationError: If claimed gain exceeds G_max.
+    """
+    g_max = max_aperture_gain_dbi(diameter_m, frequency_hz, efficiency)
+
+    if claimed_gain_dbi > g_max:
+        c = SPEED_OF_LIGHT.magnitude
+        wavelength = c / frequency_hz
+        raise PhysicalViolationError(
+            message=(
+                f"{label} claimed gain {claimed_gain_dbi:.1f} dBi exceeds "
+                f"aperture limit {g_max:.1f} dBi for {diameter_m} m dish at "
+                f"{frequency_hz / 1e9:.3f} GHz"
+            ),
+            law_violated="Antenna Aperture Limit",
+            latex_explanation=(
+                rf"$G_{{\max}} = \eta \left(\frac{{\pi D}}{{\lambda}}\right)^2 = "
+                rf"{efficiency} \times \left(\frac{{\pi \times {diameter_m}}}"
+                rf"{{{wavelength:.4f}}}\right)^2 = {g_max:.1f}\,\text{{dBi}}$. "
+                rf"Claimed ${claimed_gain_dbi:.1f}\,\text{{dBi}}$ exceeds this limit."
+            ),
+            computed_limit=g_max,
+            claimed_value=claimed_gain_dbi,
+            unit="dBi",
+        )
+
+    return g_max
+
+
+def compute_link_budget(
+    tx_power_dbm: float,
+    tx_antenna_gain_dbi: float,
+    rx_antenna_gain_dbi: float,
+    frequency_hz: float,
+    distance_m: float,
+    tx_losses_db: float = 0.0,
+    rx_losses_db: float = 0.0,
+    tx_antenna_diameter_m: float | None = None,
+    rx_antenna_diameter_m: float | None = None,
+) -> dict:
+    """Compute a full RF link budget using the Friis transmission equation.
+
+    P_rx = P_tx + G_tx + G_rx - FSPL - L_tx - L_rx
+
+    Args:
+        tx_power_dbm: Transmit power in dBm.
+        tx_antenna_gain_dbi: Transmit antenna gain in dBi.
+        rx_antenna_gain_dbi: Receive antenna gain in dBi.
+        frequency_hz: Carrier frequency in Hz.
+        distance_m: Link distance in meters.
+        tx_losses_db: TX-side miscellaneous losses in dB.
+        rx_losses_db: RX-side miscellaneous losses in dB.
+        tx_antenna_diameter_m: Optional TX antenna diameter for aperture check.
+        rx_antenna_diameter_m: Optional RX antenna diameter for aperture check.
+
+    Returns:
+        Dict with FSPL, received power, warnings, human-readable, and LaTeX.
+
+    Raises:
+        PhysicalViolationError: If antenna gains exceed aperture limits.
+    """
+    warnings = []
+    tx_aperture_limit_dbi = None
+    rx_aperture_limit_dbi = None
+
+    # Validate antenna gains against aperture limits if diameters provided
+    if tx_antenna_diameter_m is not None:
+        tx_aperture_limit_dbi = validate_antenna_gain(
+            tx_antenna_gain_dbi, tx_antenna_diameter_m, frequency_hz, "TX antenna"
+        )
+
+    if rx_antenna_diameter_m is not None:
+        rx_aperture_limit_dbi = validate_antenna_gain(
+            rx_antenna_gain_dbi, rx_antenna_diameter_m, frequency_hz, "RX antenna"
+        )
+
+    # Friis model applicability warning above 300 GHz
+    if frequency_hz > 3e11:
+        warnings.append(
+            f"Frequency {frequency_hz / 1e9:.1f} GHz exceeds 300 GHz; "
+            "Friis free-space model may not be accurate due to atmospheric absorption"
+        )
+
+    # Compute FSPL and received power
+    fspl = free_space_path_loss_db(frequency_hz, distance_m)
+    received_power_dbm = (
+        tx_power_dbm + tx_antenna_gain_dbi + rx_antenna_gain_dbi
+        - fspl - tx_losses_db - rx_losses_db
+    )
+
+    c = SPEED_OF_LIGHT.magnitude
+    wavelength = c / frequency_hz
+
+    human_readable = (
+        f"Link Budget at {frequency_hz / 1e9:.3f} GHz, {distance_m:.1f} m:\n"
+        f"  TX Power:      {tx_power_dbm:.1f} dBm\n"
+        f"  TX Gain:       {tx_antenna_gain_dbi:.1f} dBi\n"
+        f"  RX Gain:       {rx_antenna_gain_dbi:.1f} dBi\n"
+        f"  FSPL:          {fspl:.2f} dB\n"
+        f"  TX Losses:     {tx_losses_db:.1f} dB\n"
+        f"  RX Losses:     {rx_losses_db:.1f} dB\n"
+        f"  Received Power: {received_power_dbm:.2f} dBm"
+    )
+
+    latex = (
+        rf"$P_{{\text{{rx}}}} = P_{{\text{{tx}}}} + G_{{\text{{tx}}}} + G_{{\text{{rx}}}} "
+        rf"- \text{{FSPL}} - L_{{\text{{tx}}}} - L_{{\text{{rx}}}} = "
+        rf"{tx_power_dbm:.1f} + {tx_antenna_gain_dbi:.1f} + {rx_antenna_gain_dbi:.1f} "
+        rf"- {fspl:.2f} - {tx_losses_db:.1f} - {rx_losses_db:.1f} = "
+        rf"{received_power_dbm:.2f}\,\text{{dBm}}$"
+    )
+
+    return {
+        "fspl_db": fspl,
+        "received_power_dbm": received_power_dbm,
+        "wavelength_m": wavelength,
+        "tx_aperture_limit_dbi": tx_aperture_limit_dbi,
+        "rx_aperture_limit_dbi": rx_aperture_limit_dbi,
+        "warnings": warnings,
+        "human_readable": human_readable,
+        "latex": latex,
+    }