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

# Coupling Analysis

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

## Request

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

Full Helium-Starlink coupling analysis for a location.

Performs scintillation estimation, RF correction, joint precursor
assessment, and atmospheric column analysis in a single call.
Returns all 12 ML features and data quality metrics.

Physics:
    - S4_915 = 0.8 * (rho/rho_quiet)^0.6 * (Kp/9)^1.2
    - P = 0.35*Delta_rho + 0.40*Delta_RSSI + 0.25*|r|
    - r = pearsonr(rho_thermo, P_surface) over 24h window

**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

- HSCAnalysisResponse: Response body for full coupling analysis.
  - `status` string, required: Request status (success / error)
  - `lat` number, required: Queried latitude
  - `lon` number, required: Queried longitude
  - `scintillation` object: S4 scintillation analysis at 915 MHz
  - `precursor` object: Joint earthquake precursor assessment
  - `coupling` object: Ionosphere-ground coupling metrics
  - `vertical_column` object: Vertical atmospheric column analysis
  - `ml_features` object: 12 HSC ML features for downstream models
  - `data_quality` object: Data quality and coverage metrics
  - `timestamp` string, required: ISO 8601 timestamp (UTC)

## 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)