Skip to content

Update documentation for vector k in procrustes_scale function - #65

Merged
kellrott merged 1 commit into
ohsu-comp-bio:developfrom
kbcoulter:patch-1
Aug 1, 2026
Merged

Update documentation for vector k in procrustes_scale function#65
kellrott merged 1 commit into
ohsu-comp-bio:developfrom
kbcoulter:patch-1

Conversation

@kbcoulter

@kbcoulter kbcoulter commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Docs: Clarify that procrustes_scale returns vector k, not scalar

The documentation for procrustes_scale() in src/embkit/align.py suggests that k is a scalar value (the more common procrustes approach), when it actually returns a vector of per-dimension scaling factors.

Changes

Updated docstring (lines 89, 92, 101) to clarify:

  • Changed "factor" (singular) to "factors" (plural)
  • Added clearer example showing multiplication with per-dimension scaling
  • Updated return description to specify shape: one scaling value per dimension

Implementation is unchanged. Only the documentation was misleading. I believe ths covers all mentions of scalar k.

Clarified comments in procrustes_scale function regarding scaling factors and element-wise multiplication.
@kellrott
kellrott merged commit c41ffd5 into ohsu-comp-bio:develop Aug 1, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants