Configuring Python for use with Analytics

Note

These configuration instructions refer to a customer-installed instance of Python required to use Analytics Python functions. This instance of Python is not the same as the instance of Python that can be installed as part of the Analytics installation to support machine learning commands.

To configure Python to work with Analytics, you must install a compatible version of Python and add the Python executable to your computer's PATH environment variable. You must also set the ACLPYTHONDLL and PYTHONPATH system environment variables.

How it works

To run Python scripts, Analytics must be able to call the Python executable and find the scripts it is instructed to run. Analytics uses the PATH environment variable to locate Python and the PYTHONPATH environment variable to locate scripts.

Install Python (32-bit)

  1. From the Python downloads page, download one of the following versions of Python to your computer or the server:
    • 3.4.x
    • 3.5.x
    • 3.6.x

    Note

    The listed versions of Python have been tested and verified to work with Analytics or the Robots Agent.

    Any version of Python from 3.4.x onward should work. However, versions other than those listed are not guaranteed to work.

  2. On your computer or the server, double-click the installer.
  3. In the installer, select Add Python versionNumber to PATH.
  4. Click Install and follow the on-screen instructions.
  5. Reboot the computer or the server before running any Python scripts called by an Analytics script.

Set the ACLPYTHONDLL and PYTHONPATH environment variables

  1. In the C:\ drive of the operating system, create one or more folders to house your Python scripts.

    Example C:\python_scripts

  2. From the operating system, open the System Properties dialog box and click Environment Variables.
  3. In the System variables section, click New and enter the following variables:
    Variable nameVariable value
    PYTHONPATH

    The full path to the folder(s) you created to house the Python scripts. Separate multiple folder paths with a semi-colon.

    Example:

    C:\python_scripts;C:\dev;C:\tmp
    ACLPYTHONDLL

    The full path and filename of the Python DLL file in the Python installation folder.

    Example:

    c:\python_install\python35.dll

    Note

    Upon installation, Python adds the DLL to the system folder (c:\windows\system32\python35.dll) rather than the installation folder. You must copy the DLL from the system folder to the installation folder, and use the installation folder location as the variable value. Analytics or the Robots Agent look for the DLL in the Python installation folder.

    You may also need to remove any read-only settings from the installation folder.

  4. To save the variable, click OK and then in the System Properties dialog box, click OK.

Use Python in Analytics Python functions

From Analytics, use the Analytics Python functions to call functions in scripts that exist in your PYTHONPATH.

For more information, see Python.

Note

If you make any edits to a Python script, you must refresh the view in your Analytics project to use the latest version of the Python script. The simplest way to refresh the view is to close the table you are working with and then re-open it.