knok-build 0.4.0

Build-script graph tracing and code generation for knok
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

use knok_core::{CallOp, Padding2d, Pool2dOptions as CorePool2dOptions};

use super::{expr::call_output, tensor::TraceTensor};

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
/// Static options for traced 2D pooling.
pub struct Pool2dOptions {
    kernel: [usize; 2],
    padding: [usize; 4],
    stride: [usize; 2],
    dilation: [usize; 2],
}

impl Pool2dOptions {
    /// Creates options with the given kernel and matching default stride.
    pub const fn new(kernel_height: usize, kernel_width: usize) -> Self {
        Self {
            kernel: [kernel_height, kernel_width],
            padding: [0, 0, 0, 0],
            stride: [kernel_height, kernel_width],
            dilation: [1, 1],
        }
    }

    /// Sets explicit top, bottom, left, and right padding.
    pub const fn padding(mut self, top: usize, bottom: usize, left: usize, right: usize) -> Self {
        self.padding = [top, bottom, left, right];
        self
    }

    /// Sets height and width stride.
    pub const fn stride(mut self, height: usize, width: usize) -> Self {
        self.stride = [height, width];
        self
    }

    /// Sets height and width dilation.
    pub const fn dilation(mut self, height: usize, width: usize) -> Self {
        self.dilation = [height, width];
        self
    }

    fn into_core(self) -> CorePool2dOptions {
        CorePool2dOptions {
            kernel: self.kernel,
            padding: Padding2d {
                top: self.padding[0],
                bottom: self.padding[1],
                left: self.padding[2],
                right: self.padding[3],
            },
            stride: self.stride,
            dilation: self.dilation,
        }
    }
}

impl Default for Pool2dOptions {
    fn default() -> Self {
        Self::new(2, 2)
    }
}

/// Records 2D max pooling with default options.
pub fn max_pool2d<Output: TraceTensor>(input: impl TraceTensor) -> Output {
    max_pool2d_options(input, Pool2dOptions::default())
}

/// Records 2D max pooling with explicit static options.
pub fn max_pool2d_options<Output: TraceTensor>(
    input: impl TraceTensor,
    options: Pool2dOptions,
) -> Output {
    call_output(
        CallOp::MaxPool2d(options.into_core()),
        vec![input.into_expr()],
    )
}

/// Records 2D average pooling with default options.
pub fn avg_pool2d<Output: TraceTensor>(input: impl TraceTensor) -> Output {
    avg_pool2d_options(input, Pool2dOptions::default())
}

/// Records 2D average pooling with explicit static options.
pub fn avg_pool2d_options<Output: TraceTensor>(
    input: impl TraceTensor,
    options: Pool2dOptions,
) -> Output {
    call_output(
        CallOp::AvgPool2d(options.into_core()),
        vec![input.into_expr()],
    )
}