---
title: "Ligo Analyze"
method: POST
path: "/api/v1/ligo/analyze"
tags: ["LIGO Geophysical Signal"]
---

# Ligo Analyze

`POST /api/v1/ligo/analyze`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/ligo/analyze`
- Auth: none declared

Extract all geophysical features from LIGO detector noise.

Returns a 22-dimensional feature vector covering microseisms,
earth tides, atmospheric coupling, ocean loading, teleseismic
events, and anthropogenic noise.

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

## Request body

- LIGOAnalyzeRequest: Request body for full LIGO geophysical analysis.
  - `lat` number: Latitude for nearest detector selection (WGS84)
  - `lon` number: Longitude for nearest detector selection (WGS84)
  - `detector` string, nullable: Detector override: H1 (Hanford), L1 (Livingston), V1 (Virgo). If None, uses nearest to lat/lon.
  - `duration_s` number: Duration of analysis window in seconds
  - `sample_rate` number: Sampling rate in Hz (4096 standard for LIGO)
  - `ocean_state` string: Simulated ocean state for demo: calm, moderate, storm
  - `include_teleseismic` boolean: Inject a synthetic teleseismic event (demo mode)
  - `time_of_day_hours` number: Hour of day (UTC) for cultural noise modulation
  - `use_demo` boolean: Use synthetic demo data (True) or attempt GWOSC fetch (False)
  - `gps_start` integer, nullable: GPS start time for real data fetch (requires use_demo=False)

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