Metadata-Version: 2.1
Name: nestpy
Version: 1.4.7
Summary: Python bindings for the NEST noble element simulations
Home-page: UNKNOWN
Author: Christopher Tunnell
Author-email: tunnell@rice.edu
License: UNKNOWN
Project-URL: nestpy source, https://github.com/NESTCollaboration/nestpy
Project-URL: NEST library, https://github.com/NESTCollaboration/nest
Project-URL: NEST collaboration, http://nest.physics.ucdavis.edu/
Description: # nestpy
        
        [![Join the chat at https://gitter.im/NESTCollaboration/nestpy](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/NESTCollaboration/nestpy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
        [![Build Status](https://travis-ci.org/NESTCollaboration/nestpy.svg?branch=master)](https://travis-ci.org/NESTCollaboration/nestpy)
        [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1345595.svg)](https://doi.org/10.5281/zenodo.1345595)
        [![PyPi version](https://pypip.in/v/nestpy/badge.png)](https://pypi.org/project/nestpy/)
        [![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
        [![Python Versions](https://img.shields.io/pypi/pyversions/nestpy.svg)](https://pypi.python.org/pypi/nestpy)
        
        Visit the tutorials directory for tutorials on the nestpy calls, maintenance, and benchmark plots. 
        
        These are the Python bindings for the [NEST library](https://github.com/NESTCollaboration/nest), which provides a direct wrapping of functionality.  The library is not Pythonic at this point but just uses the existing naming conventions from the C++ library.
        
        You do *not* have to have NEST already installed to use this package.
        
        ## Installing from PyPI
        
        For 64-bit Linux or Mac systems, instally 'nestpy' should just require running:
        
        ```
        pip install nestpy
        ```
        
        You can then test that it works by running the example above.
        
        ## Installing from source
        
        Requirements: You must have CMake>=2.8.12 and a C++11 compatible compiler (GCC>=4.8) to build.
        
        First, you must check out this repository then simply run the installer:
        
        ```
        git clone https://github.com/NESTCollaboration/nestpy
        cd nestpy
        python setup.py install
        ```
        
        ## Usage
        
        Python bindings to the NEST library:
        
        ```
        import nestpy
        
        # This is same as C++ NEST with naming
        nc = nestpy.NESTcalc(nestpy.VDetector())
        
        interaction = nestpy.INTERACTION_TYPE(0)  # NR
        
        E = 10  # keV
        print('For an %s keV %s' % (E, interaction))
        
        # Get particle yields
        y = nc.GetYields(interaction,
        		 E)
        
        print('The photon yield is:', y.PhotonYield)
        print('With statistical fluctuations',
              nc.GetQuanta(y).photons)
        ```
        
        For more examples on possible calls, please see the tests and tutorials folders.
        
        ### Support
        
        * Bugs: Please report bugs to the [issue tracker on Github](https://github.com/NESTCollaboration/nestpy/issues) such that we can keep track of them and eventually fix them.  Please explain how to reproduce the issue (including code) and which system you are running on.
        * Help: Help can be provided also via the issue tracker by tagging your issue with 'question'
        * Contributing:  Please fork this repository then make a pull request.  In this pull request, explain the details of your change and include tests.
        
        ## Technical implementation
        
        This package is a [pybind11](https://pybind11.readthedocs.io/en/stable/intro.html) wrapper of [NEST](https://github.com/NESTCollaboration/nest) that uses [TravisCI](https://travis-ci.org) to build binaries using the [manylinux](https://github.com/pypa/python-manylinux-demo) [Docker image](https://www.docker.com).
        
        * Help from Henry Schreiner, which included a great [binding tutorial](https://indico.cern.ch/event/694818/contributions/2985778/attachments/1682465/2703470/PyHEPTalk.pdf)
        * Implementation also based on [this](http://www.benjack.io/2018/02/02/python-cpp-revisited.html)
        
        See AUTHORS.md for information on the developers.
        
        ## Citation
        
        When you use `nestpy`, please say so in your slides or publications (for publications, see Zenodo link above).  You can mention this in addition to how you cite NEST.  This is important for us being able to get funding to support this project.
        
        
        
        History
        =======
        
        Patch releases mean (the Z number in X.Y.Z version) that the underlying physics has not changed.  Changes to the NEST version will always trigger a minor or major release.  If this library changes such that end users have to change their code, this may also trigger a minor or major release.
        
        1.4.6 (2021-03-03)
        -----------------
        Sync with [NEST v2.2.1](https://github.com/NESTCollaboration/nest/releases/tag/v2.2.1)
          * Cleaned up MANIFEST so pypi dist packages are less bulky
            [#56](https://github.com/NESTCollaboration/nestpy/pull/56)
          * Added floating point comparison method for equality checks
            [#54](https://github.com/NESTCollaboration/nestpy/pull/54)
          * Random Number Generation in bindings.cpp to ensure quanta are truly randomized.
            [#54](https://github.com/NESTCollaboration/nestpy/pull/54)
          * Binding to Kr83m yields model directly so users can specify explicity deltaT_ns between decay modes.
            [#55](https://github.com/NESTCollaboration/nestpy/pull/55)
            
        1.4.5 (2021-03-01)
        -----------------
        (Pre-release, see version 1.4.6 for distributions)
        <br>
        Sync with [NEST v2.2.1](https://github.com/NESTCollaboration/nest/releases/tag/v2.2.1)
        
        1.4.4 (2021-02-10)
        -----------------
        NEST v2.2.0 (no NEST changes)
          * PyPi calls improved to compile for linux
        
        1.4.3 (2021-02-08)
        -----------------
        NEST v2.2.0 (no NEST changes)
          * Attempted bug fix (fixed properly in 1.4.4)
          * New tutorials directory
        
        1.4.2 (2021-02-01)
        -----------------
          * Bind with LUX detector file 
          * Fix interaction key interpretation in helpers
        
        1.4.1 (2020-12-15)
        -----------------
        Sync with v2.2.0 NEST. 
        Includes all files in MANIFEST.in, so that pip install will work.
        
        1.4.0 (2020-11-19)
        -----------------
        Minor changes all are to fix software bugs, no physics changes. 
        
          * MANIFEST.in include requirements
          * Make sure to include all dependencies. 
          * Fix travis builds. 
        
        1.4.0beta (2020-11-14)
        -----------------
        
        NESTv2.2.0beta
        
        1.3.2 (2020-11-11)
        -----------------
        
        NESTv2.1.2
          * New free parameters registered
          * Cases of void initialization in tests fixed
          * Introduced files for debugging tests as we improve code
          * Prepared for NEST v.2.2 which is imminent
          * Solved half of GetS1 and GetS2 issues opened in #37
        
        
        1.3.1 (2020-08-26)
        -----------------
        
        NESTv2.1.1
        
        1.3.0 (2020-07-06)
        ------------------
        
        NESTv2.1.0
        
        1.2.1 (2020-06-20)
        ------------------
        
        NESTv2.1.0beta
        
        1.1.4 (2020-06-20)
        ------------------
        
        * Update pybind11 2.5.0
        * Fix manylinux build 
        * Add Python 3.8 support
        
        1.1.3 (2019-08-05)
        ------------------
        
        Default arguments for GetYields and GetQuanta (see PR #25)
        
        
        1.1.2 (2019-08-02)
        ------------------
        
        NESTv2.0.1
        
        * execNEST included in nestpy
        * Extensive bug fixes and testing improvements
        
        1.1.1 (2018-08-29)
        ------------------
        
        NESTv2.0.0
        
        * Fix source installation (See #16).
        
        1.1.0 (2018-08-18)
        ------------------
        
        NESTv2.0.0
        
        * Release to world.
        * Cleanup (#15)
        
        1.0.3 (2018-08-18)
        ------------------
        
        NESTv2.0.0
        
        * README broken links fixed
        
        1.0.2 (2018-08-18)
        ------------------
        
        NESTv2.0.0
        
        * Metadata (classifier in setup.py, badges, chat) (#14)
        
        1.0.1 (2018-08-18)
        ------------------
        
        NESTv2.0.0
        
        * Retrigger release for PyPI deployment
        
        1.0.0 (2018-08-18)
        ------------------
        
        NESTv2.0.0
        
        * First release intended for general public.
        * Mac OSX support (#10)
        * Complete tests and various bug fixes (#13)
        * Documentation, citation, and technical detail writing
        
        
        0.2.3 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * Still working on PyPI
        
        0.2.2 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * Fix lack of deploy of release to PyPI
        
        0.2.1 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * Fix tests that were breaking only in deploys
        
        0.2.0 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * Fully wrapped NEST (PR #5)
        
        0.1.1 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * First release that deploys on PyPI. Limited functionality. (PR #2)
        
        0.1.0 (2018-08-14)
        ------------------
        
        NESTv2.0.0
        
        * Initial release
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: C++
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
