PyNEC 1.7.3.6__tar.gz → 1.7.4__tar.gz

pynec-1.7.4/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: PyNEC
+Version: 1.7.4
+Summary: Python Antenna Simulation Module (nec2++) object-oriented interface
+Author-email: Tim Molteno <tim@physics.otago.ac.nz>
+License: GPLv3
+Project-URL: Homepage, http://github.com/tmolteno/python-necpp
+Project-URL: Repository, http://github.com/tmolteno/python-necpp
+Keywords: nec2,nec2++,antenna,electromagnetism,radio
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Communications :: Ham Radio
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+Requires-Dist: numpy
+Dynamic: license-file
+
+# Python NEC2++ Module
+
+This module wraps the C++ API for antenna simulation of nec2++. It is easier to work with, and more powerful than the C-style API wrapper. Works with Python 2.7 and 3+.
+
+
+## Usage
+
+Here is an example that plots a radiation pattern.
+
+    from PyNEC import *
+    import numpy as np
+
+    #creation of a nec context
+    context=nec_context()
+
+    #get the associated geometry
+    geo = context.get_geometry()
+
+    #add wires to the geometry
+    geo.wire(0, 36, 0, 0, 0, -0.042, 0.008, 0.017, 0.001, 1.0, 1.0)
+    context.geometry_complete(0)
+
+    context.gn_card(-1, 0, 0, 0, 0, 0, 0, 0)
+
+    #add a "ex" card to specify an excitation
+    context.ex_card(1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0)
+
+    #add a "fr" card to specify the frequency 
+    context.fr_card(0, 2, 2400.0e6, 100.0e6)
+
+    #add a "rp" card to specify radiation pattern sampling parameters and to cause program execution
+    context.rp_card(0, 91, 1, 0, 5, 0, 0, 0.0, 45.0, 4.0, 2.0, 1.0, 0.0)
+
+    #get the radiation_pattern
+    rp = context.get_radiation_pattern(0)
+
+    # Gains are in decibels
+    gains_db = rp.get_gain()
+    gains = 10.0**(gains_db / 10.0)
+    thetas = rp.get_theta_angles() * 3.1415 / 180.0
+    phis = rp.get_phi_angles() * 3.1415 / 180.0
+
+
+    # Plot stuff
+    import matplotlib.pyplot as plt
+
+    ax = plt.subplot(111, polar=True)
+    ax.plot(thetas, gains[:,0], color='r', linewidth=3)
+    ax.grid(True)
+
+    ax.set_title("Gain at an elevation of 45 degrees", va='bottom')
+    plt.savefig('RadiationPattern.png')
+    plt.show()
+
+## Manual Build & install
+
+Requirements
+
+* [Swig](http://www.swig.org/download.html)
+* For Windows: [C/C++ compilers](https://wiki.python.org/moin/WindowsCompilers).
+* Git bash (for running build.sh script)
+* [uv](https://github.com/astral-sh/uv) (recommended) or pip + setuptools + numpy + wheel
+
+*Note: Download and extract swigwin.zip and add the path to swig.exe to environment.*
+
+Then do following:
+    
+        $ git clone --recursive https://github.com/tmolteno/python-necpp.git
+        $ cd python-necpp
+        $ cd PyNEC
+        $ ./build.sh
+        $ uv build               # Modern, fast build
+        $ uv pip install .       # Or: pip install .
+    
+*Note: 'sudo' is not required in windows.*
+    
+## Install from PyPI
+
+    $ sudo pip install pynec
+    
+*Note: 'sudo' is not required in windows.*
+
+## Testing
+
+Requirements
+
+* python package: matplotlib
+
+    $ python example/test_rp.py
+
+The example directory contains the following additional examples (that are inspired by excercises from a course on antennas):
+
+* logperiodic_opt.py is an example on how to combine PyNECPP with scipy.optimize to use a genetic algorithm to **optimize an antenna for multiple frequency bands** at the same time (which I thin is not possible in 4nec2). The resulting gains and VSWR are plotted over the frequency range of interest. This requires scipy >= 0.15.0 due to the usage of scipy.optimize.differential_evolution.
+* monopole_realistic_ground_plane.py plots the vertical gain pattern of a monopole antenna. Its dimensions are optimized with a local search, and the path through the search space is visualized with a heat map.
+* dipole.py does a very simple optimization of a dipole, and plots the VSWR over a given frequency range for different system impedances to file.
+
+

pynec-1.7.4/PyNEC.egg-info/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: PyNEC
+Version: 1.7.4
+Summary: Python Antenna Simulation Module (nec2++) object-oriented interface
+Author-email: Tim Molteno <tim@physics.otago.ac.nz>
+License: GPLv3
+Project-URL: Homepage, http://github.com/tmolteno/python-necpp
+Project-URL: Repository, http://github.com/tmolteno/python-necpp
+Keywords: nec2,nec2++,antenna,electromagnetism,radio
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Communications :: Ham Radio
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+Requires-Dist: numpy
+Dynamic: license-file
+
+# Python NEC2++ Module
+
+This module wraps the C++ API for antenna simulation of nec2++. It is easier to work with, and more powerful than the C-style API wrapper. Works with Python 2.7 and 3+.
+
+
+## Usage
+
+Here is an example that plots a radiation pattern.
+
+    from PyNEC import *
+    import numpy as np
+
+    #creation of a nec context
+    context=nec_context()
+
+    #get the associated geometry
+    geo = context.get_geometry()
+
+    #add wires to the geometry
+    geo.wire(0, 36, 0, 0, 0, -0.042, 0.008, 0.017, 0.001, 1.0, 1.0)
+    context.geometry_complete(0)
+
+    context.gn_card(-1, 0, 0, 0, 0, 0, 0, 0)
+
+    #add a "ex" card to specify an excitation
+    context.ex_card(1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0)
+
+    #add a "fr" card to specify the frequency 
+    context.fr_card(0, 2, 2400.0e6, 100.0e6)
+
+    #add a "rp" card to specify radiation pattern sampling parameters and to cause program execution
+    context.rp_card(0, 91, 1, 0, 5, 0, 0, 0.0, 45.0, 4.0, 2.0, 1.0, 0.0)
+
+    #get the radiation_pattern
+    rp = context.get_radiation_pattern(0)
+
+    # Gains are in decibels
+    gains_db = rp.get_gain()
+    gains = 10.0**(gains_db / 10.0)
+    thetas = rp.get_theta_angles() * 3.1415 / 180.0
+    phis = rp.get_phi_angles() * 3.1415 / 180.0
+
+
+    # Plot stuff
+    import matplotlib.pyplot as plt
+
+    ax = plt.subplot(111, polar=True)
+    ax.plot(thetas, gains[:,0], color='r', linewidth=3)
+    ax.grid(True)
+
+    ax.set_title("Gain at an elevation of 45 degrees", va='bottom')
+    plt.savefig('RadiationPattern.png')
+    plt.show()
+
+## Manual Build & install
+
+Requirements
+
+* [Swig](http://www.swig.org/download.html)
+* For Windows: [C/C++ compilers](https://wiki.python.org/moin/WindowsCompilers).
+* Git bash (for running build.sh script)
+* [uv](https://github.com/astral-sh/uv) (recommended) or pip + setuptools + numpy + wheel
+
+*Note: Download and extract swigwin.zip and add the path to swig.exe to environment.*
+
+Then do following:
+    
+        $ git clone --recursive https://github.com/tmolteno/python-necpp.git
+        $ cd python-necpp
+        $ cd PyNEC
+        $ ./build.sh
+        $ uv build               # Modern, fast build
+        $ uv pip install .       # Or: pip install .
+    
+*Note: 'sudo' is not required in windows.*
+    
+## Install from PyPI
+
+    $ sudo pip install pynec
+    
+*Note: 'sudo' is not required in windows.*
+
+## Testing
+
+Requirements
+
+* python package: matplotlib
+
+    $ python example/test_rp.py
+
+The example directory contains the following additional examples (that are inspired by excercises from a course on antennas):
+
+* logperiodic_opt.py is an example on how to combine PyNECPP with scipy.optimize to use a genetic algorithm to **optimize an antenna for multiple frequency bands** at the same time (which I thin is not possible in 4nec2). The resulting gains and VSWR are plotted over the frequency range of interest. This requires scipy >= 0.15.0 due to the usage of scipy.optimize.differential_evolution.
+* monopole_realistic_ground_plane.py plots the vertical gain pattern of a monopole antenna. Its dimensions are optimized with a local search, and the path through the search space is visualized with a heat map.
+* dipole.py does a very simple optimization of a dipole, and plots the VSWR over a given frequency range for different system impedances to file.
+
+

pynec-1.7.4/PyNEC.egg-info/SOURCES.txt

@@ -0,0 +1,78 @@
+LICENCE.txt
+MANIFEST.in
+PyNEC.py
+PyNEC_wrap.cxx
+README.md
+pyproject.toml
+setup.py
+PyNEC.egg-info/PKG-INFO
+PyNEC.egg-info/SOURCES.txt
+PyNEC.egg-info/dependency_links.txt
+PyNEC.egg-info/requires.txt
+PyNEC.egg-info/top_level.txt
+example/antenna_util.py
+example/context_clean.py
+example/dipole.py
+example/impedance_plot.py
+example/logperiodic_opt.py
+example/monopole.py
+example/monopole_realistic_ground_plane.py
+example/optimized.py
+example/radiation_pattern.py
+example/test_ai.py
+example/test_charge_densities.py
+example/test_ne_nh.py
+example/test_nrp.py
+example/test_rp.py
+example/test_rp2.py
+example/test_se.py
+example/test_structure_currents.py
+example/test_surface_patch_currents.py
+necpp_src/config.h
+necpp_src/src/AntennaInput.h
+necpp_src/src/BaseInput.h
+necpp_src/src/CurrentInput.h
+necpp_src/src/PowerBudget.h
+necpp_src/src/RadiationInput.h
+necpp_src/src/XGetopt.cpp
+necpp_src/src/XGetopt.h
+necpp_src/src/atlas_check.cpp
+necpp_src/src/c_evlcom.cpp
+necpp_src/src/c_evlcom.h
+necpp_src/src/c_geometry.cpp
+necpp_src/src/c_geometry.h
+necpp_src/src/c_ggrid.cpp
+necpp_src/src/c_ggrid.h
+necpp_src/src/c_plot_card.cpp
+necpp_src/src/c_plot_card.h
+necpp_src/src/common.h
+necpp_src/src/electromag.cpp
+necpp_src/src/electromag.h
+necpp_src/src/libNEC.cpp
+necpp_src/src/libnecpp.h
+necpp_src/src/math_util.h
+necpp_src/src/matrix_algebra.cpp
+necpp_src/src/matrix_algebra.h
+necpp_src/src/misc.cpp
+necpp_src/src/misc.h
+necpp_src/src/nec2cpp.h
+necpp_src/src/nec_context.cpp
+necpp_src/src/nec_context.h
+necpp_src/src/nec_debug.h
+necpp_src/src/nec_exception.cpp
+necpp_src/src/nec_exception.h
+necpp_src/src/nec_ground.cpp
+necpp_src/src/nec_ground.h
+necpp_src/src/nec_output.cpp
+necpp_src/src/nec_output.h
+necpp_src/src/nec_radiation_pattern.cpp
+necpp_src/src/nec_radiation_pattern.h
+necpp_src/src/nec_results.cpp
+necpp_src/src/nec_results.h
+necpp_src/src/nec_structure_currents.cpp
+necpp_src/src/nec_structure_currents.h
+necpp_src/src/nec_wire.h
+necpp_src/src/safe_array.h
+necpp_src/src/typesafe_stdint.h
+tests/test_examples.py
+tests/test_get_gain.py

pynec-1.7.4/PyNEC.egg-info/requires.txt

@@ -0,0 +1 @@
+numpy