Skip to main content

Python bindings for the NEST noble element simulations

Project description

nestpy

Join the chat at https://gitter.im/NESTCollaboration/nestpy Build Status DOI PyPi version Project Status: Active – The project has reached a stable, usable state and is being actively developed. Python Versions

These are the Python bindings for the NEST library, 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 checkout 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()

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 folder.

Support

  • Bugs: Please report bugs to the issue tracker on Github 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 wrapper of NEST that uses TravisCI to build binaries using the manylinux Docker image.

  • Help from Henry Schreiner, which included a great binding tutorial
  • Implementation also based on this

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.1.3 (2019-08-05)

Default arguments for GetYields and GetQuanta (see PR #25)

1.1.2 (2019-08-02)

NESTv2.0.1

  • testNEST 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

Download files

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

Files for nestpy, version 1.1.3
Filename, size File type Python version Upload date Hashes
Filename, size nestpy-1.1.3-cp27-cp27m-macosx_10_6_x86_64.whl (219.1 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp27-cp27m-manylinux1_x86_64.whl (231.7 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp27-cp27mu-manylinux1_x86_64.whl (231.7 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp34-cp34m-manylinux1_x86_64.whl (231.1 kB) File type Wheel Python version cp34 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp35-cp35m-macosx_10_6_x86_64.whl (205.6 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp35-cp35m-manylinux1_x86_64.whl (231.3 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp36-cp36m-macosx_10_7_x86_64.whl (218.3 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp36-cp36m-manylinux1_x86_64.whl (231.3 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp37-cp37m-macosx_10_7_x86_64.whl (222.4 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size nestpy-1.1.3-cp37-cp37m-manylinux1_x86_64.whl (231.3 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size nestpy-1.1.3.tar.gz (57.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page