MIRIS Atmospheric Research Project

The Mesospheric and Ionospheric Research Information System (MIRIS) is a distributed

open-source computing project dedicated to the study of upper atmospheric phenomena.

Operating across 1,247 sensor nodes in 43 countries, MIRIS collects, processes, and

distributes real-time atmospheric data for researchers worldwide.

Quick Start

npm install @miris/client
miris init --node-type observer
miris connect --network mainnet

2.0

System Architecture

The MIRIS architecture follows a three-tier distributed model, separating data collection, processing, and distribution into independent subsystems that communicate via a standardized message protocol.

3.0

Data Pipeline

Each sensor node collects atmospheric measurements at configurable intervals (default: 250ms). Raw data passes through a local preprocessing filter before transmission to regional aggregation servers.

Pipeline Configuration

[pipeline]
interval_ms = 250
buffer_size = 4096
compression = "zstd"
retry_policy = "exponential_backoff"

[pipeline.filters]
altitude_min = 50000    # meters (mesosphere boundary)
altitude_max = 1000000  # meters (exosphere limit)
noise_threshold = 0.02  # signal-to-noise ratio

The pipeline processes approximately 34.2 million data points per hour across all active nodes. Current latency from measurement to availability in the distribution API averages 1.2 seconds.

4.0

Atmospheric Model

MIRIS employs a proprietary atmospheric model that synthesizes real-time sensor data with historical patterns to predict upper atmospheric conditions. The model divides the atmosphere into discrete layers for analysis:

Layer	Altitude (km)	Sensors	Status
Mesosphere	50 — 85	312	Active
Thermosphere	85 — 600	524	Active
Exosphere	600 — 1000	287	Calibrating
Ionosphere	60 — 1000	124	Active

5.0

Node Network

The distributed sensor network spans 43 countries, with regional hubs coordinating data aggregation. Each node operates autonomously while maintaining synchronization with the global time reference.

6.0

API Reference

The MIRIS distribution API provides RESTful endpoints for accessing real-time and historical atmospheric data. Authentication is handled via API keys issued through the contributor portal.

Example Request

GET /api/v3/atmosphere/readings
  ?layer=mesosphere
  &altitude_min=50000
  &altitude_max=85000
  &interval=1h
  &format=json

Authorization: Bearer {your_api_key}

Response

{
  "layer": "mesosphere",
  "readings": 14208,
  "time_range": "2026-03-16T00:00:00Z/PT1H",
  "nodes_reporting": 312,
  "data": [...]
}

7.0

Contributing

MIRIS is an open-source project and welcomes contributions from researchers, engineers, and atmospheric scientists worldwide. Contributions can take several forms:

Sensor Node Hosting — Deploy a sensor node at your institution to expand network coverage
Algorithm Development — Improve atmospheric models and data processing pipelines
Documentation — Help maintain and expand this documentation
Data Analysis — Use MIRIS data in your research and share findings

Clone Repository

git clone https://github.com/miris-project/miris-core.git
cd miris-core
npm install
npm run dev