Documentation

Datasets#

The relationship in a GraphX project is source graph image → calibration → datasets → points. A dataset is an ordered group of points from one plotted series. For example, a pressure-drop graph with curves at three flow conditions can use three datasets, one for each curve, rather than mixing all values into one table.

Datasets are saved with the project, including their names, colours, point order, export inclusion, and precision settings.

Active dataset#

The active dataset is the current destination and context. Manual Add/edit points additions, accepted Trace curve output, the Data points table, Precision, Copy data, sorting, and most point-cleanup actions operate on it. Its row is visibly active, and the Data points drawer shows its name, colour, and point count.

Select a row to make that dataset active. Changing the active dataset clears multi-point selection and ends point-edit mode, so GraphX never accidentally edits a point in one series while another is being displayed as active.

Creating datasets#

Use + Add in the Datasets header. GraphX creates a new dataset with a generated name such as Dataset 2, makes it active, focuses its name for immediate rename, assigns the next default colour, and gives X and Y the default 4-significant-figure precision. If calibration is complete, ordinary Add/edit points mode is ready for the new series.

Creating a separate dataset before digitising a second curve keeps marker colours, exported columns, and later trendlines unambiguous.

Naming datasets#

Click the dataset name itself to rename it inline. Press Enter to keep the edited name or Escape to abandon the rename. Meaningful names are especially useful in CSV headings, PDF reports, and when selecting a dataset as the destination for a trace or as a source for Axis lock.

Colours#

Each dataset has its own colour control. GraphX uses that colour for its graph markers and for the pending trace preview when that dataset is the active destination. Checked datasets use their colours in JPEG overlays and PDF point overlays.

New trendlines begin with their source dataset’s colour, but a trendline’s colour can be changed independently afterwards. Changing a dataset colour therefore does not promise to recolour an already created trendline.

Export inclusion#

Each row includes an Export checkbox. Checked datasets are included in CSV, PDF, and JPEG exports. Unchecking Export does not delete the dataset, hide it from the workspace, prevent it from being active, or remove its points. It only excludes that dataset from those multi-dataset export results.

Copy data is different: it copies the active dataset as its own tab-separated table and is available from Data points when that dataset has calibrated points, regardless of its Export checkbox.

Reordering datasets#

Drag the grip at the start of a row to move it, or use the row’s up and down controls for a keyboard-accessible alternative. The displayed order is the canonical dataset order: it is kept in the project and determines the ordering of multi-dataset workspace and export output. Reordering does not change point coordinates or dataset identities.

Removing datasets#

The − Remove control targets the active dataset. GraphX protects the final remaining dataset, so Remove stays unavailable when only one dataset exists.

An empty dataset with no associated trendlines is removed immediately. If it contains points or owns trendlines, GraphX opens a confirmation dialog that states what will be removed. Confirming removes the dataset, all of its points, and associated trendlines. Because point history can refer to any dataset, removing a dataset clears the current point Undo/Redo history.