12.9. Troubleshooting

Before you attempt troubleshooting, please verify that:

• pSeven Core was installed correctly, according to section Installation,
• the license is registered (see section License Setup), and
• your system satisfies the requirements for running examples (see section Requirements).

If the problem persists, continue with the answers in this section.

Q:The example does not run when double-clicking the script (the .py file). A:See the end paragraph in section Running Examples. If you believe that your system is set up as described there, run the example from terminal (using python example_file_name.py) and see the error message, then continue troubleshooting.

Q:The example does not run, showing the message: ImportError: No module named da.p7core. A:pSeven Core was not installed properly, or the PYTHONPATH environment variable was not set. Please check section Installation.

Q:The example does not run, showing the message: ImportError: No module named ... (not the da.p7core module). A:Some required third-party module is not installed. Note the module name in the message and install that module (see section Requirements for details).

Q:Example stops before finished, showing the message: NameError: name '...' is not defined. A:An undeclared variable or a missing module or function encountered. Verify that the example script was not changed before. If you have changed the example on purpose, verify that you import all needed modules and define the variables and functions you use.

Q:The example does not run, showing the message: IOError: [Errno 2] No such file or directory: .... A:The example can not find the source data file it needs. If you run it using python -m, verify that the examples directory installed into package was not changed before. To find the package installation directory, you can use this command: python -c "import da; print('\n'.join(da.__path__))". If you run a downloaded copy of the example using python example_file_name.py, verify that you have downloaded all files listed in the example description, and that the script and data files are in the same directory.

Q:The example does not run, showing the message: There is no environment variable 'DATADVD_LICENSE_FILE'!. A:The license was not registered correctly. Check the License Setup section, in particular Registering the License if you use a node-locked license and Client Configuration if you use a floating license.

Q:The example does not run, showing the message: "No features found!". A:Wrong license file, or DATADVD_LICENSE_FILE contains an invalid path. Verify that you are using the license which includes pSeven Core. Verify that the path to license file is set correctly.

Q:The example runs, but stops afterwards without finishing and nothing happens. A:Examples may take a few minutes to execute, depending on available system resources. Please wait to see if the example continues. Also, the script may stay on pause displaying the results plot. Check if there is a message in the console beginning with “Plots are saved to…”; at this point, the plot is also shown in a new window which was probably opened in the background. Find the window and close it to continue (or finish) the example.

Q:The example runs and shows the plot, but does not save it. A:Plots are saved in the current working directory which is the directory where you invoke the Python interpreter — not necessary the same directory where the script (the .py file) is located. Look for a message starting with “Plots are saved to…” in the console log to find out the location of saved plots. Also check that you have write access to the current working directory.

Q:There is no legend on the resulting plot. A:This is due to a bug in Matplotlib, which should be resolved by installing Matplotlib version 1.1 or later (see Requirements). If newer versions are not available, this particular issue may be resolved temporarily by deleting the Matplotlib font cache (for example, in Linux: rm ~/.matplotlib/fontList.cache).

Q:The resulting plots are different from the ones shown in example description. A:Verify that Matplotlib version 1.1 or later is installed. Due to bugs in older versions of Matplotlib, plots are rendered incorrectly sometimes.