adif2map 0.0.1__py3-none-any.whl

adif2map/__init__.py

@@ -0,0 +1,8 @@
+#! /usr/bin/env python3
+# vim:fenc=utf-8
+#
+# Copyright © 2026 fred <github-fred@hidzz.com>
+#
+# Distributed under terms of the BSD 3-Clause license.
+
+__version__ = '0.0.1'

adif2map/adif2map.py

@@ -0,0 +1,357 @@
+#! /usr/bin/env python3
+# vim:fenc=utf-8
+#
+# Copyright © 2026 fred <github-fred@hidzz.com>
+#
+# Distributed under terms of the BSD 3-Clause license.
+
+import argparse
+import logging
+import os
+import re
+import sys
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from pathlib import Path
+
+import adif_parser
+import dxcty_parser
+import folium
+import numpy as np
+import pandas as pd
+import pyproj
+from folium.plugins import Geocoder, HeatMap, MarkerCluster
+from geo_ham import ddm2decimal, grid2latlon
+from jinja2 import Environment, FileSystemLoader
+
+__all__ = ["main", "load_adif", "render_html"]
+
+logger = logging.getLogger("analog")
+
+KEEP_FIELDS = [
+  "CALL", "BAND", "MODE", "COUNTRY", "LAT", "LON",
+  "GRIDSQUARE", "QSO_DATE", "TIME_ON", "TX_PWR",
+]
+
+NEEDED_FIELDS = [
+  "CALL", "BAND", "MODE", "GRIDSQUARE", "QSO_DATE",
+]
+
+MAP_MODES = {
+  'USB': 'SSB',
+  'LSB': 'SSB',
+  'BPSK31': 'PSK',
+  'BPSK64': 'PSK',
+  'FELDHELL': 'HELL',
+  'MFSK': 'FT4',
+  'OLIVIA-8/250': 'OLIVIA',
+  'OLIVIA-8/500': 'OLIVIA',
+  'QPSK': 'PSK',
+  'TOR': 'THOR',
+  'THORMICRO': 'THOR',
+  'DATA-FM': 'FM',
+  'DIGITALVOICE': 'DV',
+}
+
+GRADIENT = {
+    0.0: '#00ffff',  # Cyan - lowest density
+    0.2: '#0000ff',  # Blue
+    0.4: '#00ff00',  # Green
+    0.6: '#ffff00',  # Yellow
+    0.8: '#ff8800',  # Orange
+    1.0: '#ff0000'   # Red - highest density
+}
+
+
+@dataclass(slots=True)
+class Contact:
+  # pylint: disable=too-many-instance-attributes
+  call: str
+  band: float
+  mode: str
+  country: str
+  lat: float
+  lon: float
+  gridsquare: str
+  tx_pwr: float
+  date: datetime
+  distance: float
+
+  def __str__(self) -> str:
+    lines = [
+      f'<big><a href="https://qrz.com/db/{self.call}" target="_qrz">'
+      f'<b>{self.call}</b></a></big>',
+    ]
+
+    def add(label: str, value) -> None:
+      if value:
+        lines.append(f"<b>{label}</b>:&nbsp;{value}")
+
+    add("Country", self.country.replace(" ", "&nbsp;") if self.country else None)
+    add("Mode", self.mode)
+    add("Date", self.date.strftime("%Y-%m-%d"))
+    add("Time", self.date.strftime("%H:%M"))
+    add("Band", self.band)
+
+    if pd.notna(self.distance):
+      add("Distance", f"{self.distance / 1000:.1f}km")
+
+    add("TX Power", f"{self.tx_pwr}W" if self.tx_pwr else None)
+    return re.sub(r' +|\n +', replace_nl, "\n".join(lines).strip())
+
+
+class DXE:
+  # pylint: disable=too-few-public-methods
+  _dxe = dxcty_parser.load_cty()
+
+  @staticmethod
+  def lookup(call):
+    dxe = DXE._dxe.lookup(call)
+    return dxe.entity if dxe else None
+
+
+def replace_nl(match: re.Match) -> str:
+  if match.group().startswith('\n'):
+    return '<br>'
+  return ' '
+
+
+def display_markers(wmap: folium.FeatureGroup, contacts: pd.DataFrame) -> None:
+  marker_cluster = MarkerCluster().add_to(wmap)
+  for _, row in contacts.iterrows():
+    contact = Contact(*row.values)
+    match contact.mode:
+      case 'FT8' | 'FT4' | 'JT65':
+        color = 'orange'
+        icon = 'computer-mouse'
+      case 'CW':
+        color = 'gray'
+        icon = 'fingerprint'
+      case 'SSB':
+        color = 'blue'
+        icon = 'headset'
+      case 'RTTY':
+        color = 'darkblue'
+        icon = 'tty'
+      case 'PSK' | 'THOR' | 'OLIVIA' | 'CONTESTI':
+        color = 'cadetblue'
+        icon = 'keyboard'
+      case _:
+        color = 'beige'
+        icon = 'tower-broadcast'
+
+    try:
+      folium.Marker(
+        location=[contact.lat, contact.lon],
+        icon=folium.Icon(color=color, prefix='fa', icon=icon),
+        popup=str(contact)
+      ).add_to(marker_cluster)
+    except ValueError:
+      logger.error('ValueError (%f, %f) %s %s', contact.lat, contact.lon,
+                   contact.call, contact.mode)
+
+
+def get_info(row: pd.Series) -> pd.Series:
+  dxe = DXE.lookup(row['CALL'])
+  if dxe is None:
+    row['CALL'] = None
+    return row
+
+  try:
+    if pd.notna(row['LAT']) and pd.notna(row['LON']):
+      row['LAT'] = ddm2decimal(row['LAT'])
+      row['LON'] = ddm2decimal(row['LON'])
+    elif pd.notna(row.get('GRIDSQUARE', np.nan)):
+      row['LAT'], row['LON'] = grid2latlon(row.GRIDSQUARE)
+    else:
+      row['LAT'], row['LON'] = dxe.latitude, dxe.longitude * -1
+  except (TypeError, ValueError):
+    logger.warning('Cannot calculate the gps coords for: %s', row['CALL'])
+    row['CALL'] = None
+    return row
+
+  if not row.get('COUNTRY'):
+    row['COUNTRY'] = dxe.country
+
+  return row
+
+
+def load_adif(filename: Path) -> pd.DataFrame:
+  """ Load the adif file"""
+
+  with filename.open('r', encoding='utf-8', errors='replace') as fd:
+    adif = adif_parser.ParseADIF(fd)
+
+  data = pd.DataFrame(adif.contacts)
+  missing_fields = list(set(NEEDED_FIELDS) - set(data.columns))
+
+  if missing_fields:
+    raise ValueError(
+      f'The following fields are missing from the ADIF file: {", ".join(sorted(missing_fields))}'
+    )
+
+  keep_fields = list(set(data.columns) & set(KEEP_FIELDS))
+  data = data[keep_fields]
+
+  data[missing_fields] = np.nan
+  return data.copy()
+
+
+def normalize_data(data: pd.DataFrame, location: tuple[float, float]) -> pd.DataFrame:
+  """ Gets an adif object, cleanup the data. Normalize the data and
+  calculated the distance and azimuth """
+
+  data['CALL'] = data.CALL.astype(str)
+  data['MODE'] = data.MODE.replace(MAP_MODES)
+  data['MODE'] = data.MODE.replace({k: 'Other' for k in data.MODE.value_counts().index[9:]})
+  data['QSO_DATE'] = data['QSO_DATE'].fillna('19710101')
+  data['TIME_ON'] = data['TIME_ON'].fillna('000000')
+  data['START_TIME'] = pd.to_datetime(data[['QSO_DATE', 'TIME_ON']].agg(' '.join, axis=1))
+
+  if 'COUNTRY' not in data.columns:
+    data['COUNTRY'] = np.nan
+  data['COUNTRY'] = data['COUNTRY'].fillna('')
+
+  if 'TIME_ON' not in data.columns:
+    data['TIME_ON'] = '000000'
+
+  if 'LAT' not in data.columns:
+    data['LAT'] = np.nan
+
+  if 'LON' not in data.columns:
+    data['LON'] = np.nan
+
+  data = data.apply(get_info, axis=1)
+  data = data[~data.CALL.isnull()]
+  if data.empty:
+    raise ValueError('No valid records')
+
+  data['LAT'] = pd.to_numeric(data['LAT'])
+  data['LON'] = pd.to_numeric(data['LON'])
+
+  if 'TX_PWR' not in data.columns:
+    data['TX_PWR'] = np.nan
+  data['TX_PWR'] = data['TX_PWR'].fillna(0.0)
+
+  # calculate distance and azimuth
+  geod = pyproj.Geod(ellps='WGS84')
+  orig = np.full((data.shape[0], 2), location)
+  data['LAT'] = pd.to_numeric(data['LAT'], errors='coerce').fillna(0).astype('float64')
+  data['LON'] = pd.to_numeric(data['LON'], errors='coerce').fillna(0).astype('float64')
+  distance = np.zeros(data.shape[0])
+  distance = np.array(geod.inv(orig[:, 1], orig[:, 0],  data.LON.values, data.LAT.values))
+  data[['AZIMUTH', 'INV', 'DISTANCE']] = np.transpose(distance)
+  data = data.reset_index(drop=True)
+
+  return data.copy()
+
+
+def plot_map(data: pd.DataFrame, call: str, location: tuple[float, float]) -> str:
+
+  attr = ('&copy; <a href="https://www.OpenStreetMap.org/copyright">OpenStreetMap</a> '
+          'contributors Fred <a href="https://qrz.com/db/W6BSD">W6BSD</a>')
+
+  wmap = folium.Map(location=location, zoom_start=3, tiles=None)
+
+  folium.TileLayer(
+    tiles='https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+    name='OpenStreet Map',
+    attr=attr
+  ).add_to(wmap)
+
+  Geocoder(add_marker=False, zoom=8, provider="photon").add_to(wmap)
+  folium.Marker(location, popup=f'<b><i>Calling Station: {call}</i></b>'.replace(' ', '&nbsp'),
+                icon=folium.Icon(prefix='fa', icon='walkie-talkie', color='red')).add_to(wmap)
+
+  modes = (
+    data['MODE']
+    .value_counts()
+    .reset_index()
+    .sort_values('MODE')
+  )
+
+  for row in modes.itertuples():
+    layer = folium.FeatureGroup(name=f'{row.MODE} ({row.count})')
+    c_mode = data[data.MODE == row.MODE]
+    HeatMap(
+      data=c_mode[['LAT', 'LON']],
+      radius=25, blur=20, min_opacity=0.2,
+      max_zoom=15, gradient=GRADIENT,
+    ).add_to(layer)
+
+    display_markers(layer, c_mode)
+    layer.add_to(wmap)
+
+  folium.LayerControl().add_to(wmap)
+  return wmap._repr_html_()  # pylint: disable=protected-access
+
+
+def render_html(data: pd.DataFrame, call: str, location: tuple[float, float], output: Path):
+  contacts = data[
+    ["CALL", "BAND", "MODE", "COUNTRY", "LAT", "LON", "GRIDSQUARE", "TX_PWR",
+     "START_TIME", "DISTANCE"]
+  ]
+  contacts = contacts.dropna().reset_index(drop=True)
+
+  template_dir = Path(__file__).with_name('templates')
+  static_dir = Path(__file__).with_name('static')
+  env = Environment(loader=FileSystemLoader([template_dir, static_dir]))
+
+  template = env.get_template('map.html')
+  start = contacts.START_TIME.min()
+  end = contacts.START_TIME.max()
+
+  pmap = plot_map(contacts, call, location)
+  title = f'QSOs for {call}'
+
+  content = template.render(call=call, title=title, start=start, end=end,
+                            count=contacts.shape[0], map=pmap, date=datetime.now(UTC))
+
+  with output.open(mode="w", encoding="utf-8") as fout:
+    fout.write(content)
+    logging.info('Write file: %s', output)
+
+
+def type_grid(parg: str) -> str:
+  parg = parg.upper()
+  if not re.match(r'^[A-R]{2}[0-9]{2}[A-X]{2}$', parg):
+    raise argparse.ArgumentTypeError('Wrong maidenhead grid square')
+  return parg
+
+
+def main() -> None:
+  logger.setLevel(logging.INFO)
+  parser = argparse.ArgumentParser(description='QSO to map')
+  parser.add_argument('-c', '--call', required=True,
+                      help='Call sign')
+  parser.add_argument('-f', '--adif-file', type=Path, required=True,
+                      help='ADIF filename')
+  parser.add_argument('-o', '--output', type=Path, required=True,
+                      help='Destination filename')
+  parser.add_argument('-g', '--grid', type=type_grid, required=True,
+                      help='Maidenhead grid square AA00aa')
+  opts = parser.parse_args()
+
+  location = grid2latlon(opts.grid)
+
+  try:
+    adif = load_adif(opts.adif_file)
+    adif = adif[-10000:]
+  except (FileNotFoundError, ValueError) as err:
+    logger.error(err)
+    sys.exit(os.EX_IOERR)
+
+  try:
+    adif = normalize_data(adif, location)
+  except (ValueError, AttributeError) as err:
+    logger.error(err)
+    sys.exit(os.EX_PROTOCOL)
+
+  render_html(adif, opts.call, location, opts.output)
+
+
+if __name__ == "__main__":
+  try:
+    main()
+  except KeyboardInterrupt:
+    logger.error('Interrupted by user')

adif2map/static/style.css

@@ -0,0 +1,82 @@
+/*
+ * style.css
+ * Copyright © 2026 Fred W6BSD
+ *
+ * Distributed under terms of the BSD 3-Clause license.
+ */
+
+body {
+    background-color: #fdfdff;
+    color: #333;
+    font-family: -apple-system, BlinkMacSystemFont, Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+    margin: 0;
+    padding: 0;
+}
+
+header {
+  background: linear-gradient(135deg, #0a2342, #1c3d73);
+  font-family: Arial, sans-serif;
+  padding: 0 0;
+  text-align: center;
+  border-bottom: 4px solid #f80;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  padding-bottom: 20px;
+  color: #eee;
+}
+
+header div {
+  margin: .5rem;
+}
+
+header a {
+  color: #DAF7A6;
+}
+
+header h1 {
+  color: #DAF7A6;
+  text-align: center;
+  font-size: 3rem;
+  margin: .5rem;
+  text-shadow: 1px 1px 0 #7a9e4a,
+               2px 2px 0 #5a7a2a,
+               3px 3px 0 #3a5a1a,
+               4px 4px 0 #1a3a0a,
+               5px 5px 8px rgba(0, 0, 0, 0.3);
+}
+
+header .counters  {
+    font-family: "Courier New", Courier, monospace;
+    font-size: 1.2rem;
+    text-align: center;
+    color: #ddd;
+}
+
+main {
+  padding: 2em;
+  margin: 0 auto;
+}
+
+footer {
+  font-size: .8em;
+  background-color: #322;
+  text-align: right;
+  color: #cccccc;
+  margin-top: 0em;
+  padding: 1em 6em;
+}
+
+footer .container {
+    padding-bottom: 3em;
+    line-height: 1.6em;
+}
+
+footer a {
+  color: yellow;
+  text-decoration: none;
+}
+
+footer a:hover {
+  text-decoration: underline;
+}

adif2map/templates/map.html

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>{{ title }}</title>
+    <style>
+{% include "style.css" %}
+    </style>
+  </head>
+  <body>
+    <header>
+      <h1>QSOs for {{ call }}</h1>
+      <div>Generated by <a href="https://qsomap.bsdworld.org/">QSO Map generator</a></div>
+      <div class="counters">
+        <b>{{ count }}</b> contacts from <b>{{ start.strftime("%Y-%m-%d") }}</b> to <b>{{ end.strftime("%Y-%m-%d") }}</b>
+      </div>
+    </header>
+    <main>
+      <div class="container">
+        {{ map|safe }}
+      </div>
+    </main>
+    <footer class="footer">
+      <div class="container">
+        <!-- Copyright -->
+        <div>
+          <div>This map has been build with <a href="https://qrz.com/db/{{ call }}" target="_qrz">{{ call }}</a> adif logfile</div>
+          <div>Copyright © 2026 Fred W6BSD <a class="text-white-50" href="https://0x9900.com/">0x9900.com</a></div>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>

adif2map-0.0.1.dist-info/METADATA

@@ -0,0 +1,61 @@
+Metadata-Version: 2.5
+Name: adif2map
+Version: 0.0.1
+Summary: Display your ham radio QSOs on a map
+Project-URL: Homepage, https://github.com/0x9900/adif2map
+Project-URL: Repository, https://github.com/0x9900/adif2map
+Author-email: "Fred C." <github-fred@hidzz.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025-2026, Fred C - W6BSD
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+License-File: LICENSE
+Keywords: adif,ham radio,maps
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: adif-parser
+Requires-Dist: dxcty-parser
+Requires-Dist: folium
+Requires-Dist: geo-ham
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+Requires-Dist: pyproj
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: flake8; extra == 'dev'
+Requires-Dist: geo-ham; extra == 'dev'
+Requires-Dist: isort; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pylint; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'

adif2map-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+adif2map/__init__.py,sha256=3x0utVQ1jdaUyIluQYODfpx-h-gqGKyqO3bIgE0POLU,172
+adif2map/adif2map.py,sha256=188ndB9TnKEdknDS1_rAitgbWHE-P1DuRIHxK2KC3po,10176
+adif2map/static/style.css,sha256=7xxejIagEOB0Owhb_Wl4JZ5wI1d9e6_nwO7RHZL0DN0,1417
+adif2map/templates/map.html,sha256=qvPcMzBwpJMpQoRijpSDKbS5-9h83SFFs5iI5M5UiLE,976
+adif2map-0.0.1.dist-info/METADATA,sha256=XfXjFq9sPLq6tM19xQ60gTmmJkweoVQCME91RrEpPKQ,2925
+adif2map-0.0.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+adif2map-0.0.1.dist-info/entry_points.txt,sha256=jjzIjY0OJxvw8sr3OWgezz5JTIqlwonYZdbHIkV4TSo,52
+adif2map-0.0.1.dist-info/licenses/LICENSE,sha256=K-h24-4ywAiALKGK3hqxd3qC39neX1N8rzEe01_ZzA4,1506
+adif2map-0.0.1.dist-info/RECORD,,

adif2map-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

adif2map-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+adif2map = adif2map.adif2map:main

adif2map-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025-2026, Fred C - W6BSD
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.