python-necpp: Antenna simulation in python

This module allows you to do antenna simulations in Python using the nec2++ antenna simulation package.

This is a wrapper using SWIG of the C interface, so the syntax is quite simple. Have a look at the file necpp_src/example/test.py, for an example of how this library can be used.

Tim Molteno. tim@physics.otago.ac.nz

News

Version 2.2.x Latest releases including Eigen-based matrix solver and modern Python packaging (pyproject.toml, uv support).

Install

As of version 1.6.1.2 swig is no longer required for installation. Simply use PIP as follows:

pip install necpp

To build from source with uv:

uv build
uv pip install .

Documentation

Try help(necpp) to list the available functions. The functions available are documented in the C-style API of nec2++. This is available here

Using

The following code calculates the impedance of a simple vertical monopole antenna over a perfect ground.

import necpp

def handle_nec(result):
  if (result != 0):
    print(necpp.nec_error_message())

def impedance(frequency, z0, height):
  
  nec = necpp.nec_create()
  handle_nec(necpp.nec_wire(nec, 1, 17, 0, 0, z0, 0, 0, z0+height, 0.1, 1, 1))
  handle_nec(necpp.nec_geometry_complete(nec, 1, 0))
  handle_nec(necpp.nec_gn_card(nec, 1, 0, 0, 0, 0, 0, 0, 0))
  handle_nec(necpp.nec_fr_card(nec, 0, 1, frequency, 0))
  handle_nec(necpp.nec_ex_card(nec, 0, 0, 1, 0, 1.0, 0, 0, 0, 0, 0)) 
  handle_nec(necpp.nec_rp_card(nec, 0, 90, 1, 0,5,0,0, 0, 90, 1, 0, 0, 0))
  result_index = 0
  
  z = complex(necpp.nec_impedance_real(nec,result_index), 
              necpp.nec_impedance_imag(nec,result_index))
  
  necpp.nec_delete(nec)
  return z

if __name__ == "__main__":
  z = impedance(frequency = 34.5, z0 = 0.5, height = 4.0)
  print("Impedance \t(%6.1f,%+6.1fI) Ohms" % (z.real, z.imag))

More Information

Have a look at [http://github.com/tmolteno/necpp] for more information on using nec2++.

Metadata

Release files for necpp 2.3.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for necpp 2.3.4
File	Size	Uploaded	Provenance
necpp-2.3.4.tar.gz	1.4 MB	Aug 2, 2026	With provenance	Details

Built distributions (wheels)

Table of built distributions (wheels) for necpp 2.3.4
File	Interpreter	ABI	Platform	Reset
necpp-2.3.4-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl 4.7 MB Aug 2, 2026 With provenance	CPython 3.14	CPython 3.14	Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64	Details
necpp-2.3.4-cp314-cp314-macosx_11_0_arm64.whl 250.1 kB Aug 2, 2026 With provenance	CPython 3.14	CPython 3.14	macOS 11.0+ ARM64	Details
necpp-2.3.4-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl 4.7 MB Aug 2, 2026 With provenance	CPython 3.13	CPython 3.13	Linux glibc 2.24+ x86-64, Linux glibc 2.28+ x86-64	Details
necpp-2.3.4-cp313-cp313-macosx_11_0_arm64.whl 250.1 kB Aug 2, 2026 With provenance	CPython 3.13	CPython 3.13	macOS 11.0+ ARM64	Details
necpp-2.3.4-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl 4.7 MB Aug 2, 2026 With provenance	CPython 3.12	CPython 3.12	Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64	Details
necpp-2.3.4-cp312-cp312-macosx_11_0_arm64.whl 250.3 kB Aug 2, 2026 With provenance	CPython 3.12	CPython 3.12	macOS 11.0+ ARM64	Details
necpp-2.3.4-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl 4.7 MB Aug 2, 2026 With provenance	CPython 3.11	CPython 3.11	Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64	Details
necpp-2.3.4-cp311-cp311-macosx_11_0_arm64.whl 250.4 kB Aug 2, 2026 With provenance	CPython 3.11	CPython 3.11	macOS 11.0+ ARM64	Details

Total release size: 21.3 MB

Release files / necpp-2.3.4.tar.gz

Download URL	necpp-2.3.4.tar.gz
Size	1.4 MB
Tags	Source
SHA-256 checksum How to use checksums	`a3b12517f71c7deabea0a7f97b918dc8a1b45f2f82854cae543603b4e935cb79`
BLAKE2b-256 checksum How to use checksums	`59e50f8fd7c2c3acbc9c6c65c87a424c6381dce1e0b79281f7ccc74214884fbd`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4.tar.gz
SHA-256 checksum: a3b12517f71c7deabea0a7f97b918dc8a1b45f2f82854cae543603b4e935cb79 Verifying attestations

Release files / necpp-2.3.4-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL	necpp-2.3.4-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size	4.7 MB
Tags	CPython 3.14 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`b4ffb745379431856b39a6b373f0ca8b68854fa151ea843d516896fbb1d9bf55`
BLAKE2b-256 checksum How to use checksums	`a708d8b10ca174d11dc2cfc7b23cf77bef72a86ca9649c239fc88551bd0b6303`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
SHA-256 checksum: b4ffb745379431856b39a6b373f0ca8b68854fa151ea843d516896fbb1d9bf55 Verifying attestations

Release files / necpp-2.3.4-cp314-cp314-macosx_11_0_arm64.whl

Download URL	necpp-2.3.4-cp314-cp314-macosx_11_0_arm64.whl
Size	250.1 kB
Tags	CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`91f0af3a596ec66f1cd34af410bc71af84b1c27cd24aa578abdd300c872b4717`
BLAKE2b-256 checksum How to use checksums	`218ae4e3e426c176bc58dcfe7037a8443ffdadb32975b377dcbbf914ad0355ad`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp314-cp314-macosx_11_0_arm64.whl
SHA-256 checksum: 91f0af3a596ec66f1cd34af410bc71af84b1c27cd24aa578abdd300c872b4717 Verifying attestations

Release files / necpp-2.3.4-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL	necpp-2.3.4-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size	4.7 MB
Tags	CPython 3.13 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`fd729bb5247165d4a83ac8664839a9ea093a5017b13ae8e1962a312179d26dd6`
BLAKE2b-256 checksum How to use checksums	`f11d338360eacdd21ba8bfa8980e655bde8c3e2bc210fbf9fc44ad7e5b03250f`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
SHA-256 checksum: fd729bb5247165d4a83ac8664839a9ea093a5017b13ae8e1962a312179d26dd6 Verifying attestations

Release files / necpp-2.3.4-cp313-cp313-macosx_11_0_arm64.whl

Download URL	necpp-2.3.4-cp313-cp313-macosx_11_0_arm64.whl
Size	250.1 kB
Tags	CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`00b55ea8204ad3517c29f90533e388bb20baffcf806ffb901297e9d3f4581f14`
BLAKE2b-256 checksum How to use checksums	`1aa91d44cb17499522e793cc520771694fa54e1c605908f226bb8a6502ba06f5`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp313-cp313-macosx_11_0_arm64.whl
SHA-256 checksum: 00b55ea8204ad3517c29f90533e388bb20baffcf806ffb901297e9d3f4581f14 Verifying attestations

Release files / necpp-2.3.4-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL	necpp-2.3.4-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size	4.7 MB
Tags	CPython 3.12 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`9812427f0750fc808423602ba103714aa66a69155102d2973ca70fd3b3f24d0b`
BLAKE2b-256 checksum How to use checksums	`e19aeb5a9be2c362e278bde5daa09fd747e58c8641a55c8a8bb7c8727bd2f89a`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
SHA-256 checksum: 9812427f0750fc808423602ba103714aa66a69155102d2973ca70fd3b3f24d0b Verifying attestations

Release files / necpp-2.3.4-cp312-cp312-macosx_11_0_arm64.whl

Download URL	necpp-2.3.4-cp312-cp312-macosx_11_0_arm64.whl
Size	250.3 kB
Tags	CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`7f4f07c6dc4932cb17fdd62feafdaf155da0a380f89c4b3db2a653f35fb33de0`
BLAKE2b-256 checksum How to use checksums	`589486b2f1a893792cf266c6fe5481931abeba426f09e277fd1e5419b49776cc`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp312-cp312-macosx_11_0_arm64.whl
SHA-256 checksum: 7f4f07c6dc4932cb17fdd62feafdaf155da0a380f89c4b3db2a653f35fb33de0 Verifying attestations

Release files / necpp-2.3.4-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL	necpp-2.3.4-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size	4.7 MB
Tags	CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`f7aa1b071f0f0f75685ac2d9e97f70cab37c8e125ac85c1122e8e1d012a8dd1e`
BLAKE2b-256 checksum How to use checksums	`4f4a0a8d6cc586b3d28941397cb53fc89f8171e0bb4c4157b413326c64e7f95e`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
SHA-256 checksum: f7aa1b071f0f0f75685ac2d9e97f70cab37c8e125ac85c1122e8e1d012a8dd1e Verifying attestations

Release files / necpp-2.3.4-cp311-cp311-macosx_11_0_arm64.whl

Download URL	necpp-2.3.4-cp311-cp311-macosx_11_0_arm64.whl
Size	250.4 kB
Tags	CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`877d792cf9947d9a448ed3d47dc952517c00b4921a1f78047b606f91ec6231b3`
BLAKE2b-256 checksum How to use checksums	`46f1f64fe07b027c5a407d4fd1508a5a76f6499427d086184e74ec2e7b8abc40`
Upload date	Aug 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4-cp311-cp311-macosx_11_0_arm64.whl
SHA-256 checksum: 877d792cf9947d9a448ed3d47dc952517c00b4921a1f78047b606f91ec6231b3 Verifying attestations

Security for necpp 2.3.4

Report project as malware

Provenance

Full provenance

All 9 files in this release have been uploaded with provenance metadata.

Attestation for necpp-2.3.4.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/python-necpp
Publishing commit: github.com/tmolteno/python-necpp/tree/c1570f575c6f37048e7dd6ab23e99b12b9845e8f

Workflow

Publishing configuration: github.com/tmolteno/python-necpp/blob/c1570f575c6f37048e7dd6ab23e99b12b9845e8f/.github/workflows/build-necpp-wheels.yml
Publishing logs: github.com/tmolteno/python-necpp/actions/runs/30769545757/attempts/1

Artifact

Subject: necpp-2.3.4.tar.gz
SHA-256 checksum: a3b12517f71c7deabea0a7f97b918dc8a1b45f2f82854cae543603b4e935cb79 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.