Skip to content

Rename contactFrictionStiffness to contactFrictionGain - #67

Merged
andrewkaufman merged 3 commits into
newton-physics:mainfrom
andrewkaufman:akaufman/rename-friction-gain
Jun 1, 2026
Merged

Rename contactFrictionStiffness to contactFrictionGain#67
andrewkaufman merged 3 commits into
newton-physics:mainfrom
andrewkaufman:akaufman/rename-friction-gain

Conversation

@andrewkaufman

Copy link
Copy Markdown
Member

Summary

  • Rename newton:contactFrictionStiffnessnewton:frictionGain on NewtonMaterialAPI
  • Reorder attributes so contactStiffness, contactDamping, contactAdhesion are grouped, with frictionGain after
  • Update doc string per WG consensus: the parameter is a velocity-dependent friction gain, not a tangential stiffness
  • Bump version to 0.3.1

Context

From the WG discussion: the kf parameter produces a force proportional to velocity (viscous regime), not displacement. Calling it "stiffness" is misleading. Miles proposed frictionGain with the definition:

Friction Gain (kf) controls the slope of the friction force with respect to tangential slip velocity in the sticking regime. Larger values produce stronger resistance to small relative motion and more closely approximate ideal Coulomb sticking.

🤖 Generated with Claude Code

@andrewkaufman andrewkaufman self-assigned this May 29, 2026
@codecov

codecov Bot commented May 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

Comment thread CHANGELOG.md Outdated
Comment thread CHANGELOG.md Outdated
@andrewkaufman
andrewkaufman force-pushed the akaufman/rename-friction-gain branch from 4a22eb2 to 1cea348 Compare May 29, 2026 21:39
@andrewkaufman
andrewkaufman marked this pull request as ready for review May 29, 2026 21:39
@andrewkaufman
andrewkaufman requested a review from mmacklin May 29, 2026 21:39
The kf parameter is a velocity-dependent friction gain, not a
tangential stiffness. Ordered with the other contact* attrs:
contactStiffness, contactDamping, contactFrictionGain, contactAdhesion.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@andrewkaufman
andrewkaufman force-pushed the akaufman/rename-friction-gain branch from 1cea348 to fa63e9d Compare May 29, 2026 21:43
@andrewkaufman andrewkaufman changed the title Rename contactFrictionStiffness to frictionGain Rename contactFrictionStiffness to contactFrictionGain May 29, 2026

@chschuma-disney chschuma-disney left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree with Miles' points on the naming of the parameter. For the parameter as-is (i.e., without changing the friction model of the solvers), contactFrictionGain makes sense to me.

Comment thread newton_usd_schemas/generatedSchema.usda Outdated
Drop "at high speeds" framing — the Coulomb clamp applies regardless of
speed, not above some threshold.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

@chschuma-disney chschuma-disney left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

@andrewkaufman
andrewkaufman merged commit 2dbed9a into newton-physics:main Jun 1, 2026
19 checks passed
@andrewkaufman
andrewkaufman deleted the akaufman/rename-friction-gain branch June 1, 2026 17:46
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.

3 participants