SolidWorks

Grow a round boss (standoff, peg) height_mm out of ANY planar face, centred at (x, y, z) mm. The face is found as for add_hole_on_face. For a PCB standoff, add a blind hole in its top. Returns mass properties and `dimensions`.

Add a rectangular block: sketch width x height on the first plane, extrude by depth. Dimensions are in millimetres. Returns the created feature name, the addressable depth dimension ('D1@<name>'), `dimensions` (width, height, depth; for set_dimension) and the resulting mass properties.

Chamfer edges of the current part at 45° with the given distance (mm). edges: "all" (default), "x"/"y"/"z", or explicit indices like "2,5" from list_edges. Returns the number of edges chamfered and the resulting mass properties.

Repeat a feature `count` times evenly around 360° about an axis. The axis is the cylindrical face nearest (center_x_mm, center_y_mm) — e.g. a centre hole drilled there. feature_name defaults to the last feature. Bolt circle: drill a centre hole + one bolt hole, then pattern the bolt hole.

Create a cone/frustum by revolving a trapezoidal profile 360°. top_diameter_mm = 0 gives a full cone. Returns mass properties (volume = π·h/3 · (rb² + rb·rt + rt²)). Use new_part first.

Cut a counterbored screw hole on the +Z face at (x_mm, y_mm). A clearance shank through the thickness plus a larger coaxial flat-bottom pocket of cbore_depth_mm from the top — so a cap-head screw or heat-set insert sits flush/recessed (common for 3D-printed parts). cbore_diameter must exceed clearance_diameter. Coordinates share add_box's system. Returns mass properties.

Create a cylinder by revolving a profile 360° about an axis. The first revolve-based primitive. Returns the resulting mass properties (volume = π · r² · h). Use new_part first.

Create a disc/puck/flange: a circle extruded along +Z, centred at the origin. Flat faces are +Z/-Z, so add_hole and add_circular_pattern compose with it (round-flange bolt circles). Returns mass properties. Use new_part first.

Extrude a closed polygon into a solid: points_mm = [[x,y], ...] in mm. The polygon (first-plane coordinates, same as add_box) is auto-closed and extruded by depth_mm. Unlocks arbitrary prismatic shapes (brackets, profiles, polygons). Returns mass properties (volume = polygon area * depth).

Grow a polygon boss depth_mm out of ANY planar face: points_mm = [[x,y,z], ...] in mm. The 3D points lie on the face (found as for add_hole_on_face). For pads, ledges and mounting blocks on an existing part. Returns mass properties.

Extrude a smooth CLOSED spline through points: points_mm = [[x,y], ...] in mm. Like add_extruded_profile but the outline is a smooth curve through the points (free-form/organic shapes: cams, rounded outlines, aesthetic bosses), auto-closed and extruded by depth_mm. A spline's area is not analytic, so the returned volume is the measured value. Returns mass properties. Use new_part first.

Round edges of the current part with one constant radius (mm). edges: "all" (default), "x"/"y"/"z" for edges parallel to that world axis, or explicit indices like "2,5" from list_edges. Returns the number of edges filleted and the resulting mass properties.

Cut a circular through-hole at (x_mm, y_mm), through the part's depth axis. The hole runs straight through the thickness (the add_box extrude direction), perpendicular to the width x height profile face. Coordinates share add_box's system (the centre of a 40x20 profile is x=20, y=10). Returns mass properties.

Drill a round hole on ANY planar face, centred at 3D point (x, y, z) mm. face is "+x"/"-x"/"+y"/"-y"/"+z"/"-z": the face facing that way through the point is drilled, so a pocket floor or a step works too. Through all, or depth_mm deep (blind: heat-set inserts, screw pilots). Returns mass properties and `dimensions` (diameter, x, y, depth).

An ISO hole from SolidWorks' Hole Wizard, sized by its standard tables. kind: 'clearance' (ISO 273), 'counterbore' (socket head cap screw), 'countersink' (socket countersunk screw) or 'tapped'; size e.g. 'M3'. Centred at (x, y, z) mm on the face through that point; through all, or depth_mm deep. fit: 'close' / 'normal' / 'loose'. For tapped holes thread='modeled' cuts a real, printable ISO thread instead of SolidWorks' cosmetic one. Returns the standard's sizes in `hole` and mass properties.

Repeat a feature `count` times, `spacing_mm` apart, along a direction. direction: "+x"/"-x"/"+y"/... feature_name: the feature to repeat (e.g. "Hole"); defaults to the most recently added feature. Returns mass properties.

Loft (blend) 2+ closed polygon profiles on parallel planes stacked along +Z. profiles_mm = [[[x,y],…], …] (mm), one polygon per profile in Front-plane coords. heights_mm = the +Z offset (mm) of each profile, same length, strictly increasing, starting at 0. A 2-profile loft is a ruled transition; 3+ blend smoothly. Give profiles in a consistent vertex order to avoid twist. For non-rotational transitions (round shapes: use add_revolved_profile/add_cone). Returns mass properties. Use new_part first.

Mate a planar face of one component to a planar face of another. comp_a/comp_b are component names ('Bed' or 'Bed-1'). face_a/face_b select a planar face by direction in that component's OWN frame: "+x"/"-x"/"+y"/..., optionally "+y:inner" for the cavity side of a hollow part (the inside of a room wall instead of its outer skin). mate_type: "coincident", "distance" (uses distance_mm), "parallel" or "perpendicular". flip swaps the solution if SolidWorks lands on the mirror side. The result is measured back from the geometry after the rebuild and rejected if it is not what was asked.

Revolve a closed (radius, height) profile about the axis at radius 0. profile_mm = [[r, z], …] in mm: r = distance from the axis, z = position along it. Auto-closed and spun angle_deg (default 360°). Points at r=0 give a solid (turned shafts, vases); a profile offset from the axis gives a ring/torus. The profile may not cross the axis. Returns mass properties. Use new_part first.

Add a straight stiffening rib / gusset in a plane parallel to the Front plane. start_mm/end_mm = [x, y] ends of the rib's free edge (add_extruded_profile coordinates); the plane sits at height z_mm. The rib grows toward toward_mm (any [x, y] point on the side to fill, e.g. the inner corner of an L-bracket) until it meets the part, thickness_mm thick, centred on the plane. Returns mass properties: a triangular gusset with legs a and b adds a*b/2 * thickness.

Hollow the current part to a wall of thickness_mm, opening one face. open_face: a direction "+z"/"-z"/"+x"/... removes that planar face (open shell); "none" makes a closed hollow. Returns the resulting mass properties.

Sweep a circular profile (pipe/tube/rod) along a 2D path on the Front plane. path_mm = [[x, y], …] in mm is the centreline. Interior corners are rounded with bend_radius_mm (required when the path turns; a 2-point straight path needs none). diameter_mm = outer Ø; the round profile is auto-generated perpendicular to the path. Returns mass properties. Use new_part first.

Sweep an arbitrary closed PROFILE (cross-section) along a 2D PATH. profile_mm = [[u,v],…] in mm: the closed cross-section on the Right plane (u → world +Y, v → world +Z), centred near the origin. path_mm = [[x,y],…] in mm on the Front plane — MUST start at the origin heading +X (the profile is perpendicular to the path there). Path corners are rounded with bend_radius_mm. Volume = profile_area · path_length. For non-round extrusions along a path (rails, gaskets, trim, channels). Returns mass properties. Use new_part first.

Cut a real, printable ISO metric thread (SolidWorks' own Thread feature). size: e.g. 'M10x1.5', 'M3x0.5', 'M10x1.0' -- checked against SolidWorks' thread profiles. (x_mm, y_mm, z_mm) = centre of the circular edge where the thread starts: the end face of a rod, or the mouth of a hole (internal=True). It runs length_mm into the material, right-handed. External: the rod must have the nominal diameter (M10 -> Ø10). Internal: drill the ISO basic minor diameter first, D - 1.0825*P (M10x1.5 -> Ø8.376). Returns mass properties and the thread's size, pitch and diameters.

Report component pairs whose solids overlap, with the volume in mm^3. Touching faces do not count (a bed standing on the floor is fine); only real overlapping material does. count == 0 means the assembly is clash-free.

Close the current part or assembly without saving (export/save first if needed).

Compare the current part's cross-sections with a reference mesh's at the same heights. offset_mm [dx, dy, dz] moves the mesh into the part's frame. A different area means a misread feature; equal areas with different extents a shifted frame. Returns per-section pairs and the worst differences.

Cut a polygonal pocket/slot from the +Z face: points_mm = [[x,y], ...] in mm. Auto-closed polygon, cut blind by depth_mm or all the way through when depth_mm is omitted. For pockets, slots, cutouts. Returns mass properties.

Cut a polygon pocket/slot on ANY planar face: points_mm = [[x,y,z], ...] in mm. The 3D points must lie on one face facing `face` ("+x"/"-x"/...), which is found through them; cut blind by depth_mm or through when omitted. For side pockets/cutouts. Returns mass properties.

Cut a polygon sketched on a reference plane, symmetric about that plane. plane: 'front' (z = 0), 'top' (y = 0) or 'right' (x = 0); points_mm = 3D [x, y, z] points ON that plane (e.g. x = 0 for 'right'). Cuts through all in both directions (depth_mm omitted) or depth_mm in total, centred on the plane. For shapes seen from the side: wedges, windows, symmetric recesses. Returns mass properties.

Cut a straight slotted hole (obround) on the +Z face. Centred at (x_mm, y_mm); length_mm is centre-to-centre of the rounded ends, width_mm the slot width, angle_deg its orientation in the +Z plane (0 = +X). Cut blind by depth_mm or through when omitted. Returns mass properties.

Export the current part or assembly to STEP/STL/IGES/Parasolid/3MF (format from extension). Silent (no prompts). Verifies the file appears on disk and reports its size. For STL/3MF, tessellation resolution is set first: quality 'coarse'|'fine' (default 'fine' for print quality), or pass deviation_mm (+ optional angle_deg) for a reproducible custom resolution (overrides quality). Ignored for other formats.

Get the bounding box of the whole assembly (min/max/size in mm).

Get the tight bounding box of the current part (min/max/size in mm).

Get volume (mm^3), mass (kg), surface area (mm^2), centre of mass, and bounding box.

Report whether SolidWorks is reachable, its revision, and the active/current part.

Insert a .sldprt into the current assembly with its ORIGIN at (x, y, z) mm. The part's own origin lands exactly on that point, and the placement is read back and verified. fixed=True pins the component; fixed=False leaves it free for mates. The default fixes only the FIRST component, giving the assembly a ground to build against. Returns the component's name, placement and box.

List the assembly's components: name, path, fixed, position, rotation, bounding box. Positions are in mm and rotations in degrees, both in assembly coordinates; the bounding box of each component is in assembly coordinates too.

List every dimension in the current part: name (for set_dimension), feature, value, unit. For a part opened from disk, or when the names the tools returned are gone.

List the part's edges (index, type; lines give axis/length/midpoint). Use the index with add_fillet/add_chamfer edges="2,5" to target specific edges.

List the part's faces (index, planar?, normal, area, centre) for inspection. Indices are positional and shift as features are added; call again after edits.

Create a new empty assembly document; it becomes the current document. Assemblies compose saved parts: insert_component places each part, add_mate constrains them, check_interference proves nothing overlaps.

Create a new empty part document; it becomes the current part.

Open an existing .sldasm file; it becomes the current document.

Open an existing .sldprt file; it becomes the current part.

Force a rebuild of the current part and report whether it rebuilt without errors.

Save the current assembly to a native .sldasm file (so it can be reopened).

Save the current part to a native .sldprt file (so it can be reopened/edited).

Save an isometric, zoom-to-fit screenshot of the current part or assembly (PNG/BMP/JPG).

Move/rotate a component: its origin to (x, y, z) mm, rotated rx/ry/rz degrees. name is the component name ('Bed' or 'Bed-1'); rotations apply X, then Y, then Z about the assembly axes, and work on a fixed component too. The transform is read back and compared, so a move SolidWorks ignored (e.g. one already pinned by mates) fails loudly instead of silently leaving the part where it was.