pyGDM2


NamepyGDM2 JSON
Version 1.1.8 PyPI version JSON
download
home_pagehttps://gitlab.com/wiechapeter/pyGDM2
SummaryA python full-field electrodynamical solver, based on the Green dyadic method (volume integral technique in frequency domain).
upload_time2024-10-17 10:35:30
maintainerNone
docs_urlNone
authorPeter R. Wiecha
requires_python>=3.7
licenseGPLv3+
keywords coupled dipoles method green dyadic method electrodynamical simulations nano optics frequency-domain
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ***********************************
Requirements / Installation
***********************************

pyGDM is an open source python toolkit for electro-dynamical simulations, implementing the `Green dyadic method (GDM) <https://doi.org/10.1088/0034-4885/68/8/R05>`_, a volume discretization technique. 
pyGDM is based on simulation codes and theoretical models developed over the past 20 years by `Christian Girard <http://www.cemes.fr/Theory-of-Complex-Nano-optical?lang=en>`_ at CEMES (see e.g. `Ch. Girard 2005 Rep. Prog. Phys. 68 1883 <https://doi.org/10.1088/0034-4885/68/8/R05>`_), with contributions from G. Colas des Francs, A. Arbouet, R. Marty, C. Majorel, A. Patoux, Y. Brûlé and P.R. Wiecha.
In contrast to most other coupled-dipole codes, pyGDM uses a `generalized propagator <https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.74.526>`_, which allows to cost-efficiently treat large monochromatic problems such as angle-of-incidence scans or raster-scan simulations.

pyGDM2 is available on `pypi <https://pypi.python.org/pypi/pygdm2/>`_ and `gitlab <https://gitlab.com/wiechapeter/pyGDM2>`_. 

Detailed documentation with many examples can be found at the `pyGDM2 documentation website <https://wiechapeter.gitlab.io/pyGDM2-doc/>`_. See also the `documentation paper on arXiv (1802.04071) <https://arxiv.org/abs/1802.04071>`_ or a more `theoretical review about the GDM method <https://doi.org/10.1088/0034-4885/68/8/R05>`_.




Requirements
================================

Python
------------------
    - **python** (3.5+, `python <https://www.python.org/>`_)
    - **numba** (to drastically accelerate computations we use `numba <http://numba.pydata.org/>`_)
    - **numpy** (`numpy <http://www.numpy.org/>`_)
    - **scipy** >= v0.17.0, lower versions supported with restrictions (`scipy <https://www.scipy.org/>`_)

Optional Python packages
-------------------------------------
    - **pytables** (v3.x recommended. For hdf5 saving/loading of simulations. `pytables <https://www.pytables.org/>`_)
    - **matplotlib** (*Strongly recommended*. For all 2D visualization tools. `matplotlib <https://matplotlib.org/>`_)
    - **mayavi** (for all 3D visualization. `mayavi <http://docs.enthought.com/mayavi/mayavi/mlab.html>`_)
    - **mpi4py** (for MPI parallelized calculation of spectra. `mpi4py <http://mpi4py.readthedocs.io/en/stable/>`_)
    - **PIL** (image processing. `PIL <https://pypi.python.org/pypi/PIL>`_)
    - **PaGMO / PyGMO** (version 2.4+. *Required* for the **EO** submodule. `pagmo <https://esa.github.io/pagmo2/>`_)
    - **cupy** (version 7+, for GPU-based matrix inversion) `cupy <https://docs-cupy.chainer.org/en/stable/index.html>`_)

(all available via `pip <https://pypi.python.org/pypi/pip>`_)



Installation under linux
=============================================

Via pip
-------------------------------

Install from pypi repository via

.. code-block:: bash
    
    $ pip install pygdm2



Via source code
-------------------------------

From source, install pyGDM via the setup-script. *DO NOT use the setup.py directly for installation*, this may install pyGDM as "egg" which leads to problems with *numba* caching.
Please use pip instead. Run the following command in the source directory:

.. code-block:: bash
    
    $ pip3 install . --user

For a system wide installation, run as superuser without the *--user* argument. 
To install to a user-defined location, use the *target* option:

.. code-block:: bash
    
    $ pip3 install . --target=/some/specific/location


To only compile without installation, you can use the setup.py script

.. code-block:: bash
    
    $ python3 setup.py build sdist


        


Installation under windows
=============================================

For windows, we also recommend `Anaconda <https://www.anaconda.com/download/#windows>`_ in which pyGDM can be installed easily via pip. From pyGDM2 V1.1 on, installation from source should work straightforward in any other python distribution as well (described above).

Via pip
-------------------------------

We provide a 64bit windows binary on the pypi repository (tested on Win7 and Win10). Install via

.. code-block:: bash
    
    $ pip install pygdm2



Installation under Mac OS X
=============================================

Tested with the pypi version, installation via pip, with the Anaconda distribution. From pyGDM2 V1.1 on, installation from source should work straightforward in any other python distribution as well (described above).

   .. code-block:: bash
    
        $ pip install pygdm2




Authors
=========================

Python implementation
------------------------
   - P\. R. Wiecha
   - contributions by A\. Arbouet, C\. Majorel, Y. Brûlé, A\. Patoux


Original fortran code by
-------------------------
   - **Ch\. Girard**
   - G\. Colas des Francs
   - A\. Arbouet
   - R\. Marty
   - P\. R. Wiecha



   



            

Raw data

            {
    "_id": null,
    "home_page": "https://gitlab.com/wiechapeter/pyGDM2",
    "name": "pyGDM2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "coupled dipoles method, green dyadic method, electrodynamical simulations, nano optics, frequency-domain",
    "author": "Peter R. Wiecha",
    "author_email": "pwiecha@laas.fr",
    "download_url": "https://files.pythonhosted.org/packages/09/09/d05d47993ce3e57947d7b1940bcd25c16796e5fb219e44897431328495ae/pygdm2-1.1.8.tar.gz",
    "platform": null,
    "description": "***********************************\nRequirements / Installation\n***********************************\n\npyGDM is an open source python toolkit for electro-dynamical simulations, implementing the `Green dyadic method (GDM) <https://doi.org/10.1088/0034-4885/68/8/R05>`_, a volume discretization technique. \npyGDM is based on simulation codes and theoretical models developed over the past 20 years by `Christian Girard <http://www.cemes.fr/Theory-of-Complex-Nano-optical?lang=en>`_ at CEMES (see e.g. `Ch. Girard 2005 Rep. Prog. Phys. 68 1883 <https://doi.org/10.1088/0034-4885/68/8/R05>`_), with contributions from G. Colas des Francs, A. Arbouet, R. Marty, C. Majorel, A. Patoux, Y. Br\u00fbl\u00e9 and P.R. Wiecha.\nIn contrast to most other coupled-dipole codes, pyGDM uses a `generalized propagator <https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.74.526>`_, which allows to cost-efficiently treat large monochromatic problems such as angle-of-incidence scans or raster-scan simulations.\n\npyGDM2 is available on `pypi <https://pypi.python.org/pypi/pygdm2/>`_ and `gitlab <https://gitlab.com/wiechapeter/pyGDM2>`_. \n\nDetailed documentation with many examples can be found at the `pyGDM2 documentation website <https://wiechapeter.gitlab.io/pyGDM2-doc/>`_. See also the `documentation paper on arXiv (1802.04071) <https://arxiv.org/abs/1802.04071>`_ or a more `theoretical review about the GDM method <https://doi.org/10.1088/0034-4885/68/8/R05>`_.\n\n\n\n\nRequirements\n================================\n\nPython\n------------------\n    - **python** (3.5+, `python <https://www.python.org/>`_)\n    - **numba** (to drastically accelerate computations we use `numba <http://numba.pydata.org/>`_)\n    - **numpy** (`numpy <http://www.numpy.org/>`_)\n    - **scipy** >= v0.17.0, lower versions supported with restrictions (`scipy <https://www.scipy.org/>`_)\n\nOptional Python packages\n-------------------------------------\n    - **pytables** (v3.x recommended. For hdf5 saving/loading of simulations. `pytables <https://www.pytables.org/>`_)\n    - **matplotlib** (*Strongly recommended*. For all 2D visualization tools. `matplotlib <https://matplotlib.org/>`_)\n    - **mayavi** (for all 3D visualization. `mayavi <http://docs.enthought.com/mayavi/mayavi/mlab.html>`_)\n    - **mpi4py** (for MPI parallelized calculation of spectra. `mpi4py <http://mpi4py.readthedocs.io/en/stable/>`_)\n    - **PIL** (image processing. `PIL <https://pypi.python.org/pypi/PIL>`_)\n    - **PaGMO / PyGMO** (version 2.4+. *Required* for the **EO** submodule. `pagmo <https://esa.github.io/pagmo2/>`_)\n    - **cupy** (version 7+, for GPU-based matrix inversion) `cupy <https://docs-cupy.chainer.org/en/stable/index.html>`_)\n\n(all available via `pip <https://pypi.python.org/pypi/pip>`_)\n\n\n\nInstallation under linux\n=============================================\n\nVia pip\n-------------------------------\n\nInstall from pypi repository via\n\n.. code-block:: bash\n    \n    $ pip install pygdm2\n\n\n\nVia source code\n-------------------------------\n\nFrom source, install pyGDM via the setup-script. *DO NOT use the setup.py directly for installation*, this may install pyGDM as \"egg\" which leads to problems with *numba* caching.\nPlease use pip instead. Run the following command in the source directory:\n\n.. code-block:: bash\n    \n    $ pip3 install . --user\n\nFor a system wide installation, run as superuser without the *--user* argument. \nTo install to a user-defined location, use the *target* option:\n\n.. code-block:: bash\n    \n    $ pip3 install . --target=/some/specific/location\n\n\nTo only compile without installation, you can use the setup.py script\n\n.. code-block:: bash\n    \n    $ python3 setup.py build sdist\n\n\n        \n\n\nInstallation under windows\n=============================================\n\nFor windows, we also recommend `Anaconda <https://www.anaconda.com/download/#windows>`_ in which pyGDM can be installed easily via pip. From pyGDM2 V1.1 on, installation from source should work straightforward in any other python distribution as well (described above).\n\nVia pip\n-------------------------------\n\nWe provide a 64bit windows binary on the pypi repository (tested on Win7 and Win10). Install via\n\n.. code-block:: bash\n    \n    $ pip install pygdm2\n\n\n\nInstallation under Mac OS X\n=============================================\n\nTested with the pypi version, installation via pip, with the Anaconda distribution. From pyGDM2 V1.1 on, installation from source should work straightforward in any other python distribution as well (described above).\n\n   .. code-block:: bash\n    \n        $ pip install pygdm2\n\n\n\n\nAuthors\n=========================\n\nPython implementation\n------------------------\n   - P\\. R. Wiecha\n   - contributions by A\\. Arbouet, C\\. Majorel, Y. Br\u00fbl\u00e9, A\\. Patoux\n\n\nOriginal fortran code by\n-------------------------\n   - **Ch\\. Girard**\n   - G\\. Colas des Francs\n   - A\\. Arbouet\n   - R\\. Marty\n   - P\\. R. Wiecha\n\n\n\n   \n\n\n",
    "bugtrack_url": null,
    "license": "GPLv3+",
    "summary": "A python full-field electrodynamical solver, based on the Green dyadic method (volume integral technique in frequency domain).",
    "version": "1.1.8",
    "project_urls": {
        "Homepage": "https://gitlab.com/wiechapeter/pyGDM2"
    },
    "split_keywords": [
        "coupled dipoles method",
        " green dyadic method",
        " electrodynamical simulations",
        " nano optics",
        " frequency-domain"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0909d05d47993ce3e57947d7b1940bcd25c16796e5fb219e44897431328495ae",
                "md5": "fa067ddffd1940b34246a20c0d315c4e",
                "sha256": "848f62fd4e7c3b1bdb00dce6ebaaf8eba8457d11163dde22daebe70925f44620"
            },
            "downloads": -1,
            "filename": "pygdm2-1.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "fa067ddffd1940b34246a20c0d315c4e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 357664,
            "upload_time": "2024-10-17T10:35:30",
            "upload_time_iso_8601": "2024-10-17T10:35:30.159802Z",
            "url": "https://files.pythonhosted.org/packages/09/09/d05d47993ce3e57947d7b1940bcd25c16796e5fb219e44897431328495ae/pygdm2-1.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-17 10:35:30",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "wiechapeter",
    "gitlab_project": "pyGDM2",
    "lcname": "pygdm2"
}
        
Elapsed time: 0.30570s