Patterns and transforms
These features copy, reflect, move and scale what earlier features made: lpattern, cpattern, curvepattern, mirror, moveBody, scale, and combine, which applies a boolean between whole bodies. The examples use a 60 x 20 x 10 mm bar with a pocket of radius 3 at x = 10 (feature F4) or the plate of the overview.
{
"format": "ck-part", "version": 1,
"features": [
{
"type": "sketch", "id": "F1", "plane": {"kind": "std", "id": "front"},
"points": [
{"id": "a", "x": 0, "y": 0},
{"id": "b", "x": 60, "y": 0},
{"id": "c", "x": 60, "y": 20},
{"id": "d", "x": 0, "y": 20}
],
"entities": [
{"type": "line", "id": "e1", "p1": "a", "p2": "b"},
{"type": "line", "id": "e2", "p1": "b", "p2": "c"},
{"type": "line", "id": "e3", "p1": "c", "p2": "d"},
{"type": "line", "id": "e4", "p1": "d", "p2": "a"}
],
"constraints": []
},
{"type": "extrude", "id": "F2", "op": "add", "sketch": "F1", "end": "blind", "depth": 10},
{
"type": "sketch", "id": "F3", "plane": {"kind": "face", "id": "F2.C1"},
"points": [{"id": "c", "x": 10, "y": 10}],
"entities": [{"type": "circle", "id": "e1", "c": "c", "r": 3}], "constraints": []
},
{"type": "extrude", "id": "F4", "op": "cut", "sketch": "F3", "end": "blind", "depth": 4}
]
}
Seeds and copies
lpattern, cpattern and mirror copy features, not faces. A seed is the id of an earlier feature that made a tool solid: an extrude, revolve, sphere, sweep, loft or hole, or an earlier pattern. The copies of the tool are combined with the body in the same way as the seed was: copies of a cut are cut, copies of a boss are added. A copy that falls outside the body does nothing and is not an error, but the pattern says so with a warning (see Pattern warnings). A seed that is not a tool-making feature, or does not exist, is missingReference; an empty seeds list is noSeeds.
The faces of a copy carry the id of the pattern and the number of the copy: F4.C0@F5.1, F4.S.e1@F5.2. The copies are numbered from 1; the seed itself keeps its name. A pattern of a pattern chains the suffixes. A pattern’s tool is its seeds together with all of their copies, so a pattern whose seeds is another pattern copies the whole result of the first one, the first seed included: a row of 5 holes (F4, then F5 with count 5) used as the seed of a second pattern along the other axis gives 5 x 5 = 25 holes, with "seeds": ["F5"] alone. (Builds before this change dropped the first seed from the copy rows and gave 21; listing both ids, ["F4", "F5"], was the way round it, and still gives the same result.)
Threads on the seed’s faces are copied to the copies too: see edge and face edits. All three pattern features take carryThreads (default true) to switch this off; a thread feature id can also be listed in seeds to copy that thread alone.
lpattern
Copies the seeds along a direction.
| Field | Type | Default | Meaning |
|---|---|---|---|
seeds | list of feature ids | required | See above. |
dir | {"kind": "axis", "axis": "x"} | required | The direction the copies run along. A world axis (x, y or z); {"kind": "vector", "dir": [x, y, z]} (any direction, oblique too; the length does not matter); {"kind": "axis", "point": [x, y, z], "dir": [x, y, z]} (only the direction is read); a straight edge {"kind": "edge", "faces": [f1, f2], "at": [x, y, z]} (it runs from the edge’s start to its end); the axis of a cylindrical face {"kind": "face", "id": ...}; an axis feature {"kind": "feature", "id": ...} or a sketch line {"kind": "sketchLine", "sketch": ..., "entity": ...}. A direction that does not resolve (a zero vector, a flat face, a curved edge) is missingReference. The same forms work for dir2 and dir3; reverse flips the way. |
spacing | number or expression | 0 | Distance between copies, mm. |
count | number or expression | 0 | Number of instances, including the seed. A value of 1 or less makes no copies and is not an error; a fractional count is rounded; more than 10000 is invalidValue. |
reverse | boolean | false | Copy towards the negative direction. Not read with distanceType: "toObject". |
distanceType | "spacing", "extent" or "toObject" | "spacing" | How the copies are spread, see below. Any other word is invalidValue with field: "distanceType". |
extent | number or expression | none | With "extent": distance from the seed to the last copy, mm. It must be above 0 (invalidValue with field: "extent"). |
to | reference or point | none | With "toObject": what the last copy reaches. See below. Missing or not found: missingReference with field: "to". |
toOffset | number or expression | 0 | With "toObject": moves the end the way the copies go, mm; negative stops short. |
dir2, count2, spacing2, reverse2, distanceType2, extent2, to2, toOffset2 | as above | none | A second direction: the same fields for it. Without dir2 there is no second direction; count2 defaults to 1. A dir2 along dir is invalidValue with field: "dir2". |
Copy k (from 1) is the seed moved by k * spacing along dir. With a second direction, the grid cell (i, j) (i along dir, j along dir2) is copy j * count + i, the seed being (0, 0), so the copies along the first direction keep their numbers from a one-direction pattern. More than 10000 instances in all is invalidValue.
Distance types, per direction:
"spacing":spacingis the distance between neighbours, as above."extent":extentis the distance from the seed to the last copy, and the spacing isextent / (count - 1). A newcountkeeps the extent."toObject": the copy furthest along the direction reachesto, measured from the middle of what is patterned (the centre of the box of the seeds’ tool solids).tois a plane ({"kind": "std", "id": "right"}, a plane feature{"kind": "feature", "id": "F9"}) or a flat face ({"kind": "face", "id": "F2.S.e2"}, with an optionalatpoint that finds the face again if its name changed): the end is where the line from the middle along the direction meets it. Or a point:[x, y, z],{"kind": "point", "at": [x, y, z]}or a body vertex{"kind": "vertex", "faces": [..], "at": [..]}: the end is its distance along the direction. The object gives the side, so the copies go the other way when it lies behind the middle, andreverseis not read. The pattern follows the object when it moves. Refusals: a plane or face that runs along the direction ispatternToObjectParallel; an object at the middle, or an offset that brings the end back to or behind it, ispatternToObjectAtSeed(withdistance); a curved face ispatternToObjectUnsupported.
{
"type": "lpattern", "id": "F5", "seeds": ["F4"], "dir": {"kind": "axis", "axis": "x"}, "count": 3,
"distanceType": "toObject", "to": {"kind": "face", "id": "F2.S.e2"}, "toOffset": -10
}
The pocket at x = 10 is copied towards the bar’s end face at x = 60, ending 10 short of it: pockets at 10, 30 and 50.
{
"type": "lpattern", "id": "F5", "seeds": ["F4"], "dir": {"kind": "axis", "axis": "x"}, "spacing": 15,
"count": 3
}
Run result: no errors; 12 faces, volume 11660.708 mm³. Three pockets in a row: 10, 25 and 40 mm from the left edge. The pocket faces are F4.C0, F4.S.e1, F4.C0@F5.1, F4.S.e1@F5.1, F4.C0@F5.2, F4.S.e1@F5.2.
{
"type": "lpattern", "id": "F5", "seeds": ["F4"], "dir": {"kind": "axis", "axis": "x"}, "spacing": 15,
"count": 3, "reverse": true
}
Run result: no errors; 8 faces, volume 11886.9027 mm³. The copies go to negative x, outside the bar: no copy touches the body. This is not an error; the warning patternCopiesNoEffect with copies: [1, 2] says so.
{
"type": "lpattern", "id": "F5", "seeds": ["F9"], "dir": {"kind": "axis", "axis": "x"}, "spacing": 15,
"count": 3
}
Run result: errors F5: missingReference; 8 faces, volume 11886.9027 mm³.
Large patterns
The only fixed limit is count: more than 10000 instances in one pattern is invalidValue. Time is the limit that matters, and it depends on how the grid is made. Measured on a 3 mm pitch grid of through holes (radius 1) in a 2 mm plate, one regen on a built wasm in Node on a laptop; the times include building the mesh for the reply, and the volume of every run matches the analytic value to 1e-9. No clock was installed, so no budget could trigger; with a clock the default featureTimeMs of 120 s applies (see robustness).
| Grid | Holes | lpattern of lpattern | One sketch of circles, one extrude cut | One sketch of points, one hole |
|---|---|---|---|---|
| 10 x 10 | 100 | 0.5 s | 0.3 s | under 0.1 s |
| 20 x 20 | 400 | 1.0 s | not measured | 1.2 s |
| 30 x 30 | 900 | 2.1 s | 2.4 s | 3.3 s |
| 50 x 50 | 2500 | 9.5 s | 14.5 s | about 18 s |
The cost of a hole feature with many points grows about in step with the number of points: only the holes whose boxes meet are united, and all the tools are cut from the body in one step (earlier builds folded every hole into one growing union, which grew with the square of the count: 7.6 s for 10 x 10, 131 s for 20 x 20 and 748 s for 30 x 30). The hole column is a native build run beside other tests (the 10 x 10, 20 x 20 and 30 x 30 values from the fix that removed the quadratic growth, the 50 x 50 value from tests/hole_many_points.rs, which also checks 2506 faces and the analytic volume); a 50 x 50 grid of lpattern of lpattern takes about 20 s in the same native run. The numbers depend on the machine; the tests bound them loosely (180 s). With a clock installed the default featureTimeMs of 120 s applies, so a slow machine can still trip it on the largest grids: split the points over several features or raise the limit.
A two-dimensional grid is one pattern with dir2, or two patterns, the second seeded with the first ("seeds": ["F5"]: a pattern’s tool holds its seeds and all their copies, see above).
cpattern
Copies the seeds around an axis.
| Field | Type | Default | Meaning |
|---|---|---|---|
seeds | list of feature ids | required | See above. For assemblies the list may be empty and bodies used, see parts and assemblies. |
axis | {"kind": "axis", "axis": "z"} | required | The axis the copies turn about. A world axis through the origin (x, y or z); {"kind": "axis", "point": [x, y, z], "dir": [x, y, z]} for any line (a point on it, defaulting to the origin, and its direction, oblique too; the length of dir does not matter, and its sign sets the sense of the turn); a straight edge {"kind": "edge", "faces": [f1, f2], "at": [x, y, z]}; the axis of a cylindrical face {"kind": "face", "id": ...}; an axis feature {"kind": "feature", "id": ...} or a sketch line. A bolt circle round (40, 50) is {"kind": "axis", "point": [40, 50, 0], "dir": [0, 0, 1]}. A reference that does not resolve (a zero dir, a flat face, a curved edge) is missingReference. |
count | number or expression | 0 | Number of instances including the seed. |
angle | number or expression | 360 | Degrees. With equal it is the total angle; otherwise the step. |
equal | boolean | true | true: copies are spread evenly: the step is angle / count for a full turn (360) and angle / (count - 1) otherwise, so the last copy lies at angle. false: angle is the step between neighbours. |
reverse | boolean | false | Turn the other way. |
The base is a disc of radius 30 and depth 10 with one through hole of radius 3 at x = 20 (F4):
{
"format": "ck-part", "version": 1,
"features": [
{
"type": "sketch", "id": "F1", "plane": {"kind": "std", "id": "front"},
"points": [{"id": "c", "x": 0, "y": 0}],
"entities": [{"type": "circle", "id": "e1", "c": "c", "r": 30}], "constraints": []
},
{"type": "extrude", "id": "F2", "op": "add", "sketch": "F1", "end": "blind", "depth": 10},
{
"type": "sketch", "id": "F3", "plane": {"kind": "face", "id": "F2.C1"},
"points": [{"id": "c", "x": 20, "y": 0}],
"entities": [{"type": "circle", "id": "e1", "c": "c", "r": 3}], "constraints": []
},
{"type": "extrude", "id": "F4", "op": "cut", "sketch": "F3", "end": "blind", "depth": 10}
]
}
Appended to it:
{
"type": "cpattern", "id": "F5", "seeds": ["F4"], "axis": {"kind": "axis", "axis": "z"}, "count": 4,
"angle": 360
}
Run result: no errors; 7 faces, volume 27143.3605 mm³. Four holes 90 degrees apart (the seed and three copies): volume pi 30² 10 - 4 pi 3² 10 = 27143.3605.
Appended to the same disc document:
{
"type": "cpattern", "id": "F5", "seeds": ["F4"], "axis": {"kind": "axis", "axis": "z"}, "count": 3,
"angle": 30, "equal": false
}
Run result: no errors; 6 faces, volume 27426.1039 mm³. With equal: false the angle is the step: copies at 30 and 60 degrees.
mirror
Reflects seeds, or the whole body, about a plane.
| Field | Type | Default | Meaning |
|---|---|---|---|
seeds | list of feature ids | required unless body | The features to reflect. Each copy is instance 1 of the mirror (F4.C0@F5.1); a mirrored cap keeps its cap number. |
plane | plane reference | required | A standard plane, a plane feature or a planar face. A missing plane is missingReference. |
body | boolean | false | Reflect the whole body made so far and unite it with the body (seeds are then ignored). The copy’s faces get @<mirror id>.1. A copy clear of the body is added as a separate body without a boolean. |
replace | boolean | false | With body: the image takes the place of the body instead of being united with it. On a sheet metal part (the last feature was a sheet feature) the part stays a sheet: the reflected panel tree, with the same flat pattern and bend table, for any plane including a flat face of the sheet. Without replace, a sheet is joined to its image only when the plane runs along a bend-free straight edge of the base plate, square to it (one sheet that unfolds as a whole); any other plane is refused with sheetMetalUnsupported {detail, hint} and the part is unchanged. |
[
{"type": "plane", "id": "P1", "mode": "offset", "base": {"kind": "std", "id": "right"}, "offset": 30},
{"type": "mirror", "id": "F5", "seeds": ["F4"], "plane": {"kind": "feature", "id": "P1"}}
]
Run result: no errors; 10 faces, volume 11773.8053 mm³. The pocket at x = 10 is mirrored about the plane x = 30 to x = 50: volume 11773.8053. The copy’s faces are F4.C0@F5.1, F4.S.e1@F5.1.
{"type": "mirror", "id": "F5", "body": true, "seeds": [], "plane": {"kind": "std", "id": "right"}}
Run result: no errors; 10 faces, volume 23773.8053 mm³. The whole body is reflected about x = 0 and united with itself: box [-60,0,0] to [60,20,10]; volume 23773.8053 = 2 x 11886.9027.
moveBody
Moves, rotates or copies whole bodies.
| Field | Type | Default | Meaning |
|---|---|---|---|
bodies | list of selectors | all bodies | Which bodies. target is accepted for bodies, and body when it is an object or array (or a string while copy is not true). |
translate | [x, y, z] | none | Translation; components may be expressions. |
rotate | object | none | {"axis": [x, y, z], "origin": [x, y, z], "angle": degrees}. axis can also be "x", "y", "z" or {"kind": "axis", "axis": "x"}; origin defaults to the world origin. |
copy | boolean | false | Keep the source body and add a moved copy; its face names get @<id>.1. |
body | string | none | With copy: true: the name of the copies (bodyNameConflict if taken). |
mirror | plane reference | none | With copy: true: the copy is the mirror image about this plane (solid bodies only). |
Body selectors: {"body": "Block"} (every body with that name), {"face": "F2.C1"} or the bare face name (the body that holds the face), {"feature": "F4"} or a bare id without a dot (every body holding a face made by that feature, including copies), {"surface": "F7"} (a surface body), {"lump": 2} (by index). A selector that finds nothing is missingReference (with name and nearest for {body}).
The rotation is applied first, then the translation. Without copy the bodies move in place and all names stay; moved bodies are not united with what they touch, so the result may hold overlapping bodies (use combine afterwards). No motion at all is a no-op. The older keys dx, dy, dz with axis and angle still read.
Errors: nothingToCut (no body), missingReference, invalidValue {detail} (a vector without three components, a non-finite number, a zero rotation axis), bodyNameConflict.
{
"type": "moveBody", "id": "F5", "translate": [100, 0, 0],
"rotate": {"axis": [0, 0, 1], "origin": [0, 0, 0], "angle": 90}
}
Run result: no errors; 8 faces, volume 11886.9027 mm³. Rotated 90 degrees about z first, then moved 100 in x: box [80,0,0] to [100,60,10]. The names are unchanged.
{"type": "moveBody", "id": "F5", "copy": true, "body": "Copy", "translate": [0, 30, 0]}
Run result: no errors; 16 faces, volume 23773.8053 mm³. The copy sits 30 mm further in y and its faces carry @F5.1: F2.C0@F5.1, F2.S.e1@F5.1, F2.S.e2@F5.1, …
scale
Scales bodies about a point, uniformly or per axis.
| Field | Type | Default | Meaning |
|---|---|---|---|
factor | number, expression or [sx, sy, sz] | required | The factors along the world axes. factors is a synonym. Each must be finite and above 0. |
at | [x, y, z] | none | The fixed point (origin is a synonym). |
about | string | "centroid" | Without at: "origin" or "centroid" (the centre of mass of the selection). |
bodies | list of selectors | all bodies | As for moveBody (body and target are read too). |
The bodies change in place and every face keeps its name. The result is exact for planes, for cylinders and cones stretched along their axis, for B-spline faces and for spheres and tori under a uniform factor. What cannot be kept exact is refused with invalidValue {detail, hint} and the body is left as it was: round faces stretched across their axis, a sphere or torus under a non-uniform factor, and revolution, extrusion, screw and offset surfaces. A factor of 0 or less is refused with invalidValue {detail: "a scale factor must be above zero"}; for a negative factor the hint suggests mirror, but the same hint is also given for 0, where it does not apply.
On the plate of the overview:
{"type": "scale", "id": "F5", "factor": [1, 2, 0.5], "about": "origin"}
Run result: no errors; 6 faces, volume 8000 mm³. box [0,0,0] to [40,40,5]; volume 8000 = 8000 x 1 x 2 x 0.5.
A bar with a round pocket cannot be stretched across the pocket axis:
{"type": "scale", "id": "F5", "factor": [1, 2, 0.5], "about": "origin"}
Run result: errors F5: invalidValue {"detail":"a round face (cylinder or cone) would be stretched across its axis","hint":"scale it by one factor on all three axes, or only along the axis of the round faces (a cylinder stretched along its own axis stays exact)"}; 8 faces, volume 11886.9027 mm³.
{"type": "scale", "id": "F5", "factor": -1}
Run result: errors F5: invalidValue {"detail":"a scale factor must be above zero","hint":"a negative factor would mirror the body: use mirror"}; 6 faces, volume 8000 mm³.
combine
A boolean between whole bodies of one part. bodyBoolean is accepted as a second name for the feature type.
| Field | Type | Default | Meaning |
|---|---|---|---|
op | string | required | union (add, join), cut (subtract), intersect (common) or split. Anything else is invalidValue. |
target | selector | required | Exactly one body (a is a synonym): {"face": ..}, {"lump": n} or {"body": name}. Several bodies with the name are ambiguousBody. |
tools | list of selectors | required | One or more bodies (tool or b). A tool may not be the target. |
keepTools | boolean | false | Keep the tool bodies; otherwise they are consumed. |
body | string | the target’s name | Name of the result body. |
tolerance, autoFuzzy | See features. |
union joins the target with each tool in turn, cut subtracts them, intersect keeps what lies inside all, split cuts the target into the part outside all tools and the part inside them (two bodies). Faces keep their names; a face divided by the operation gets ~k. The bodies that take no part come first, then the result.
Errors: nothingToCut (no body), missingReference, ambiguousBody, invalidValue {detail}, bodyNameConflict, booleanFailed, booleanVolumeMismatch, cutNoEffect (a cut or split changed nothing), combineEmpty (an intersect of bodies that do not overlap).
A disc and a second body Tool made with newBody, overlapping it:
{
"format": "ck-part", "version": 1,
"features": [
{
"type": "sketch", "id": "F1", "plane": {"kind": "std", "id": "front"},
"points": [{"id": "c", "x": 0, "y": 0}],
"entities": [{"type": "circle", "id": "e1", "c": "c", "r": 20}], "constraints": []
},
{"type": "extrude", "id": "F2", "op": "add", "sketch": "F1", "end": "blind", "depth": 10},
{
"type": "sketch", "id": "F3", "plane": {"kind": "std", "id": "front"},
"points": [
{"id": "a", "x": 10, "y": 10},
{"id": "b", "x": 30, "y": 10},
{"id": "c", "x": 30, "y": 30},
{"id": "d", "x": 10, "y": 30}
],
"entities": [
{"type": "line", "id": "e1", "p1": "a", "p2": "b"},
{"type": "line", "id": "e2", "p1": "b", "p2": "c"},
{"type": "line", "id": "e3", "p1": "c", "p2": "d"},
{"type": "line", "id": "e4", "p1": "d", "p2": "a"}
],
"constraints": []
},
{
"type": "extrude", "id": "F4", "op": "newBody", "body": "Tool", "sketch": "F3", "end": "blind",
"depth": 10
}
]
}
{"type": "combine", "id": "F5", "op": "cut", "target": {"face": "F2.C1"}, "tools": [{"body": "Tool"}]}
Run result: no errors; 5 faces, volume 12251.2239 mm³. The tool is subtracted from the disc and consumed; volume 12251.2239.
{
"type": "combine", "id": "F5", "op": "intersect", "target": {"face": "F2.C1"},
"tools": [{"body": "Tool"}]
}
Run result: no errors; 5 faces, volume 315.1467 mm³. Only the overlap of disc and tool is left.
curvepattern
Copies the seeds along a path.
| Field | Type | Default | Meaning |
|---|---|---|---|
seeds | list of feature ids | required | As for lpattern. |
path | {"kind": "sketch", "id": ..} or {"kind": "curve", "id": ..} | required | As a sweep’s path: an open chain of lines and arcs of a sketch, a sketch3d spline, a helix or another curve feature. Missing or not found: missingPath (checked first). A closed chain is pathInvalid. |
count | number or expression | 0 | Instances including the seed, as for lpattern. |
spacing | number or expression | 0 | Distance along the path between copies, mm; must be above 0 (invalidValue with field: "spacing"). |
distanceType | "spacing" or "extent" | "spacing" | "extent": extent is the distance along the path from the seed to the last copy. |
extent | number or expression | none | See distanceType. |
start | number or expression | 0 | Where the seed sits along the path, mm. Outside 0 to the path’s length: patternStartOutside. |
startFraction | number or expression | none | The same as a fraction of the path’s length, 0 to 1; it keeps its place when the path changes length. Read instead of start when given. |
flip | boolean | false | Run the path from its other end. |
orientation | "fixed" or "tangent" | "fixed" | "fixed": the copies are moved, not turned. "tangent": they are carried with a rotation-minimising frame along the path: round an arc they turn about its axis, at a corner between two pieces by the least turn between their directions, and along a helix or spline by small turns between sampled directions. |
The older format’s names are read too: reverse for flip, align: true for "orientation": "tangent", equal: true (with no distanceType) for copies spread over the rest of the path, and a bare string path for a sketch id.
The path runs from its end nearest the middle of the seeds (flip: from the other end). Copy k is the seed moved from the path point start to the path point start + k * spacing, turned with the path when orientation is "tangent". The seed need not sit on the path: a seed 10 mm inside an arc stays 10 mm inside it with "tangent". A last copy past the end of the path is patternBeyondPath, with lastAt, length and maxSpacing, the largest spacing that fits.
{
"type": "curvepattern", "id": "C9", "seeds": ["H5"], "path": {"kind": "sketch", "id": "S8"}, "count": 3,
"distanceType": "extent", "extent": 125.66370614359172, "orientation": "tangent"
}
With S8 an arc of radius 40 about (50, 50) from (50, 10) anticlockwise to (50, 90), and the hole H5 at (50, 20): copies at (80, 50) and (50, 80). With "orientation": "fixed" they are at (90, 60) and (50, 100).
Pattern warnings
After lpattern, cpattern and curvepattern have combined their copies, the result’s face names tell which copies left a mark (a copy’s faces carry @<pattern>.<k>, see above). Three warnings come from that, without any extra boolean in the common case:
| Warning | Params | When |
|---|---|---|
patternCopiesNoEffect | copies (copy numbers), of (the number of copies), hint | Copies that changed nothing: a cut that misses the body, a boss inside the material. A cut copy that left no face but whose box meets the body is checked with an exact intersection (it may have cut away a whole lump). |
patternCopiesApart | copies, hint | Boss copies that touch nothing: each stands as a body of its own. |
patternCopiesOverlap | hint, and minSpacing for a one-direction lpattern | Copies that overlap each other or the seed: the union of seed and copies has less volume than one seed per instance. minSpacing is the width of what is patterned along the direction, the least spacing that keeps copies apart. Copies that only touch are not reported. |
Not built
The feature types fillpattern and spattern are accepted as names (they are not unknownFeature) but are not implemented: they fail with the error code TODO(rebuild): <type> needs ck-ops, except that spattern without a sketch that names a regenerated sketch reports missingSketch first.