Skip to content

Commit a15ba7a

Browse files
committed
Fix: Enhance user-centric scenario description for clarity and detail
1 parent 41e23e8 commit a15ba7a

1 file changed

Lines changed: 12 additions & 6 deletions

File tree

plans/architecture.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,13 @@ This document complements the user-facing specification (`plans/specification.md
2020

2121
## 2. User-Centric Target Scenario
2222

23-
> A researcher uses DataLab to load experimental data from the lab.
24-
> From the GUI, they start an embedded Jupyter server that launches a **DataLab kernel**.
25-
> They open a notebook (locally or remotely) connected to this kernel and write:
23+
> A researcher uses DataLab to load and explore experimental data from the lab.
24+
> Using the graphical interface, they inspect signals and images, apply standard processing operations, and identify the data they want to work on.
25+
>
26+
> When they decide to continue the analysis programmatically, they open a Jupyter notebook associated with the current analysis context.
27+
>
28+
> The notebook starts in an execution environment that provides direct access to the DataLab workspace.
29+
> The researcher writes the following code:
2630
>
2731
> ```python
2832
> img = workspace.get("i042")
@@ -34,13 +38,15 @@ This document complements the user-facing specification (`plans/specification.md
3438
> When executing the cell:
3539
>
3640
> - the processed image appears **inline in the notebook**,
37-
> - **and simultaneously in the DataLab GUI**,
41+
> - **and simultaneously in the DataLab interface (when available)**,
3842
> - with views and metadata updated consistently.
3943
>
4044
> The notebook is then shared with a colleague, who can:
4145
>
42-
> - reproduce the analysis **without launching DataLab** (standalone mode),
43-
> - or resume the workflow in the GUI by opening the associated DataLab project.
46+
> - reproduce the analysis using the notebook alone (without DataLab installed),
47+
> - or resume and extend the workflow in the DataLab graphical interface by opening the associated project.
48+
>
49+
> When needed, a notebook can be opened to continue the analysis programmatically, using the same execution environment and data context.
4450
4551
This scenario combines:
4652

0 commit comments

Comments
 (0)