COIL(nged)

okay bestie, this is COIL(nged) — yep, the nged manual page from the BRL-CAD User Commands — and it's literally about making coil springs in mged like it's no big deal. 🌀💅

🌸 NAME 🌸

coil — create a coil spring geometry object

✨ SYNOPSIS ✨

           coil [-d mean_outer_diameter] [-w wire_diameter] [-H helix_angle]
                [-p pitch] [-n number_of_turns] [-s start_cap_type] [-e end_cap_type]
                [-S coil_data_structure] [-l overall_length] [-L] [name]

💖 DESCRIPTION 💖

The coil command creates a coil spring geometry as a combination of pipe and cylindrical primitives in the database. No cap, it's building real geometry for you. An optional name may be provided; if omitted, the object is named coil.

All dimensional parameters are in the current working units unless otherwise noted.

🎀 Options 🎀

• -d mean_outer_diameter — mean outer diameter of the coil. Defaults to 10× the wire diameter if unspecified. If both are zero, defaults to 1000 (with wire diameter defaulting to 100).
• -w wire_diameter — diameter of the coil wire. Defaults to 1/10 of the mean outer diameter if unspecified.
• -H helix_angle — helix angle of the coil in degrees. Affects the pitch of the winding relative to the axis. (Unsupported when -l is used.)
• -p pitch — distance between adjacent turns along the coil axis. Must be ≥ wire diameter; if smaller, it is automatically set to the wire diameter.
• -n number_of_turns — number of full coil turns.
• -s start_cap_type — end cap style at the start of the coil: 0 = open (no cap), 1 = squared, 2 = squared and ground.
• -e end_cap_type — end cap style at the end of the coil. Same values as -s.
• -l overall_length — constrain the coil to a total axial length. When set, pitch and/or number of turns are adjusted automatically to fit. Caps are forced to open (0) and helix angles are ignored.
• -L — use left-hand winding (default is right-hand).
• -S coil_data_structure — advanced: provide an explicit section data structure to override the automatic coil generation.

🦋 EXAMPLES 🦋

🌟 Example 1. Create a default coil 🌟

mged> coil

Creates a coil spring named coil using default dimensions.

💫 Example 2. Create a named coil with specific dimensions 💫

mged> coil -d 50 -w 5 -p 6 -n 10 spring1

Creates a 10-turn coil spring named spring1 with a mean outer diameter of 50 units, wire diameter of 5 units, and pitch of 6 units per turn.

🎀 Example 3. Create a left-hand wound coil with caps 🎀

mged> coil -d 100 -w 10 -n 8 -s 2 -e 2 -L lh_spring

Creates a left-hand wound coil with squared-and-ground end caps.

🔗 SEE ALSO 🔗

pipe(nged) — that's the whole cross-reference, bestie. 🫶

👑 AUTHOR 👑

BRL-CAD Team — iconic behavior, honestly.

💀 BUG REPORTS 💀

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org.

---

okay that's the whole page! 🫶 source/version: BRL-CAD; page: COIL(nged); date: not shown in the original footer, so that's a little mystery. 💖