// Coilover Bottom
// Part consists of a 70 mm diameter retainer plate with a cylindrical lower mount body below it, and a eye-end mount (or hole) at the bottom. Above the retainer plate, there is a cylindrical damper body with a hole through its length that allows a piston shaft to pass through it when included in the coilover assembly.

// Set units
@settings(defaultLengthUnit = mm, kclVersion = 1.0)

// Import parameters
import retainerPlateDia, retainerPlateLength, baseSeatingDia, baseSeatingLength, lowerMountDia, damperBodyLength, lowerMountLength, eyeEndMountOuterDia, eyeEndMountLength, eyeEndMountHoleDia, eyeEndMountThickness, eyeEndMountFillet, damperBodyDia, pistonShaftHoleDia, lengthBelowRetainerPlate, lowerMountOverallLength, pointOffset from "parameters.kcl"

// Retainer Plate
retainerPlateSketch = startSketchOn(XY)
retainerPlateProfile = circle(
  retainerPlateSketch,
  center = [0, 0],
  radius = retainerPlateDia / 2,
  tag = $seg01,
)
retainerPlateExtrude = extrude(retainerPlateProfile, length = retainerPlateLength, tagStart = $capStart001)
  |> chamfer(
       length = 3.7,
       tags = [
         getCommonEdge(faces = [seg01, capStart001])
       ],
     )

// Base seating just below the retainer plate
baseSeatingSketch = startSketchOn(retainerPlateExtrude, face = START)
baseSeatingProfile = circle(baseSeatingSketch, center = [0.0, 0.0], radius = baseSeatingDia / 2)
baseSeatingExtrude = extrude(baseSeatingProfile, length = baseSeatingLength)

// Lower Mount
lowerMountSketch = startSketchOn(baseSeatingExtrude, face = END)
lowerMountProfile = circle(
  lowerMountSketch,
  center = [0, 0],
  radius = lowerMountDia / 2,
  tag = $seg02,
)
lowerMountExtrude = extrude(lowerMountProfile, length = lowerMountLength, tagEnd = $capEnd001)
  |> chamfer(
       length = 3,
       tags = [
         getCommonEdge(faces = [seg02, capEnd001])
       ],
     )

// Eye End for Lower Mount
eyeEndSketch = startSketchOn(lowerMountExtrude, face = END)
eyeEndProfile = circle(
  eyeEndSketch,
  center = [0, 0],
  radius = eyeEndMountOuterDia / 2,
  tag = $seg04,
)
eyeEndExtrude = extrude(eyeEndProfile, length = eyeEndMountLength, tagEnd = $capEnd002)
  |> fillet(
       radius = eyeEndMountOuterDia / 2 - 0.01,
       tags = [
         getCommonEdge(faces = [seg04, capEnd002])
       ],
     )
  |> fillet(
       radius = 3,
       tags = [
         getCommonEdge(faces = [capEnd001, seg04])
       ],
     )

// Eye End Outer Profile for Lower Mount
eyeEndOuterSketch = startSketchOn(YZ)

eyeEndOuterProfile = startProfile(
       eyeEndOuterSketch,
       at = [
         eyeEndMountThickness / 2 + eyeEndMountFillet + pointOffset,
         -lengthBelowRetainerPlate + 25
       ],
     )
  |> xLine(length = -pointOffset)
  |> tangentialArc(radius = eyeEndMountFillet, angle = 90)
  |> yLine(length = -22)
  |> xLine(length = -eyeEndMountThickness)
  |> yLine(length = 22)
  |> tangentialArc(radius = eyeEndMountFillet, angle = 90)
  |> xLine(length = -pointOffset)
  |> yLine(length = -30)
  |> xLine(endAbsolute = eyeEndMountThickness / 2 + eyeEndMountFillet + pointOffset)
  |> close(%)

eyeEndOuterExtrude = extrude(eyeEndOuterProfile, length = 30, symmetric = true)
lowerMount = subtract([eyeEndExtrude], tools = [eyeEndOuterExtrude])

// Eye End Hole for Lower Mount
eyeEndHolePlane = offsetPlane(XZ, offset = 15)
eyeEndHoleSketch = startSketchOn(eyeEndHolePlane)
eyeEndHoleProfile = circle(
  eyeEndHoleSketch,
  center = [
    0,
    -lengthBelowRetainerPlate + eyeEndMountOuterDia / 2
  ],
  radius = eyeEndMountHoleDia / 2,
)
eyeEndHoleExtrude = extrude(eyeEndHoleProfile, length = -40)
lowerMountSolid = subtract([lowerMount], tools = [eyeEndHoleExtrude])

// Damper body above the retainer plate
damperBodySketch = startSketchOn(XY)
damperBodyProfile = circle(damperBodySketch, center = [0, 0], radius = damperBodyDia / 2)
damperBodyExtrude = extrude(damperBodyProfile, length = damperBodyLength)

// Hole for the piston shaft in the damper body
pistonShaftSketch = startSketchOn(damperBodyExtrude, face = END)
pistonShaftProfile = circle(pistonShaftSketch, center = [0, 0], radius = pistonShaftHoleDia / 2)
pistonShaftHole = extrude(pistonShaftProfile, length = -damperBodyLength)


coilover-bottom

// Coilover Top
// Part consists of a 70 mm diameter plate with a tapered mount body , and a eye-end mount (with a hole) on top of it. Below this plate/body, there is a stopper that limits the travel of the coilover, and a piston shaft below it to guide the coilover.

// Set units
@settings(defaultLengthUnit = mm, kclVersion = 1.0)

// Import parameters
import eyeEndMountOuterDia, pointOffset, eyeEndMountLength, eyeEndMountHoleDia, eyeEndMountThickness, eyeEndMountFillet, pistonRodStopDia, pistonRodStopLength, upperMountPlateDia, upperMountPlateThickness from "parameters.kcl"

// Stopper for the Piston Rod located just below Upper Mount Plate
pistonRodStopSketch = startSketchOn(XY)
pistonRodStopperProfile = circle(
  pistonRodStopSketch,
  center = [0, 0],
  radius = pistonRodStopDia / 2,
  tag = $seg01,
)

pistonRodStopperExtrude = extrude(pistonRodStopperProfile, length = -pistonRodStopLength, tagStart = $capStart001)
  |> chamfer(
       length = 6,
       tags = [
         getCommonEdge(faces = [seg01, capStart001])
       ],
     )

// Piston Rod located below the Stopper
pistonRodSketch = startSketchOn(pistonRodStopperExtrude, face = START)
pistonRodProfile = circle(pistonRodSketch, center = [0, 0], radius = 4.95)
pistonRodExtrude = extrude(pistonRodProfile, length = 200)

// Upper Mount Plate
upperMountPlateSketch = startSketchOn(pistonRodStopperExtrude, face = END)
upperMountPlateProfile = circle(
  upperMountPlateSketch,
  center = [0, 0],
  radius = upperMountPlateDia / 2,
  tag = $seg02,
)
upperMountPlateExtrude = extrude(upperMountPlateProfile, length = upperMountPlateThickness, tagEnd = $capEnd001)
  |> chamfer(
       length = 19,
       tags = [
         getCommonEdge(faces = [seg02, capEnd001])
       ],
     )

// Eye End for Upper Mount
eyeEndSketch = startSketchOn(upperMountPlateExtrude, face = END)
eyeEndProfile = circle(
  eyeEndSketch,
  center = [0, 0],
  radius = eyeEndMountOuterDia / 2,
  tag = $seg03,
)
eyeEndExtrude = extrude(eyeEndProfile, length = eyeEndMountLength, tagEnd = $capEnd002)
  |> fillet(
       radius = eyeEndMountOuterDia / 2 - 0.01,
       tags = [
         getCommonEdge(faces = [seg03, capEnd002])
       ],
     )

// Eye End Outer Profile for Upper Mount
eyeEndOuterSketch = startSketchOn(YZ)
eyeEndOuterProfile = startProfile(
       eyeEndOuterSketch,
       at = [
         eyeEndMountThickness / 2 + eyeEndMountFillet + pointOffset,
         upperMountPlateThickness + eyeEndMountLength - 25
       ],
     )
  |> xLine(length = -pointOffset)
  |> tangentialArc(radius = eyeEndMountFillet, angle = -90)
  |> yLine(length = 22)
  |> xLine(length = -eyeEndMountThickness)
  |> yLine(length = -22)
  |> tangentialArc(radius = eyeEndMountFillet, angle = -90)
  |> xLine(length = -20)
  |> yLine(length = 30)
  |> xLine(endAbsolute = eyeEndMountThickness / 2 + eyeEndMountFillet + pointOffset)
  |> close(%)

eyeEndOuterExtrude = extrude(eyeEndOuterProfile, length = 30, symmetric = true)
upperMount = subtract([eyeEndExtrude], tools = [eyeEndOuterExtrude])

// Eye End Hole for Upper Mount
eyeEndHolePlane = offsetPlane(XZ, offset = 15)
eyeEndHoleSketch = startSketchOn(eyeEndHolePlane)
eyeEndHoleProfile = circle(
  eyeEndHoleSketch,
  center = [
    0,
    upperMountPlateThickness + eyeEndMountLength - (eyeEndMountOuterDia / 2)
  ],
  radius = eyeEndMountHoleDia / 2,
)
eyeEndHoleExtrude = extrude(eyeEndHoleProfile, length = -40)
upperMountSolid = subtract([upperMount], tools = [eyeEndHoleExtrude])
  |> appearance(color = "#252318", roughness = 90, metalness = 90)


coilover-top

// Coilover assembly parameters
// Key dimensional parameters for all parts in the coilover assembly. These are imported into the kcl part files. Key parameters include retainer plate, eye mount, spring and piston rod dimensions.

// Set units
@settings(defaultLengthUnit = mm, kclVersion = 1.0)

// Coilover Bottom (coilover-bottom.kcl)
export retainerPlateDia = 70
export retainerPlateLength = 6.3
export baseSeatingDia = 55
export baseSeatingLength = 5
export lowerMountDia = 38
export damperBodyLength = 51
export lowerMountLength = 92
export eyeEndMountOuterDia = 25
export eyeEndMountLength = eyeEndMountOuterDia / 2 + 30
export eyeEndMountHoleDia = 12.5
export eyeEndMountThickness = 12.7
export eyeEndMountFillet = 5
export damperBodyDia = lowerMountDia
export pistonShaftHoleDia = 10
export lengthBelowRetainerPlate = baseSeatingLength + lowerMountLength + eyeEndMountLength
export lowerMountOverallLength = lengthBelowRetainerPlate + retainerPlateLength
export pointOffset = 20 // Used to help build profile for subtraction


// Coilover Spring (spring.kcl)
export springRadius = 22
export springLength = 200
export springRevolutions = 8
export coilThickness = 6

// Coilover Top (coilover-top.kcl)
export pistonRodStopDia = 25
export pistonRodStopLength = 32.5
export upperMountPlateDia = 70
export upperMountPlateThickness = 22.5
export pistonShaftDia = pistonShaftHoleDia - 0.1 // reduced shaft dia from the hole to provide some clearance


parameters

// Spring for coilover assembly
// Spring that sits on top of the retainer plate in the coilover assembly, with a piston shaft running through it. 200 mm long, with a 22 mm radius, and coils at 6 mm thick.


import springRadius, springLength, springRevolutions, coilThickness from "parameters.kcl"

helixPath = helix(
  axis = Z,
  radius = springRadius,
  length = springLength,
  revolutions = springRevolutions,
  angleStart = 360,
  ccw = false,
)

springSketch = startSketchOn(XZ)
  |> circle(center = [springRadius, 0], radius = coilThickness / 2)
  |> sweep(path = helixPath)
  |> appearance(color = "#d78109", roughness = 90, metalness = 50)


spring

Geometry Engine

Zoo CAD Engine Overview

KCL: A Programming Language for Parametric CAD

File Formats

A Practical Overview of CAD File Formats

Text-to-CAD

Text-to-CAD: Generating Editable, Parametric B-Rep CAD Models from Natural Language

Automation

Automating Your Workflow

Features

Getting Started

Zoo Design Studio

Authentication

Errors

Generate a CAD model from text.

List all ML prompts.

Get a ML prompt.

List conversations

Converts a proprietary CAD format to KCL.

Generate code completions for KCL.

Iterate on a CAD model with a prompt.

Iterate on a multi-file CAD model with a prompt.

List text-to-CAD models you've generated.

Get a text-to-CAD response.

Give feedback to a specific ML response.

Open a websocket to prompt the ML copilot.

Open a websocket which accepts modeling commands.

Modeling

Get API call metrics.

List API calls.

Get details of an API call.

List async operations.

Get an async operation.

List API calls for your org.

Get an API call for an org.

List API calls for your user.

Get an API call for a user.

List API calls for a user.

API Calls

List API tokens for your user.

Create a new API token for your user.

Get an API token for your user.

Delete an API token for your user.

API Tokens

Listen for callbacks to GitHub app authentication.

Get the consent URL for GitHub app authentication.

Listen for GitHub webhooks.

Apps

Execute a Zoo program in a specific language.

Create a terminal.

Executor

Get CAD file center of mass.

Convert CAD file from one format to another.

Convert CAD file with defaults.

Get CAD file density.

Get CAD file mass.

Get CAD file surface area.

Get CAD file volume.

File

Get OpenAPI schema.

Get ip address information.

Authorize an inbound auth request from our Community page.

Uploads files to public blob storage for debugging purposes.

Creates an internal telemetry event.

Get an API token for a user by their discord ID.

Return pong.

Get the pricing for our subscriptions.

Start an OAuth 2.0 Device Authorization Grant.

Confirm an OAuth 2.0 Device Authorization Grant.

Request a device access token.

Verify an OAuth 2.0 Device Authorization Grant.

Listen for callbacks for the OAuth 2.0 provider.

Get the consent URL and other information for the OAuth 2.0 provider.

Revoke an OAuth2 token.

Oauth2

Get an org.

Update an org.

Create an org.

Delete an org.

List members of your org.

Add a member to your org.

Get a member of your org.

Update a member of your org.

Remove a member from your org.

Get the privacy settings for an org.

Update the privacy settings for an org.

Get the SAML identity provider.

Update the SAML identity provider.

Create a SAML identity provider.

Delete an SAML identity provider.

Get the shortlinks for an org.

List orgs.

Set the enterprise price for an organization.

Get a user's org.

Orgs

Get payment info about your org.

Update payment info for your org.

Create payment info for your org.

Delete payment info for your org.

Get balance for your org.

Create a payment intent for your org.

List invoices for your org.

List payment methods for your org.

Delete a payment method for your org.

Get the subscription for an org.

Update the subscription for an org.

Create the subscription for an org.

Validate an orgs's information is correct and valID for automatic tax.

Get balance for an org.

Update balance for an org.

Get payment info about your user.

Update payment info for your user.

Create payment info for your user.

Delete payment info for your user.

Get balance for your user.

Create a payment intent for your user.

List invoices for your user.

List payment methods for your user.

Delete a payment method for your user.

Get the subscription for a user.

Update the user's subscription.

Create the subscription for a user.

Validate a user's information is correct and valID for automatic tax.

Get balance for an user.

Update balance for an user.

Payments

List service accounts for your org.

Create a new service account for your org.

Get an service account for your org.

Delete an service account for your org.

Service Accounts

Get the shortlinks for a user.

Create a shortlink for a user.

Redirect the user to the URL for the shortlink.

Update a shortlink for a user.

Delete a shortlink for a user.

Shortlinks

Create a new store coupon.

Store

Convert angle units.

Convert area units.

Convert current units.

Convert energy units.

Convert force units.

Convert frequency units.

Convert length units.

Convert mass units.

Convert power units.

Convert pressure units.

Convert temperature units.

Convert torque units.

Convert volume units.

Unit

Get your user.

Update your user.

Delete your user.

Update properties in the CRM

Get extended information about your user.

Create a new support/sales ticket from the website contact form. This endpoint is authenticated.

Get the OAuth2 providers for your user.

Get the privacy settings for a user.

Update the user's privacy settings.

Get a session for your user.

List users.

List users with extended information.

Get extended information about a user.

Get a user.

Update a subscription for a user.

Creates a new support/sales ticket from the website contact form. This endpoint is for untrusted

coilover-assembly

KCL

Parts