https://github.com/mdouchement/bilateral

A Fast Bilateral image filter for Golang
https://github.com/mdouchement/bilateral

bilateral bilateral-filter filter golang image image-processing library

Last synced: over 1 year ago
JSON representation

A Fast Bilateral image filter for Golang

• Host: GitHub
• URL: https://github.com/mdouchement/bilateral
• Owner: mdouchement
• License: mit
• Created: 2018-02-27T18:50:56.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2020-05-10T02:11:30.000Z (about 6 years ago)
• Last Synced: 2025-01-07T06:50:10.775Z (over 1 year ago)
• Topics: bilateral, bilateral-filter, filter, golang, image, image-processing, library
• Language: Go
• Homepage:
• Size: 1.63 MB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Fast Bilateral filter for Golang

[![GoDoc](https://img.shields.io/badge/godoc-reference-blue.svg)](https://pkg.go.dev/github.com/mdouchement/bilateral)

[![Go Report Card](https://goreportcard.com/badge/github.com/mdouchement/bilateral)](https://goreportcard.com/report/github.com/mdouchement/bilateral)

[![License](https://img.shields.io/github/license/mdouchement/bilateral.svg)](http://opensource.org/licenses/MIT)

A FastBilateral filter is a non-linear, edge-preserving and noise-reducing

smoothing filter for images. The intensity value at each pixel in an image is

replaced by a weighted average of intensity values from nearby pixels.

Algorithm and implementation is based on http://people.csail.mit.edu/sparis/bf/ 


Please cite above paper for research purpose.

| Original | Filtered | Luminance Filtered |

|:--:|:--:|:--:|

| ![original](https://github.com/mdouchement/bilateral/blob/master/data/greekdome-gray.jpeg)



 | ![filtered](https://github.com/mdouchement/bilateral/blob/master/data/greekdome-gray-filtered.jpeg)
SigmaSpace: `16`
SigmaRange: `0.076` (auto)
Execution time `1.22s` | ![luminance](https://github.com/mdouchement/bilateral/blob/master/data/greekdome-gray-filtered-lum.jpeg)
SigmaSpace: `16`
SigmaRange: `0.76` (auto)
Execution time `348.56ms` |

| ![original](https://github.com/mdouchement/bilateral/blob/master/data/greekdome.jpeg)



 | ![filtered](https://github.com/mdouchement/bilateral/blob/master/data/greekdome-filtered.jpeg)
SigmaSpace: `16`
SigmaRange: `0.092` (auto)
Execution time `21.66s` | ![luminance](https://github.com/mdouchement/bilateral/blob/master/data/greekdome-filtered-lum.jpeg)
SigmaSpace: `16`
SigmaRange: `0.76` (auto)
Execution time `347.69ms` |

```go

// Fast Bilateral

bilateral.Auto(m)

// Luminance Fast Bilateral

luminance.Auto(m)

```

## Requirements

- Golang 1.7.x

## Installation

```bash

$ go get -u github.com/mdouchement/bilateral

```

## Usage

```go

fi, _ := os.Open("input_path")

defer fi.Close()

m, _, _ := image.Decode(fi)

start := time.Now()

fbl := bilateral.New(m, 16, 0.1)

fbl.Execute()

m2 := fbl.ResultImage() // Or use `At(x, y)` func or just use `fbl` as an image.Image for chained treatments.

fo, _ := os.Create("output_path")

defer fo.Close()

jpeg.Encode(fo, m2, &jpeg.Options{Quality: 100})

```

[Full example](https://github.com/mdouchement/bilateral/blob/master/data/main.go)

## Licence

MIT. See the [LICENSE](https://github.com/mdouchement/bilateral/blob/master/LICENSE) for more details.

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Launch linter (`gometalinter --config=gometalinter.json ./...`)

4. Commit your changes (`git commit -am 'Add some feature'`)

5. Push to the branch (`git push origin my-new-feature`)

6. Create new Pull Request