Skip to content

Multi-capture API index

Use these guides when you need periodic or scheduled captures (for example, hourly RxMER snapshots) along with downstream analysis.

Background Read the capture operation guide first. It explains how capture operations, transactions, storage, and memory lifecycle hang together.

Workflow at a glance

  1. Plan - Decide whether you need multi-RxMER or multi-channel-estimation captures and confirm storage availability.
  2. Start - Call the workflow-specific endpoint (for example, multi-RxMER capture) with schedule, modem list, and retention options.
  3. Monitor - Poll operation status and review logs via the PyPNM system endpoints.
  4. Download - Use the workflow guide or file manager to grab ZIP archives once captures complete.
  5. Analyze - Feed the captures into one of the advanced analysis modules listed below.

Memory Behavior

Multi-capture workflows have two distinct memory phases:

  1. Capture phase Active operations keep a live in-memory capture service plus per-operation counters and temporary samples.

  2. Analysis phase Analysis requests decode staged PNM files into parser objects, models, and sometimes NumPy arrays before releasing those intermediates.

Completed capture services no longer need to remain in memory just to serve status. Terminal operation status is now persisted and used as a fallback when the live service has already been evicted.

For the full lifecycle and memory discussion, see Multi-Capture Operation Overview.

Multi-capture workflows

Workflow Purpose
Multi-RxMER capture Periodic downstream OFDM RxMER sampling across multiple carriers.
Multi-DS channel estimation Scheduled OFDM channel estimation captures and reporting.
Multi-US OFDMA Pre-Equalization Multi-sample upstream OFDMA Pre-Equalization capture and analysis under /advance/multi/us.

Advanced analysis modules

Module Purpose
Multi-RxMER min/avg/max Roll up RxMER across captures.
Multi-RxMER echo reflection Detect reflection/echo candidates from trend-removed averaged RxMER via IFFT.
Multi-ChanEst min/avg/max Summaries for channel estimation data.
Group delay calculator Compute group delay variations.
OFDM performance 1:1 Compare per-subcarrier capacity vs profile.
OFDM echo detection Detect reflections and echo artifacts.
Phase slope LTE detection Spot LTE-related interference patterns.
Signal statistics Extract RMS/min/max variance from captures.