summaryrefslogtreecommitdiff
path: root/integralimg.go
blob: 007e2c6081963b1bd26cc67b9943c6b7e3d539b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
// Copyright 2019 Nick White.
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.

package integralimg

import (
	"image"
	"math"
)

// I is the Integral Image
type I [][]uint64

// Sq contains an Integral Image and its Square
type WithSq struct {
	Img I
	Sq I
}

// Window is a part of an Integral Image
type Window struct {
	topleft uint64
	topright uint64
	bottomleft uint64
	bottomright uint64
	width int
	height int
}

// ToIntegralImg creates an integral image
func ToIntegralImg(img *image.Gray) I {
	var integral I
	var oldy, oldx, oldxy uint64
	b := img.Bounds()
	for y := b.Min.Y; y < b.Max.Y; y++ {
		newrow := []uint64{}
		for x := b.Min.X; x < b.Max.X; x++ {
			oldx, oldy, oldxy = 0, 0, 0
			if x > 0 {
				oldx = newrow[x-1]
			}
			if y > 0 {
				oldy = integral[y-1][x]
			}
			if x > 0 && y > 0 {
				oldxy = integral[y-1][x-1]
			}
			pixel := uint64(img.GrayAt(x, y).Y)
			i := pixel + oldx + oldy - oldxy
			newrow = append(newrow, i)
		}
		integral = append(integral, newrow)
	}
	return integral
}

// ToSqIntegralImg creates an integral image of the square of all
// pixel values
func ToSqIntegralImg(img *image.Gray) I {
	var integral I
	var oldy, oldx, oldxy uint64
	b := img.Bounds()
	for y := b.Min.Y; y < b.Max.Y; y++ {
		newrow := []uint64{}
		for x := b.Min.X; x < b.Max.X; x++ {
			oldx, oldy, oldxy = 0, 0, 0
			if x > 0 {
				oldx = newrow[x-1]
			}
			if y > 0 {
				oldy = integral[y-1][x]
			}
			if x > 0 && y > 0 {
				oldxy = integral[y-1][x-1]
			}
			pixel := uint64(img.GrayAt(x, y).Y)
			i := pixel * pixel + oldx + oldy - oldxy
			newrow = append(newrow, i)
		}
		integral = append(integral, newrow)
	}
	return integral
}

// ToAllIntegralImg creates a WithSq containing a regular and
// squared Integral Image
func ToAllIntegralImg(img *image.Gray) WithSq {
	var s WithSq
	s.Img = ToIntegralImg(img)
	s.Sq = ToSqIntegralImg(img)
	return s
}


// GetWindow gets the values of the corners of a square part of an
// Integral Image, plus the dimensions of the part, which can
// be used to quickly calculate the mean of the area
func (i I) GetWindow(x, y, size int) Window {
	step := size / 2

	minx, miny := 0, 0
	maxy := len(i)-1
	maxx := len(i[0])-1

	if y > (step+1) {
		miny = y - step - 1
	}
	if x > (step+1) {
		minx = x - step - 1
	}

	if maxy > (y + step) {
		maxy = y + step
	}
	if maxx > (x + step) {
		maxx = x + step
	}

	return Window { i[miny][minx], i[miny][maxx], i[maxy][minx], i[maxy][maxx], maxx-minx, maxy-miny}
}

// GetVerticalWindow gets the values of the corners of a vertical
// slice of an Integral Image, starting at x
func (i I) GetVerticalWindow(x, width int) Window {
	maxy := len(i) - 1
	maxx := x + width
	if maxx > len(i[0])-1 {
		maxx = len(i[0]) - 1
	}

	return Window { i[0][x], i[0][maxx], i[maxy][x], i[maxy][maxx], width, maxy }
}

// GetHorizontalWindow gets the values of the corners of a horizontal
// slice of an Integral Image, starting at y
func (i I) GetHorizontalWindow(y, height int) Window {
	maxy := y + height
	maxx := len(i[0]) - 1
	if maxy > len(i) - 1 {
		maxy = len(i) - 1
	}

	return Window { i[y][0], i[y][maxx], i[maxy][0], i[maxy][maxx], maxx, height }
}

// Sum returns the sum of all pixels in a Window
func (w Window) Sum() uint64 {
	return w.bottomright + w.topleft - w.topright - w.bottomleft
}

// Size returns the total size of a Window
func (w Window) Size() int {
	return w.width * w.height
}

// Mean returns the average value of pixels in a Window
func (w Window) Mean() float64 {
	return float64(w.Sum()) / float64(w.Size())
}

// Proportion returns the proportion of pixels which are on
func (w Window) Proportion() float64 {
	area := w.width * w.height
	// divide by 255 as each on pixel has the value of 255
	sum := float64(w.Sum()) / 255
	return float64(area) / sum - 1
}

// MeanWindow calculates the mean value of a section of an Integral
// Image
func (i I) MeanWindow(x, y, size int) float64 {
	return i.GetWindow(x, y, size).Mean()
}

// MeanStdDevWindow calculates the mean and standard deviation of
// a section on an Integral Image
func (i WithSq) MeanStdDevWindow(x, y, size int) (float64, float64) {
	imean := i.Img.GetWindow(x, y, size).Mean()
	smean := i.Sq.GetWindow(x, y, size).Mean()

	variance := smean - (imean * imean)

	return imean, math.Sqrt(variance)
}