lunartrace.workbench.presets

Preset research operations: real Python the researcher can read, run and edit.

Each preset is the body of one marimo cell. Cells share the names defined by the Lab setup cell: mo, np, sq (slope_quality), wroi (workbench ROI API), figures, site, ring and taus. “Show Python” displays exactly these bodies; nothing here is pseudocode.

`Preset`

class

Preset

One researcher-facing analysis preset.

Attributes

Name	Type	Description
`id`	`str`	Stable key used by the Lab request (for example `"roi-rows"`).
`title`	`str`	Short menu label.
`summary`	`str`	One-sentence description shown beside the title.
`code`	`str`	Python source of one marimo cell body, executed verbatim in the Lab.

`Preset.as_json`

def as_json(self) -> dict[str, str]

Serialise the preset for the GET /presets response.

Returns

dict of str to str — Keys id, title, summary and code.

`SETUP`

attribute

SETUP

Setup cell body; MANIFEST and STORE are placeholders bound by setup_with_paths.

RING and TAUS stay free names that the caller defines in the notebook.

`setup_with_paths`

function

def setup_with_paths(manifest: Path, store: Path) -> str

Bind the manifest and store paths into the setup cell.

Parameters

Name	Type	Description
`manifest`	`pathlib.Path`	Site source manifest path; stored as a POSIX string literal.
`store`	`pathlib.Path`	Source store root; stored as a POSIX string literal.

Returns

str — SETUP with the placeholders replaced, so a downloaded script and the Lab notebook load the same Site.

Notes

RING and TAUS are left as names for the caller to define.

`STEEP_FOLLOWUP`

attribute

STEEP_FOLLOWUP

Follow-up cell appended after the steep-share preset; it reads the slider it defines.

`preset`

function

def preset(preset_id: str) -> Preset

Look up a preset by its id.

Parameters

Name	Type	Description
`preset_id`	`str`	Id of a member of `PRESETS`.

Returns

Preset — The matching preset.

Raises

KeyError — If no preset has this id.

`cells_for`

function

def cells_for(preset_ids: list[str]) -> list[str]

Return the marimo cell bodies for the chosen presets, in order.

Parameters

Name	Type	Description
`preset_ids`	`list of str`	Preset ids in the order they should appear in the notebook.

Returns

list of str — One code body per preset, plus STEEP_FOLLOWUP immediately after "steep-share".

Raises

KeyError — If any id is not a known preset.