How Sous Chef works
Sous Chef turns what you do in QGIS into a recipe: a Processing model you can run again on other data.
Recipes are saved in the Recipe Book group of the Processing Toolbox.
Making a recipe
- Record: press the record button on the Sous Chef toolbar, work as usual, then press it again to stop.
While recording you can pause (to try things out), add a note to the step you just ran, look at what's
been recorded so far, or throw the recording away.
- From a layer: right-click a layer and choose Create Recipe from This Layer…. Sous Chef traces the
steps that made it, back to the layers it started from.
- Tweak a saved recipe: Processing › Sous Chef › Open a Recipe to Review or Tweak…, or right-click
it in the Recipe Book.
What gets recorded
Processing tools (also batch and “iterate” runs), the Field Calculator, Save Features As, selections used by a
tool, layer filters, joins set up in Layer Properties, the Raster Calculator window and virtual layers.
A recipe you run while recording is unpacked into its own steps.
Typed values, digitising and other edits by hand can't be repeated by a recipe: they're listed as warnings.
The review window
- Ingredients are what the recipe asks for when it runs: the layers to choose (amber) and any settings
you choose to ask for (violet). Click a setting in a step and choose “Ask when the recipe runs”.
- Steps that look like repeats, earlier attempts or discarded results start left out, with the reason;
tick them back in if needed.
- For each result, choose whether it's a final output, an intermediate result that isn't kept, or both.
- Taste Test runs the recipe on the layers you recorded with and compares the results.
- Undo (Ctrl+Z) takes back the last change.
- Images & Animations… makes pictures of the workflow, not the recipe itself: a still image (thirteen
designs, from flowchart cards to a radial flowchart, sticky notes and a comic strip), an animation as a GIF or an MP4
video (maps drawn step by step, a metro ride, a knight's pilgrimage, a kitchen, a board game and more) or a written recipe
(a fun cookbook card, plain instructions, a methods paragraph for a report, or a checklist). Star your favourite designs
to bring them to the front.
- Share saves the recipe itself as one zip file (with its styles and symbol) or as a Python script.
- Right-click a step and choose Start the Recipe from This Step's Result to begin from that layer next time
(a merged layer, say).
Running and sharing a recipe
Run it from the Recipe Book like any Processing tool. To share it, use Share › Share as One Zip File…
(or right-click it in the Recipe Book). Others add the .model3 file with Processing Toolbox › Models ›
Add Model to Toolbox; they don't need Sous Chef.
Settings and privacy
Sous Chef has a page in Settings › Options. It makes no internet connections. The background tracker
keeps notes in memory only, and they're gone when QGIS closes.