Create a Sample
A sample represents a single laboratory specimen that executes a reusable workflow independently.
Unlike a batch, which manages a collection of samples progressing through the same workflow together, a sample is tracked individually from the moment it is created. Every protocol execution, observation, file, note, compliance event, and workflow state transition belongs specifically to that sample.
Samples may be created directly or promoted from an existing batch during workflow execution.
Examples include:
- Banana TC-001
- Arabidopsis Plant 42
- Agrobacterium Clone A17
- Oyster Mushroom Plate 08
Relationship Between Workflows and Samples
A workflow defines the standardized laboratory process.
Each sample represents one independent execution of that reusable workflow.
flowchart LR
W["Reusable Workflow"]
W --> P1["Protocol 1"]
P1 --> P2["Protocol 2"]
P2 --> P3["Protocol 3"]
W -. creates execution .-> S["Sample"]
S -. executes .-> P1
Unlike batches, there is only a single laboratory object being tracked.
Every protocol executed belongs exclusively to that sample.
Creating a Sample
Select New Sample from the Samples page.
Creating a sample consists of selecting the reusable workflow to execute and providing basic execution information.
Required information includes:
- Domain
- Species
- Workflow
- Sample name
Optional information includes:
- Scheduled start time
- Notes
flowchart LR
Domain --> Species
Species --> Workflow
Workflow --> Sample["Create Sample"]
Domain
Select the laboratory domain.
Examples include:
- Tissue Culture
- Fungus
- Agrobacterium
The selected domain filters both available species and compatible workflows.
Species
Select the species this sample belongs to.
Species are filtered by the selected domain.
Selecting a species limits the available workflows to those designed for that organism, helping ensure appropriate laboratory procedures are followed.
Workflow
Select the workflow this sample will execute.
The selected workflow defines:
- protocol execution order
- laboratory procedures
- workflow state transitions
- required materials
- environmental requirements
- scheduling
- data collection forms
The workflow itself is never copied.
Instead, the sample becomes a live execution of that reusable workflow.
flowchart TB
Workflow["Reusable Workflow"]
Workflow --> Protocol1["Protocol 1"]
Workflow --> Protocol2["Protocol 2"]
Workflow --> Protocol3["Protocol 3"]
Sample["New Sample"]
Sample -. Executes .-> Workflow
The same workflow may therefore be reused indefinitely while every sample maintains its own completely independent execution history.
Sample Name
Provide a descriptive identifier for the sample.
Examples include:
- Banana TC-001
- Plate A12
- Plant 47
- Clone B-09
- Transformation 2026-018
Good naming conventions make samples easier to locate throughout execution, reporting, and audit history.
Scheduled For
Specify when execution is expected to begin.
Scheduling allows FlaskTrack to:
- calculate protocol due dates
- schedule protocol delays
- generate upcoming work alerts
- assist laboratory planning
The scheduled start time becomes the reference point for protocol scheduling throughout the workflow.
Notes
Optionally record information specific to this sample.
Examples include:
- source material
- experimental objectives
- collection location
- operator instructions
- observations prior to execution
- laboratory assumptions
Unlike workflow descriptions, these notes apply only to this individual sample.
Sample Execution
After selecting Create Sample, FlaskTrack creates a new execution of the selected workflow.
The sample immediately inherits:
- ordered protocols
- protocol steps
- scheduling rules
- laboratory instructions
- environmental requirements
- custom data collection forms
- workflow state transitions
flowchart LR
Sample
--> Workflow
Workflow
--> Protocols
Protocols
--> Execution["Laboratory Execution"]
Execution
--> Events["Execution Events"]
Events
--> Reports["Reports & Analytics"]
From this point forward, every protocol execution, laboratory observation, compliance event, attachment, note, and collected data record belongs exclusively to this sample.
Executing or modifying one sample never affects any other sample, even when they execute the same reusable workflow.
Reusing Workflows
A single workflow may be executed by thousands of independent samples.
flowchart TB
Workflow["Agrobacterium Transformation Workflow"]
Workflow --> S1["Sample A"]
Workflow --> S2["Sample B"]
Workflow --> S3["Sample C"]
Workflow --> S4["Sample D"]
Workflow --> SN["..."]
S1 --> H1["Independent History"]
S2 --> H2["Independent History"]
S3 --> H3["Independent History"]
S4 --> H4["Independent History"]
Every sample follows the same standardized laboratory process while maintaining its own execution history, laboratory data, files, notes, workflow progress, and audit trail.
This separation between reusable workflows and individual sample executions allows laboratories to standardize procedures while preserving complete traceability and reproducibility for every specimen.