PhloemDocs

Runs

A run is a named stretch of recording. Start one on Live, find it later in Replay or on the console's Runs page.

Record a run

  1. On Live, type a name in Name this run (optional).
  2. Press Record. The button reads Recording while it runs.
  3. Press it again to stop. A note confirms Run 13 saved · 4m 12s.

Record is disabled until a source is connected. With no name, a run is known by when it started.

The arrow beside Record (Recording options) opens Recording settings… and Past runs.

Recording settings

Recording settings… opens the Recording sheet for the active project.

Before recording

Add question picks one of your workspace's run fields. Answers are kept with the run and written into its files. Open a question to set:

SettingChoices
At RecordAsk each time · Fixed value
Requiredon or off
Default / Valuethe answer filled in for you

With questions set, Record shows them first. A blank required field reads Needed to start. Run fields are defined on the console's Runs page, Fields tab, or with phloem field.

After recording

Turn on Save files automatically to write files when each run ends. Off, you export runs from Past runs when you need them.

SettingChoices
FolderChoose a folder
FormatsTDMS · CSV · CSV · one file · CSV · long · Parquet · MCAP (those this device offers)
Split (under More)One file · By time (min) · By size (MB)
RateEvery sample, or a lower rate in Hz
CSVcolumn separator, decimal separator, decimals
Name patternplaceholders such as {Project} and {Year}; Next file previews the name

Recent files lists what was written, with Show in folder. Press Save to keep changes.

Find a run in Replay

Open Replay and the runs tab on the left. Runs are grouped by day, newest first, for the active project.

  • Filter runs — match by name.
  • Filter by tag — runs holding an event or command, from Events and Commands.
  • Click a run to show its window.

Each row's More menu:

ItemDoes
Download…opens the export sheet on this run. See Export data.
Send to cloud…sends what only this device holds
Release local data…keeps the run; its samples may be pruned when the disk budget is full. Upload first sends it before releasing.
Delete run…removes a manual run from this device's list and the cloud's

A recipe run cannot be deleted, only released. A run still recording cannot be deleted.

Runs in the console

The Runs page lists every device's runs, newest first. Tabs: Runs, Recipes, Fields.

FilterChoices
WhenLast 7 days · Last 30 days · Last 90 days · All time
DeviceAll devices, or one
ProjectAll projects, or one
RecipeAny recipe, or one
Unita unit name prefix
Latest per unitone row per unit, its latest attempt
Fielda run field and its value

Click a unit to see every attempt on it. Open a recipe for its measurements, worst first.

A run's page has Copy link, Open in SQL and Download data. A recipe run adds tabs Summary, Measurements, Evidence and Recipe. Its Data section says whether the run is in the cloud.

Note

A run appears in the console once it syncs. See Sync.

Updated