tch 0.0.4

Rust wrappers for the PyTorch C++ api (libtorch).
Documentation 
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

/// Devices on which tensor computations are run.
///
/// This currently represents a device type rather than a device
/// which could be problematic in a multi-GPU setting.
/// If needed, a device index should be added.

/// A torch device.
#[derive(Debug, Copy, Clone)]
pub enum Device {
    /// The main CPU device.
    Cpu,
    /// The main GPU device.
    Cuda,
}

pub enum Cpu {}
impl Cpu {
    /// Gets the current number of allowed threads for parallel computations.
    pub fn get_num_threads() -> i64 {
        super::device_wrapper::get_num_threads()
    }

    /// Sets the number of allowed threads for parallel computations.
    pub fn set_num_threads(n: i64) {
        super::device_wrapper::set_num_threads(n)
    }
}

pub enum Cuda {}
impl Cuda {
    /// Returns the number of GPU that can be used.
    pub fn device_count() -> i64 {
        super::device_wrapper::cuda_device_count()
    }

    /// Returns true if cuda support is available.
    pub fn is_available() -> bool {
        super::device_wrapper::cuda_is_available()
    }

    /// Returns true if cudnn support is available.
    pub fn cudnn_is_available() -> bool {
        super::device_wrapper::cudnn_is_available()
    }

    /// Sets cudnn benchmark mode.
    ///
    /// When set cudnn will try to optimize the generators durning
    /// the first network runs and then use the optimized architecture
    /// in the following runs. This can result in significant performance
    /// improvements.
    pub fn cudnn_set_benchmark(b: bool) {
        super::device_wrapper::set_benchmark_cudnn(b)
    }
}

impl Device {
    pub(crate) fn c_int(&self) -> libc::c_int {
        match self {
            Device::Cpu => 0,
            Device::Cuda => 1,
        }
    }

    pub(crate) fn of_c_int(v: libc::c_int) -> Self {
        match v {
            0 => Device::Cpu,
            1 => Device::Cuda,
            _ => panic!("unexpected device {}", v),
        }
    }

    /// Returns a GPU device if available, else default to CPU.
    pub fn cuda_if_available() -> Device {
        if Cuda::is_available() {
            Device::Cuda
        } else {
            Device::Cpu
        }
    }
}