Hydra Image Processor (HIP) has been written to expedite the addition of functionality. All of the machinery needed to distribute data and iterate over neighborhoods is included. Adding a new function is as easy as copying a template file and replacing the requisite lines of code. This paradigm is intended to encourage research and development of operations that would otherwise be intractable without hardware acceleration.
Contribution is as easy as a pull request on GitHub. Following the guidelines will ensure requests are not rejected for minor issues. Once your code conforms to the guidelines, please submit your requests here.
Alternatively, you can contribute by detailing your needs on this forum. HIP was also designed to be a practical library that meets the needs of microscopist. I really enjoy when theory and application meet. By explaining in detail (examples are always helpful as well) what your needs are, the community will be able to find novel ways accomplish your goals.
From the very beginning HIP was written to be clean, consistent, and as clear as possible. The use of object oriented programming and templates have made this project quickly extensible as well as maintainable. Each portion of code, down to the lowest operation, should be as "glanceable" as possible. Meaning that use of spacing, letter case, and naming scheme should be as information dense as possible. It all boils down to, make code that assists the reader in their understanding of what it is intended to accomplish.
- Format, format, format. Make it look clean and consistent with existing code.
- Do not duplicate functionality. Use existing functions/classes when possible. Consider extending existing functionality before creating new.
- Use templates to ensure code maintainability.
- Mimic what as already been done. If code looks inconsistent or "out of place." Correct it or bring it to the community's attention.
- Try crazy things! HIP was built to quickly get operations onto GPU hardware. Use this opportunity to create things that would not otherwise be tractable.