10. Diagrams, Axes and 3D Maps¶
Answers to frequent questions about building diagrams, scaling axes, working with cursors, legends and text objects, and creating 3D maps, isolines, colour maps and difference maps.
10.1. Axes, Scaling and Linking¶
10.1.1. How do I keep a fixed or zoomed axis range when I add new channels to a diagram?¶
Adding a channel resets the diagram to the full axis range. Store the range first and restore it afterwards:
Set the axis range you want (zoom or enter the limits in the axis parameters).
Right-click the diagram and choose Autoscale > Save Scaling. This stores the X and Y axis scaling (type, minimum, maximum, delta and label format) of all diagrams of the page.
Add the new signals.
Right-click the diagram again and choose Autoscale > Load Scaling.
The same two commands are useful in templates that are filled with new data by data exchange. The saved scaling belongs to the page and is restored for the diagrams with the same names. The threshold function (Data > Threshold (Range)) only highlights a range, it does not lock the axis.
See also: Diagram=>X/Y/Z-Axis=>Parameters, Data=>Threshold (Range).
10.1.2. Why is the fixed minimum I entered in the axis parameters changed (for example -0.5 instead of 0)?¶
If Autoscale, Minimum fixed and # of Labels are active at the same time in the axis parameters, UniPlot must satisfy the label count and may shift the minimum so that the range divides evenly. The number of labels has priority. Choose one of these options:
Deselect Autoscale and enter minimum, maximum and the label settings manually.
Deselect # of Labels if the exact label count is not important.
Set the scaling, then store it with right-click > Autoscale > Save Scaling and restore it later with Autoscale > Load Scaling. This is useful for templates with data exchange. Do not click the Autoscale button in the axis parameters dialog afterwards, because it rescales the axis again.
See also: Diagram=>X/Y/Z-Axis=>Parameters.
10.1.3. Can an axis be scaled automatically using only the data in the visible range of the other axis?¶
Yes, for the Y axis. UniPlot can scale the Y axis to the X range that is currently displayed:
Zoom the X axis to the range you want.
Select the diagram, right-click and choose Autoscale > Autoscale y-axis for x-range.
This is a manual action for the selected diagrams; there is no permanent automatic setting. The reverse (scaling the X axis from a displayed Y range) is not available. To apply the same scaling to several diagrams, store it with Autoscale > Save Scaling and restore it with Autoscale > Load Scaling.
10.1.4. Is there a keyboard shortcut for Autoscale, and how do I autoscale all diagrams of a document?¶
There is no keyboard shortcut for Autoscale. To autoscale all diagrams of a page, right-click a diagram and choose Autoscale > Autoscale Page; Autoscale > Autoscale selected Diagrams autoscales only the selected diagrams. A data exchange can autoscale the diagrams as well if the autoscale option is ticked in the data exchange options. A button for a global autoscale of all diagrams of a document can be added to the user toolbar with a short UniScript add-in (see LayerAutoScale for the UniScript function).
See also: Data=>Data Exchange=>Options, Tools=>Customize User Toolbar.
10.1.5. How do I link the scales of several diagrams, and why does the Y-link not copy the first and last label?¶
Select the diagram and choose Diagram > Link Axes Scales…. Select the axis to link (for example x-link or y-link), give the link a name and confirm. Repeat the steps for the other diagrams with the same link name.
Only X and Y axes can be linked. Linking the Z axes of several diagrams is not available.
Set up the axis completely (including the first and last label value, for example -5 to 105) before you create the link. The link then passes these settings to all linked diagrams. Changing the first or last label of an axis that is already linked is not propagated.
With stacked diagrams, use the grid in the X axis link and not the hidden X axes of the other diagrams of the stack. Otherwise some X axis titles are not updated when you change the data source.
The automatic naming of new axis links (X-link1, X-link2, …) stopped after 10 links before R2024.3. From R2024.3 up to 99 links are named automatically.
If a channel was added by drag and drop and created a new axis, the option to link the X axis may be greyed out. Add channels with Load instead (see How do I add a second channel to an existing Y axis instead of getting a new axis?).
See also: Diagram=>Link Axes Scales.
10.1.6. How do I add a second channel to an existing Y axis instead of getting a new axis?¶
Do not drag and drop the channel. Select the diagram and the axis, then click Load in the Data Browser. The channel is added to the same diagram and axis without a new axis. To keep the axis title when you load a new channel, double-click the Y axis title and tick Protect Axis Title.
Dragging a channel onto the Y axis of an existing diagram adds the curve together with an additional Y axis. If a new diagram or grid is created instead of a curve, check the drop target.
See also: Load Data into a Diagram, Diagram=>X/Y/Z-Axis=>Title.
10.1.7. A dragged channel landed in the wrong Y axis. How do I move the curve to another Y axis?¶
Copy the curve to the right axis with the clipboard instead of dragging it again:
Click the curve to select it and choose Edit > Copy (Ctrl+C).
Select the diagram of the target Y axis, for example with the diagram combo box in the toolbar.
Choose Edit > Paste (Ctrl+V). The axes are rescaled automatically.
Select the curve in the wrong axis and press Del.
Check the axis title afterwards. If Set Title during load or Auto Axis Title is ticked in the axis title settings, the title can change to the name of the new channel. To avoid the problem, add channels with Load instead of drag and drop (see How do I add a second channel to an existing Y axis instead of getting a new axis?).
See also: Copying Datasets, Edit=>Paste, Diagram=>X/Y/Z-Axis=>Title.
10.1.8. How do I add a second Y axis on the right and assign curves to the left or right axis?¶
Select the diagram, right-click and choose Add Y axis Right (or click the corresponding toolbar button). Select the left Y axis and load the first dataset, then select the right Y axis and load the second dataset. To make an axis start at 0, double-click the axis and set the minimum value to 0.
See also: Stacked diagrams with multiple y axes, Diagram=>X/Y/Z-Axis=>Parameters.
10.1.9. Why do the True/False text labels reappear on the Y axis after reopening the file or when I add a Y axis?¶
Two separate effects exist:
In some releases the user label settings of an axis (text labels from enumeration channels) were not stored correctly in the document, so labels you had switched off returned when the file was reopened. This is fixed in a later release; update to the current release (Help > Check for Updates).
Before R2024.0, a new Y axis created with the add-axis command copied the user labels of the original axis. Since R2024.0 they are not copied. To control the user labels of an axis, open the axis user label settings (Diagram=>X/Y/Z-Axis=>User Label).
See also: Diagram=>X/Y/Z-Axis=>User Label.
10.1.10. How do I make the grid lines match the axis ticks or the custom axis labels?¶
If there are several Y axes (left and right), the grid follows only one of them. In a stacked diagram you can align the labels of the Y axis with the grid: double-click the Y axis (or right-click > Parameters…) and select Align Label to Grid. This option is available only for the Y axis of a stacked diagram; the Maximum value is then calculated from the minimum, delta, axis length and the number of grid lines.
If you defined custom labels (for example 6 labels but 11 grid lines are shown):
Define the same number of labels on both sides of the diagram.
In the diagram settings (Diagram=>Diagram Settings) select the Grid row and, under the Y axis, set Attach to to the other diagram or axis.
See also: Diagram=>X/Y/Z-Axis=>Parameters, Diagram=>Layout=>Grid.
10.1.11. How do I show a time axis as date and time instead of seconds?¶
Double-click the axis (or right-click > X axis > Parameters), set Type to Date-Time and use the Date Format… button to choose or define the display format (for example dd.mm.yy hh:mm:ss or hh:mm). Rotating the labels by 45 degrees in the axis label settings (Diagram=>X/Y/Z-Axis=>Label) improves readability.
Prerequisites for the channel you plot against:
The channel must contain a real date and time value. If year, month, day, hour, minute and second are stored in separate channels, first create a formula channel that combines them into one date/time value, and plot against that channel in a 2D X/Y graph.
A pure time-of-day channel has no date information. The axis then restarts at 00:00 after midnight. Create a date/time channel by adding the date and time channels in a formula, for example
Date_Time = Date + Time, and plot against that channel.If a date column and a time column are imported separately and UniPlot shows the point number as X axis, combine both into one date/time channel in the same way.
See also: The Add/Edit Formula Channel Dialog Box, Diagram=>X/Y/Z-Axis=>Parameters.
10.1.12. How do I show the X axis in seconds (or hours) when the time channel is a date/time value, or convert seconds to hours?¶
If the channel is imported as date/time (HH:MM:SS.SSS), UniPlot converts it to a day-based number (days since 30 December 1899). Setting the axis type to linear then does not give seconds. Either change the format of the time vector so that it is imported as a numeric time in seconds, or create a formula channel that converts the value to seconds (value multiplied by 86400, minus the start time).
To show seconds as hours, scale the X coordinates by 1/3600 with Data > More Data Functions… > Scale coordinates…, or create a formula channel that divides the time channel by 3600.
See also: Data=>Scale coordinates (2D).
10.1.13. Why is the time axis of my y/t diagram 10 times too large (for example 10000 s instead of 1000 s)?¶
The 1D: y/t graph type assumes equidistant points (the start value and the step are set in the 1D and 2D dataset properties). For data with its own time channel use the graph type 2D: x/y and select the time channel as X channel. For MDF, INCA, CAN, ODS and I-file data, which know the time channel of every channel, use 2D: y/t “MDF/INCA/CAN/ODS/iFile”; it plots against the correct time channel automatically.
See also: Load Data into a Diagram, Automatic X-Channel Selection.
10.1.14. How do I change the unit shown in the axis title, or show units according to DIN 461?¶
Axis title for a new diagram: open File > Import Options… and select the desired format in the Placeholder to create the axis title drop-down. This is how you get the unit in the form required by DIN 461 (without square brackets).
Edit the unit of the axis title: right-click the diagram > More Functions > Unit as an axis label… and edit the unit.
Change the unit of the channel itself: open Edit in the Data Browser, select the channel and change the unit attribute.
See also: File=>Import Options, Diagram=>More Diagram Functions=>Unit as Axis Label.
10.1.15. How do I give axis, axis title and labels the same colour as their curve by default?¶
Double-click the axis title and tick Title and Label in Curve Color and Axis in Curve Color. To make this the default for all new diagrams, enable the same two checkboxes in the global settings for axis titles. From UniScript use LayerSetAxesAttribs.
See also: Diagram=>X/Y/Z-Axis=>Title.
10.1.16. Can I use a comma instead of a point as decimal separator in axis and legend labels?¶
Yes, from R2020.0. In Tools > More Options…, section Diagram Options, use the setting Decimal and Thousands Separators. It selects the number format of axis labels, table cells and text objects for all diagrams. In versions before R2020.0 UniPlot always uses a point, independent of the regional settings.
See also: Tools=>More Options.
10.1.17. Can I show axis labels in hexadecimal (for example operating mode codes)?¶
Yes. Right-click the axis, choose Parameters… and select Hexadecimal (0x0000) as number format. For the Z axis use Diagram > z-Axis > Parameters…. The values are shown with the prefix 0x. The hexadecimal format exists since R2014.0. Import the codes as decimal numbers (convert hex to decimal beforehand).
Limits:
Axis labels are always aligned to a regular grid, so arbitrary hex codes cannot be placed exactly at their values. For discrete modes number them 1, 2, 3, … and describe them in the legend or with text labels.
Isoline labels of a 3D dataset can only be shown as decimal or exponential, not as hexadecimal.
See also: Diagram=>X/Y/Z-Axis=>Parameters.
10.1.18. Can the axis show values such as 1.0, 1.5, 2.0 with one common exponent label instead of 1.0E2, 1.5E2?¶
There is no automatic common exponent. Options: scale the data (for example with a scaling filter) and put the factor into the axis title, or place a text object with the exponent next to the axis. The axis Label dialog (double-click the axis labels) can also define text for individual axis values.
See also: Diagram=>X/Y/Z-Axis=>Label.
10.1.19. How do I label the X axis with text values from a channel?¶
Use a category plot: in the Data Browser choose the graph type Category Plot and use the text channel as the X (label) channel. The import fills the freely definable axis labels automatically. The axis title can be changed separately.
See also: Diagram=>Category Options, NC_plotcategory.
10.1.20. Why are axis labels displayed broken, rotated wrongly, or irregularly positioned?¶
If labels are drawn broken or rotated incorrectly and the text direction setting has no effect, this is a rendering problem of the graphics engine. See The diagram shows display errors (broken labels, black areas, lost transparency in PDF, disappearing cursor). How do I fix it?.
With 45 degree label orientation and label texts of different lengths, the labels may be shifted irregularly and are hard to assign to the ticks. This is a known limitation without a documented workaround.
10.2. Data Cursors and Cursor Tables¶
10.2.1. How do I add cursors and a table with the values at the cursor positions?¶
Select the graph and click the Data Cursor button (or choose Data > Data Cursor…, F5). To show a table of values, right-click the graph and choose Cursor > Cursor Data Table…, select the settings and click OK. The table is updated when you move the cursors. To place cursor values in a text object or a table cell that updates automatically, use the field function @f{cursor_value}.
If the cursor table shows # instead of a value, see Why does the cursor data table show “#” instead of values?.
See also: Data=>Cursor Data Table, Data=>Data Cursor.
10.2.2. Why does the cursor data table show “#” instead of values?¶
A # appears in the data cursor table in two cases:
Both cursor lines overlap, so there is no difference between them.
The curves have different end points. UniPlot does not extrapolate, so a curve has no value if the cursor lies beyond its last point.
Move the cursor lines apart and place the cursors inside the common data range of all curves (for example on the shorter curve).
See also: Data=>Cursor Data Table.
10.2.3. How do I change the number of decimal places of the cursor values?¶
Measurement cursor (F5): double-click the vertical cursor indicator in the diagram and set the number of decimal places at the bottom of the dialog. Widen the value column of the Measurement Cursor dialog if the additional decimals are not visible.
Cursor data table: right-click the table > Configuration…, select Number under Cell Format > Format and choose up to 10 decimal places.
If the table shows too coarse X values, check the actual cursor position before assuming that the data are wrong.
10.2.4. Why does the cursor show values of only one diagram or one curve, or disappear at random?¶
The cursor shows only the data of the clicked diagram: link all axes with Diagram > Link Axes Scales…; the cursor data window then lists all datasets of the page. The option Display all cursor data in the data cursor configuration (Data > Data Cursor Configuration…) controls how many datasets are listed. A cursor that spans all diagrams on its own is not a standard function.
The cursor disappears at random or the cursor table shows only one curve: this occurs with the screen rendering mode Direct2D (default). Change Tools > More Options > Installation > Graphics Rendering Screen to 2: GDI+ or 1: GDI, see The diagram shows display errors (broken labels, black areas, lost transparency in PDF, disappearing cursor). How do I fix it?.
The cursor window stops listing values after a number of rows when many files with filters are plotted and some datasets have no points in the diagram: click the affected plot, open the dataset list, right-click Z-order, press Cancel in the dialog and close the dataset list. Removing filters from channels that have no data points in the diagram also helps.
See also: Diagram=>Link Axes Scales.
10.2.5. How do I change the order of the channels in the cursor data table?¶
There is no sort function. The order follows the stacking order (z-order) of the diagrams. Choose Diagram > Diagram Settings…, select the diagram and use the buttons to send it back or bring it to front until it is in the right position. Within a diagram with several datasets, open the dataset list (Ctrl+D), select the diagram, click Z-order and move the dataset. Alternatively, plot the channels in the desired order.
See also: Data=>Dataset List, Diagram=>Diagram Settings.
10.2.6. Can the cursor table show first and last values, use legend names, or be placed in a diagram table?¶
The cursor data table cannot show the first and last X value of the data. Use field functions in a normal table to get first and last values.
The data cursor label does not use renamed legend text. A data table can show the names you want.
There is no function to place delta-cursor values directly into a table. Right-click the cursor values, copy them to the clipboard and paste them into a table.
To step through the cycles of a P-V diagram with the cycle navigation buttons is not possible, because these buttons only work for cycle-based X axes. Open the dataset list, deselect all datasets, select the first one, then select the next dataset to move through the cycles.
See also: Data=>Cursor Data Table.
10.3. Curves, Datasets and Special Plot Types¶
10.3.1. Why does my line connect points vertically instead of point by point?¶
UniPlot connects the points in the order of the data. It sorts by X only if you ask for it. Use the Sort X-Coordinates option in the Data Browser, or Data > More Data Functions… > Sort x-coordinates in ascending order, so that the line is drawn point by point in X order. Also check that the correct X channel is used.
See also: The Data Browser Window, Data=>Sort x-coordinates (2D).
10.3.2. Why does UniPlot plot values that are not in my data when I plot one channel against another?¶
If two channels have different time channels (different raster groups), UniPlot interpolates one channel onto the time channel of the other to avoid losing data. This is the default behaviour; it cannot be switched off. To plot the channels against each other point by point:
Plot both channels as Y/t graphs and create an empty diagram.
Select both curves (Shift+click) and right-click > Multiple Datasets > Interpolate Curves… (the command is also registered as “2D-Interpol: Sum/Diff/Div/Mult/Min/Max/Mean…”).
In the list Function choose Correlation between two datasets (Y2 versus Y1), select the destination diagram and the two datasets and click Create New Dataset. Autoscale the diagram if the curve is not visible.
Alternatively, make sure both channels share the same time channel, or export to Excel and re-import so that they share one time base.
See also: Data=>Dataset List.
10.3.3. Why does a 3D map (X/Y/Z dataset) show values that do not match the raw data?¶
A 3D dataset is created in two steps:
The data can be classified (filtered) at creation: a grid of 100 x 100 cells is laid over the X/Y plane and the median of each cell is used. This reduces the data and removes large differences within a cell. Switch it off with the option Enable Data Filter for 3D datasets in Tools > More Options, section 2D and 3D Datasets, then plot again.
The data are interpolated onto the interpolation matrix. The matrix density is limited (100) and cannot be increased; the function reduce3d can help to keep maximum Z values.
Of several points with identical X/Y only one is kept, and which one is random. Averaging them is not possible in a map, because a map allows only one Z value per X/Y point. If duplicates occur, prepare the data and remove the incorrect duplicates beforehand.
See also: Data=>3D Dataset Properties, Tools=>More Options.
10.3.4. How does UniPlot handle missing values in curves and maps?¶
Missing values are removed before a dataset is created. For 2D datasets the remaining valid points are connected by a straight line, so a gap is not shown. For 3D datasets the data is always interpolated and extrapolated to a rectangular matrix. There is no setting in the diagram to hide the connecting line. Two options exist:
Filter in the Data Browser: define a filter for the channel that removes missing values. All diagrams created afterwards show only the filtered result.
Formula channel: use
replace_missings(c1, c2)to replace missing values of channel c1 with the values of channel c2, orreplace_missings(c1, value)to replace them with a constant. For this function the option Missing-Value handling must be switched off in the formula input dialog.
A broken curve or axis display for gaps is not available.
See also: Channels with Missing Values, The Add/Edit Formula Channel Dialog Box.
10.3.5. How do I draw a curve as steps instead of a linear connection?¶
Right-click the curve, choose Append Filter Function, select step, choose the step type and click OK. You can also create a new step dataset with Data > More Data Functions… > Create step dataset (start horizontal) or Create step dataset (start vertical).
See also: Data=>Step dataset horizontal, Data=>Step dataset vertical.
10.3.6. How do I plot a subset of points as a separate curve without a connecting line?¶
Use a record filter:
In the Data Browser Edit window click the Filter button > Data Filter.
Pick a base channel, an operation (==, >, <, …) and a limit.
Create one filter per subset and plot the diagrams. The filter is stored per dataset.
To draw the subset with symbols only, deactivate the line in the dataset properties.
To apply the filter to another file, use Data > Data Exchange (Document) (or Page). The Record Filter column shows the filters. With Replace File the new data is loaded with the filter applied. To discriminate automatically, add a 0/1 channel to the data and filter on it. The curve filters extract (by X value) and extract_points (point range) cannot cut points in the middle of a curve.
To highlight points in all plots of a document with one filter:
Right-click a white area of a page and select Document Data Exchange.
In Exchange Data File click Add Record Filter, define the conditions in Data Filter and confirm. A new entry with the same file name and the filter in the Record Filter column appears.
Click 2D styles, deselect line, select symbol and choose the colour for the file number of the new entry.
Execute the data exchange.
See also: Edit Filter Functions, Data=>Data Exchange (Document).
10.3.7. How do I highlight phases of a test cycle based on the value range of another channel?¶
Create a 0/1 indicator curve and fill it:
Plot the channel that defines the phase.
Right-click the curve and choose Append Filter Function > Extract Range (Special).
Enter the minimum and maximum value of the phase. Set Axes to 2 (Y axis) and Type to 3. The filtered dataset is 1 inside the range and 0 outside.
Double-click the new dataset, enable Fill Color and choose a transparency.
Set the Y axis range manually to 0 to 1 and disable autoscale.
Copy the dataset and paste it into other diagrams to repeat the highlighting.
The filter Extract Range (Special) checks whether a coordinate lies between min and max. Its parameters:
Axes: 1 uses the X coordinates, 2 uses the Y coordinates.
Type 0: min and max are absolute values.
Type 1: min and max are relative to the maximum value. Enter values between 0 and 1.
Type 2: the data are scaled to the range 0 to 1. Enter values between 0 and 1.
Type 3: all points are kept. Values inside the range become 1, values outside become 0 (indicator curve).
See also: find - Extract Range (Special).
10.3.8. Can I colour only a part of a curve, for example points above a limit?¶
There is no function that changes marker or line colour of single points depending on a limit value. Alternatives:
Highlight the area between the curve and a limit value with Data > More Data Functions… > Fill area between 2 2D-datasets with hatch. This works for a constant limit, because the base value applies to the whole dataset.
Create a second dataset with the points of interest (record filter or extract range filter) and give it its own colour.
See also: Data=>Fill Area (2D).
10.3.9. How do I draw a mean (moving average) line through a curve and keep the original markers?¶
Use a smoothed copy of the curve. The smoothing is done by the smooth filter or by Data > More Data Functions… > Reduce Signal Noise (Moving Average)…. Markers are always drawn on top of the curve, so:
Select the curve and copy it (Ctrl+C, Ctrl+V).
Open the dataset list, select the second curve and click Configuration.
Apply the smoothing to the copy and hide all its markers.
The original keeps its markers and the copy is the smooth line. Alternatively, make the markers much smaller or reduce the marker frequency.
See also: Data=>Reduce Signal Noise.
10.3.10. Why are the markers not scaled when I apply a scale filter?¶
In the dataset properties, the option Plot Symbols for selects whether symbols are drawn for the Original data (default) or for the Filtered data. Choose Filtered data so the markers follow the filter. If the filter is applied before the symbols are activated, Filtered data is selected automatically.
See also: Data=>1D and 2D Dataset Properties.
10.3.11. How do I apply several filters to a curve, and can a filter be applied to only a section of a curve?¶
Double-click the curve, click Edit Filter… (or right-click the curve and choose Edit Filter Functions…), select the filters and add them with the add button. The applied filters are listed and run in the given order. The extract filter limits a curve to an X range, but it removes the rest of the curve. Applying a filter to only a part of a curve while the remainder stays in the same curve (for example smoothing only the first 100 s of 1000 s) is not possible with the standard filters.
See also: List of filter functions.
10.3.12. How do I add a mean curve of many curves in one diagram?¶
Select the curves: hold Shift and click them, use Diagram > Select all Datasets in Page (or Diagram > Select all Datasets in selected Diagrams), or select them in the Dataset List window.
Right-click and choose Multiple Datasets > Interpolate Curves….
In the list Function select Mean of all selected datasets and click Create New Dataset. A new curve with the mean is created.
See also: Data=>Create a mean dataset.
10.3.13. How do I add an X or Y offset to curves, to a whole file, or to all datasets of a page or template?¶
One curve: double-click the curve (or Data > Dataset List and Configuration, or Ctrl+D and Configuration) and enter the X offset on the dataset tab.
All curves of a file or document: open the dataset list (Ctrl+D), switch to the Document tab, select all datasets (click the first one, then Shift+Down), click the global offset button xy-off/factor and enter the offset for all selected curves.
With cursors: add a cursor, position it, right-click the curve and choose Cursor > Move Dataset (or Data > Data Cursor > Move Datasets). You can enter your own offset or use the cursor difference, and apply it to all datasets from the same source. Curves added afterwards are not shifted.
See also: Data=>Data Cursor=>Move Datasets, Data=>Dataset List.
10.3.14. How do I plot a vertical line (drop line) at each X position?¶
Load the data from the Data Browser, open the dataset properties, untick the line style, select the drop line style and a symbol style. To annotate points, right-click the curve and add a text object of type 2D label point.
See also: Data=>1D and 2D Dataset Properties.
10.3.15. How do I display the value of a single point on a curve, and keep a label at a fixed offset?¶
Use field functions in a text box:
@f{labelsinglepoint} shows the value at an X position, for example
@f{labelsinglepoint(Data1, 5000)}.@f{labeldatapoint} labels the point with a given index and can be offset freely, for example
@f{labeldatapoint(Data1, 10, %.2f, 0, 2)}.
A text object that stays at an axis value returns to that position on every refresh. If you need a label that you can move manually, use a normal text field instead of an automatic text.
See also: Data=>Label Data Points.
10.3.16. Why does a 2D: x/y/Label dataset not show all my remarks?¶
By default UniPlot creates at most 50 labels per dataset. If the dataset has more points, the 50 labels are distributed evenly over all points, so many rows with a remark are skipped. This applies to the dataset type 2D: x/y/Label and to Data > More Data Functions… > Label Data Points….
To label more points:
Enter this line in the UniPlot command window, for example for 500 labels:
WriteProfileInt("Settings", "LabelDataPoint_Count", 500);
Plot the dataset again.
Very many labels slow down the page and overlap. If only some rows contain a remark, filter the data to these rows with a record filter before you plot.
See also: Data=>Label Data Points, Edit Filter Functions.
10.3.17. How do I create a 2D curve with error bars?¶
In the Data Browser select the graph type 2D: x/y Errorbars (dataset with error bars) and the four channels X, Y and the minus and plus error. By script use the functions in script\datasets\rs_xy_error_dataset.ic:
// 4 vectors of equal length
auto_xy_CreateErrorDataset(hLayer, ssName, rvX, rvY, rvYMinus, rvYPlus)
To load the values from a netCDF file use auto_xy_CreateErrorDatasetEx with the channel names [x, y, minus_error, plus_error]:
oParameter = [. bXSort = TRUE]; // sort by x
auto_xy_CreateErrorDatasetEx(hLayer, p1, svVarName, oParameter)
Notes:
Other error visualisations, such as a continuous error line or an error band, are not available.
A bug where error bars beyond the first 4000 were repeated is fixed in R2023.4, see Why are error bars drawn at wrong positions in a diagram with many points?.
In a bar chart with error bars, a dataset with only one point shows the wrong values (the negative error is taken as the value). Add one dummy data point to each dataset as workaround.
See also: auto_xy_CreateErrorDataset.
10.3.18. Why are error bars drawn at wrong positions in a diagram with many points?¶
Fixed in R2023.4
This was a bug in older releases. With many points, the first 4000 error bars were used again and again instead of the actual error bars, so the error bars appeared at the wrong places. This also affected 2D x/y/Cycle-Index diagrams. Update to R2023.4 or later (Help > Check for Updates). In older releases the only workaround is to reduce the number of points.
See also: Dialog Box=>Errorbars, How do I create a 2D curve with error bars?.
10.3.19. How do I plot cycles (hysteresis, charge/discharge, P-V cycles) as one coloured curve per cycle?¶
Use the graph type 2D: x/y/Cycle-Index. It creates one curve per value of the index channel. Do not use 2D: x/y/Label; it adds a text label to each data point.
Import the data and select 2D: x/y/Cycle-Index in the Data Browser.
Set the X, Y and index (i) channels and click Load.
Colour the curves: select a style beginning with
AUTO:, for exampleAUTO:Curve, in the dataset style list of the toolbar. If the style assigns the colours byCurve(see Tools > Dataset Style Order Configuration), each curve gets its own colour. You can also change single curves in the dataset list (Ctrl+D) or by double-clicking a curve.Add a legend with right-click > Add Legend > Add Legend for 2D-datasets (Table).
To show only some groups (for example 1000 and 3000 rpm), select the graph, open the dataset list (Ctrl+D), untick the unwanted curves and click OK. The index value of each curve is shown under Data Source in the dataset list.
P-V diagrams: the type 2D: PV-diagram: (CA) Crank Angle is used to split cycles also creates one curve per cycle. A new cycle starts where the CA channel decreases (for example from 719 back to 0). If the CA channel only increases, UniPlot asks for the cycle start and the cycle length in the CA unit (default 0 and 720). If you get only one curve:
With a real crank angle channel, enter the correct cycle start and cycle length, and a cycle selection such as All.
With a cycle-number channel (1, 2, 3, …) instead of a crank angle, all values fall into the first cycle. Use 2D: x/y/Cycle-Index instead and select the cycle-number channel as index (i) channel.
Notes:
There is no option that uses the point number as X. If another channel repeats its values every cycle (for example the crank angle), use it as X with 2D: x/y/Cycle-Index or 2D: x/y Cycle. Both give the same result.
With the plain 2D: x/y type the lines follow the sample order and the cursor jumps between the branches. A filter such as
CYCLE_NUMBER==622is applied only to the first detected cycle. For a hysteresis plot with a record filter per cycle, set a filter for the first cycle in the Data Browser (Edit) and plot it. Set the filter for the second cycle, plot again, and repeat. Finally switch to the Waterfall presentation. The cursor does not work in the result.
See also: Waterfall Diagram, Load Data into a Diagram, Toolbar=>Dataset Style, Tools=>Dataset Style Order Configuration.
10.3.20. How do I create a waterfall plot?¶
Load a 3D x/y/z diagram: in the Data Browser select the graph type 3D: x/y/z, choose a time or timestamp channel as X, the channel with the second dimension (for example the particle size) as Y and the quantity as Z. Then use the shortcut toolbar to switch the graph to Waterfall (alternatives are Polar, 2D and 3D). The same toolbar changes the waterfall properties. For crank-angle based cycles, load the data as a 2D: x/y Cycle diagram and switch to the waterfall view.
See also: Waterfall Diagram, Diagram=>Layout=>Waterfall.
10.3.21. How do I create a p-V diagram from indicating data?¶
In the Data Browser choose the diagram type 2D: PV-diagram: (CA) Crank Angle is used to split cycles. Select the channels for X (volume), Y (pressure) and crank angle (ca), then click Load. One curve is created per cycle.
If each pressure value is drawn as a vertical line down to 0 bar instead of a connected p-V curve, the wrong diagram type is usually selected. Also check in the Data Browser Edit window that all data was imported correctly. If all cycles appear as one curve, see How do I plot cycles (hysteresis, charge/discharge, P-V cycles) as one coloured curve per cycle?.
See also: pV-diagram data type.
10.3.22. How do I create a pie chart, and show category names in its legend?¶
In the Data Browser import the file, select the graph type Pie Chart or Pie Chart with Label, select the channel(s) and press Load. There is no pie chart command that creates the plot from scratch in the Diagram menu. If the legend shows values instead of names, use the type Pie Chart with Label: the names are taken from the label column next to the values, so the legend does not have to be edited each time new data is loaded.
See also: Diagram=>Pie Chart, pie.
10.3.23. How do I create a grouped category (bar) plot where each measurement file has its own category?¶
In the Data Browser use Edit > Add Channel to create an extra channel (for example Step) and give group values (1, 2, 3, …) to the data of each measurement. Use the new channel as Label in the category plot. Double-click the category plot and use Category Options to turn it into a stacked diagram if needed. Alternatively, overlap separate diagrams, select them with Shift and use Diagram > Create Stacked Diagram.
See also: Diagram=>Category Options, Diagram=>Create Stacked Diagram.
10.3.24. How do I draw bars or histogram bars in front of the grid?¶
Open Tools > More Options > Diagram Options and enable Plot 2D bars on top of the grid. All bar graphs and histograms then show the bars in front of the grid. For a single diagram with several plots, double-click the empty part of the diagram, select the diagram in the Diagram Settings dialog and use send to back or bring to front (also in the toolbar).
Known limitations of the bar chart: there is no transparency for bar colours; when a second Y axis is added the chart becomes stacked and the setting for showing the grid behind the bars is ignored. If bars turn upside down when the Y axis is set to logarithmic, check that the value Y-Base for droplines, filling, bars and hatch (in the 1D- and 2D-dataset properties) equals the axis minimum.
See also: Tools=>More Options, Diagram=>Diagram Settings.
10.3.25. How do I create a polar diagram or a spider web (radar) diagram?¶
Select the Cartesian diagram and use Diagram > Display as Polar Plot (Ctrl+P) or the polar diagram button in the toolbar. Polar settings are in Diagram > Layout…, tab Polar. 3D data cannot be displayed in polar coordinates: a 3D Cartesian map switched to polar is empty.
A spider web diagram is a polar diagram with category labels. The labels of a 2D category diagram can be redefined by double-clicking the label; in the polar view the fill colour cannot be set, so set it in the 2D view first.
See also: Diagram=>Layout=>Polar.
10.3.26. How do I build a 3D histogram or residency plot (time per speed/torque region)?¶
Use the 3D classification add-in:
Import the data and create a 2D: x/y graph with the X and Y channels you need (for example speed and torque) and click Load.
Enable the add-in in Tools > Add-In Manager… by selecting 3D Classification of XY time signals.
Right-click the curve, choose the 3D classification command (compound counting) in the New Dataset submenu, set the parameters (class widths and so on). For a correct total time disable Relative frequency in percentage and set the scale factor. The result is a map of counts per cell.
To show it as 2D bubble plot: switch to the flat 2D view, open 3D dataset configuration, untick Show Isolines on the Color Map tab and select Bubble Plot on the Scatter Plot tab; adjust the options so that the bubble size reflects the residency.
Export the matrix with File > More File Functions… > Save 3D Data Matrix….
See also: 3D-Classification of a XY-Dataset, Dialog Box=>Bubble Options.
10.3.27. How do I create a scatter or bubble plot with a third channel as colour or size?¶
Load the data as 3D x/y/z dataset. In the 3D dataset configuration set the Hull tab to No Hull. On the Scatter Plot tab select bubble plot and choose how the Z channel controls colour and size.
The same method works for a GPS track (latitude and longitude as X and Y).
A plot with four variables (X, Y, colour and size at the same time) is not possible.
To plot several Z columns automatically, loop over the columns in a UniScript.
To add points over a 3D x/y/z diagram, add a 2D X/Y dataset with symbols to the same diagram.
See also: Data=>3D-Dataset=>Scatter Plot, Dialog Box=>Bubble Options.
10.3.28. Why does the box-whisker plot not show values, and why is the minimum whisker wrong?¶
Data > More Data Functions… > Box-Whisker-Plot… only draws the plot. To show the numbers, add a text box with the median and interquartile range, for example Median 12.34 (IQR 8.12 - 15.23), or compute the statistic with Data > More Data Functions… > Compute statistic. A wrong minimum whisker is a known bug of the box-whisker plot in some versions; check with the latest release.
See also: Data=>Box Whisker, Data=>Compute statistic (2D).
10.3.29. Can I change the graph type of an existing diagram (for example from Y/T to X/Y)?¶
No. Select the graph in the diagram and press Delete (the empty diagram remains). Keep the diagram selected and add a new graph of the desired type (for example 2D X/Y with the new X channel), then autoscale the diagram.
10.3.30. How do I create a 3D map from a table with X values in the first row and Y values in the first column?¶
A matrix cannot be plotted directly. A 3D map needs three channels (X, Y and Z of equal length). Convert the table to column form (X, Y, Z in each row) before the import, for example in Excel or with a UniScript import filter, then plot it with the graph type 3D: x/y/z.
10.3.31. How do I extract the X, Y and Z data (matrix) of a 3D diagram?¶
Select the 3D graph and choose File > More File Functions… > Save 3D Data Matrix…, then enter a file name. The menu entry is only available when the data points of the graph can be selected; for a 3D bar graph the points cannot be selected, so use another 3D type (for example surface or map).
10.3.32. How do I show an efficiency map with the full-load curve and driving-cycle points, and count points above a threshold?¶
Display the efficiency map as a 3D dataset with colour filling or isolines, the full-load curve (torque over speed) as a line and the operating points as a scatter overlay (2D X/Y dataset with symbols in the same diagram). A distribution of the driving points over the map is not available directly but can be programmed in UniScript. Every sample is one point, so repeated cycles are counted as often as they occur in the data.
To show or count only points above a threshold (for example 95 % efficiency):
Choose Data > Data Exchange (Page).
Click the … button to add a record filter.
Set the filter so that only the points above the threshold remain.
See also: Data=>Data Exchange (Page).
10.3.33. Can UniPlot create hydro-turbine hill charts?¶
Yes. Plot flow on X, head on Y and efficiency (or another parameter) as 3D dataset with isolines. Data and axis assignment have to be set per channel.
10.3.34. How can I get average and standard deviation (or min/max) for each crank angle over many cycles?¶
The formula functions mean and stdev work on all values of a channel, not per angle across cycles. With existing tools:
Load the data as a 2D: x/y Cycle diagram and switch to the Waterfall view.
Add a cursor and place it at the maximum and minimum values.
Right-click a curve > Cursor > Cursor Data table and configure the table to show the requested values.
See also: Browser=>Mean Cycle.
10.3.35. How can I compare individual engine cycles with the mean cycle?¶
Create a mean cycle file, plot the single cycles on top of each other and add the mean cycle:
Open the file in the Data Browser and click Edit. Right-click the data grid and choose More Functions > Create Mean Cycle NC file….
Enter the independent channel (time or crank angle, monotonically increasing), the X coordinate of the cycle start and the cycle length. UniPlot saves the mean, minimum and maximum cycle in a new NC file.
Plot the original file with the dataset type 2D: x/y Cycle. In the dialog Single Cycle Import enter the cycle start, the cycle length and the cycle selection (for example
2,6,9-13or All). UniPlot creates one curve per cycle. Each cycle starts at the cycle start, so the cycles lie on top of each other.Drag the mean cycle channel from the mean cycle file into the same diagram.
To look at one cycle at a time, open the dataset list (Ctrl+D) and untick the cycles you do not want to see. Or plot again with another cycle selection.
See also: Browser=>Mean Cycle, Load Data into a Diagram, How do I plot cycles (hysteresis, charge/discharge, P-V cycles) as one coloured curve per cycle?, NC_CreateMeanCycleFile.
10.4. Diagram Layout, Text Objects and Legends¶
10.4.2. Why are colours or fonts ignored in a text box, and can I mix font sizes?¶
Formatting such as colour and font changes inside a text object is not applied when Word wrap is selected. This is a known limitation; insert line breaks manually instead. Within one text object only the formatting options of the text object dialog are available; different text sizes in one text object are not supported (use separate text objects).
See also: Bold, Italic, Underline, Strikeout, Color.
10.4.3. Why does a legend or text show a Greek sigma instead of “S” in channel names like Name\Signal?¶
In UniPlot text, the sequence backslash and S switches to the Greek (symbol) character set, so \S is rendered as sigma. If a channel name contains a backslash followed by S (typical for MDF4 names such as Counter_TestStep\Signal...), double the backslash in the text: Counter_TestStep\\Signal.
See also: Special characters.
10.4.4. Can I use LaTeX formulas in axis titles?¶
LaTeX cannot be inserted directly into an axis title. Hide the original axis title and place a text box with the LaTeX formula (Edit > Insert LaTeX Formula) at that position. A LaTeX installation is required.
See also: Edit=>Insert LaTeX Formula, Tools=>LaTeX Formula Configuration.
10.4.6. How do I remove the frame on a new page or the page margins?¶
The frame line is the page margin. Switch it off with File > Page Margin… and untick Show Page Margin. The page itself cannot be removed because it is the reference for reports. To use more of the window, set the page margins to the minimum and set the background of the empty page (right-click > Properties…) to Opaque with white colour.
See also: File=>Page Margin.
10.4.7. Can I rotate a diagram by 90 or 180 degrees?¶
There is no rotation function, but 90, -90 and 180 degrees can be imitated with axis settings (45 degrees is not possible):
90 degrees right: swap the axes; right-click the diagram > Properties… and set the X axis display to Top; right-click the Y axis > Parameters… and tick Scale descending.
90 degrees left: swap the axes; set the Y axis display to Right; right-click the X axis > Parameters… and tick Scale descending.
180 degrees: normal axes; set the X axis to Top and the Y axis to Right and tick Scale descending for both axes.
See also: Diagram=>X/Y/Z-Axis=>Parameters.
10.4.8. How do I switch a diagram from the 3D view back to the 2D view?¶
Press Ctrl+2 to switch from the 3D view back to the 2D view (Ctrl+3 switches to the 3D view). The menu entries are Diagram > Display as 2D Plot and Diagram > Display as 3D Plot; Diagram > Display as Waterfall (Ctrl+F) shows the waterfall view.
See also: Diagram=>Display as 2D Plot, Diagram=>Display as 3D Plot.
10.4.9. How do I change the font size of the Z axis label in a 3D diagram?¶
In a 3D diagram the dialog Diagram > z-axis > Label does not offer the font dialog that the X and Y axes have. Use Diagram > Layout… and change the size with the Font button there.
See also: Diagram=>Layout.
10.4.10. Can I define a default format for diagrams and legends, or change the format of many objects at once?¶
Default style of new diagrams: there is no dialog for it. Write a UniScript function that formats a diagram after it was created (frame, grid style and colour and so on) and run it after creating the diagrams.
Default legend format (size, font): the default legend settings cannot be changed. Format legends individually or with a UniScript that applies the same properties to all legends.
Default settings of 2D and 3D datasets: set them before plotting in Tools > Options… (button 3D Dataset); all new graphs use these settings.
Many pages or diagrams at once: use the Format Painter, see Where is the Copy Format function, and how do I copy the formatting of a curve or diagram to others?.
See also: Tools=>Options.
10.4.11. Where is the Copy Format function, and how do I copy the formatting of a curve or diagram to others?¶
Use the yellow brush icon in the toolbar (Edit > Copy Format). If the toolbar is not visible, right-click an empty area next to the menu bar and enable it.
Select the diagram or curve whose appearance you want to copy.
Click the brush and select the target diagram.
Choose in the style list which parts of the style are transferred.
With Edit styles… and Add a new style you create your own style and select exactly which properties (colour, width, symbols and so on) are transferred. To apply a style to the objects on several pages at once, select the pages. Properties that are not in the list cannot be transferred easily; for example, the marker type and fill colour of a dataset are not transferred. The Bind to command only synchronises scaling, not font sizes.
To change the layout of all diagrams on one page, select them with the Ctrl key before opening the layout window.
See also: Edit=>Copy Format, Edit=>Copy Format=>Style Editor.
10.4.12. I changed the colours of the style sequence in a template, but the curves still use the default colours. What now?¶
After editing the style sequence in the template, select Auto: Curve in the drop-down list of the toolbar. The curves then use the colours and line widths you defined.
See also: Tools=>Dataset Style Configuration, Tools=>Dataset Style Order Configuration.
10.4.13. Why are my 3D diagram styles missing after installing a new UniPlot version?¶
Style files that were saved inside the installation folder of the old version are removed together with the old installation; UniPlot does not copy user files between version folders. Styles saved in the user documents folder are not affected. Restore the style files from a backup of the old installation, and save your own styles in the user directory (Help > Open User Directory…).
See also: Help=>Open User Directory.
10.4.14. How do I change or customise the text shown in a legend?¶
Editing the text of the legend box directly does not change the plot, because the legend always shows the correct dataset name. To get editable legend text:
Double-click the curve and, in the dataset window, tick Legend and type the text you want; confirm with OK.
Right-click the curve or graph and add a legend of the dataset.
Double-click the legend box to customise it.
Select Display dataset legend text and untick the legend properties you do not want.
The legend text is fixed this way and is not updated when more channels are added to the diagram. Special characters of a channel name (for example the degree sign) are replaced by _ in UniPlot channel names; with the dataset legend text you can show any character. You can allow more characters in channel names with Tools > More Options > Data Import and Data Browser > Allow Special chars in channel names.
See also: Table=>Dataset Legend Configuration, Data Import and Data Browser.
10.4.15. How do I show a legend for all curves, or one legend per diagram?¶
Right-click the curve > Add Legend > Add Legend for 2D-datasets (Table) to create a legend with all curves of the diagram. For data files, Add Legend > Add Legend for Data Files (Table) only offers the scope current page or document; a scope per diagram does not exist. If diagrams on one page use different files, create the legend per diagram with the data record legend function (scopes Page, Diagram and Stacked Diagram), or build a text or table object per diagram.
See also: Table=>File Legend Configuration.
10.4.16. How do I remove the extra empty row in a legend table, change the symbol length, or show start and end values?¶
Extra empty row: double-click the legend table to open Dataset Legend Configuration and uncheck the option Extra Header Row. Click OK.
Length of the line symbol in the legend (default 1.2 cm): enter in the UniPlot command window, for example
WriteProfileString('Settings', 'legend-symbol-length', '2.5'). The first two parameters are fixed, the third is the length in cm. The setting is permanent. See WriteProfileString.Start and end value of a curve: the legend dialog offers the values Y-Start and Y-End.
See also: Table=>Dataset Legend Configuration.
10.4.17. Why does the attribute list of the data file legend only show attributes of the first file?¶
This applied to R2020.5 and earlier, when two or more diagrams from different data files were on one page. It is fixed in R2020.6: all attributes of all data files on the page are offered in the file legend configuration. Update UniPlot.
10.4.18. How do I use the number format of the channel, or the exponential format, in a data table?¶
A new data table generates a default number format (for example
0000.00) for every column, which overrides the number format of the channel. Remove the number-format entry of the column in the data table configuration; then the dataset format of that channel is used.The e-format could be selected in data tables and cursor data tables (right-click > Configuration > Format…) but the cells stayed decimal in versions before R2021.4. This is fixed in R2021.4; update via Help > Check for Updates and set the cell format to the number or E-format.
See also: Data=>Create a data table.
10.4.19. How do I select all datasets or invert the selection in the dataset list?¶
There is no invert-selection button. To invert a selection, select one line, press Ctrl+A to select all lines, press the space bar (or the show/hide button) to hide all datasets, and then select the ones you want to see.
See also: Data=>Dataset List.
10.5. 3D Maps, Isolines and Colour Maps¶
10.5.1. How do I colour an X/Y/Z map with a colour map, change the isolines and add a colour legend?¶
Colour map: double-click the 3D plot (or click Configure 3D Dataset in the toolbar), open the Color Map tab and choose a colour map. Make sure that Color Filling between isolines is active.
Isoline values: in the 3D dataset configuration enter minimum, delta and maximum of the isolines. For a colour scale with three colours such as blue, white and red, the colours are defined by the limits (isoline values) between the colours; for a white zero set limits so that the white band is symmetric around 0 (for example -0.5 to 0.5).
Colour legend: right-click the plot > 3D Color Legend.
Symbols or lines on the map: add a 2D X/Y dataset to the same diagram and give it symbols or a line.
To show the Z channel name and unit in the legend, right-click the graph > Add Field Function… (or Diagram > Insert Field Function…), select Create legend for 3D dataset, pick
zname.unitand confirm. The field function @f{3dlegend} cannot be typed manually into a text box.
See also: Data=>3D-Dataset=>Isolines, Data=>3D Color Legend, Data=>3D Dataset Properties.
10.5.2. How do I set a default colour map or default settings for new 3D diagrams?¶
Choose Tools > Options….
Click the 3D Dataset button.
Click the Colormap button and select the colour map you want as default.
Make sure that Color Filling between isolines is selected.
Confirm all dialogs with OK.
All new graphs use these settings. The same dialog sets the other defaults for 2D and 3D dataset diagrams.
See also: Tools=>Options.
10.5.3. How do I add my own colour map or company colour scale?¶
From R2026.5: choose Tools > Colors > User Color Maps… to create, edit, delete, import and export your own colour maps for 3D datasets. User colour maps are saved in the UniPlot user directory and are kept when UniPlot is updated. An exported colour map file (
.rgb) can be imported by other users, which is a way to distribute a company colour scale. For scripts, see the functions ColorScale_AddUser, ColorScale_DeleteUser and ColorScale_GetUserNames.Earlier versions: create a custom 3D style with Tools > Dataset Style Configuration…, edit each colour, save and assign it to the dataset.
Individual line colours can be defined under Tools > Colors > User Colors… (R2026.5 and later; Tools > User Colors in earlier versions).
See also: Tools=>Colors=>User Color Maps, Tools=>Colors=>User Colors.
10.5.4. How do I set the isoline range or colour map for many 3D plots at once?¶
Open the template, press Ctrl+D and enable the Document radio button at the top. Select the diagrams, click Configuration on the right, enter the isoline value range and click OK and Close. The colour map can be selected in the common-properties dialog from R2023.3; in earlier versions it can not. To transfer all 3D dataset settings from one dataset to others use Data > Copy 3D dataset configuration. Older versions had a problem that the isoline range always started at 0 (also negative ranges); update to the latest version.
See also: Data=>Copy 3D dataset configuration, Data=>Dataset List.
10.5.5. Changing the colour of the 3D colour map raises an error in R2026. How do I fix it?¶
Customising the colour map is done in the 3D dataset configuration: select the first colour on the left, change its fill colour (RGB), do the same for the last colour, then click Update and OK. An error that occurred in some early R2026 releases is fixed in a later release; update to the current release (Help > Check for Updates). From R2026.5 you can also define colour maps with Tools > Colors > User Color Maps….
See also: Help=>Check for Updates.
10.5.6. After a data exchange some areas or lines of the 3D map have no colour or isolines. Why?¶
The interpolation settings limit the interpolation range. Fix it for:
One diagram: right-click an isoline of the 3D dataset, choose Interpolation, untick Interpolation on gridlines and set the range to automatically.
All new diagrams: Tools > Options > Interpolation with the same settings.
All diagrams of an existing template: open the dataset list (Ctrl+D), choose the Document option, select all 3D datasets, click Configuration and set the interpolation properties (range automatic).
See also: Browser=>Interpolation, Data=>Interpolation.
10.5.7. My 3D map shows local minima or maxima that do not exist in the data. How can I avoid this?¶
A 3D dataset is optionally filtered at creation (Tools > More Options > 2D and 3D Datasets > Enable Data Filter for 3D datasets) and then interpolated onto the interpolation matrix. The default interpolation (range, type) is set in Tools > Options > Interpolation; per diagram, right-click an isoline and choose Interpolation. Artifacts such as non-existing local minima are typically caused by the Thin Plate interpolation type. Switch to Linear interpolation.
For more detail in colour maps and spectrograms: disable Enable Data Filter for 3D datasets, plot again, increase the number of isolines in the 3D dataset configuration (type standard, steps or linear), and adapt the interpolation range via right-click on the dataset. Maximum values may be lost by interpolation.
See also: What is the difference between the interpolation methods in UniPlot ?.
10.5.8. How do I fit, remove or define the hull (envelope) of a 3D map?¶
The shape of a 3D map is controlled by the hull.
Plot all points without a hull: double-click the plot > 3D dataset configuration > tab Hull > hull type No hull > OK. In the Data Browser also disable the button Sort x-coordinates and plot the graph again.
Hull far above the real maximum: a hull created with a 3D dataset is convex by default. Right-click the dataset > Find Data Hull…, adapt the parameters and press OK.
Limit the map to a user-defined boundary (hide map data above an envelope curve): create a table with three columns, X value, Y value and a command, where
mmeans move (no line) andlmeans line:800 0 m 800 400 l 1200 600 l 2300 400 l 2300 0 m
Load it with File > More File Functions… > Load 3D Data Hull…, select the diagram, click Configure 3D Dataset in the toolbar, open the Hull tab and choose user-defined. The map is limited to the area inside the hull.
Calculations on the map (Map Calculator): data outside a user-defined hull are set to zero or invalid values in later calculations, so the Map Calculator returns zeros. Remove the user-defined hull or use one that covers the data. For extrapolation at low speed or torque, choose another hull type (for example North Line) in the 3D dataset configuration on the Hull tab and repeat the extrapolation.
See also: Data=>3D-Dataset=>Hull, Data=>Find data hull (3D), Map Calculator.
10.5.9. How do I improve isoline labels, and can I keep user-defined labels after a data exchange?¶
The size of the label box cannot be set separately; it grows with the font size and may overlap other isolines. For better readability open the 3D dataset configuration (Data > 3D-Dataset…), tab Isoline. In the group Label Attributes:
select Fit to Gradient,
enable Transparency,
enable In Line Color to draw each label in the colour of its isoline,
increase the font size with Font….
Under Label choose the placement Random or Middle.
A data exchange resets user-defined isoline labelling (positions and style) to the default method; this cannot be prevented at the moment. Disabling automatic in the isoline settings only fixes the number format.
To show Z values only at specific points, right-click the point and use the shortcut menu to add or remove labels per plot; there is no option for all plots at once. To read the Z value at a given X/Y point of a contour plot, insert an isoline, select Edit X-Y position, enter the coordinates, click OK and add a label on that isoline.
See also: Data=>3D-Dataset=>Isolines.
10.5.10. How do I highlight a single isoline or set the isoline values manually?¶
Copy the dataset into the diagram again, show only the one isoline (for example z = 1.56) and give it the colour and width you want. In the 3D dataset configuration you can enter isoline values with the form min,delta,max (for example 200,5,240) and click Insert. Duplicate values in the isoline list were fixed in R2022.2.
See also: Data=>3D-Dataset=>Isolines.
10.5.11. How do I change the Z limits of a 3D map and of its colour legend?¶
Click into the diagram and click the Z button in the toolbar or choose Diagram > z-Axis > Parameters… to open the Z axis parameters. For a colour map the colour range is defined by the isoline values and the colour map in the 3D dataset configuration, so set the same isoline range (minimum, delta, maximum) for plots that you want to compare, for several diagrams at once as described in How do I set the isoline range or colour map for many 3D plots at once?.
See also: Data=>3D Color Legend.
10.5.12. The colour legend of a 3D diagram ignores my settings in R2025.3. Why?¶
Fixed in R2026.0
In R2025.3 the 3D colour legend was not updated correctly after you changed its settings. This is fixed in R2026.0. Update to R2026.0 or later (Help > Check for Updates).
To change the legend, right-click the colour legend and choose 3D Legend Properties….
See also: Data=>3D Color Legend, Help=>Check for Updates.
10.5.13. Why does a 3D bubble plot or 3D diagram look different after reopening the file?¶
If a diagram or map appears with reduced content after saving and reopening, run Data > Data Exchange (Page) and click OK without changes to refresh the display. If the problem persists with a particular file, update to the latest release.
See also: Data=>Data Exchange (Page).
10.5.14. How do I create a difference dataset or difference map, and why does it fail or give no result?¶
3D maps: select both map datasets, then choose Data > More Data Functions… and pick Difference map and other functions (3D) (the dialog configures the difference map in detail), or choose File > More File Functions… > Difference Map… to create the difference of maps from two documents. A difference of compressor maps works the same way.
2D curves: select the curves and use right-click > Multiple Datasets > Interpolate Curves…. Choose the function Difference (Y1 - (sum(Y2 + Y3 + …))) for the absolute difference or Relative Deviation (y2 - y1) / y1 * 100 for a percentage difference.
The difference computation interpolates one dataset onto the other, therefore:
For 2D curves the X data (for example engine speed) must be monotonic; if the X values are not strictly rising, the difference cannot be calculated. Check the source data for non-monotonic sections.
For 3D maps both maps need enough measurement points; with too few points the creation is aborted. The two datasets may have different numbers of points.
For 3D maps the X/Y coordinates of one dataset are the reference and the Z of the other dataset is interpolated and subtracted. If the X/Y points of both maps differ slightly, the result at a point is Z of the first map minus the interpolated Z of the second map, so the values do not match the raw table points exactly. This is expected.
If the two maps cover different operating ranges, or a user-defined hull cuts the area, the result may contain a white gap or implausible values such as
1e37(UniPlot’s “no value”) for operating points that exist in only one map. Make sure both maps cover the same operating range and check the hull of the diagram.
See also: Data=>Difference map and other functions (3D), auto_xyz_Sub.
10.5.15. Creating a difference map fails with “At least one of the files does not contain 3D data” or errors in do_sty_iso.ic. What can I do?¶
Several causes were fixed in later releases:
At least one of the files does not contain 3D dataoccurred when the source maps were created in a certain way (a 2D and a 3D diagram of the same data). It is fixed in later releases; update to the current version.A script error “can’t concatenate operands” when computing a 3D difference map is fixed in R2022.1. Other errors in
do_sty_iso.icor a 3D difference map that is not recalculated after Data Exchange are fixed in later releases; update to the current release.A problem that broke the 2D interpolation and some 2D dataset functions is fixed in R2020.5.
10.6. Display, Rendering and Fixed Issues¶
10.6.1. The diagram shows display errors (broken labels, black areas, lost transparency in PDF, disappearing cursor). How do I fix it?¶
Display problems depend on the graphics engine used for the screen and the printer. Open Tools > More Options…, section Installation, and change Graphics Rendering Screen and/or Graphics Rendering Printer:
Screen: 1: GDI, 2: GDI+ or 3: Direct2D (Default). Switch from Direct2D to GDI+ (or GDI) for cursors that disappear at random, broken or wrongly rotated axis labels, or a black area in the window (typical with an external screen; switching to another page and back repairs it temporarily).
Printer / PDF: 1: GDI (Default) or 2: GDI+. GDI does not support transparency or anti-aliasing. If transparency (for example of markers or filled areas) is lost in page preview, print or PDF, set the printer output to GDI+. Text backgrounds of tables that are always white and missing table comments in PDF were also fixed this way.
GDI+ can look less sharp than Direct2D. Marker transparency that was reset after a data exchange of a 2D diagram is fixed in a later release.
See also: Installation, Tools=>More Options.
10.6.2. Why does the circle symbol look distorted in the symbol list of the curve style dialog?¶
The symbol preview in the list is drawn without anti-aliasing, so a circle may look slightly distorted. In the diagram the symbols are drawn as perfect circles, also when zoomed, printed or exported. It does not affect functionality.
10.6.3. Why do vertical lines appear when I fill the area under a curve or between a curve and a threshold?¶
This is a known rendering effect of the fill colour, mainly with channels that contain very many data points. Set the transparency of the fill colour to the minimum so that the lines are no longer visible. Reducing the number of data points (resampling) also helps.
See also: Data=>Fill Area (2D).
10.6.4. Why does the min/max of a threshold range jump to wrong values?¶
Changing the minimum or maximum of an existing threshold range and confirming with OK can set wrong values (for example 0.5 becomes 0). Click Autoscale after changing the threshold range, or delete the range and insert a new one.
See also: Data=>Threshold (Range).
10.6.5. The extract_points filter has no effect on a curve shown with markers only. How do I make it work?¶
If markers were already enabled before the filter is added, the part cut off by extract_points may still be displayed. Create the 2D x/y diagram with a line style, add the filter in the 2D curve configuration and close all dialogs. Then reopen the configuration and switch from line to markers.
10.6.6. Isolines are doubled, or isoline values are duplicated, in my 3D map. How do I solve this?¶
Doubled isolines (also after autoscale) and duplicate values in the isoline value scaling that distort the colour scale are fixed in later releases (duplicate values in the isolines dialog in R2022.2). Update via Help > Check for Updates or download the latest installer. If Check for Updates reports Couldn't resolve host name, the proxy or DNS settings of the computer block the update check; download the installer manually instead.
See also: Help=>Check for Updates.
id-1235727