mmhdc 0.1.1

No project description provided

MM-HDC: Maximum-Margin Hyperdimensional Computing

This repository provides an implementation of the multi-class maximum-margin hyperdimensional computing (MM-HDC) classifier that adopts the optimization problem formulation of multi-class Weston-Watkins SVM to HDC.

The algorithm is implemented in the MultiMMHDC class, which can be imported as:

from mmhdc import MultiMMHDC
from mmhdc.utils import HDTransform

You can run the MNIST example from the GitHub repo as follows:

git clone https://github.com/nzeulin/mmhdc.git && cd mmhdc
python -m pip install --upgrade pip && python -m pip install mmhdc
python -m pip install -r example/requirements.txt
python example/example.py --config example/mnist_config.py

C++ backend is highly recommended to use, as it can significantly accelerate the model training. In this case, use python -m pip install mmhdc[cpp].

NOTE: If you don't have gcc installed in your system (required for compiling C++ module), you can install it as a Conda package into your venv: conda install -c conda-forge gxx_linux-64.

Current features

• C++ backend (libtorch) to enable fast MM-HDC training.
• Support of floating-point prototypes and hypervectors.

Tips for best results

Empirically, setting C=torch.inf, selecting relatively low lr (e.g., the default lr=1e-5), and fine-tuning margin_width between [0..1] leads to the highest classification accuracy and smooth convergence.

Citation

If you use this repository in your research, please cite our paper:

@article{zeulin2026large,
  title={Large-Margin Hyperdimensional Computing: A Learning-Theoretical Perspective},
  author={Zeulin, Nikita and Galinina, Olga and Balakrishnan, Ravikumar and Himayat, Nageen and Andreev, Sergey},
  journal={arXiv preprint arXiv:2603.03830},
  year={2026}
}