Skip to main content

An Open-Source Python Library for the Development and Comparison of Algorithms in Two-Dimensional Electromagnetic Inverse Scattering Problems

Project description

eispy2d

An Open-Source Python Library for the development of algorithms for 2D Electromagnetic Inverse Scattering Problems (EISPs).

Motivation

This library was thought to provide a common and basic framework for researchers that want to test new ideas about algorithms for EISPs. Then, they will not need to develop the whole structure (domain model, discretization formulations, forward solvers, data visualization, statistical inference, etc).

What can I do with this library?

With the tools in this library, you can represent an instance of EISP, develop algorithms, run them, and analyze the results in many different ways. The library provides specific implementations for case studies and benchmarking, so one can get preliminary results, measure the performance, and compare with different algorithms or different versions of the same algorithm.

Model assumptions

Besides considering the two-dimensional formulation, we are assuming as well TMz polarization of incident waves and linear, isotropic, non-dispersive, and non-magnetic materials.

Install

Initially, the library was thought to be a collection of ".py" files that anyone can download and add to his/her project. It would be amazing if, one day, this library became a well-organized Python package which one can install through Pip or Conda. But, as this is an implementation developed by only one person, then these steps will be considered someday in the future. For while, you just need to download the codes and call the modules as you do with any library that you create.

Dependencies

Before using eispy2d, please ensure you have all the required dependencies installed. The project includes a requirements.txt file listing all necessary packages. You can install these dependencies by running pip install -r requirements.txt in your command line or terminal. These packages are essential for the proper functioning of the library, including numerical computations, visualization tools, and optimization algorithms that power the electromagnetic inverse scattering solvers.

How to use

You may find usages examples here. There are scripts and Jupyter Notebooks in which you can see how the classes are called, how to build a problem, how to run an experiment, etc.

Contribute

You are totally welcome to contribute to this library by finding bugs, suggesting changes, implementing the algorithms in the literature, and providing your algorithms so others can use them to compare in their experiments. You may add issues, send pull requests or contact me through e-mail.

Citation

We've already written an article describing the library. While it is still under review, its preprint version is available at the arXiv repository via this link. If you use this library, you may acknowledge by citing it:

@ARTICLE{11015426,
  author={Costa Batista, André and Adriano, Ricardo and Batista, Lucas S.},
  journal={IEEE Access}, 
  title={EISPY2D: An Open-Source Python Library for the Development and Comparison of Algorithms in Two-Dimensional Electromagnetic Inverse Scattering Problems}, 
  year={2025},
  volume={13},
  number={},
  pages={92134-92154},
  keywords={Libraries;Electromagnetic scattering;Imaging;Image reconstruction;Electromagnetics;Microwave theory and techniques;Microwave integrated circuits;Microwave imaging;Microwave FET integrated circuits;Inverse problems;Comparison of algorithms;electromagnetic inverse scattering problem;microwave imaging;open-source library;optimization},
  doi={10.1109/ACCESS.2025.3573679}
}

Further information

For further information and questions, please send me an email.

Have fun! André

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eispy2d-1.0.3.tar.gz (205.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eispy2d-1.0.3-py3-none-any.whl (231.2 kB view details)

Uploaded Python 3

File details

Details for the file eispy2d-1.0.3.tar.gz.

File metadata

  • Download URL: eispy2d-1.0.3.tar.gz
  • Upload date:
  • Size: 205.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for eispy2d-1.0.3.tar.gz
Algorithm Hash digest
SHA256 4af3836af4a2b5ec2bc2855ba0dd478d02d5b00ca669dec52563cc6a83b186ce
MD5 03656d28b38349f2843dee55048d0da4
BLAKE2b-256 111a9a59eb98b672a4c6806d3f47527b527e732c72eba690700d5ed2af32c795

See more details on using hashes here.

File details

Details for the file eispy2d-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: eispy2d-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 231.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for eispy2d-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 45a9544f47bf576048382ae274e984665321a6d02708426ef26e187e9686362f
MD5 894e05915a41f7f48e45852cb005993f
BLAKE2b-256 26f780a33225df6118cbb6a9c8672b13d744fcdf50a6f9ae70514f79fe82079c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page