deimos

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #machine-learning #docker #macos #windows #cli #vue #awesome-list #security #ios #mcp #open-source

(★ 11)

Implementations for various Computer Vision image processing functions from scratch in C with minimal dependencies

deimos 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Deimos

Deimos is an experimental computer vision library in C

> I am trying to distill my knowledge into [a computer vision guide](https://aadv1k.gitbook.io/cv-guide), which serves as an introductory guide to this field and goes into details about the algorithms implemented below. I welcome any suggestions/critiques, thanks!

## Features

- Geometric Transformations
  - [X] Rotation
  - [X] Scaling
  - [X] Shearing/Warping
- Smoothing
  - [X] Gaussian filter
  - [X] Median filter
  - [X] Bilateral filter
  - [X] Box filter
- Edge detection
  - [X] Unsharp mask
  - [X] Laplacian Filter (Difference of Gaussian)
  - [X] Sobel operator
- Color
  - [X] Greyscale
  - Contrast
- Thresholding
  - [X] Global
  - [X] Otsu's Method
- Feature extraction
  - [X]  Harris corner detection

## Build (Make)

```
git clone git@github.com:aadv1k/deimos
cd deimos/
make
```

## Build (without make)

> If you don't have make on windows, you can instead use the `build.bat`, it gets the job done.

```console
git clone git@github.com:aadv1k/deimos
cd deimos/
.\build.bat
```

## Examples

> **Note**
> The filters are un-optimized, they work best on smaller images

```console
./cv gray ../data/img1.jpg ./output.png
./cv sharpen --sigma 3 ../data/img1.jpg ./output.png
./cv blur --kernel 9 --sigma 5 ../data/img1.jpg ./output.png
```

## Usage

```console
Usage:
  ./bin/deimos <command> <args> input output

Examples:
  deimos blur --sigma 3.4 --kernel 5 input.png output.png
  deimos gray input.png output.png
  deimos median --kernel 3 input.png output.png
  deimos sharpen --sigma 0.6 --kernel 3 input.png output.png

Commands:
  Smoothing:
    blur, gaussian    Apply Gaussian blur to the image.
    median            Apply median filter to the image.
    bilateral         Apply bilateral filter to the image.
    box, mean         Apply box filter onto the image.

Edge Detection:
    sobel             Apply Sobel filter to the image.
    laplacian         Apply Laplacian filter onto the image.
    sharpen           Sharpen image via an unsharp mask.

Thresholding:
    global-threshold  Apply the global threshold filter over the image. 'sigma' would be the threshold.
    otsu-threshold    Apply Otsu's threshold filter over the image.

Feature Extraction:
    harris-corners    Detect corners within the image via Harris corner detection.

Transformations:
    rotate            Rotate the image by `sigma` deg.
    scale             Scale the image by sigma factor; if sigma is negative then downscale else upscale
    shear             Shear or skew the image at both axis by sigma factor.
    flipX             Horizontally mirror the image
    flipY             Vertically mirror the image

Color enhancements:
    gray              Convert image to grayscale.
    contrast          Increase/decrease contrast based on `sigma`

Other Commands:
    help              Print this help message.

Options:
  --sigma             Specify the primary modifier for the convolutions.
  --kernel            Define the kernel size for convolutions (if applicable).
  --no-threshold      Disable specifying a threshold for the sobel operator, default to setting gradient magnitude 
```

## Gallery

> **Note**
> this showcases only some of the many avaliable filters

### Gaussian blur

```console
./bin/deimos blur --kernel 9 --sigma 3 ./data/img1.jpg ./img1-gaussian-3-9.png
```

| Original Image | Gaussian Blur |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Gaussian Blur](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/gaussian-3-9.jpg) |

### Median filter

```console
./bin/deimos median --kernel 9 ./data/img1.jpg ../output.jpg
```

| Original Image | Median Filter |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Median Filter](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/median-9.jpg) |

### Unsharp mask

```console
./bin/deimos sharpen --kernel 9 --sigma 1.2 ./data/img1.jpg ../output.jpg
```

| Original Image | Unsharp Mask |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Unsharp Mask](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/sharpen-1-9.jpg) |

### Laplacian filter

```console
./bin/deimos laplacian --kernel 3 --sigma 1.5 ./data/img1.jpg ./output.jpg
```

| Original Image | Laplacian Filter |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Laplacian Filter](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/laplacian-1-3.jpg) |

</div>

### Otsu's Threshold

```console
./bin/deimos otsu-threshold ./data/img1.jpg ./output.jpg
```

| Original Image | Otsu's threshold |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Laplacian Filter](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/otsu-threshold.jpg) |

</div>

### Sobel operator

```console
./bin/deimos sobel --no-threshold ./data/img1.jpg ./output.jpg
```

| Original Image | Sobel Operator |
| --- | --- |
| ![Original Image](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/img1.jpg) | ![Laplacian Filter](https://raw.githubusercontent.com/Aadv1k/deimos/master/docs/.gitbook/assets/sobel.jpg) |

</div>

## Credits

Thanks to [Adrian Sieber](https://github.com/ad-si) for pointing out a fault in calculating Otsu's threshold. (See #1)

deimos

deimos 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

deimos

deimos 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README