SimTX API/Packets/StationImpactList
Appearance
| Frame | ServerFrame, field 63
|
|---|---|
| Member | station_impacts
|
| Direction | Server → client |
| Session | Moderation |
| Roles | ROLE_MODERATION.
|
| Permission | None |
| Answers | ListStations |
| Defined in | control.proto
|
StationImpactList is an interference analysis for moderators. On a moderation session the server sends it right after the StationList that answers a ListStations. It ranks transmitters by how much they affect receivers, which helps to find jammers and badly configured stations.
Definition
message StationImpactList { int64 request_id = 1; repeated TransmitterImpact impacts = 2; }
Fields
| # | Field | Type | Description |
|---|---|---|---|
| 1 | request_id |
int64 |
The ListStations request_id.
|
| 2 | impacts |
repeated TransmitterImpact |
One entry per transmitter, highest impact first. |
TransmitterImpact
message TransmitterImpact {
bytes session_id = 1;
string callsign = 2;
string address = 3;
double frequency_hz = 4;
string modulation = 5; // string enum (common.proto)
float power_watts = 6;
float occupied_bandwidth_hz = 7;
float impact_score = 8;
int32 affected_receivers = 9;
float nearest_receiver_km = 10;
string reasons = 11;
}
| # | Field | Type | Description |
|---|---|---|---|
| 1 | session_id |
bytes |
16-byte transmission id. |
| 2 | callsign |
string |
Callsign. |
| 3 | address |
string |
Client address. |
| 4 | frequency_hz |
double |
Carrier frequency, Hz. |
| 5 | modulation |
string |
Modulation name. |
| 6 | power_watts |
float |
Power, W. |
| 7 | occupied_bandwidth_hz |
float |
Occupied bandwidth, Hz. |
| 8 | impact_score |
float |
Largest spectral overlap with any receiver's passband, percent (0 to 100). The list is sorted by this value, highest first. |
| 9 | affected_receivers |
int32 |
Receivers whose passband the transmitter overlaps significantly. |
| 10 | nearest_receiver_km |
float |
Great-circle distance to the nearest receiver, km. NaN when there are no receivers. |
| 11 | reasons |
string |
Human-readable notes, such as an overdriven amplifier. |