{"id":13831667,"url":"https://github.com/gnuradio/volk","last_synced_at":"2025-05-14T19:08:42.794Z","repository":{"id":26751830,"uuid":"30209641","full_name":"gnuradio/volk","owner":"gnuradio","description":"The Vector Optimized Library of Kernels","archived":false,"fork":false,"pushed_at":"2025-03-10T22:56:44.000Z","size":3869,"stargazers_count":579,"open_issues_count":42,"forks_count":211,"subscribers_count":52,"default_branch":"main","last_synced_at":"2025-04-14T12:44:30.700Z","etag":null,"topics":["sdr","simd","simd-instructions","simd-programming"],"latest_commit_sha":null,"homepage":"http://libvolk.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnuradio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json"}},"created_at":"2015-02-02T21:29:47.000Z","updated_at":"2025-04-10T02:35:32.000Z","dependencies_parsed_at":"2023-10-03T14:57:28.644Z","dependency_job_id":"39b8ca9a-d87b-4638-831a-c44f9dd0b96d","html_url":"https://github.com/gnuradio/volk","commit_stats":{"total_commits":1512,"total_committers":121,"mean_commits":12.49586776859504,"dds":0.8928571428571429,"last_synced_commit":"dd258a959a33a9c4c7db34992fe20f2012a8c879"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuradio%2Fvolk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuradio%2Fvolk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuradio%2Fvolk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuradio%2Fvolk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnuradio","download_url":"https://codeload.github.com/gnuradio/volk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254209859,"owners_count":22032897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sdr","simd","simd-instructions","simd-programming"],"created_at":"2024-08-04T10:01:36.401Z","updated_at":"2025-05-14T19:08:41.656Z","avatar_url":"https://github.com/gnuradio.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.com/gnuradio/volk.svg?branch=master)](https://travis-ci.com/gnuradio/volk) [![Build status](https://ci.appveyor.com/api/projects/status/5o56mgw0do20jlh3/branch/master?svg=true)](https://ci.appveyor.com/project/gnuradio/volk/branch/master)\n![Check PR Formatting](https://github.com/gnuradio/volk/workflows/Check%20PR%20Formatting/badge.svg)\n![Run VOLK tests](https://github.com/gnuradio/volk/workflows/Run%20VOLK%20tests/badge.svg)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3360942.svg)](https://doi.org/10.5281/zenodo.3360942)\n\n![VOLK Logo](/docs/volk_logo.png)\n\n# Welcome to VOLK!\n\nVOLK is a sub-project of GNU Radio. Please see https://www.libvolk.org/ for bug\ntracking, documentation, source code, and contact information about VOLK.\nSee https://www.gnuradio.org/ for information about GNU Radio.\n\nVOLK is the Vector-Optimized Library of Kernels. It is a library that contains kernels of hand-written SIMD code for different mathematical operations. Since each SIMD architecture can be very different and no compiler has yet come along to handle vectorization properly or highly efficiently, VOLK approaches the problem differently.\n\nFor each architecture or platform that a developer wishes to vectorize for, a new proto-kernel is added to VOLK. At runtime, VOLK will select the correct proto-kernel. In this way, the users of VOLK call a kernel for performing the operation that is platform/architecture agnostic. This allows us to write portable SIMD code.\n\nBleeding edge code can be found in our git repository at\nhttps://www.gnuradio.org/git/volk.git/.\n\n## How to use VOLK:\n\nFor detailed instructions see https://www.libvolk.org/doxygen/using_volk.html\n\nSee these steps for a quick build guide.\n\n### Building on most x86 (32-bit and 64-bit) platforms\n\n```bash\n$ mkdir build\n$ cd build\n$ cmake ..\n$ make\n$ make test\n$ sudo make install\n\n# You might want to explore \"make -j[SOMEVALUE]\" options for your multicore CPU.\n\n# Perform post-installation steps\n\n# Linux OS: Link and cache shared library\n$ sudo ldconfig\n\n# macOS/Windows: Update PATH environment variable to point to lib install location\n\n# volk_profile will profile your system so that the best kernel is used\n$ volk_profile\n```\n\n#### Missing submodule\nWe use [cpu_features](https://github.com/google/cpu_features) to detect CPU features, e.g. AVX.\nSome platforms require a very recent version that is not available through the appropriate package manager.\nIn this case you must use `cpu_features` as a submodule.\n\n**NOTE**: Most package managers provide recent enough `cpu_features` versions by now. \nPlease default to the provided `cpu_features` version first, and only use the submodule in cases where this fails. \nPlease open an issue if this is the case.\n\nThere are two options to get the required code in a submodule:\n```bash\ngit clone --recursive https://github.com/gnuradio/volk.git\n```\nwill automatically clone submodules as well.\nIn case you missed that, you can just run:\n```bash\ngit submodule update --init --recursive\n```\nthat'll pull in missing submodules.\n\n\n### Building on Raspberry Pi and other ARM boards (32 bit)\n\nTo build for these boards you need specify the correct cmake toolchain file for best performance.\n\n_Note: There is no need for adding extra options to the compiler for 64 bit._\n\n* Raspberry Pi 5 `arm_cortex_a76_hardfp_native.cmake`\n* Raspberry Pi 4 `arm_cortex_a72_hardfp_native.cmake`\n* Raspberry Pi 3 `arm_cortex_a53_hardfp_native.cmake`\n\n```bash\n$ mkdir build \u0026\u0026 cd build\n$ cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/arm_cortex_a76_hardfp_native.cmake ..\n# make -j4 might be faster\n$ make\n$ make test\n$ sudo make install\n\n# volk_profile will profile your system so that the best kernel is used\n$ volk_profile\n```\n\n## Code of Conduct\nWe want to make sure everyone feels welcome. Thus, we follow our [Code of Conduct](docs/CODE_OF_CONDUCT.md).\n\n## Contributing\nWe are happy to accept contributions. [Please refer to our contributing guide for further details](docs/CONTRIBUTING.md).\nAlso, make sure to read the [Developer's Certificate of Origin](docs/DCO.txt) and make sure to sign every commit with `git commit -s`.\n\n## Releases and development\nWe maintain a [CHANGELOG](docs/CHANGELOG.md) for every release. Please refer to this file for more detailed information.\nWe follow semantic versioning as outlined in [our versioning guide](docs/versioning.md).\n\n## Supported platforms\nVOLK aims to be portable to as many platforms as possible. We can only run tests on some platforms.\n\n### Hardware architectures\nCurrently VOLK aims to run with optimized kernels on x86 with SSE/AVX and ARM with NEON.\nSupport for MIPS and RISC-V is experimental; some kernels are known not to work on these architectures.\n\n### OS / Distro\nWe run tests on a variety of Ubuntu versions and aim to support as many current distros as possible.\nThe same goal applies to different OSes. Although this does only rarely happen, it might occur that VOLK does not work on obsolete distros, e.g. Ubuntu 12.04.\n\n### Compilers\nWe want to make sure VOLK works with C/C++ standard compliant compilers. Of course, as an open source project we focus on open source compilers, most notably GCC and Clang.\nWe want to make sure VOLK compiles on a wide variety of compilers. Thus, we target AppleClang and MSVC as well. Mind that MSVC lacks `aligned_alloc` support for aligned arrays. We use MSVC specific instructions in this case which cannot be `free`'d with `free`.\n\n\n## License\n\n**VOLK 3.0 and later are licensed under the GNU Lesser General Public License v3.0 or later (LGPL-3.0-or-later).**\n\n### Previous VOLK version license\n\nEarlier versions of VOLK (before VOLK 3.0) were licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).\nSince then, VOLK migrated to the LGPL-3.0-or-later.\n\nBeing technical: There are 3 people left (out of 74) who we haven't been able to get in contact with (at all), for a total of 4 (out of 1092) commits, 13 (of 282822) additions, and 7 (of 170421) deletions. We have reviewed these commits and all are simple, trivial changes (e.g., 1 line change) and most are no longer relevant (e.g., to a file that no longer exists). Volk maintainers (@michaelld and @jdemel) are in agreement that the combination -- small numbers of changes per committer, simple changes per commit, commits no longer relevant -- means that we can proceed with relicensing without the approval of the folks. We will try reaching out periodically to these folks, but we believe it unlikely we will get a reply.\nWe kindly request them to re-submit their GPL-3.0-or-later license code contributions to LGPL-3.0-or-later by adding their name, GitHub handle, and email address(es) used for VOLK commits\nto the file [AUTHORS_RESUBMITTING_UNDER_LGPL_LICENSE.md](docs/AUTHORS_RESUBMITTING_UNDER_LGPL_LICENSE.md).\n\n### Legal Matters\n\nSome files have been changed many times throughout the years. Copyright\nnotices at the top of source files list which years changes have been\nmade. For some files, changes have occurred in many consecutive years.\nThese files may often have the format of a year range (e.g., \"2006 - 2011\"),\nwhich indicates that these files have had copyrightable changes made\nduring each year in the range, inclusive.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuradio%2Fvolk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnuradio%2Fvolk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuradio%2Fvolk/lists"}