# Как работает сеть

## Коротко

Сеть работает как хорошо организованное расписание. Портал заранее знает, когда
какой спутник пролетит над каждой станцией, и раздаёт станциям задания: «в
14:32 слушай такой-то спутник на такой-то частоте». Станция в нужный момент
слушает, записывает услышанное и отправляет запись обратно на портал. Там
результат проверяют и выкладывают для всех.

Проследим путь одного {term}`наблюдения <Наблюдение>` от начала до конца.

## 1. Портал считает пролёты

Портал знает координаты каждой станции и орбиту каждого спутника — её описывают
две строки чисел, {term}`TLE`. По ним он вычисляет, когда спутник поднимется над
{term}`горизонтом станции <Горизонт станции>`, когда пройдёт выше всего и когда
скроется. Этот отрезок времени называется {term}`пролётом <Пролёт>`.

Подробнее об орбитах — на странице [](orbits.md).

## 2. Наблюдение попадает в расписание

Из пролёта делают наблюдение: «станция N слушает спутник S с 14:32 до 14:41 на
частоте 436,5 МГц». Наблюдение можно запланировать вручную на портале, а может
{term}`автопланировщик <Автопланировщик>`, который сам заполняет расписание
станций подходящими пролётами.

Портал учитывает, какие антенны стоят на станции: спутник, который передаёт на
частоте, недоступной антеннам станции, ей не предложат.

## 3. Станция слушает

Программа станции — {term}`клиент <Клиент>` — получает расписание с портала и
к началу наблюдения готовит приёмник. Во время пролёта она:

- подстраивает частоту приёма, потому что из-за
  {term}`эффекта Доплера <Эффект Доплера>` частота спутника «плывёт»;
- если есть {term}`поворотное устройство <Поворотное устройство>`, поворачивает
  антенну вслед за спутником;
- записывает звук, рисует {term}`водопад <Водопад>` и пытается выделить из
  сигнала цифровые {term}`кадры <Кадр>`.

## 4. Результат уходит на портал

Когда пролёт закончился, станция отправляет на портал всё, что получила:
аудиозапись, водопад и кадры. Портал оценивает наблюдение: если пришли
цифровые кадры — приём удался, если не пришло вообще ничего — наблюдение
неудачное. Операторы
могут посмотреть водопад и отметить результат вручную — это называется
{term}`вычиткой <Вычитка>`.

## 5. Данные идут дальше

Принятые кадры портал пропускает через {term}`декодер <Декодер>` и превращает в
понятные значения: температуру, напряжение, состояние систем спутника.
Картинки со спутников попадают в галерею. Создатели спутника могут подписаться
на данные своего аппарата и получать новые кадры сразу после приёма.

## Схема

```text
       Портал sonik.space
   считает пролёты, составляет расписание,
   хранит и показывает результаты
        │                       ▲
        │ задание:              │ результат:
        │ что, когда,           │ звук, водопад,
        │ на какой частоте      │ кадры
        ▼                       │
       Станция
   антенна → приёмник → компьютер с клиентом
        ▲
        │ радиосигнал
        │
       Спутник
```

Всё происходит без участия человека: станция может неделями работать сама,
а владелец только заглядывает на портал посмотреть результаты.

## Хочу подробнее

- [Жизненный цикл наблюдения](https://sonik.space/docs/network/observations.html) —
  то же самое языком портала.
- [Как клиент ведёт наблюдение](https://sonik.space/docs/flowgraphs/overview.html) —
  что происходит на станции во время пролёта.
- [Планирование наблюдений](https://sonik.space/docs/network/scheduling.html) и
  [оценка наблюдений](https://sonik.space/docs/network/rating.html).