Download Latest Version antenne3d-1.0.zip (188.6 kB)
Home
Name Modified Size InfoDownloads / Week
antenne3d-1.0.zip 2026-11-12 188.6 kB
LICENSE 2026-11-12 35.1 kB
README.md 2026-11-12 12.4 kB
antenna3d.html 2026-11-12 264.0 kB
Totals: 4 Items   500.1 kB 15

Antenne 3D / Antenna 3D

Dessin et analyse d'antennes filaires dans le navigateur — Wire-antenna drawing and analysis in the browser

par / by F4NLJ · Licence / License : GNU GPL v3 or later

Français · English


Français

Antenne 3D est un logiciel d'analyse d'antennes filaires dans un seul fichier HTML. Il fonctionne dans n'importe quel navigateur récent, sans installation, sans serveur et sans connexion. On dessine l'antenne en 3D, à main levée ou par cotes. L'outil calcule l'impédance, le ROS, le diagramme de rayonnement et le gain avec un solveur par méthode des moments du même type que NEC. Il peut aussi optimiser les dimensions, explorer automatiquement des formes, et produire une fiche de construction en PDF.

Démarrage rapide

  1. Télécharger antenne3d.html.
  2. L'ouvrir dans Firefox, Chrome, Edge ou Safari.
  3. Choisir un exemple dans Modèle → Exemples, puis cliquer sur ▶ Analyser.

L'interface est en français ou en anglais (boutons FR | EN).

Fonctions

Dessin et construction

  • Grille 3D avec plans de travail XY, XZ et YZ ; tracé en polyligne ou à main levée, avec accrochage à la grille et aux extrémités existantes.
  • Construction relative : on sélectionne un bout et on ajoute un brin, une self, une trappe ou une bobine dans une direction et sur une longueur données. Quand on change une longueur, tout ce qui est accroché au-delà suit.
  • Tableau des fils modifiable (coordonnées, longueurs), cotes affichées dans la vue, vues orthogonales et 3D, annulation.

Éléments

  • Selfs série R-L-C et trappes (circuit bouchon L // C avec pertes), placées à une jonction de fils.
  • Bobines dessinées (hélices réelles : spires, diamètre, fil), par exemple les selfs de phase de colinéaire.
  • Radiales automatiques, mât métallique (relié ou isolé), fils isolés (εr, épaisseur).

Alimentation et ligne

  • Coaxiale (âme et masse) ou bifilaire ; alimentation au centre d'un fil, à un bout, à une jonction de plusieurs brins (âme sur le radiateur, masse sur les radiales), ou entre deux points distincts.
  • Ligne jusqu'au poste (Zc, coefficient de vélocité, longueur, pertes) : ROS au poste et pertes dans la ligne.
  • Extérieur de la gaine du coax modélisé (courant de mode commun), avec self de choc ou balun.

Sol

  • Espace libre, sol parfait, ou sol réel : eau de mer, eau douce, très bon, moyen, pauvre, très pauvre, ou valeurs personnalisées εr et σ.

Résultats

  • Impédance, ROS, perte de retour, résonances, bande à ROS ≤ 2, abaque de Smith.
  • Gain max et gain dans la direction visée ; détail par polarisation (verticale, horizontale, circulaire droite et gauche).
  • Rendement (pertes du conducteur et du sol), rapport avant/arrière, diagrammes en azimut et en élévation, diagramme 3D, répartition du courant sur les fils.

Optimisation et exploration

  • Optimiseur local (Nelder-Mead) : cotes libres (longueurs, positions de points, angles, spires, valeurs L et C), but (gain dans une direction, omni, gain max ou ROS), polarisation, contrainte de ROS sur une bande.
  • Exploration de formes globale (évolution différentielle) : fil libre façon NASA ST5, méandre, hélice, Yagi à N éléments, colinéaire à N sections. Contraintes d'encombrement et d'écart entre fils, test de robustesse aux tolérances de fabrication, galerie des meilleures formes différentes.

Fichiers

  • Enregistrement dans le navigateur, téléchargement et ouverture de modèles .json.
  • Export NEC (.nec) pour 4nec2 et xnec2c.
  • Fiche de construction PDF : vues cotées, tableaux des fils, des bobinages et des angles aux jonctions, liste de coupe, étapes de montage et de réglage, courbes.

Validation du solveur

Comparaison avec des valeurs connues :

Cas Antenne 3D Référence
Dipôle λ/2, rayon λ/1000, espace libre 84 + j43 Ω, 2,15 dBi ≈ 82 + j45 Ω, 2,15 dBi
Monopole λ/4 sur sol parfait 41 + j19 Ω, 5,17 dBi la moitié du dipôle, 5,15 dBi
Ground-plane, 4 radiales horizontales 23 Ω ≈ 22 Ω
Dipôle horizontal à λ/4 au-dessus d'un sol parfait 7,5 dBi au zénith ≈ 7,5 dBi
Dipôle horizontal à λ/2 au-dessus d'un sol moyen (14 MHz) 7,3 dBi à 28° valeurs NEC comparables
Hélice axiale droite, 8 tours, C = λ 10,3 dBi en circulaire droite, −21 dBi en circulaire gauche polarisation circulaire droite attendue

Limites

  • Fils fins uniquement : longueur de segment nettement supérieure au rayon. Les surfaces pleines se modélisent par une grille de fils.
  • Sol réel par la méthode des images pondérées (coefficients de Fresnel), sans Sommerfeld. Le calcul devient approximatif à moins de λ/50 du sol, et les fils posés sur un sol réel ne sont pas modélisables.
  • La ligne d'alimentation est calculée à part ; son rayonnement n'est pris en compte que si la gaine est modélisée.
  • Les résultats sont ceux d'une simulation : radôme, supports, objets proches et tolérances les décalent. Il faut toujours valider par une mesure, par exemple au NanoVNA.

Sources et compilation

antenne3d.html      application assemblée (fichier unique, autonome)
src/app.html        interface, dessin 3D, analyse, optimiseur, exploration
src/solver.js       solveur méthode des moments (EFIE fil fin, sol, pertes, champ lointain)
src/i18n.js         traduction français / anglais
src/pdf.js          mini-générateur PDF vectoriel (sans dépendance)
src/sheet.js        fiche de construction PDF
src/build.py        assemble les sources en antenne3d.html
examples/           modèles d'exemple (.json)

Pour reconstruire après une modification (Python 3, Linux, macOS ou Windows) :

cd src
python3 build.py      # écrit ../antenne3d.html

Aucune bibliothèque externe ni dépendance réseau n'est nécessaire.

Licence

Copyright © 2026 F4NLJ.

Ce programme est un logiciel libre : vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence publique générale GNU, telle que publiée par la Free Software Foundation, en version 3 ou (à votre choix) toute version ultérieure. Il est distribué dans l'espoir d'être utile, mais sans aucune garantie, sans même la garantie implicite de qualité marchande ou d'adéquation à un usage particulier. Voir le fichier LICENSE pour le texte complet.

Les modèles d'antennes que vous créez avec l'outil (fichiers .json, .nec, fiches PDF) vous appartiennent : la GPL ne s'applique pas aux données produites par le programme.


English

Antenna 3D is a wire-antenna analysis tool in a single HTML file. It runs in any modern browser with no installation, no server and no network connection. Draw the antenna in 3D, freehand or by dimensions. The tool computes impedance, SWR, radiation pattern and gain with a method-of-moments solver of the same kind as NEC. It can also optimise dimensions, explore shapes automatically, and produce a PDF construction sheet.

Quick start

  1. Download antenne3d.html.
  2. Open it in Firefox, Chrome, Edge or Safari.
  3. Pick an example from Model → Examples, then click ▶ Analyse.

The interface is in English or French (FR | EN buttons).

Features

Drawing and construction

  • 3D grid with XY, XZ and YZ work planes; polyline or freehand drawing, snapping to the grid and to existing end points.
  • Relative construction: select an end point and add a wire, coil, trap or helix in a given direction over a given length. When a length changes, everything attached beyond it follows.
  • Editable wire table (coordinates, lengths), dimensions shown in the view, orthographic and 3D views, undo.

Elements

  • Series R-L-C coils and traps (parallel L // C tank with loss), placed at a junction of wires.
  • Drawn helix coils (real helices: turns, diameter, wire), e.g. collinear phasing coils.
  • Automatic radials, metal mast (connected or insulated), insulated wires (εr, thickness).

Feed and line

  • Coaxial (centre conductor and shield) or twin-lead; feed at the centre of a wire, at an end, at a multi-wire junction (centre conductor on the radiator, shield on the radials), or between two distinct points.
  • Feed line to the radio (Zc, velocity factor, length, loss): SWR at the radio and line loss.
  • Outside of the coax shield modelled (common-mode current), with choke or current balun.

Ground

  • Free space, perfect ground, or real ground: sea water, fresh water, very good, average, poor, very poor, or custom εr and σ.

Results

  • Impedance, SWR, return loss, resonances, SWR ≤ 2 band, Smith chart.
  • Maximum gain and gain in the target direction; breakdown by polarisation (vertical, horizontal, right- and left-hand circular).
  • Efficiency (conductor and ground losses), front/back ratio, azimuth and elevation patterns, 3D pattern, current distribution on the wires.

Optimisation and exploration

  • Local optimiser (Nelder-Mead): free dimensions (lengths, point positions, angles, turns, L and C values), goal (gain in a direction, omni, maximum gain or SWR), polarisation, SWR constraint over a band.
  • Global shape exploration (differential evolution): NASA ST5-style free wire, meander, helix, N-element Yagi, N-section collinear. Size and wire-spacing constraints, robustness test against build tolerances, gallery of the best distinct shapes.

Files

  • Save in the browser; download and open .json models.
  • NEC export (.nec) for 4nec2 and xnec2c.
  • PDF construction sheet: dimensioned views, tables of wires, windings and junction angles, cut list, assembly and tuning steps, curves.

Solver validation

Comparison with known values:

Case Antenna 3D Reference
λ/2 dipole, radius λ/1000, free space 84 + j43 Ω, 2.15 dBi ≈ 82 + j45 Ω, 2.15 dBi
λ/4 monopole over perfect ground 41 + j19 Ω, 5.17 dBi half the dipole, 5.15 dBi
Ground-plane, 4 horizontal radials 23 Ω ≈ 22 Ω
Horizontal dipole λ/4 above perfect ground 7.5 dBi at zenith ≈ 7.5 dBi
Horizontal dipole λ/2 above average ground (14 MHz) 7.3 dBi at 28° comparable NEC values
Right-hand axial helix, 8 turns, C = λ 10.3 dBi RHCP, −21 dBi LHCP right-hand circular polarisation expected

Limitations

  • Thin wires only: segment length well above the radius. Solid surfaces are modelled as wire grids.
  • Real ground uses the weighted-image method (Fresnel coefficients), without Sommerfeld. Results become approximate below λ/50 above ground, and wires lying on a real ground cannot be modelled.
  • The feed line is computed separately; its radiation is only included when the shield is modelled.
  • Results come from a simulation: radome, supports, nearby objects and tolerances shift them. Always confirm by measurement, e.g. with a NanoVNA.

Sources and build

antenne3d.html      assembled application (single self-contained file)
src/app.html        user interface, 3D drawing, analysis, optimiser, exploration
src/solver.js       method-of-moments solver (thin-wire EFIE, ground, losses, far field)
src/i18n.js         French / English translation
src/pdf.js          dependency-free vector PDF writer
src/sheet.js        PDF construction sheet
src/build.py        assembles the sources into antenne3d.html
examples/           example models (.json)

To rebuild after a change (Python 3, Linux, macOS or Windows):

cd src
python3 build.py      # writes ../antenne3d.html

No external library or network dependency is required.

License

Copyright © 2026 F4NLJ.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE file for the full text.

Antenna models you create with the tool (.json, .nec files, PDF sheets) are yours: the GPL does not apply to the data produced by the program.

73 de F4NLJ

Source: README.md, updated 2026-11-12