PyNAVIS

pyNAVIS: an open-source cross-platform Neuromorphic Auditory VISualizer

<p> <img align="right" height="180" width="180" src="https://github.com/jpdominguez/pyNAVIS/blob/master/images/wiki-images/pynavis_logo.png?raw=true"/> <a href="http://www.gnu.org/licenses/gpl-3.0"> <img src="https://img.shields.io/badge/License-GPL%20v3-blue.svg"/> </a> <a href="https://pypi.python.org/pypi/pyNAVIS"> <img src="https://img.shields.io/pypi/v/pyNAVIS.svg"/> </a> <a href="https://pynavis.readthedocs.io/en/latest"> <img src="https://readthedocs.org/projects/pynavis/badge/?version=latest"/> </a> </p> <p align="justify"> pyNAVIS is an open-source cross-platform Python module for analyzing and processing spiking information obtained from neuromorphic auditory sensors. It is primarily focused to be used with a NAS, but can work with any other cochlea sensor.</p> </p> <h2>Installing</h2> <p align="justify"> pyNAVIS is distributed on <a href="https://pypi.org/project/pyNAVIS/">PyPi</a> and can be installed with pip:

pip install pyNAVIS

For more information, head over to the <a href="https://pynavis.readthedocs.io/en/latest/">ReadTheDocs Documentation</a>.

</p> <h2>Getting started</h2> <p align="justify"> Now that you have everything set up, you can create a new Python file and import the package:

from pyNAVIS import *

With this, you can now use all the functionalities that pyNAVIS provides. A more detailed guide with examples can be read <a href="https://pynavis.readthedocs.io/en/latest/Getting%20started.html">here</a>.

</p> <h2>Software package</h2> <p align="justify"> The Python code has been documented using docstrings, which is very convenient for users that want to either use the software or develop new features and functionalities. </p> <p align="justify"> To see all the information for the different Python modules, classes, methods and all the possible configuration options, read the <a href="https://pynavis.readthedocs.io/en/latest/pyNAVIS.html">pyNAVIS package section</a>. </p> <h2>Contributing</h2> <p align="justify"> New functionalities or improvements to the existing project are welcome. To contribute to this project please follow these guidelines: <ol align="justify"> <li> Search previous suggestions before making a new one, as yours may be a duplicate.</li> <li> Fork the project.</li> <li> Create a branch.</li> <li> Commit your changes to improve the project.</li> <li> Push this branch to your GitHub project.</li> <li> Open a <a href="https://github.com/jpdominguez/pyNAVIS/pulls">Pull Request</a>.</li> <li> Discuss, and optionally continue committing.</li> <li> Wait untill the project owner merges or closes the Pull Request.</li> </ol> If it is a new feature request (e.g., a new functionality), post an issue to discuss this new feature before you start coding. If the project owner approves it, assign the issue to yourself and then do the steps above. </p> <p align="justify"> Thank you for contributing to pyNAVIS! </p> <h2 name="Cite">Cite this work</h2> <p align="justify"> <b>APA</b>: Dominguez-Morales, J. P., Gutierrez-Galan, D., Rios-Navarro, A., Duran-Lopez, L., Dominguez-Morales, M., & Jimenez-Fernandez, A. (2021). pyNAVIS: An open-source cross-platform software for spike-based neuromorphic audio information processing. Neurocomputing, 449, 172-175. </p> <p align="justify"> <b>ISO 690</b>: DOMINGUEZ-MORALES, Juan P., et al. pyNAVIS: An open-source cross-platform software for spike-based neuromorphic audio information processing. Neurocomputing, 2021, vol. 449, p. 172-175. </p> <p align="justify"> <b>MLA</b>: Dominguez-Morales, Juan P., et al. "pyNAVIS: An open-source cross-platform software for spike-based neuromorphic audio information processing." Neurocomputing 449 (2021): 172-175. </p> <p align="justify"> <b>BibTeX</b>: @article{dominguez2021pynavis, title={pyNAVIS: An open-source cross-platform software for spike-based neuromorphic audio information processing}, author={Dominguez-Morales, Juan P and Gutierrez-Galan, D and Rios-Navarro, A and Duran-Lopez, L and Dominguez-Morales, M and Jimenez-Fernandez, A}, journal={Neurocomputing}, volume={449}, pages={172--175}, year={2021}, publisher={Elsevier} } </p> <h2>License</h2> <p align="justify"> This project is licensed under the GPL License - see the <a href="https://github.com/jpdominguez/pyNAVIS/blob/master/LICENSE">LICENSE.md file</a> for details. </p> <p align="justify"> Copyright © 2018 Juan P. Dominguez-Morales<br> <a href="mailto:jpdominguez@atc.us.es">jpdominguez@atc.us.es</a> </p>