6. Startup Problems, Crashes and Error Messages¶
This chapter helps you to recover when UniPlot does not start, crashes, freezes, shows a start-up error (for example E06D7363 or C0000005) or displays diagrams incorrectly.
6.1. Startup problems and start-up error messages¶
6.1.1. UniPlot does not start or crashes at startup - what can I do?¶
Almost all start-up problems (an error message at every start, an empty file list, missing toolbar buttons or sidebar tabs, a hang on the splash screen, a crash before the main window appears) are caused by the user environment and not by the program files: a faulty script in an Autoload folder, left-over cache files in the LocalStore or AutoSave folder, an invalid user home directory or a network drive that is not reachable. Reinstalling UniPlot alone usually does not help, because the files in the user directory are kept.
Work through the following steps in this order and test after each step. Close UniPlot completely before you change files.
Start UniPlot without autoload files.
Open the
Programfolder of your UniPlot installation in the Windows Explorer (for exampleC:\Program Files\UniPlot Software\<release>\Program) and copy the full path ofuniplot.exe.Open a command prompt (
cmd).Paste the path in double quotes and add the parameter
/NoAutoLoadafter it (see AppGetCommandLine):"C:\Program Files\UniPlot Software\<release>\Program\uniplot.exe" /NoAutoLoad
Press Enter. UniPlot starts without loading the script files of the autoload folders.
If the same error message appears again, the autoload scripts are not the cause: continue with step 3 and note the exact error text for the support. If UniPlot starts without an error, one of the autoload script files is the cause: continue with step 2.
Find the faulty autoload script.
Open Help > Check drive speed… (Help=>Check Drive Speed). All drives (user directory, local user directory, temporary directory and the other drives) should show the result OK. A slow drive or a drive without write access can be the reason for a slow or failing start.
Right-click anywhere in the log area (the Event window) of UniPlot to open the Event Window Configuration (View=>Event Window Configuration), select all options and click OK. All messages are then shown and saved in the file
Settings\uniplot.logof the user directory.Copy all script files from the autoload folders to a temporary folder: the
autoloadfolder of the installation (for exampleC:\Program Files\UniPlot Software\<release>\autoload) and theAutoloadfolder of the user home directory (for exampleDocuments\UniPlot\Autoload). Then remove the files from the autoload folders. Scripts can also be loaded from the directories listed under Search Path for Automation Script Files (Tools > More Options > Paths and Files); check these folders as well.Copy one file at a time back from the temporary folder to the autoload folder and start UniPlot after each file. The file after which the error returns is the cause; contact its author or correct it.
If the problem persists, send the log files of UniPlot to the support (see UniPlot crashes or reports a memory access violation - which information do I need to collect for the analysis?).
Empty the LocalStore and AutoSave folders. UniPlot keeps temporary copies of open documents and its own cache files in the sub-folders
LocalStoreandAutoSave(see Copy On Open). Normally they are cleaned up when UniPlot closes, but after a crash they can contain a defective file that is loaded again at every start.AutoSaveis located in the user home directory (GetUserDirectory() + "AutoSave", by defaultDocuments\UniPlot\AutoSave).LocalStoreis located in the local user directory (GetUserDirectory(1)): this is the user home directory if it is on a local drive, otherwise the local application data folder:C:\Users\<user>\AppData\Local\UniPlot\LocalStore
AppDatais a hidden folder: type the path into the address bar of the Windows Explorer. To find the exact locations, runGetUserDirectory()andGetUserDirectory(1)in the UniPlot command window (GetUserDirectory). Move the content of both folders to a temporary directory (or delete it). Your configuration, add-ins and formulas are not stored there. If UniPlot works again, you can delete the moved files. Copy documents that you still need fromAutoSavefirst, because they may be the only copy of unsaved work (see A UniPlot file can no longer be opened, or UniPlot crashed with unsaved work - can it be recovered?).Check the user home directory. Open Tools > More Options > Paths and Files and check the entry User Home Directory: the folder must exist, must be writable and should be on a local drive (not on a network share that may be unavailable, and not on a folder with restricted rights). Keep the full path short. The value is stored in the registry in
HKEY_CURRENT_USER\Software\RSB\UniPlot5\settingsasUser-Home-Directory; if UniPlot cannot start at all, correct or delete this entry (and other entries that point to drives that no longer exist) with the Windows registry editor (see GetUserDirectory).Test with a new user directory. Close UniPlot, rename the
UniPlotfolder in your Documents folder (for example toUniPlot_old) and start UniPlot: it creates a new user directory. If this solves the problem, copy your own scripts, templates and add-ins back one by one. Alternatively start UniPlot with a new user name (uniplot.exe /NoAutoLoad /User TestUser): UniPlot then uses a separate registry key and a sub-folder with the user name in the user directory (see AppGetCommandLine).Use
us_start_clean(). If you can still start a UniPlot instance (for example an older installation or a start with/NoAutoLoad), runus_start_clean()in the command window (View=>Command Window). The function starts a new UniPlot instance without loading the autoload files and without the settings from the registry (the settings are written to a new ini file, see the parameter/IniFileNamein AppGetCommandLine). After a normal restart UniPlot worked again in the reported cases ofsystem-error 8007007e(see system-error (m_sc) 8007007e: IPZ/IPW files cannot be opened or saved after a new installation - how do I repair it?).Check the default printer. UniPlot asks Windows for the default printer. A default printer that is not reachable (for example a network printer of another site) can stop the start (see UniPlot does not start: “Please wait for printer connection” or a printer-related error - how do I fix it?).
Check the graphics rendering. If the main window or the diagram area stays black or the display is broken right after the start, change Tools > More Options > Installation > Graphics Rendering Screen (see The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?).
Network drives and security software. The user directory and the temporary directory should be on a fast local drive (see step 2). Virus scanners, endpoint-security or VPN clients can slow down or block the start; ask your IT department to exclude the UniPlot folders from heavy scanning. Update UniPlot to the latest release (Help > Check for updates…, Help=>Check for Updates).
If UniPlot still does not start, collect the log files from the folder log in the user home directory (by default Documents\UniPlot\log) and the file Settings\uniplot.log, the exact error text and the UniPlot release, and see UniPlot crashes or reports a memory access violation - which information do I need to collect for the analysis?.
See also: Error E06D7363 at start-up (or on every import) - how do I fix it?, Error C0000005 or Internal Error -1073741819 - what does it mean?, An error appears at start-up and the file list, user toolbar, data browser or sidebar tabs are empty or missing - how do I fix it?, An error message names a script such as obj_doc.ic, rs_mdf4.ic or do_recover.ic, or toolbar buttons are missing - how do I find the cause?.
6.1.2. Error E06D7363 at start-up (or on every import) - how do I fix it?¶
E06D7363 is the Windows code of a C++ exception that was raised inside UniPlot and was not handled. It is a generic code: the same code can have several causes, almost always in the user environment. Typical accompanying symptoms are an empty file list, a missing user button bar, a black window, autoload scripts or color maps that are not loaded, a Data Browser that hangs, or the error appearing on every data import.
The cause is found with the procedure described in UniPlot does not start or crashes at startup - what can I do?. The most frequent solutions, in this order:
Close UniPlot and empty the
LocalStorefolder (andAutoSave), see UniPlot does not start or crashes at startup - what can I do? (step 3). If noLocalStorefolder exists at all, check the user home directory.Start with
/NoAutoLoadand find the faulty autoload script (steps 1 and 2).Check in Tools > More Options > Paths and Files that the User Home Directory, the NEW Command Template File Location and the Search Path for Automation Script Files point to existing, reachable and writable folders. Entries on a network drive that is slow or not connected can stop UniPlot at start or in the Data Exchange; replace them by local paths.
Rename the user directory (
Documents\UniPlot) to test with a clean profile.Check that no file is locked by another program or by a second UniPlot instance, and that the full path of the user directory is short.
In some environments the error occurred only when the PC was connected to the company network (UniPlot checks for updates through the Internet) or when a VPN/security client was active. Allow the access in the firewall, set Check for Updates in Tools > More Options > Installation to Do not check, or disconnect the client for a test.
Update to the latest release (Help > Check for updates…).
See also: UniPlot does not start or crashes at startup - what can I do?, Help=>Check for Updates.
6.1.3. Error C0000005 or Internal Error -1073741819 - what does it mean?¶
C0000005 (decimal -1073741819, “memory access violation” or “access violation”) is a Windows error code that means that a program accessed memory that it must not access. It can appear at start-up (sometimes as Internal Error -1073741819), while loading a data file or in a script (for example memory access violation in netcdf.ic). Because it is a generic code, check the following in this order:
UniPlot release. A crash at start-up with
Internal Error (-1073741819)that is related to an unavailable network printer was fixed in R2023.4. If you use an older release, update (Help > Check for updates…, click Download and quit UniPlot; for a local installation the setup starts when UniPlot is closed).Start-up errors: follow UniPlot does not start or crashes at startup - what can I do? (
/NoAutoLoad, emptyLocalStoreandAutoSave, check the user home directory). If the messagePlease wait for printer connectionappears together with the error, see UniPlot does not start: “Please wait for printer connection” or a printer-related error - how do I fix it?.Another Windows user. Log on with a different Windows user on the same PC. If UniPlot works there, the profile of the first user is the cause.
Error while opening a data file (for example a DAT file of INCA/VISU): toggle Tools > More Options > Data Import and Data Browser > Delayed Channel Import, and check the Windows language and region settings (in some reported cases the error disappeared after the regional settings were changed). If the error occurs only for some data files, the file itself may be invalid.
Create a dump file for the analysis, see UniPlot crashes or reports a memory access violation - which information do I need to collect for the analysis?.
See also: Error E06D7363 at start-up (or on every import) - how do I fix it?, Data Import and Data Browser.
6.1.5. system-error (m_sc) 8007007e: IPZ/IPW files cannot be opened or saved after a new installation - how do I repair it?¶
The message system-error (m_sc) 8007007e is the Windows error “The specified module could not be found”. It was observed after a second (for example pre-release) installation was started on the same user account: UniPlot could then no longer open IPZ/IPW files and could not save new files.
Start the instance that still runs and execute the following command in the command window (View=>Command Window):
us_start_clean()
The command starts a clean UniPlot instance (without autoload files and without the registry settings). Then restart UniPlot normally; this solved the problem. Changing the user directory to avoid the Windows “controlled folder access” did not help.
If the error persists, follow UniPlot does not start or crashes at startup - what can I do?. Make sure that the installation you start is complete and that security software does not block the UniPlot program files.
See also: UniPlot does not start or crashes at startup - what can I do?.
6.1.8. UniPlot opens many old templates or IPZ files at start, or hangs at “loading DLL libraries” while restoring previous files - how can I stop that?¶
When UniPlot was not closed normally, it restores the documents of the previous session from the files in the AutoSave and LocalStore folders of the user home directory when it starts (see Copy On Open). Hundreds of old files in these folders cause UniPlot to open hundreds of documents, to hang, and to lock files on network drives for colleagues.
Close UniPlot.
Find the home directory: Tools > More Options > Paths and Files > User Home Directory (or Help > Open User Directory…, Help=>Open User Directory).
Make a backup copy, then empty the sub-folders
AutoSaveandLocalStore(see UniPlot does not start or crashes at startup - what can I do?, step 3, for their locations). Remove files of third-party tools from theAutoloadfolder only if you know that they are not needed.Restart UniPlot.
Keep path names short.
See also: UniPlot does not start or crashes at startup - what can I do?.
6.1.9. UniPlot starts very slowly or stays on “load dll libraries” - what can I do?¶
A long wait on the start screen usually means slow file access: the program directory or the user home directory is on a slow network share, a VPN or a remote site, or UniPlot reopens the last files at start from a drive that is slow or unavailable.
Run Help > Check drive speed… (Help=>Check Drive Speed). The user directory and the temporary directory should be on a fast local drive.
Move the user home directory to a fast local drive (Tools > More Options > Paths and Files > User Home Directory) or install UniPlot on a fast local disk.
In Tools > More Options > Data Import and Data Browser, switch off Open the last recently used data file at start up, and in Tools > More Options > UniPlot Document Options switch off Copy On Open.
Empty
LocalStoreandAutoSave(UniPlot opens many old templates or IPZ files at start, or hangs at “loading DLL libraries” while restoring previous files - how can I stop that?).Ask your IT department to exclude the UniPlot folders from heavy virus scanning. Check the memory and CPU use in the Windows Task Manager.
If the user home directory or registry entries refer to network drives that no longer exist (for example after a server move), UniPlot hangs right after the start. Edit or delete the entries that contain inaccessible drive paths, especially
User-Home-Directory, inHKEY_CURRENT_USER\Software\RSB\UniPlot5\settings.Test with
/NoAutoLoadto exclude autoload scripts.
See also: UniPlot does not start or crashes at startup - what can I do?, Copy On Open.
6.1.10. Too many arguments (E000000A) in an add-in script, or UniPlot looks for libraries on a drive that no longer exists - how do I reset the paths?¶
Delete the search paths that point to old add-in versions or to a drive that no longer exists. UniPlot stores directory settings, including the search paths for libraries and add-ins, in the user configuration.
Open Tools > More Options > Paths and Files.
Delete entries that point to a drive that does not exist any more (for example a former network drive) or to an old add-in version.
If the error remains, the entry is stored in the registry below
HKEY_CURRENT_USER\Software\RSB\UniPlot5\. Remove it there (see UniPlot’s Use of the Windows Registry).
See also: UniPlot does not start or crashes at startup - what can I do?, An error message names a script such as obj_doc.ic, rs_mdf4.ic or do_recover.ic, or toolbar buttons are missing - how do I find the cause?.
6.1.11. UniPlot shows an Office or “MUI” error message on some computers - is this a UniPlot problem?¶
Usually not. UniPlot may call a Word, PowerPoint or Excel template or a COM object that is located on an inaccessible resource, or the Microsoft Office installation on the computer is damaged. Start UniPlot without autoload files (/NoAutoLoad), check the User Home Directory in Tools > More Options > Paths and Files, and repair or reinstall Microsoft Office if the error is reported by Office. See UniPlot does not start or crashes at startup - what can I do?.
6.1.12. DDE Exception: The client failed to execute open-job (Code 0x4009) and Cannot open NC data file when opening NC2 or UJF files - what can I check?¶
UniPlot uses an internal DDE (inter-process) communication when it opens data files. If a security mechanism of your IT department (endpoint protection, application control) blocks this communication, opening files can fail with this message.
Ask your IT department whether endpoint-security software blocks the UniPlot processes and add an exception for the UniPlot program folder.
Test with a clean user profile (UniPlot does not start or crashes at startup - what can I do?, step 5) and check the paths in Tools > More Options > Paths and Files.
Changing registry entries or reinstalling alone does not help. As a temporary workaround, use the previous release.
6.1.13. A UniPlot file can no longer be opened, or UniPlot crashed with unsaved work - can it be recovered?¶
A damaged document file generally cannot be repaired. UniPlot saves IPZ documents from time to time into the AutoSave folder of the user home directory, for example:
C:\Users\<user>\Documents\UniPlot\AutoSave\
(GetUserDirectory() + "AutoSave"). Look in this folder for automatic saves of the document, copy them to a safe place and open the copy. Do this before you empty AutoSave or LocalStore as described in UniPlot does not start or crashes at startup - what can I do?. If UniPlot was terminated with the Task Manager or by a power failure, the files in AutoSave and LocalStore are processed at the next start.
See also: Copy On Open, GetUserDirectory.
6.2. Crashes and freezes¶
6.2.1. UniPlot crashes or reports a memory access violation - which information do I need to collect for the analysis?¶
Memory access violations and sudden closes without a message are hard to analyse. First try the steps in UniPlot does not start or crashes at startup - what can I do? and update to the latest release (older releases are affected more often). Log on with another Windows user on the same PC to rule out a profile problem. If the problem remains, collect:
The exact error text, the UniPlot release and the Windows version, and when exactly the error appears (steps to reproduce).
The UniPlot and UniScript log files from the
logfolder of the user home directory (by defaultDocuments\UniPlot\log) for the time of the error.Whether personal autoload scripts run at start (try
/NoAutoLoad).A dump file: start UniPlot, open the Windows Task Manager, right-click the UniPlot process and choose Create dump file (German Windows: Abbilddatei erstellen). The file
uniplot.DMP(about 180 MB) is created in the temporary folder of the user.If a particular data file or document triggers the crash, a reduced sample file with the steps that lead to the error.
6.2.2. UniPlot freezes or shows “not responding” - what can I check?¶
UniPlot works directly on the open files; a slow or unstable network drive is therefore the most frequent cause of freezes, crashes and very long waiting times (for example after clicking OK in the Data Exchange).
Run Help > Check drive speed… (Help=>Check Drive Speed) and check the drives that contain your data, documents and the user directory. Work with local copies of IPZ and data files, and set a simple local folder as default folder. Test without the company network (for example at home) to confirm the network as cause.
In Tools > More Options > UniPlot Document Options toggle Copy On Open and Use a background process to save the document (Copy On Open).
If the freeze affects only the Data Exchange or a single file: copy the file to another folder and rename it, avoid special characters in file and path names, toggle Tools > More Options > Data Import and Data Browser > Delayed Channel Import and, for INCA DAT files, toggle Unicode Data Files in the same section.
Empty the
LocalStorefolder and thelogfolder of the user home directory (An error appears at start-up and the file list, user toolbar, data browser or sidebar tabs are empty or missing - how do I fix it?).If only one Windows user is affected, the user profile is the cause: test with another Windows user and with a new user directory (UniPlot does not start or crashes at startup - what can I do?, step 5).
When a window does not open, see UniPlot seems to freeze when I open a dialog (for example Data > Dataset List) and CPU usage is 0% - what is the cause?. When opening NC/NC2 files freezes UniPlot, see UniPlot freezes or crashes while opening NC or NC2 files (“UniPlot is busy right now”) - what can I do?.
If UniPlot cannot be closed from the Task Manager, end the task in the Processes tab instead of the Details tab.
Try the three graphics settings in Tools > More Options > Installation > Graphics Rendering Screen (GDI, GDI+, Direct2D) and use the one with the best stability (The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?).
See also: Help=>Check Drive Speed.
6.2.3. UniPlot seems to freeze when I open a dialog (for example Data > Dataset List) and CPU usage is 0% - what is the cause?¶
The dialog is probably not frozen but opened invisibly: its window was placed on a second monitor that is no longer connected.
Connect the monitor again and move the window to the main screen. Or close the dialog with the keyboard: press Tab several times, then Enter or Esc.
Choose a safe graphics mode: set Tools > More Options > Installation > Graphics Rendering Screen to GDI or GDI+ (The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?).
If an expanded Data Browser hangs, also check that its pop-up window is not on a disconnected monitor.
6.2.4. UniPlot freezes or crashes while opening NC or NC2 files (“UniPlot is busy right now”) - what can I do?¶
A known cause is a channel whose data type raises an exception while the Data Browser draws its preview. UniPlot then stays in the drawing phase. Workarounds:
Do not use the preview of the Data Browser.
Import the channels as double instead of float: set Data Type for 1D-, 2D-Datasets in Tools > Options to double before you import the file (the default is float, see Imported values differ slightly (for example 8.3 becomes 8.3000001, or a number is off by 1). Why?). There is no menu named “Tools > Datatype”.
Check the network and disk speed if the files are on OneDrive or a network drive (Help=>Check Drive Speed).
Crash when you remove records from an NC file (or call _NC_Pack): the NC file had a very large number of global attributes. Remove the extra global attributes. _NC_Pack is an internal function. NC2 files are more flexible than NC files and recommended.
6.2.5. UniPlot closes without a message when I open or export a page with 3D difference maps - how can I avoid it?¶
For particular data combinations, pages with 3D difference maps can crash UniPlot. Disable the option Remove flat triangles for 3D datasets in Tools > More Options > 2D and 3D Datasets (Tools=>More Options) and restart UniPlot. If UniPlot closes without a message in other situations (for example when replacing the data file of a document with very large DAT files, or when creating a difference dataset of two 3D datasets), update to the latest release and send the affected files and the steps to reproduce (see UniPlot crashes or reports a memory access violation - which information do I need to collect for the analysis?).
6.2.6. UniPlot crashes when I delete the ROWCOUNTER cell in the data table configuration - how can I avoid it?¶
In an older release, clearing the number format cell of the ROWCOUNTER column in the data table configuration caused a reproducible crash. Do not clear this cell; enter a valid number format instead, and update to the latest release.
6.2.7. UniPlot crashes when a UniScript uses recursive functions and the log shows “Max Stack Used” - what does it mean?¶
The stack is limited by the operating system. A stack overflow is usually caused by a recursive function without a proper termination condition. In one case a recursive function created an object and called itself inside a try statement; when the recursive call failed, the object was lost and the memory problem occurred. Make sure that the recursion terminates and do not place the recursive call inside the try block.
6.2.8. Which crashes and start-up errors are fixed in later UniPlot releases?¶
If you use one of the following releases, update first (Help > Check for updates…, Help=>Check for Updates):
Release |
Problem |
Fixed in |
|---|---|---|
R2023.3 and earlier |
Crash at start-up with |
R2023.4 |
R2022.4 and earlier |
Crash when a 2D/3D Excel Table is created |
R2022.5 |
R2024.1 and earlier |
The start of UniPlot could fail because of the initialization of the Sequencer |
R2024.2 |
If you received a patch script for one of these problems, delete it from the Autoload folder after the update so that the fix of the new release is used.
6.3. Display problems¶
6.3.1. The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?¶
This is a graphics rendering problem, not a data problem. It occurs mainly with several monitors (different resolutions, scaling or connection types such as HDMI, VGA, DisplayPort), laptops with docking stations, high DPI settings, Remote Desktop and VPN sessions, terminal servers and test-bench PCs. Symptoms are black areas or rectangles in front of diagrams, black file dialogs, text boxes that are visible on screen but missing in the printout, unreadable menus or toolbar icons, and cursors or legends that disappear.
A typical sign is a black diagram area while the menus, the Data Browser and the File List are displayed normally. Change the rendering mode of UniPlot:
Open Tools in the menu bar.
Choose More Options….
Open the section Installation in the Settings dialog.
Set the option Graphics Rendering Screen to 2: GDI+ (recommended first). If the display is still wrong, try 1: GDI.
Save the setting with OK. Restart UniPlot if the display does not update.
The option offers these values:
Value |
Remark |
|---|---|
1: GDI |
Used up to and including UniPlot R2016. Fast, but no transparent areas, anti-aliasing and so on. Solved the problem in most reported cases (Remote Desktop, VPN, QHD second screen). |
2: GDI+ |
From UniPlot R2017. Better output quality than GDI, but slower. |
3: Direct2D (Default) |
Hardware accelerated output, from UniPlot R2018. Quality like GDI+ and faster than GDI. |
For printing problems also change Graphics Rendering Printer in the same section (1: GDI (Default) or 2: GDI+). All UniPlot functions and outputs work with all modes; the mode only affects the display. If UniPlot is too unstable to open the dialog, the function AppSetGDI sets the same value in the command window. Further measures:
Use View > Replot (View=>Replot) once or several times, or un-maximize the UniPlot window, as a temporary workaround.
Set the same Windows display scaling on all monitors and update the graphics drivers.
Restart the PC if axes or legends disappear after screen resolution changes.
See also: Installation, UniPlot tabs and fonts are very small on a high-resolution display - what helps?.
6.3.2. Diagram cursors disappear, the cursor table shows only one curve, or an inserted Excel worksheet shows no preview - which setting fixes it?¶
These symptoms were caused by the screen rendering mode. Change Tools > More Options > Installation > Graphics Rendering Screen from Direct2D (default) to GDI or GDI+ and refresh the display or restart UniPlot. Cursors are then stable and embedded OLE objects such as an Excel worksheet show their preview. See The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?.
6.3.3. UniPlot tabs and fonts are very small on a high-resolution display - what helps?¶
This is a Windows display scaling issue. Set the scaling in the Windows settings (System > Display > Scale) to 100% or another value. In addition, right-click uniplot.exe in the UniPlot Program folder, choose Properties > Compatibility > Change high DPI settings and adjust the override. If the graphs turn black on the second monitor, see The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?.
6.3.4. The Event window disappeared. How can I show it again?¶
Show it again with View > Event Window (View=>Event Window). The window may be minimised at one of the edges of the UniPlot window: hover over it to enlarge it and click the pin symbol to dock it permanently. If it does not work, empty LocalStore (An error appears at start-up and the file list, user toolbar, data browser or sidebar tabs are empty or missing - how do I fix it?), update UniPlot, or reinstall UniPlot.
6.3.6. Umlauts or other special characters in my scripts are garbled on a PC with Chinese regional settings - why?¶
Save your script files in UTF-8. A script file that is not UTF-8 encoded is read in the ANSI code page of the Windows system locale. Umlauts saved in a Western ANSI encoding are therefore shown as other characters on a PC with a Chinese (or other non-Western) system locale.
Since R2024.3, UniPlot’s own script files are UTF-8 encoded, and new script files are saved in UTF-8. UniPlot recognises UTF-8 files automatically.
Update to R2024.3 or later.
Save your own
.icfiles, and the text files they read, as UTF-8. For example, open the file in a text editor, choose Save As and select the encoding UTF-8.Since R2024.3, fopen and text_file_write also use UTF-8 by default. If your script reads ANSI text files, specify the encoding when you open them, for example:
h = fopen("c:/myfile.txt", "rt, ccs=ansi");
See also: Can UniPlot use Chinese or other Unicode characters in channel names, or in file names?, fopen, text_file_write.
6.4. Performance, memory and limits¶
6.4.1. A channel with millions of points is reduced or cannot be plotted against its time channel - how can I increase the limit?¶
UniPlot limits the number of points per curve (data reduction) to be fast. Channels with more than 2 million points (for example MF4/MDF or DXD files) are reduced, which can block plotting a channel or make a filter or FFT result meaningless for channels with millions of points. The limit can be increased; the valid range is 2e6 to 64e6 points (default: 10e6).
Permanently (execute once in the command window, View=>Command Window), then import the file again:
WriteProfileInt("Settings", "data-reduce-limit", 32e6)
Only for the current UniPlot session:
_g()._data_reduce_limit = 8e6
Displaying curves becomes slower with very large data. A higher limit also made UniPlot more stable with large data in reported cases. See Processing Large Data Files and WriteProfileInt.
6.4.2. How can I speed up the loading of very large MF4 or other data files, or files with many rows?¶
Delayed Channel Import (Tools > More Options > Data Import and Data Browser): when enabled, channels of MDF and TDM files are loaded only when needed. This shortens the loading time considerably for large MF4 files (200 MB to 1 GB). For files with very many rows (more than about 70,000), switching it off made the import faster in one case; try both settings (Data Import and Data Browser).
Raise the data reduction limit if UniPlot is unstable (A channel with millions of points is reduced or cannot be plotted against its time channel - how can I increase the limit?).
Reading from a network drive or over VPN is often the main bottleneck. Copy the file to a local drive first and compare (Help=>Check Drive Speed).
6.4.3. UniPlot is very slow when I work from a remote site or over a slow network - what can I do?¶
UniPlot is a desktop application; its speed does not depend on the site. Slowness comes from documents (IPZ files) or data on slow network drives, because UniPlot works on the opened files, whereas other applications load the whole file into memory. Work with local copies of IPZ and data files, check the drives with Help > Check drive speed… (Help=>Check Drive Speed) and use the performance-related settings in Tools > More Options (Copy On Open, Delayed Channel Import, see Copy On Open).
6.4.4. Many “UniPlot Extension” processes stay in the Windows Task Manager - what are they and how do I get rid of them?¶
“UniPlot Extension” is the file description of UniPlot’s helper programs, mainly us.exe, the stand-alone UniScript interpreter in the Program folder (see us.exe). Normally each process ends when its task is finished.
UniPlot starts us.exe itself, for example when you close an IPZ file. The file is then compacted in a separate process so that you can continue working (see File=>Close (Save Compact)). For large files on a slow network drive, this can take several minutes. Scripts can also start us.exe or other programs with system or ShellExecute.
If many processes pile up:
Check your own scripts that start
us.exeor other programs withsystem()orShellExecute(). Make sure the called program ends properly and does not crash or wait for input.Release COM objects such as Excel when you no longer need them (for example
xls = 0).Keep IPZ files on a local drive.
Before you end such a process in the Task Manager, make sure that no IPZ file is still being compacted.
See also: File=>Close (Save Compact), us.exe, system, ShellExecute.
6.4.5. IPZ files open as “Write-Protected” and cannot be edited - why?¶
Check how the file was opened. This happens when files are opened from a file manager with Quick View active: the quick viewer opens the file read-only. Switch Quick View off and open the file normally. If the problem persists, check that Copy On Open in Tools > More Options > UniPlot Document Options is off, empty LocalStore and AutoSave (An error appears at start-up and the file list, user toolbar, data browser or sidebar tabs are empty or missing - how do I fix it?), and check the lock files described in Copy On Open (a file that is open on another computer is opened as a copy).
6.4.6. An error message appears after clicking “Channel Quick View…”. What should I check?¶
Check that the folder Template\qv in the UniPlot installation directory (for example C:\Program Files\UniPlot Software\<release>\Template\qv) exists and is not empty. If files are missing, repair or reinstall UniPlot.
id-1483056