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

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

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@'), dimensions (width, height, depth; for set_dimension) and the resulting mass properties.

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).

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.

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.

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 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.

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.

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.

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.

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 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.

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.

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.

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.

Drill a through-hole on ANY planar face, centred at 3D point (x, y, z) mm.

face is "+x"/"-x"/"+y"/"-y"/"+z"/"-z" (the face to drill); (x,y,z) is the centre in global coordinates and must lie on that face. Enables side holes and bolt circles on cylinder end-faces. Returns mass properties.

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 face ("+x"/"-x"/...); cut blind by depth_mm or through when omitted. For side pockets/cutouts. 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.

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.

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, 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.

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.

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.

Set a named driving dimension (e.g. 'D1@BlockExtrude') in mm, rebuild, and remeasure.

This is the parametric edit at the heart of the correction loop. Every modelling tool returns its dimensions by role in dimensions.

Assign a material by name (e.g. "6061 Alloy", "AISI 1020", "ABS").

Makes mass and density reflect a real material instead of the 1000 kg/m³ default. Returns mass properties including density.

Add a global equation linking dimensions, then rebuild and remeasure.

A SolidWorks equation string, e.g. '"D1@BlockExtrude" = 25' or '"D1@BlockExtrude" = 2 * "D1@Sketch1"'. A global variable is '"W" = 40'; link a dimension to it with '"width@Sketch1" = "W"'. Persists a relation (unlike set_dimension). Returns mass properties.

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

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

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

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.

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.

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.

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

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

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

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

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.

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

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

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.

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.

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.

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.

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