Skip to content

Latest commit

 

History

History
68 lines (54 loc) · 2.48 KB

CONTRIBUTING.md

File metadata and controls

68 lines (54 loc) · 2.48 KB
Raw

Contributing to SIMDe

First off, if you're even reading this, thank you! There is a lot of work to do, and any help is appreciated.

If you haven't already, please read the README. The wiki also has some good information, especially the FAQ and a guide on how to implement a new function.

For information on developing for architectures you don't have access to, please see the Development Environment page on the wiki.

If you still have questions, or if anything below doesn't make sense to you, please feel free to use the issue tracker or the mailing list to ask. I know the SIMDe documentation needs a lot of improvement, and asking questions will help us understand what is missing, so please don't be shy!

Building the Tests

SIMDe contains an extensive test suite used for development. Most users will never need to build the suite, but if you're contributing code to SIMDe you'll need to build them.

Here is the basic procedure for compiling the tests:

mkdir test/build
cd test/build
CFLAGS="-march=native" CXXFLAGS="-march=native" cmake ..
make -j
./run-tests

Note that -march=native may not be the right flag for your compiler. That should work for most compilers on x86/x86_64, though MSVC is an exception (try /arch:AVX2 instead of -march=native). On other architectures please consult your compiler documentation to find out what flags you should use to enable the SIMD extension for your target platform. Here are a few to try:

  • ARM:
    • -march=armv8-a+simd (for ARMv8)
    • -march=armv7-a -mfpu=neon (for ARMv7)
  • POWER
    • -mcpu=native

If you need a flag not listed above, please let us know so we can add it to the list.

Coding Style

SIMDe has an EditorConfig file to configure your editor for things like tabs vs. spaces, how many spaces, etc. If you use an editor which doesn't support it out of the box then odds are good there is a plugin you can download; please do so.

For other coding style information, please see the Coding Style document in the Wiki.