# Propeller A propeller, an axial fan or a wind rotor: blades of airfoil sections set at their pitch on cylinders round the axis, skewed and raked as on a propeller drawing, lofted into smooth solids on a hub. Four types pick the laws the blades follow: a marine propeller (Wageningen B-series), an air propeller for aircraft and drones, an axial fan and a wind turbine rotor (Schmitz's optimum). The blades grow out of a shaft's cylindrical face and fuse into it, or stand on a hub of their own with a nose and a bore. ```js import { propeller } from '@fluidcad/airfoils'; ``` ## Use ```js // A four-bladed boat propeller, Ø120 at P/D 0.9 and EAR 0.7, skewed and // raked, its cone aft and a D-flat bore for the shaft. propeller({ blades: 4, diameter: 120, pitchRatio: 0.9, ear: 0.7, skew: 20, rake: 8, hubDiameter: 22, nose: "cone", noseSide: "back", bore: "dflat", boreDiameter: 8, flat: 3, fillet: 1.5, }); // A 5x4.5 drone propeller: two Clark Y blades, the pitch given as a length. propeller({ type: "air", blades: 2, diameter: 127, pitchBy: "pitch", pitch: 114.3, hubDiameter: 12, nose: "dome", boreDiameter: 5 }); // The rotor of an 80 mm case fan: seven swept paddle blades of bent plate. propeller({ type: "fan", blades: 7, diameter: 76, pitchBy: "angle", pitchAngle: 30, chord: 0.3, planform: "paddle", skew: 25, hubDiameter: 36, hubLength: 14, bore: "none", }); // A Ø600 wind rotor for a tip speed ratio of 6, a dome upwind. propeller({ type: "wind", diameter: 600, tsr: 6, hubDiameter: 60, nose: "dome", boreDiameter: 10, fillet: 3 }); // Blades grown straight out of a shaft: its face is the hub. propeller(select(face().cylinder()), { type: "air", diameter: 120, fillet: 1.5 }); ``` `propeller(at, { type, blades, diameter, hand, pitchBy, pitchRatio, pitch, pitchAngle, tsr, setting, ear, chord, planform, lift, skew, rake, tip, section, thicknessBy, rootThickness, tipThickness, camber, edge, hubDiameter, hubLength, nose, noseSide, noseLength, bore, boreDiameter, flat, fillet, offset, phase, flip })`. It adds by default (`.new()` keeps it a body of its own). **Where it stands.** `at` is optional: left out, go straight to the options. - **Nothing**: on the Z axis at the origin, on its own hub. The hub's back is on the XY plane and the propeller pushes towards +Z, its front. - **A shaft's or a hub's outside (cylindrical) face**: the blades grow out of the face and fuse into it, their roots centred on the middle of the face. The shaft is the hub, so the hub's, the nose's and the bore's values don't apply and the dialog hides them. A bore's face is refused. - **A planar face**: its own hub stands on the face, out along its normal, centred on a round face's centre. - **An axis** (a world axis, an `axis()`, a straight edge) or **a connector**: its own hub along that line, its back at the line's origin. `offset` moves it along the axis, `phase` turns the blades about it and `flip` makes it push the other way. **The types.** Each type sets how the chord, the thickness, the section and the pitch run from the root to the tip: | Type | Chord | Thickness | Section | Pitch | |---|---|---|---|---| | `"marine"` | B-series, sized by `ear` | B-series, `t/D = A − B·Z` | ogival, flat face | constant; reduced at the root for 4 blades and more | | `"air"` | the `planform`, sized by `chord` at 0.75 R | 20 % at the root to 8 % at the tip | Clark Y | constant | | `"fan"` | as Air | 8 % to 5 % | bent plate, 6 % camber | constant | | `"wind"` | Schmitz's optimum for `tsr` and `lift` | 24 % to 12 % | NACA 4412 | Schmitz's twist, turned by `setting` | `section` and `thicknessBy` override the type's section and thickness. ## Values | Value | Default | What it does | |---|---|---| | `at` | none | Where it stands (above). | | `type` | `"marine"` | `"marine"`, `"air"`, `"fan"` or `"wind"`. | | `blades` | 3 | 2 to 12. | | `diameter` | 100 | The tip circle's. | | `hand` | `"right"` | `"right"` or `"left"`. A right-handed propeller turns clockwise seen from behind; a right-handed wind rotor, clockwise seen from upwind. | | `pitchBy` | `"ratio"` | Marine, air and fan: how the pitch is given. `"ratio"` (`pitchRatio`), `"pitch"` (`pitch`) or `"angle"` (`pitchAngle`). | | `pitchRatio` | 1 | P/D: how far one turn screws forward, over the diameter. 0.2 to 2.5. | | `pitch` | 100 | The pitch as a length. | | `pitchAngle` | 25 | Degrees, the blade's angle to the plane of rotation at 0.75 R. 1 to 80. | | `tsr` | 6 | Wind: the tip speed ratio the rotor is designed for (tip speed over wind speed). Higher is narrower and flatter. 2 to 12. | | `setting` | 0 | Wind: degrees, turns every blade about its span. −20 to 20. | | `ear` | 0.55 | Marine: the expanded area ratio, the blades' area over the disc's. 0.25 to 1.2. | | `chord` | 0.1 | Air and fan: the blade's width at 0.75 R over the diameter (c/D). 0.03 to 0.5. | | `planform` | `"classic"` | Air and fan: `"classic"` (widest near 0.4 R), `"elliptic"`, `"tapered"`, `"straight"` or `"paddle"` (widest at the tip). | | `lift` | 1 | Wind: the design lift coefficient. Higher makes narrower blades. 0.5 to 1.6. | | `skew` | 0 | Degrees, sweeps the tips back against the rotation, along the pitch helix. −60 to 60. | | `rake` | 0 | Degrees, leans the blades aft. −30 to 30. | | `tip` | `"rounded"` | Air, fan and wind: `"rounded"` (the blade closes to a point at the tip circle) or `"square"` (cut at the tip circle). A marine blade is always rounded. | | `section` | `"auto"` | `"auto"` (the type's own), `"naca"` (4-digit, cambered by `camber`), `"clarky"`, `"ogival"` or `"plate"` (bent by `camber`). | | `thicknessBy` | `"auto"` | `"auto"` (the type's own) or `"custom"` (`rootThickness` to `tipThickness`). | | `rootThickness`, `tipThickness` | 15, 8 | Custom thickness at the root and at the tip, % of the chord. 1 to 40. | | `camber` | 4 | A NACA or a plate section's camber, % of the chord. 0 to 15. Not used while `section` is `"auto"`. | | `edge` | 0.5 | The trailing edge's thickness at least, % of the chord. 0.1 to 5. | | `hubDiameter` | 20 | Own hub: its diameter. It must stay under 0.75 of the propeller's. | | `hubLength` | 0 | Own hub: its length. 0 just covers the blade roots. | | `nose` | `"none"` | Own hub: `"none"`, `"cone"` or `"dome"`. | | `noseSide` | `"front"` | `"front"` (the side it pushes towards) or `"back"` (a boat propeller's cone). | | `noseLength` | 0 | The nose's length. 0 takes it from the hub: 0.8 of its diameter for a cone, half for a dome. | | `bore` | `"round"` | Own hub: `"none"`, `"round"`, `"dflat"` or `"hex"`, through the hub (blind under a nose). | | `boreDiameter` | 5 | The bore's diameter; across the flats for a hex. | | `flat` | 2 | D flat: from the axis to the flat, between 0 and the bore's radius. | | `fillet` | 0 | The root fillet: flares the blades into the hub. It must stay under a quarter of the blade's span. | | `offset` | 0 | Along the axis. | | `phase` | 0 | Degrees: turns the blades about the axis. | | `flip` | `false` | Pushes the other way along the axis. | The root fillet is a flare built into the blade's sections, as large as `fillet` at the hub and gone by twice that out. It is not a `fillet()`, which fails on a blade's thin trailing edge. ## Frames | Frame | Where it is | |---|---| | `axis` | Origin on the axis at the back of the propeller's own hub (grown from a shaft: at the middle of the face). Z along the axis out of the hub's back, X the direction a `phase` of 0 measures from. `phase` and `offset` move the propeller on the frame, never the frame. | `connector("axis", p.frame("axis"))` makes it a connector in a part file. ## Buckets | Bucket | What it holds | |---|---| | `startFaces` | The hub's back end (none under a back nose). | | `endFaces` | The hub's front end (none under a front nose). | | `sideFaces` | The blades, the hub's wall and its nose. | | `internalFaces` | The bore. | A propeller grown from a shaft has no hub of its own: all its faces, the blades', are `sideFaces`. ## As a part `propellerPart` is the propeller as a part an assembly inserts, with the same values by id (all but `at`: the assembly places it) and the same dialog, under **Generate Parts**: ```js import { propellerPart } from '@fluidcad/airfoils'; const prop = insert(propellerPart, { type: "air", blades: 2, diameter: 127, nose: "dome" }); mate("revolute", motor.connectors.shaftEnd, prop.connectors.axis); ``` | Connector | Where it is | |---|---| | `axis` | The `axis` frame. A plain mate on a connector pointing out of a shaft's end seats the hub's back on it, with no `.flip()`. |