Skip to main content

A performant implementation of the principle of Maximum Coding Rate Reduction (MCR2).

Project description

Maximal Coding Rate Reduction

This repository is an unofficial implementation of the following papers:

This also serves as the host repository for the Pip package.

What is Maximal Coding Rate Reduction?

Our goal is to learn a mapping that maps the high-dimensional data that lies in a low-dimensional manifold to low-dimensional subspaces with the following three properties:

  1. Between-Class Discriminative: Features of samples from different classes/clusters should be highly uncorrelatedand belong to different low-dimensional linear subspaces
  2. Within-Class Compressible: Features of samples from the same class/cluster should be relatively correlated in a sense that they belong to a low-dimensional linear subspace
  3. Maximally Diverse Representation: Dimension (or variance) of features for each class/cluster should beas large as possibleas long as they stay uncorrelated from the other classes

To achieve this, we propose an objective function called Maximal Coding Rate Reduction (MCR2). In our paper, we provide not only theoretical guarantees to the desired properties upon convergence, but also practical properties such as robustness to label corruption and empirical results such as state-of-the-art unsupervised clustering performance. For more details on algorithm design, please refer to our paper.

What is ReduNet?

Our goal is to build a neural network for representation learning with the following properties:

  1. Interpretable: We should be able to interpret each network operator and assign precise meaning to each layer and parameter.
  2. Forward-Propagation Only: The network should be trained using much-more interpretable forward-propagation methods, as opposed to back-propagation which tends to create black-boxes.
  3. Use MCR2: The network should seek to optimize MCR2 loss function, as the purpose is distribution learning.

To achieve this, we propose a neural network architecture and algorithms called ReduNet. In our paper, we provide not only theoretical interpretations and a precise derivation of each operator in the network, but also connections to other architectures that form naturally as components of ReduNet. We also provide empirical justification for the power of ReduNet. For more details on algorithm design, please refer to our paper.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcr2-0.0.6.tar.gz (8.8 kB view details)

Uploaded Source

Built Distribution

mcr2-0.0.6-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file mcr2-0.0.6.tar.gz.

File metadata

  • Download URL: mcr2-0.0.6.tar.gz
  • Upload date:
  • Size: 8.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.11.0 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for mcr2-0.0.6.tar.gz
Algorithm Hash digest
SHA256 4f359e3180c09f2418f66e2c0f03df0dfe30ee67a9f2c0e97393406d0db64774
MD5 50ff81311fc505f90f7230cbac6ef9ad
BLAKE2b-256 5360474e9dd7cda77a9083da62703a991e744b898cbb5d28b752200a1f94a3b3

See more details on using hashes here.

File details

Details for the file mcr2-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: mcr2-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.11.0 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for mcr2-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 c769fb45ba4307a68c03e19f92250a9d3855da02cd8ee8ded9f676bc1c71203c
MD5 3dfa80622505ad40a38f3b80d12c9599
BLAKE2b-256 076ffebc5995cc912e901df4e047e49dbf25c1262592714b07ae7ac0ca038bfa

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page