Metadata-Version: 2.1
Name: pytorch-ard
Version: 0.2.3
Summary: Make your PyTorch faster
Home-page: https://github.com/HolyBayes/pytorch_ard
Author: Artem Ryzhikov
License: UNKNOWN
Description: # Variational Dropout Sparsifies NN (Pytorch)
        [![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](LICENSE)
        [![PyPI version](https://badge.fury.io/py/pytorch-ard.svg)](https://badge.fury.io/py/pytorch-ard)
        
        
        Make your neural network 300 times faster!
        
        Pytorch implementation of Variational Dropout Sparsifies Deep Neural Networks ([arxiv:1701.05369](https://arxiv.org/abs/1701.05369)).
        
        ## Description
        The discovered approach helps to train both convolutional and dense deep sparsified models without significant loss of quality. Additive Noise Reparameterization
        and the Local Reparameterization Trick discovered in the paper helps to eliminate weights prior's restrictions (<a href="https://www.codecogs.com/eqnedit.php?latex=\alpha\leq&space;1" target="_blank"><img src="https://latex.codecogs.com/gif.latex?\alpha\leq&space;1" title="\alpha\leq 1" /></a>) and achieve Automatic Relevance Determination (ARD) effect on (typically most) network's parameters. According to the original paper, authors reduced the number of parameters up to 280 times on LeNet architectures and up to 68 times on VGG-like networks with a negligible decrease of accuracy. Experiments with Boston dataset in this repository proves that: 99% of simple dense model were dropped using paper's ARD-prior without any significant loss of MSE. Moreover, this technique helps to significantly reduce overfitting and helps to not worry about model's complexity - all redundant parameters will be dropped automatically. Moreover, you can achieve any degree of regularization variating regularization factor tradeoff (see ***reg_factor*** variable in [boston_ard.py](examples/boston/boston_ard.py) and [cifar_ard.py](examples/cifar/cifar_ard.py) scripts)
        
        ## Usage
        
        ```python
        import torch_ard as nn_ard
        from torch import nn
        import torch.nn.functional as F
        
        input_size, hidden_size, output_size = 60, 150, 1
        
        model = nn.Sequential(
            nn_ard.LinearARD(input_size, hidden_size),
            nn.ReLU(),
            nn_ard.LinearARD(hidden_size, output_size)
        )
        
        
        criterion = nn_ard.ELBOLoss(model, F.cross_entropy)
        print('Sparsification ratio: %.3f%%' % (100.*nn_ard.get_dropped_params_ratio(model)))
        
        # test stage
        model.eval() # Needed for speed-up
        model(input)
        ```
        
        ## Installation
        
        ```
        pip install git+https://github.com/HolyBayes/pytorch_ard
        ```
        
        ## Experiments
        
        All experiments are placed at [examples](examples/) folder and contains baseline and implemented models comparison.
        
        ### Boston dataset
        
        Two scripts were used in the experiment: [boston_baseline.py](examples/boston/boston_baseline.py) and [boston_ard.py](examples/boston/boston_ard.py). Training procedure for each experiment was **100000 epoches, Adam(lr=1e-3)**. Baseline model was dense neural network with single hidden layer with hidden size 150.
        
        |                | Baseline (nn.Linear) | LinearARD, no reg | LinearARD, reg=0.0001 | LinearARD, reg=0.001 | LinearARD, reg=0.1 | LinearARD, reg=1 |
        |----------------|----------|-------------|-----------------|----------------|--------------|------------|
        | MSE (train)    | 1.751    | 1.626       | <span style="color:green"><b>1.587</b></span>           | 1.962          | 17.167       | 33.682     |
        | MSE (test)     | <span style="color:red"><b>22.580</b></span>   | 16.229      | <span style="color:green"><b>15.957</b></span>          | <span style="color:green"><b>8.416</b></span>          | 25.695       | 30.231     |
        | Compression, % | <span style="color:red"><b>0</b></span>        | 0.38        | <span style="color:green"><b>52.95</b></span>           | <span style="color:green"><b>64.19</b></span>          | <span style="color:green"><b>97.29</b></span>        | <span style="color:green"><b>99.29</b></span>      |
        
        You can see on the table above that variating regularization factor any degree of compression can be achieved (for example, ~99.29% of connections can be dropped if reg_factor=1 will be used). Moreover, you can see that training with LinearARD layers with some regularization parameters (like reg=0.001 in the table above) not only significantly reduces number of model parameters (>64% of parameters can be dropped after training), but also significantly increases quality on test, reducing overfitting.
        
        ## Tips
        
        1. Despite the high performance of implemented layers in "end-to-end" mode, authors recommends to use in fine-tuning pretrained models without ARD prior. In this case the best performance could be achieved. Moreover, it will be faster - despite of comparable convergence speed of this layers optimization, each training epoch takes more time (approx. twice longer - ~2 times more parameters in \*ARD implementations).  This fact well describable - using ARD prior in earlier stages can drop useful connections with unobvious dependencies.
        2. Model's sparsification takes almost no any speed-up effects until You convert it to the sparse one! (*TODO*)
        
        
        ## Requirements
        * **PyTorch** >= 0.4.0
        * **SkLearn** >= 0.19.1
        * **Pandas** >= 0.23.3
        * **Numpy** >= 1.14.5
        
        ## Authors
        
        ```
        @article{molchanov2017variational,
          title={Variational Dropout Sparsifies Deep Neural Networks},
          author={Molchanov, Dmitry and Ashukha, Arsenii and Vetrov, Dmitry},
          journal={arXiv preprint arXiv:1701.05369},
          year={2017}
        }
        ```
        [Original implementation](https://github.com/ars-ashuha/variational-dropout-sparsifies-dnn) (Theano/Lasagne)
        
        ## Citation
        
        ```
        @misc{pytorch_ard,
          author = {Artem Ryzhikov},
          title = {HolyBayes/pytorch_ard},
          url = {https://github.com/HolyBayes/pytorch_ard},
          year = {2018}
        }
        ```
        
        ## Contacts
        
        Artem Ryzhikov, LAMBDA laboratory, Higher School of Economics, Yandex School of Data Analysis
        
        **E-mail:** artemryzhikoff@yandex.ru
        
        **Linkedin:** https://www.linkedin.com/in/artem-ryzhikov-2b6308103/
        
        **Link:** https://www.hse.ru/org/persons/190912317
        
Keywords: pytorch,bayesian neural networks,ard,deep learning,neural networks,machine learning
Platform: UNKNOWN
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3 
Description-Content-Type: text/markdown
