Metadata-Version: 2.1
Name: tmeasures
Version: 0.1a0
Summary: Invariance, Same-Equivariance and other measures for Neural Networks. Support for PyTorch (now) and TensorFlow (coming).
Home-page: https://github.com/facundoq/transformational_measures
Author: Facundo Manuel Quiroga
Author-email: facundoq@gmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/facundoq/transformational_measures/issues
Project-URL: Documentation, https://github.com/facundoq/transformational_measures
Project-URL: Source Code, https://github.com/facundoq/transformational_measures
Description: # Transformational Measures 
        
        The Transformational Measures (TM) library allows neural network designers to evaluate the invariance, equivariance and other properties of their models with respect to a set of transformations. Support for Pytorch (current) and Tensorflow/Keras (coming). 
        
        ### Visualizations
        
        
        
        **Invariance heatmap**: Each column shows the invariance to rotation of a layer of a Neural Network. Each row/block inside each column indicates the invariance of a feature map or single neuron, depending on the layer. 
        
        ![](res/heatmap.png)
        
        **Invariance vs layer, same model**: Plot of the transformational and sample invariance to rotations of a simple neural network trained on MNIST, with and without data augmentation. The X axis indicates the layer, while the Y axis shows the average invariance of the layer.
        
        ![](res/invariance.jpg)
        
        **Invariance vs layer, different models**: Plot of the invariance to rotations of several well-known models trained on CIFAR10. The number of layers of each model is fit on a percentage scale, so that different models can be compared 
        
        ![](res/invariance_models_cifar10.jpg)
        
        # PyTorch API
        
        TODO describe
        
        # TensorFlow API
        
        [In development](https://github.com/midusi/transformational_measures_tf/) 
        
        # Examples
        
        You can find many uses of this library in the [repository with the code](https://github.com/facundoq/variance_measure) for the article [Measuring (in)variances in Convolutional Networks](https://link.springer.com/chapter/10.1007/978-3-030-27713-0_9), where this library was first presented. Also, in the code for the experiments of the PhD Thesis ["Invariance and Same-Equivariance Measures for Convolutional Neural Networks" (spanish)](http://sedici.unlp.edu.ar/handle/10915/90903).
        
        # Citing
        
        If you use this library in your research, we kindly ask you to cite [Measuring (in)variances in Convolutional Networks](https://link.springer.com/chapter/10.1007/978-3-030-27713-0_9)
        
        ## Bibtex
        
            @inproceedings{quiroga2019measuring,
            title={Measuring (in) variances in Convolutional Networks},
            author={Quiroga, Facundo and Torrents-Barrena, Jordina and Lanzarini, Laura and Puig, Domenec},
            booktitle={Conference on Cloud Computing and Big Data},
            pages={98--109},
            year={2019},
            organization={Springer}
            }
        
        
Keywords: transformational measures equivariance same-equivariance invariance variance neural networks python pytorch numpy tensorflow
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.6
Description-Content-Type: text/markdown
