Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Multi-case Comparison

Several analysis modules support importing CSV files from previous uPrime sessions and overlaying them on top of the current plot. This is useful for comparing experimental conditions, validating against numerical data, or assembling multi-panel publication figures.

The same workflow is used in: Mean & Convergence (Mean Velocity tab), Reynolds Stress, TKE Budget, Spectra (Spatial Welch and Temporal), Correlation, and Anisotropy (Lumley line mode).

Importing a case

Click ‘Import Case…‘ and select a CSV file. The CSV must follow the column layout produced by uPrime’s own ‘Export Profile‘ or ‘Export Data‘ actions. The imported case is added to the case list with an auto-assigned color and dashed linestyle.

Reynolds stress line profile with two imported cases overlaid. The current dataset is shown as solid lines; imported cases use distinguishable colors and linestyles. The legend uses the user-assigned label per case.

Figure 1:Reynolds stress line profile with two imported cases overlaid. The current dataset is shown as solid lines; imported cases use distinguishable colors and linestyles. The legend uses the user-assigned label per case.

Managing cases

Click ‘Manage Cases…‘ to open the Case Manager dialog. From here, cases can be renamed, hidden, or removed. Each case retains its imported file path, line geometry (where applicable), and any header metadata such as UmU_m.

Case Manager dialog. Each row corresponds to one imported case. Use the rename field to change the legend label; toggle visibility with the checkbox; click ‘Remove‘ to drop a case from the list.

Figure 2:Case Manager dialog. Each row corresponds to one imported case. Use the rename field to change the legend label; toggle visibility with the checkbox; click ‘Remove‘ to drop a case from the list.

Plot styles

Click ‘Edit Styles…‘ to change line color, linestyle, marker, and label per case. The current dataset and imported cases are styled independently.

Quantity selector and layout chooser

For modules with multiple quantities (Reynolds stresses with several components, TKE budget with PP, CC, DD, RR, etc.), the quantity selector controls which quantity is overlaid. The layout chooser switches between single-axes overlay and a faceted grid (one panel per case, sharing axes).

Combined export

Click ‘Export All Cases…‘ to save the current dataset and all visible imported cases together in a single CSV. A case column is added to identify which row belongs to which case, suitable for pandas, MATLAB, or further plotting.

Header consistency checks

uPrime reads metadata from CSV headers when available. For Mean Velocity profiles, the # U_m = header is read per imported case. If the imported UmU_m differs from the current setting, a status-bar warning is shown for that specific case so you can manually re-normalize before publishing.