Skip to main content

A Python Library Implementing Dimension Insensitive Euclidean Metric (DIEM)

Project description

plot

PyPI Built with NumPy DOI License

diemsim

diemsim is an optimized Python library to compute "Dimension Insensitive Euclidean Metric (DIEM)", surpassing Cosine similarity for multidimensional comparisons.

Latency Benchmarking

Our proposed approaches,
Compact Vectorization optimizes latency of the existing function 'DIEM_Stat' by around 46.50%
plot Compact Optimized getDIEM optimizes latency of the existing function 'getDIEM' by 34.27% plot

Getting Started

Install the package via pip:

pip install diemsim

Usage

from diemsim import DIEM

N= 12
maxV= 1
minV= 0
n_iter= int(1e5)

S1= np.random.rand(N) * (maxV - minV) + minV
S2= np.random.rand(N) * (maxV - minV) + minV

# Initialize DIEM
diem= DIEM( N= N, maxV= maxV, minV= minV, n_iter= n_iter ) 

# Compute DIEM value
value= diem.sim( S1, S2)

print( "Output Value: ", value )

Find Quick Start notebook here

Key Contributors

Boddu Sri Pavan , Chandrasheker Thummanagoti

Please refer CONTRIBUTING.md for contributions to diemsim

To cite our Python library

BibTeX

@software{diemsim,
title = {diemsim: A Python Library Implementing Dimension Insensitive Euclidean Metric (DIEM)},
author = {Boddu Sri Pavan, Chandrasheker Thummanagoti},
year = {2025},
publisher = {Zenodo},
version = {v1.0.0},
doi = {10.5281/zenodo.15351274},
url = {https://doi.org/10.5281/zenodo.15351274}
}

APA

BodduSriPavan111. (2025). BodduSriPavan-111/diemsim: Initial Release (v0.0.1). Zenodo. https://doi.org/10.5281/zenodo.15351275

Acknowledgements

BibTeX

@misc{tessari2025surpassingcosinesimilaritymultidimensional,
title={Surpassing Cosine Similarity for Multidimensional Comparisons: Dimension Insensitive Euclidean Metric},
author={Federico Tessari and Kunpeng Yao and Neville Hogan},
year={2025},
eprint={2407.08623},
archivePrefix={arXiv},
primaryClass={cs.LG},
url={https://arxiv.org/abs/2407.08623},
}

Thank You !

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

diemsim-0.0.3.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

diemsim-0.0.3-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file diemsim-0.0.3.tar.gz.

File metadata

  • Download URL: diemsim-0.0.3.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.11.3 Windows/10

File hashes

Hashes for diemsim-0.0.3.tar.gz
Algorithm Hash digest
SHA256 b1eba63db44440e855c176be0c8eb4884059866cbbf37e97b284b7f4b4b8ee94
MD5 fd23c45ebaaf76feb962f62c7e96b5a5
BLAKE2b-256 526d8508e9d4c68f7eece0d139dc7d630951ee3c693d1c4ea045ab398572ce08

See more details on using hashes here.

File details

Details for the file diemsim-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: diemsim-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.11.3 Windows/10

File hashes

Hashes for diemsim-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d984bc23a608182a0a8240a78a1cb678ef87d37a7658305042d8c56c24308e24
MD5 a04c1d4920bb9be8d4b2cbd7103d45f2
BLAKE2b-256 005aa644e1150010ed43736f00dded8cb531583c4fef8abe564efcc90359281f

See more details on using hashes here.

Supported by

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