diff options
| author | Onur Gündüz <ogunduz@gmail.com> | 2026-05-30 10:36:10 +0200 |
|---|---|---|
| committer | Onur Gündüz <ogunduz@gmail.com> | 2026-06-14 08:26:42 +0200 |
| commit | 10bf114474d5b79193159e5c865734362cf7abfb (patch) | |
| tree | a5bcd2a7ea22e4008988f9daf6d5b479bfdd918e | |
| parent | 385bed06e606f9cbacb719c9569cc77e4000f12c (diff) | |
| download | ffwd-10bf114474d5b79193159e5c865734362cf7abfb.tar.gz ffwd-10bf114474d5b79193159e5c865734362cf7abfb.zip | |
api: add opt-in l2 normalization helper
| -rw-r--r-- | pplx_embed.c | 34 | ||||
| -rw-r--r-- | pplx_embed.h | 9 |
2 files changed, 40 insertions, 3 deletions
diff --git a/pplx_embed.c b/pplx_embed.c index 9c02fa9..ba77676 100644 --- a/pplx_embed.c +++ b/pplx_embed.c @@ -1070,12 +1070,40 @@ float *pplx_model_embed(const pplx_model_t *model, pplx_workspace_t *ws, } /* ======================================================================== - * Cosine similarity + * Vector helpers * ======================================================================== */ +int pplx_l2_normalize(float *vec, int dim) +{ + if (!vec || dim <= 0) return -1; + + float norm_sq = 0.0f; + for (int i = 0; i < dim; i++) + norm_sq += vec[i] * vec[i]; + + if (!(norm_sq > 0.0f) || !isfinite(norm_sq)) return -1; + + float inv_norm = 1.0f / sqrtf(norm_sq); + for (int i = 0; i < dim; i++) + vec[i] *= inv_norm; + return 0; +} + float pplx_cosine_similarity(const float *a, const float *b, int dim) { + if (!a || !b || dim <= 0) return 0.0f; + float dot = 0.0f; - for (int i = 0; i < dim; i++) dot += a[i] * b[i]; - return dot; + float norm_a_sq = 0.0f; + float norm_b_sq = 0.0f; + for (int i = 0; i < dim; i++) { + dot += a[i] * b[i]; + norm_a_sq += a[i] * a[i]; + norm_b_sq += b[i] * b[i]; + } + + if (!(norm_a_sq > 0.0f) || !(norm_b_sq > 0.0f) || + !isfinite(norm_a_sq) || !isfinite(norm_b_sq)) + return 0.0f; + return dot / sqrtf(norm_a_sq * norm_b_sq); } diff --git a/pplx_embed.h b/pplx_embed.h index 276c67f..0816e20 100644 --- a/pplx_embed.h +++ b/pplx_embed.h @@ -165,7 +165,16 @@ int pplx_model_embed_spans(const pplx_model_t *model, pplx_workspace_t *ws, float *out_embeddings); /* + * L2-normalize vec[dim] in place. + * + * Returns 0 on success. Returns -1 for invalid arguments or a zero-length + * vector, which cannot be normalized. + */ +int pplx_l2_normalize(float *vec, int dim); + +/* * Cosine similarity between two vectors. + * Returns 0 for invalid arguments or if either vector has zero length. */ float pplx_cosine_similarity(const float *a, const float *b, int dim); |
