AgentFoundrySign in ↗
← All examples

blender tools

Helical compression spring with spring rate

Generate a compression spring as a round wire swept along a helix with closed end coils, and report its free length, solid length and spring rate from the wire material. Use it for mechanisms, suspension props and machine details.

Recorded render of Helical compression spring with spring rate

What this component contains

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • coil_spring.py
  • component.json
  • graphcheck.py
  • meshcheck.py
  • preview.png
  • test_coil_spring.py
  • test_package.py
  • verification/native.json

How it works

Operator
baltor.coil_spring
Parameters
mean_diameter, wire_diameter, active_coils, pitch, end_coils, clockwise, samples_per_turn, wire_sides and 1 more
Result
One closed, smooth-shaded mesh object named Coil Spring along +Z.
Blender
4.2 or later
Axes
Blender Z up, -Y forward
Units
metres

Recorded checks

blender 5.2.1 LTS (hash 9e2066aef7ef built 2026-08-25 02:12:34)

  • addon_install_and_enable
  • operator_runs_with_defaults
  • blender_data_matches_core
  • addon_disable_unregisters
  • script_mode_runs
  • clean_reopen_addon_file
  • clean_reopen_script_file
  • gltf_separate_export
  • engine_output_clean

Limits to consider

Ends are closed but not ground flat, so the spring does not stand on a flat face. The height changes pitch abruptly where active coils meet end coils. The rate uses the basic formula G d^4 / (8 D^3 n) without the Wahl curvature correction and assumes small deflections. Extension spring hooks are not modelled. Verified in Blender 5.2.1; written for the 4.2 API.