WAP-Tool 0.1.0__py3-none-any.whl

wap/static/base.css

@@ -0,0 +1,305 @@
+/*
+ * style.css
+ * Copyright © 2026 Fred W6BSD
+ *
+ * Distributed under terms of the BSD 3-Clause license.
+ */
+body {
+	background-color: #fdfdff;
+	color: #333;
+  display: flex;
+  flex-direction: column;
+  font-family: -apple-system, BlinkMacSystemFont, Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+  font-size: 16px;
+  line-height: 1.6em;
+  margin: 0;
+  min-height: 100vh;
+  padding: 0;
+}
+
+header {
+  background: linear-gradient(135deg, #0a2342, #1c3d73);
+  color: #DAF7A6;
+  font-family: Arial, sans-serif;
+  padding: 1rem 0;
+  text-align: center;
+}
+
+header h1 {
+  margin: 1em 0;
+  text-align: center;
+  font-size: 3rem;
+}
+
+header ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+
+  display: flex;
+  justify-content: center;   /* center horizontally */
+  gap: 1.5rem;               /* spacing between items */
+}
+
+header li a {
+  color: #fff;
+  background: #335;
+  text-decoration: none;
+  padding: 0.5rem 1rem;
+  border-radius: 4px;
+  border: 1px solid #777;
+
+}
+
+header ul a:hover,
+header ul a:focus {
+  background: #337;
+}
+
+header ul a[aria-current="page"] {
+  background: #686;
+}
+
+main {
+  flex: 1;
+  padding: 3em;
+  padding-bottom: 5em;
+  border-left: 2px solid #ccc;
+  border-right: 2px solid #ccc;
+  margin: 0 auto;
+  width: 900px;
+}
+
+main h2 {
+  border-top: 4px solid #f80;
+  color: #512E5F;
+  font-size: 2em;
+  padding-right: 1.7em;
+  padding-top: .25em;
+  text-align: left;
+}
+
+main h3 {
+  color: #512E5F;
+  background-color: #ddeeff;
+  padding: 1em 0 .5em .5em;
+  border-bottom: 3px solid #f80;
+  font-family: Helvetica, sans-serif;
+  font-weight: Bold;
+  margin-top: 2em;
+}
+
+main .container {
+  margin-left: 2.5em;
+  margin-top: 2.5em;
+}
+
+main a {
+  text-decoration: none;
+  font-weight: bold;
+}
+
+main a:hover {
+  text-decoration: underline;
+}
+
+main img {
+  border-radius: 6px;
+  width: 100%;
+}
+
+table.power {
+  width: 50%;
+  font-family: Arial;
+  border-collapse: collapse;
+  margin: 20px auto;
+  background: white;
+  border-radius: 5px;
+  overflow: hidden;
+  box-shadow: 0 1px 3px rgba(0,0,0,0.5);
+}
+
+.power th {
+  background-color: #4a90e2;
+  color: white;
+  padding: 6px;
+  text-align: center;
+  font-weight: 600;
+  border: 1px solid #777;
+}
+
+.power td {
+  padding: 6px 12px;
+  border-bottom: 1px solid #eee;
+  text-align: right;
+  border: 1px solid #ddd;
+}
+
+.power tr:nth-child(even) {
+  background-color: #f8f9fa;
+}
+
+.power tr:hover {
+  background-color: #e3f2fd;
+}
+
+.power tr:last-child td {
+  border-bottom: none;
+}
+
+.form-container {
+    background-color: white;
+    padding: 20px;
+    border-radius: 8px;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+    width: 100%;
+    max-width: 600px;
+    margin: 2em auto;
+}
+
+.form-container h2 {
+    all: unset;
+    font-family: 'Arial', sans-serif;
+    font-size: 24px;
+    font-weight: 600;
+    color: #0a2342;
+    text-align: center;
+    display: block;
+}
+
+.form-container hr {
+  border: 0;
+  border-top: 1px solid #0a2342;
+  margin: 1.5rem 0;
+}
+
+.form-group {
+    margin-bottom: 20px;
+}
+
+.form-group label {
+  font-weight: bold;
+  display: block;
+  margin-bottom: 8px;
+  color: #555;
+  font-weight: 600;
+}
+
+.form-group input,
+.form-group textarea {
+    width: 100%;
+    padding: 12px;
+    border: 1px solid #ddd;
+    border-radius: 6px;
+    font-size: 16px;
+    box-sizing: border-box;
+}
+
+.form-group textarea {
+    height: 120px;
+    resize: vertical;
+}
+
+button[type="submit"] {
+    background-color: #4CAF50;
+    color: white;
+    border: none;
+    padding: 12px 20px;
+    border-radius: 6px;
+    cursor: pointer;
+    font-size: 16px;
+    width: 100%;
+    transition: background-color 0.3s;
+}
+
+button[type="submit"]:hover {
+    background-color: #45a049;
+}
+
+select {
+  padding: 10px 15px;
+  border: 1px solid #ddd;
+  border-radius: 8px;
+  background-color: white;
+  font-size: 16px;
+  color: #333;
+  width: 200px;
+  height: 45px;
+  appearance: none;
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  cursor: pointer;
+}
+
+footer {
+  font-size: .8em;
+	background-color: #322;
+	text-align: right;
+  color: #cccccc;
+  line-height: 1.1rem;
+  margin-top: 0em;
+  padding: 1em 4em;
+}
+
+footer a {
+  color: yellow;
+  text-decoration: none;
+}
+
+footer a:hover {
+  text-decoration: underline;
+}
+
+.result {
+  background: #f8fafc;
+  border: 1px solid #e2e8f0;
+  border-radius: 6px;
+  padding: 16px;
+  margin: 20px 0;
+}
+
+.error,
+.status {
+  border-radius: 8px;
+  padding: 1.5em 2em;
+  margin: 2em 3em;
+}
+
+.status {
+  background-color: #dfd;
+  border: 3.5px solid #daa;
+}
+
+.error {
+  color: #fff;
+  font-weight: bold;
+  background-color: #f44;
+  border: 3.5px solid #faa;
+}
+
+.center {
+  text-align: center;
+}
+
+.band-pill-group input[type=checkbox] { display: none; }
+
+.band-pill-group label {
+  cursor: pointer;
+  padding: 2px 10px;
+  border-radius: 999px;
+  border: 1px solid #ccc;
+  font-size: 12px;
+  color: #333;
+  background-color: #efe;
+  user-select: none;
+  display: inline-block;
+  font-weight: 500;
+  margin-bottom: 0;
+}
+
+.band-pill-group input[type=checkbox]:checked + label {
+  background: #dbeaff;
+  color: #55d;
+  border-color: #55d;
+  font-weight: 500;
+}

wap/static/perf.css

@@ -0,0 +1,73 @@
+/*
+ * perf.css
+ * Copyright © 2026 Fred W6BSD
+ *
+ * Distributed under terms of the BSD 3-Clause license.
+ */
+
+.legend {
+  line-height: 1.6em;
+  padding-left: 2em;
+  padding-right: 2em;
+  margin-bottom: 1.5em;
+}
+
+.note {
+  background-color: #eeffee;
+  border-radius: 8px;
+  padding: 1.5em 2em;
+  margin: 2em 3em;
+  border: 3.5px solid #ada;
+}
+
+#stats {
+  font-family: "Avenir Next", "Avenir", Arial, Helvetica, Roboto, sans-serif;
+  margin: 3rem 6rem;
+  border: 1px solid #aaa;
+  border-radius: 8px;
+  background-color: #ddd;
+}
+
+#stats .title {
+  font-weight: bold;
+  padding: .5em;
+  border-bottom: 1px solid #aba;
+}
+
+#stats ul {
+  border-radius: 0 0 8px 8px;
+  background-color: #eee;
+  list-style: none;
+  padding: 1.2rem;
+  margin: 0;
+}
+
+#stats li {
+  padding: 2px 0;
+  color: #333;
+}
+
+table.results {
+  margin-left: 2em;
+  border-collapse: collapse;
+}
+
+.results td, .results th {
+  padding: 5px 12px;
+  border: 1px solid #ccc;
+}
+
+.warning {
+  margin-left: 1em;
+  padding: 0 1em;
+  font-weight: bold;
+  background-color: red;
+  color: white;
+}
+.dim {
+  color: #f99;
+}
+.highlight {
+  color: #66c;
+  font-weight: 600;
+}

wap/templates/perf.html

@@ -0,0 +1,296 @@
+{% extends "perfbase.html" %}
+
+{% block title %}{{ title }}{% endblock %}
+
+{% block content %}
+
+<div class="note">
+    Because the plots are built from real reception reports rather than models, they provides a
+    <b>practical view of how the antenna performs</b> on the air, helping to compare bands, antenna
+    configurations, and installation changes under real propagation conditions.
+</div>
+
+<div id="stats">
+    <div class="title">Antenna performance calculated by <a href="https://wspr.bsdworld.org/">wspr.bsdword.org</a> using <a href="https://www.wsprnet.org/drupal/wsprnet/map">WSPR data</a>.</div>
+    <ul>
+        <li>Report date: <b>{{ date.strftime('%Y-%m-%d %H:%M') }} UTC</b></li>
+        <li>Station call sign: <b>{{ call }}</b></li>
+        <li>Grid locator: <b>{{ data.iloc[0]['tx_loc'] }}</b></li>
+        {% if antenna %}
+        <li>Antenna: <b>{{ antenna }}</b></li>
+        {% endif %}
+        <li>WSPR data:
+            <b>from: {{ start.strftime('%Y-%m-%d %H:%M') }}
+                <span style="display: inline-block; width: 10px;"></span>
+                to: {{ end.strftime('%Y-%m-%d %H:%M') }}</b>
+        </li>
+        <li>
+            {% if data.shape[0] < 150 %}
+            Data processed: <b>{{ data.shape[0] }}</b> <span class="warning">You don't have enough spots</span>
+            {% else %}
+            Data processed: <b>{{ data.shape[0] }}</b>
+            {% endif %}
+        </li>
+        <li>Transmit power anounced:
+            {% if data.power.min() == data.power.max() %}
+            <b>{{ data.power.mean() | int }}</b> dBm <i>({{ "{:.3f}".format(10**((data.power.mean() - 30) / 10)) }}Watt)</i>
+            {% else %}
+            Min: <b>{{ data.power.min() | int }}</b> dBm -
+            Avg: <b>{{ data.power.mean() | int }}</b> dBm <i>({{ "{:.3f}".format(10**((data.power.mean() - 30) / 10)) }}W)</i> -
+            Max: <b>{{ data.power.max() | int }}</b> dBm
+            {% endif %}
+        </li>
+        <li>Max distance: <b>{{ data.distance.max() }}</b> km</li>
+        <li>Band tested:
+            {% if data.band.unique() | length > 1 %}
+            <table class="results">
+                <tr><th>Band</th><th>Spots</th><th>Comment</th></tr>
+                {% set errors = [] %}
+                {% for b in data.band.unique() | sort %}
+                {% set count = data[data.band == b]['id'].count() %}
+                <tr>
+                    <td style="text-align: right;">{{ b }}</td>
+                    <td style="text-align: left;">{{ count }}</td>
+                    <td style="text-align: left;">
+                    {% if count < 100 %}
+                        <span class="dim">Not enough spots for an accurate assessment</span>
+                    {% else %}
+                    <span class="highlight">OK</span>
+                    {% endif %}
+                    </td>
+                </tr>
+                {% if count < 100 %}{{ errors.append(1) or "" }}{% endif %}
+                {% endfor %}
+            </table>
+            {% else %}
+            {% for b in data.band.unique() | sort %}
+            <b>{{ b }}</b>{% if not loop.last %}, {% endif %}
+            {% endfor %}
+            {% endif %}
+        </li>
+    </ul>
+</div>
+
+{% if errors %}
+<div class="warning">
+    Remove bands with insufficient spots before generating the report.
+</div>
+{% endif %}
+
+{% if "azimuth_scatter" in graphs %}
+<div class="container">
+    <h2 id="azimuth_scatter">Distance and density</h2>
+    <div class="legend">
+        <p>This polar scatter plot shows the <b>75th percentile</b> of WSPR spot distances by azimuth from the transmitting station. Each point marks the distance below which 75% of WSPR reports were received in that direction. The angle shows the receiving station's direction, and the radius shows this distance.</p>
+
+        <p>Clusters of points in certain directions show where the antenna system and propagation support stronger and more reliable signals. On the other hand, gaps or shorter distances might mean there are directional nulls, local obstacles, ground effects near the antenna, <b>or not many receiving stations</b> in those directions.</p>
+    </div>
+    <img src="{{ graphs["azimuth_scatter"][1] }}" alt="{{ graphs["azimuth_scatter"][0] }}">
+</div>
+{% endif %}
+
+{% if "radiation_pattern" in graphs %}
+<div class="container">
+    <h2 id="radiation_pattern">Radiation pattern</h2>
+    <div class="legend">
+        <p>This polar plot shows the <b>75th percentile</b> of WSPR reception distance by azimuth, which is the range where contacts are almost always possible. In each direction, the line marks how far a reliable signal can reach. Lobes in some directions show where the antenna and propagation support stronger, more reliable signals. Nulls indicate obstacles, ground effects, or just fewer receiving stations in those directions. This approach makes it easy to compare how well the antenna works in different directions and on different bands.</p>
+
+        <p>When the plot shows multiple bands, the differences in shape and size reveal how the antenna and propagation change with frequency. This makes it easier to compare how well the antenna works in different directions and how far it can reach on each band during real operating conditions.</p>
+    </div>
+    <img src="{{ graphs["radiation_pattern"][1] }}" alt="{{ graphs["radiation_pattern"][0] }}">
+</div>
+{% endif %}
+
+{% if "band_distance" in graphs %}
+<div class="container">
+    <h2 id="band_distance">Distance / band</h2>
+    <div class="legend">
+        <p>This <a href="javascript:void(0);" onclick="show_help('boxplot');" style="color: #0066cc; cursor: help; text-decoration: underline dashed;">boxplot</a> summarizes the distribution of WSPR reception distances for each band.</p>
+
+        <p>The median and quartiles indicate the typical propagation range and its variability, while the whiskers and outliers represent less common short- and long-distance paths. Comparing bands shows how propagation and antenna effectiveness vary with frequency, offering a concise view of which bands provide consistent coverage or occasional long-distance reach.</p>
+        <p><b>Extreme outliers have been removed</b> to more accurately reflect antenna performance.</p>
+    </div>
+    <img src="{{ graphs["band_distance"][1] }}" alt="{{ graphs["band_distance"][0] }}">
+</div>
+{% endif %}
+
+{% if "hours_distance" in graphs %}
+<div class="container">
+    <h2 id="hours_distance">Distance / hour</h2>
+    <div class="legend">
+        <p>This <a href="javascript:void(0);" onclick="show_help('boxplot');" style="color: #0066cc; cursor: help; text-decoration: underline dashed;">boxplot</a> shows the distribution of WSPR reception distances across all bands by hour of day.</p>
+
+        <p>The median and spread show how the propagation range changes throughout the day, with longer distances at night and shorter distances during the day. Aggregating multiple spots allows the plot to highlight when each band-antenna combination is most effective for reaching distant receivers. Extreme outliers have been removed to improve the accuracy of antenna performance assessment.</p>
+    </div>
+    <img src="{{ graphs["hours_distance"][1] }}" alt="{{ graphs["hours_distance"][0] }}">
+</div>
+{% endif %}
+
+{% if "plot_snr_vs_distance" in graphs %}
+<div class="container">
+    <h2 id="plot_snr_vs_distance">Signal strength vs distance</h2>
+    <div class="legend">
+        <p>This graph shows how signal strength (SNR) changes with distance.</p>
+
+        <p>The median SNR shows the typical signal strength you can expect at each distance, and it drops as distance increases. The 10th and 90th percentile curves show the usual range of performance. As the gap between these percentiles widens at longer distances, it means there is more variation in long-path propagation.</p>
+    </div>
+    <img src="{{ graphs["plot_snr_vs_distance"][1] }}" alt="{{ graphs["plot_snr_vs_distance"][0] }}">
+</div>
+{% endif %}
+
+{% if "snr_distance_errorbar" in graphs %}
+<div class="container">
+    <h2 id="snr_distance">SNR vs distance</h2>
+    <div class="legend">
+        <p>The vertical bars show the typical signal strength (SNR) at each distance. The light blue line shows how many spots occur at each distance, as shown on the right-side axis.</p>
+
+        <p>The graph below shows how signal strength changes with distance. Signal-to-noise ratio (SNR) measures how clear the signal is compared to background noise, and it usually drops as you move farther away. A DX antenna can help keep the signal stronger over longer distances.</p>
+    </div>
+    <img src="{{ graphs["snr_distance_errorbar"][1] }}" alt="{{ graphs["snr_distance_errorbar"][0] }}">
+</div>
+{% endif %}
+
+{% if "takeoff_angle" in graphs %}
+<div class="container">
+    <h2 id="takeoff_angle">Estimated takeoff angle</h2>
+    <div class="legend">
+      <p>The chart shows the estimated antenna <a href="javascript:void(0);" onclick="show_help('takeoff');" style="color: #0066cc; cursor: help; text-decoration: underline dashed;">takeoff angles</a> ranges for each frequency band, based on contact distances. Each arc represents a band and highlights the range of angles linked to the most successful contacts.</p>
+
+      <p>Higher takeoff angles lead to shorter, more local contacts, while lower angles are linked to longer-distance (DX) paths. Bands with arcs closer to 0° have more low-angle radiation, which is usually better for long-distance communication.</p>
+    </div>
+    <img src="{{ graphs["takeoff_angle"][1] }}" alt="{{ graphs["takeoff_angle"][0] }}">
+</div>
+{% endif %}
+
+{% if map %}
+<div class="container">
+    <h2 id="graph-7}">Spot map</h2>
+    <div class="legend">
+        <p>This interactive map shows all the information for each spot.</p>
+    </div>
+    {{ map|safe }}
+</div>
+{% endif %}
+
+<!-- popup help -->
+<div id="boxplot" class="modal" style="display: none;">
+    <div class="modal-card">
+        <span class="close">&times;</span>
+        <div class="help_title">Understanding Boxplots</div>
+        <div class="modal-content">
+            <p>A boxplot is a visual tool that displays how data is distributed. It shows the middle 50% of the data in a box, with the median marked by a line inside.</p>
+            <p>The ends of the box represent the 25th and 75th percentiles, while whiskers extend to the smallest and largest values. Outliers appear as individual points beyond the whiskers.</p>
+            <p>Boxplot on <a href="https://en.wikipedia.org/wiki/Box_plot" target="wikipedia">Wikipedia</a>.
+        </div>
+    </div>
+</div>
+
+<div id="takeoff" class="modal" style="display: none;">
+    <div class="modal-card">
+        <span class="close">&times;</span>
+        <div class="help_title">Understanding Takeoff Angle</div>
+        <div class="modal-content">
+            <p><b>Median takeoff angle decreases with increasing band frequency.</b></p>
+            <ul>
+                <li>Higher angles (40-70°) optimal for regional/NVIS propagation</li>
+                <li>Moderate angles (10-45°) supporting mixed propagation modes</li>
+                <li>Lower angles (0-20°) enabling long-distance multi-hop DX</li>
+            </ul>
+        </div>
+    </div>
+</div>
+
+<style>
+/* 1. Backdrop Overlay */
+.modal {
+  display: none;
+  position: fixed;
+  z-index: 1000;
+  left: 0;
+  top: 0;
+  width: 100%;
+  height: 100%;
+  background-color: rgba(0, 0, 0, 0.5); /* Dimmed background */
+  backdrop-filter: blur(4px); /* Modern blur effect */
+  display: flex; /* Centers the content easily */
+  align-items: center;
+  justify-content: center;
+}
+
+/* 2. The Modal Card */
+.modal-card {
+  background-color: #ffffff;
+  padding: 2rem;
+  border-radius: 12px;
+  box-shadow: 0 10px 25px rgba(0, 0, 0, 0.2);
+  width: 90%;
+  max-width: 550px;
+  position: relative;
+  animation: modalFadeIn 0.3s ease-out;
+}
+
+/* 3. Typography & Spacing */
+.help_title {
+  margin-top: 0;
+  color: #333;
+  font-family: sans-serif;
+  font-size: 1.5rem;
+  color: #070;
+}
+
+.modal-content {
+  line-height: 1.6;
+  color: #555;
+  font-family: sans-serif;
+}
+
+/* 4. Close Button */
+.close {
+  position: absolute;
+  right: 20px;
+  top: 15px;
+  font-size: 1.8rem;
+  color: #999;
+  cursor: pointer;
+  transition: color 0.2s;
+}
+
+.close:hover {
+  color: #333;
+}
+
+/* 5. Simple Entrance Animation */
+@keyframes modalFadeIn {
+  from { opacity: 0; transform: translateY(-20px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+</style>
+
+<script>
+window.show_help = function(elemname) {
+  const modal = document.getElementById(elemname);
+  if (!modal) {
+    console.error("Modal element not found");
+    return;
+  }
+
+  modal.style.display = "flex";
+
+  const handleClosing = (event) => {
+    const isEscape = event.key === 'Escape';
+    const isClickOutside = event.target === modal;
+    const isCloseBtn = event.target.classList.contains('close');
+
+    if (isEscape || isClickOutside || isCloseBtn) {
+      modal.style.display = "none";
+      document.removeEventListener('keyup', handleClosing);
+      modal.removeEventListener('click', handleClosing);
+    }
+  };
+
+  document.addEventListener('keyup', handleClosing);
+  modal.addEventListener('click', handleClosing);
+};
+</script>
+
+{% endblock %}