Skip to content

Latest commit

 

History

History
72 lines (57 loc) · 7.5 KB

CONTRIBUTING.md

File metadata and controls

72 lines (57 loc) · 7.5 KB
Raw

How to Contribute

We are very happy to see you reading this page!

Our team wholeheartedly and excitedly welcomes the community to contribute to ngc-learn. Contributions from members of the community will help ensure the long-term success of this project and achieve its goal to create useful tools for others to conduct research in biomimetic neural systems and algorithms. However, before you plan to make contributions, here are important resources to get started with:

We encourage the community to make major types of contributions including:

  • Bug fixes: Address open issues and fix bugs presented in the master branch (or find and fix currently unknown bugs).
  • Documentation fixes: Improving the documentation is just as important as improving the library itself. If you find a typo in the documentation, or have made improvements, do not hesitate to send an email or preferably submit a GitHub pull request. Documentation can be found under the docs directory (note that you will need to have installed all of the items in the specific requirements.txt file in /docs/ folder in order to build the Read the Docs documentation files).
  • Model museum designs: Implement new/classical predictive processing/coding and biomimetic (neural) models that appear in both modern/older publications or have been used in useful/interesting applications or analyses using ngc-learn's nodes and cables and integrate them into the Model Museum. Also notify us if you would like the NAC Laboratory to internally schedule integrating and including your published/used neurobiological model in the Model Museum.
  • Extensions to the core engine: Incorporate new nodes, including new/missing functionalities/aspects of neural dynamics, spiking cell models / response kernels, error neuron simulations, dendritic tree calculations, and optimizations, or cables, including new/missing synaptic transformations, such as complex or more neurobiologically-faithful transmission of (vector) signals, or synaptic update rules (neuromodulation, other variants of spike-time dependent plasticity, etc.).
  • Additional assets: Incorporate models (which would also go into the Model Museum) currently missing; for example, models/systems based on equilibrium propagation or competitive learning. This can include any missing functionality in the neural dynamics simulation that would support other aspects of neurobiological processing.
  • New functionalities: Implement new features (often placed in ngclearn/utils/) including, but not limited to, rendering/visualization tools, data generating processes to test/evaluate neural systems on, mathematical functions/distribution utilities helpful for analyzing or facilitating the calculations underlying simulated neural dynamics (such as other integration methods not found in ngc-learn's backend), and/or tests to further improve the library's completeness.
  • New demonstrations/tutorials: If you would like to contribute to ngc-learn's tutorials/demonstrations, we happily welcome informative contributions that explore different ways of using the library, including how a particular classical or landmark model or system can be built, simulated, and/or analyzed with ngc-learn. Please adhere to the style of the other tutorials (found under "Tutorials" in the documentation) to ensure uniformity.

Beyond the above items, there are many other ways to help. In particular answering queries on the issue tracker, reporting issues that you are facing, and giving a "thumbs up" on issues that others report and that are relevant to you.

If your research or application uses ngc-learn, please send us an email and we will update our "List of Papers/Publications" page to cite and include your work. Furthermore, if you use ngc-learn in teaching tutorials, organizing workshops, or in the classroom, please let us know and we will link to your public resource(s) given that one of ngc-learn's goals is to make research and education in predictive coding, spiking neural networks, neurobiologically-motivated neural systems, and computational cognitive neuroscience more accessible and open to individuals across disciplines.

Finally, it also helps us immensely if you spread the word: reference the project from your blog and articles, mention it in any of your slack/discord channels to interested groups, link to it from your website, or simply star it in GitHub.

Submission

Please read the coding conventions below and make sure that your code is consistent with ours. When making a contribution, make a pull request to ngc-learn with an itemized list of what you have done. When you submit a pull request, it is immensely helpful to include example script(s) that showcase the proposed changes and highlight any new APIs. We always love to see more test coverage. When it is appropriate, add a new test to accompany your contribution for checking the correctness of your code.

Coding Conventions

We value readability and adhere to the following coding conventions:

  • Indent using four spaces (soft tabs)
  • Always put spaces after list items and method parameters (e.g., [1, 2, 3] rather than [1,2,3]), and around operators and hash arrows (e.g., x += 1 rather than x+=1)
  • You must use the Google Python Style for the docstrings

We look forward to your contributions. Thank you!

The Neural Adaptive Computing (NAC) Laboratory and the ngc-learn development team