Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ihhub/penguinv
Computer vision library with focus on heterogeneous systems
https://github.com/ihhub/penguinv
avx computer-vision cpp cuda gpu hacktoberfest heterogeneous-systems image-processing opencl python simd sse thread-pool
Last synced: about 3 hours ago
JSON representation
Computer vision library with focus on heterogeneous systems
- Host: GitHub
- URL: https://github.com/ihhub/penguinv
- Owner: ihhub
- License: other
- Created: 2016-06-09T04:56:17.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-03-18T15:05:56.000Z (10 months ago)
- Last Synced: 2024-12-26T18:11:28.483Z (7 days ago)
- Topics: avx, computer-vision, cpp, cuda, gpu, hacktoberfest, heterogeneous-systems, image-processing, opencl, python, simd, sse, thread-pool
- Language: C++
- Homepage:
- Size: 3.89 MB
- Stars: 119
- Watchers: 13
- Forks: 90
- Open Issues: 106
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
penguinV
======
PenguinV is a powerful **image processing** library with focus on heterogeneous systems.
The library is designed with an idea to have common API for CPUs and GPUs simplifying developer's work on context switching between devices.
Core features of the library:
- heterogeneous system support (CPUs and GPUs)
- CUDA, OpenCL and SIMD (SSE, AVX, NEON) support
- [Python support](https://github.com/ihhub/penguinV/tree/master/src/python)
- [multithreading support](#multithreading-support)
- cross-platform (Windows, Linux, MacOS)
- compactness
- ability to process separate parts of an image (ROI)
- user-defined image types and more.
What can it do?
---------------------------
You can develop a software within minutes of your time to obtain **high performance** and **accuracy**.
It is up to developer to decide which device (CPU or GPU) would execute the code or give such control to the library.
Example code for below images could look like this:
```cpp
Image red = ExtractChannel( image, RED_CHANNEL );
Image binary = Threshold( red, // threshold
GetThreshold( // get weighted threshold
Histogram( red ) ) ) ); // get image histogram
BlobDetection detection;
...
detection.find( binary );
...
Image rgb = ConvertToRgb( binary );
rgb = BitwiseAnd( image, rgb );
...
rgb = BitwiseOr( image, rgb );
```
The trick behind the code is that you have a **single interface** for CPU as well as for GPU!
   
 
Contribution
---------------------------
[](https://github.com/ihhub/penguinv/actions)
We welcome and appreciate any help, even if it's a tiny text or code change.
Please read [contribution](https://github.com/ihhub/penguinV/blob/master/CONTRIBUTING.md) page before starting work on a pull request.
Not sure what to start with? Feel free to refer to [good first issue](https://github.com/ihhub/penguinV/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) or [help wanted](https://github.com/ihhub/penguinV/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) tags.
Requirements
---------------------------
To compile the source code your compiler must support at least **C++ 11** version.
How to install
---------------------------
The library is distributed in the form of source code. To use the library you need to include necessary files into your application project. That's it! No more extra moves!
How to compile an example
---------------------------
Open README.md file in any of [example](https://github.com/ihhub/penguinV/tree/master/examples) directories and follow instructions.
Multithreading support
---------------------------
The library contains it's own thread pool which creates multiple tasks to run image processing function for a given image via multiple threads. Such tenchnique gives a big boost on machines with major CPU usage.
GPU support
---------------------------
All source code and descriptions related to CUDA or OpenCL are located in separate [**src/cuda**](https://github.com/ihhub/penguinV/tree/master/src/cuda) and [**src/opencl**](https://github.com/ihhub/penguinV/tree/master/src/opencl) directories respectively. Read full description about CUDA or OpenCL support in **README** file in the directory.
License
---------------------------
This project is under 3-clause BSD License. Please refer to file [**LICENSE**](https://github.com/ihhub/penguinV/blob/master/LICENSE) for more details.
API description
---------------------------
Directory [**doc**](https://github.com/ihhub/penguinV/tree/master/doc) contains latest and valid information and description of library's API.