---
title: "Atmospheric Coupling"
method: POST
path: "/api/v1/cross-physics/helium-starlink/atmospheric-coupling"
tags: ["Helium-Starlink Coupling"]
---

# Atmospheric Coupling

`POST /api/v1/cross-physics/helium-starlink/atmospheric-coupling`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/cross-physics/helium-starlink/atmospheric-coupling`
- Auth: none declared

Thermosphere-surface atmospheric coupling analysis.

Correlates Starlink-derived thermospheric density at 550 km
altitude with surface barometric pressure to characterise the
full vertical atmospheric column.  Strong coupling (high |r|)
may indicate large-scale atmospheric forcing from volcanic
eruptions, nuclear detonations, or Lamb wave propagation.

Physics:
    r = pearsonr(rho_thermosphere, P_surface)
    over trailing 24-hour window at 1-hour resolution.

Coupling strength is classified as:
    weak       |r| < 0.3
    moderate   0.3 <= |r| < 0.5
    strong     0.5 <= |r| < 0.7
    very_strong|r| >= 0.7

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- HSCAnalysisRequest: Request body for Helium-Starlink coupling analysis endpoints.
  - `lat` number, required: Latitude in decimal degrees (WGS84)
  - `lon` number, required: Longitude in decimal degrees (WGS84)
  - `radius_km` number: Analysis radius in kilometres (default 50)
  - `include_training` boolean: If True, trigger model retraining with latest data

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)