Installation

From Eigenvector Research Documentation Wiki
Revision as of 17:30, 9 September 2024 by Donal (talk | contribs) (→‎Recommendations for Offline Installation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Installing PLS_Toolbox

PLS_Toolbox is delivered as a Windows Installer (.exe for Windows only) or as a compressed ZIP file (all platforms). Installation is a two-part process of copying and decompressing files into a local folder and then adding those files to your MATLAB path. You will need your License Code (obtained at the time of purchase).

System Requirements

  • Compatible with any MATLAB released within 5 years of released date of this product. In general, Eigenvector products should work on most modern computers. For system requirements of specific versions of MATLAB see here.
  • PLS_Toolbox does not require any other MATLAB toolboxes but will make use of the Parallel Computing Toolbox in certain scenarios if present.

MATLAB Compatibility

Although we try to maintain inter-compatibility with MATLAB add-on Toolboxes to the greatest extent possible some incompatibilities do exist. Most of these cases originate from situations where PLS_Toolbox has an established function and The MathWorks (TMW) introduces a new function with the same name and is unwilling to rename it. Because we don't have access to the entire TMW product family this list may not include all incompatible functions:

  • Incompatible Functions
    • cluster.m (Stats Toolbox)
    • crossval.m (Stats Toolbox)
    • regression.m (Neural Net Toolbox)
    • ridge.m (Stats Toolbox)
  • Intentional overloads:
    • boxplot.m (Stats Toolbox because of DataSet Object conflict)
  • Compatible Functions
    • dendrogram.m (Stats Toolbox)
    • range.m (Stats Toolbox)
    • kstest.m (Stats Toolbox)


To manage which function is being called, relocate PLS_Toolbox on your MATLAB path. Putting PLS_Toolbox at the bottom of the path will allow the use of MATLAB functions but will often make PLS_Toolbox inoperable until it's moved back to the top of the path. Within Browse you can select Help>Move Path Folders and indicate the location (Top or Bottom). The evrimovepath function can be used from the command line.

Using the Windows EXE Installer

It is recommended that Windows users use the PLS_Toolbox Windows Installer.

  1. Copy the .exe file to your Desktop (or other suitable local location).
  2. Double click the icon and follow the instructions. Be sure to verify the location of the installation folder; by default it will be the "toolbox" folder of your current MATLAB installation. Windows users: may need to choose a folder within your personal Documents folder in order to avoid permissions problems caused by Windows security.
  3. When the Installer has completed, it will prompt you to start MATLAB and run an install script.
  4. If MATLAB doesn't start see Step 2 below.

Manually Installing from ZIP File (all platforms)

  1. File Extraction
    Decompress the PLS_Toolbox ZIP file. We recommend placing the decompressed PLS_Toolbox main folder into the 'userpath' folder for your MATLAB installation (the default location for this folder is your Documents folder). Older versions of PLS_Toolbox may have been placed in the MATLAB "toolbox" folder (e.g. C:\Program Files\MATLAB\R2016a\toolbox) but this is no longer recommended.
    Note: If you already have a version of PLS_Toolbox installed, be sure the folders do not have the same name (by default they should not). Rename your existing copy of PLS_Toolbox if necessary.
  2. Run evriinstall
    For MATLAB to find PLS_Toolbox, the directories that contain the toolbox files must be added to the MATLAB search path.
    Please Note: If you are familiar with installing toolboxes purchased from The MathWorks, this process is different. TMW installers typically are able to set the path automatically. PLS_Toolbox has its own installation method.
    Start MATLAB and follow these steps:
    • Start MATLAB and use the Current Folder toolbar to navigate to the PLS_Toolbox main folder (created in step 1).
    • Type evriinstall at the command line (in the COMMAND WINDOW):
      >> evriinstall
      A dialog box will appear (see below.) Change the settings as needed then click the Install button. EVRIINSTALL will add PLS_Toolbox to the MATLAB path, check for any installation problems, and output results to the command window.
    • See the Reference Topics page for information about PLS_Toolbox functions. Continue reading the Software User Guide for information using Solo and PLS_Toolbox.
    Installation Guide Window PLS TB 8.7.PNG

Configuring Java

In some older versions of MATLAB, including version 7.0.4 (R14SP2), it is necessary to manually add the jar files included with PLS_Toolbox to the MATLAB java class path. Please see this FAQ for more information:

How to configure Java files in older versions of MATLAB?

Installing Solo

System Requirements

For Solo based products the system requirements will track the version of MATLAB used to build Solo. See MATLAB Runtime column in the release notes for the version of MATLAB used to build Solo and then check the system requirements for that specific version of MATLAB here. The MATLAB Runtime is automatically installed during the installation process. All Solo based products require an internet connection to be installed.

Installation

Windows

If you install Solo into the default "Destination Folder", C:\Program Files\EVRI\Solo_###, where ### is the version number, then you need to install it "As Administrator" in order for library folders to be created under that path. Using "As Administrator" should not be necessary if you install it to a Destination Folder which your user account has access rights to.

For Installing Solo 9.0 and newer

Important System Requirement: Please ensure that the latest Microsoft Windows Visual C++ Redistributable library is installed on the computer. This can be installed from: Microsoft Choose the "X64" 64-bit architecture choice. If this is not installed you will get an error window saying "The code execution cannot proceed because VCRUNTIME140.dll was not found. Reinstalling the program may fix this problem".

  1. Copy the installer.exe file to your Desktop (or other suitable local location).
  2. Double click the icon and follow the instructions. (To customize the installation process, see here)
  3. Click Next in the Solo Installer window. This window has basic product information about Solo.
  4. In the Installation Options window, choose the Installation folder, by default it will be in the "EVRI" folder of your program files folder. Also choose if you wish the create a Desktop shortcut. Click Next.
  5. Click Next in the Required Software window. This window says that Solo requires MATLAB Runtime (as of 2023 this is version 2020b but the EVRI will upgrade the version in the future to accommodate updated operating systems and new features, this occurs roughly every 3-5 years). If the MATLAB Runtime is not already installed on the computer then it will be installed, offering a default install location which you can change if necessary.
  6. Click Install in the Confirmation window. This windows shows were Solo will be installed and where the Runtime is installed.
  7. Click Finish on the Installation Complete window. This window shows that the installation was successful and give instructions on how to launch Solo.
  8. To launch Solo:
    • Navigate to the installation location and go to the "application" folder.
    • If installing with a license file (evrilicense.lic) or license server file (evrilm.xml), move these files into this "application" folder with the .exe file.
    • Double click on the Solo icon. If this is the first time launching Solo then you will be prompted for the license code. The correct license code can be found by logging in to your Eigenvector account and navigating to the Download tab.
For Installing Solo 8.9.2 and older
  1. Copy the installer.exe file to your Desktop (or other suitable local location).
  2. If installing with a license file (evrilicense.lic) or license server file (evrilm.xml), move these files into the same folder as the installer .exe file.
  3. Double click the icon and follow the instructions. Be sure to verify the location of the installation folder; by default it will be in the "EVRI" folder of your program files folder. (To customize the installation process, see Solo Installer Flags)
  4. Identify if you want desktop and Start menu shortcuts created as well as if you want to associate .mat files with Solo.
  5. Identify if you want to add Solo to the system path. Doing so will assure 3rd-party programs will be able to start up Solo (where the 3rd-party program offers this feature.)
  6. When the Installer has completed, you will be asked if you want to start Solo now. The first time you run Solo, it will need to unpack several libraries and make take a minute or so to complete installation. Subsequent startups will take less time. Note that when installed in the standard Program Files folder, this step needs to be done as a user with administrative privileges so it is best to do from the installer.

NOTE: If installing Solo with a license server, see the Evri_license_server documentation.

Troubleshooting: If having problems downloading, installing or running Solo, see the Solo Troubleshooting page.

Mac

For macOS and Solo 8.9.2 and newer:

  1. Image Mounting
    Open the Solo.dmg (or Solo+MIA.dmg) disk image file by double-clicking on it. The disk image will mount on your computer.
  2. Launching The Installer Application
    Right-click the Solo_WebInstaller.app and select Open to open the application. You will be prompted for a password to run the java based installer ("java wants to make changes").
  3. Follow Instructions
    Follow the dialog box instructions, the MATLAB Compiler Runtime (MCR) will be installed if it hasn't been already. The Installation Complete dialog may have instructions relating to opening the application from a shell script, these instructions can be ignored. Double-clicking the application will open it.
  4. Drag the App to the Dock
    By default, the applications will be located in the /Applications/EigenvectorResearchInc/ folder. A versioned folder name (e.g., Solo_892) will be created and the .app folder will be located in the "application" folder. For version 8.9.2 of Solo the app is located at /Applications/EVRI/Solo_892/application. Open the app and drag its icon to the MacOS application dock for easy access.


For installing Solo 8.9.2 and older on macOS Catalina and later, the Matlab 2019b MCR (MATLAB Compiler Runtime) must be installed prior to opening the Solo app:

https://www.mathworks.com/products/compiler/matlab-runtime.html

  1. Image Mounting
    Open the Solo.dmg (or Solo+MIA.dmg) disk image file by double-clicking on it. The disk image will mount on your computer.
  2. Copy Solo APP
    Copy the Solo.app (or Solo+MIA.app) bundle to your Applications folder.
  3. Launching The Application
    Right-click Solo.app and select Open to open the application.
  4. Errors on Startup
    If you receive a message saying "the Disk has been damaged" (OS X 10.7+) you may need to disable Mac Gatekeeper as described here and for Mac OS Sierra (and higher) see here.
  • To disable Gatekeeper (i.e., set it to install from “Anywhere”) from the command line, open a new Terminal window then enter the following command:
$ sudo spctl --master-disable
  • To re-enable Gatekeeper enter the following command:
$ sudo spctl --master-enable

NOTE: The first time you run Solo, it will need to unpack several libraries and may take several minutes (or longer depending on system resources) to complete installation. Subsequent startups will take less time.

Troubleshooting: If having problems downloading, installing or running Solo, see the Solo Troubleshooting page.

Linux

For Installing Solo 9.0 and newer:
  1. Extract the Solo_WebInstaller.install package.
  2. Run the installer as a super user, the default location will be /usr/local/bin.
  3. Use the shell script provided to launch the application by providing the MCR location as the first input:
    ./run_Solo.sh /usr/local/MATLAB/MATLAB_Runtime/v99/
  4. Additional inputs can be added (contained in single quotes):
    ./run_Solo.sh /usr/local/MATLAB/MATLAB_Runtime/v99/ '-debug -loadsettings "/home/scott/default.xml"'
For older installations:
  1. Unzip/UnTar
    Copy the tar.gz file into a target folder (create one using the mkdir command) in any convenient location (e.g. the user's home directory or any accessible location) and use the following command to unzip/untar the application:
     tar -xzf solo.tar.gz
    (note: archive name will be depend on the exact application you are installing)
  2. Launching The Application
    In a console window, change the working directory to the target folder and use the command:
     ./solo
    (application name will depend on the exact application you purchased). If starting from a different working directory, use the full path to the solo application. You can also create a shortcut which performs this operation.
First Run Notes: The first time you run Solo, it will need to unpack several libraries and make take several minutes (or longer depending on system resources) to complete installation. Subsequent startups will take less time. If the program has been installed in a general system folder (such as /usr/local/bin ) then the initial run of Solo may need to be done using SUDO so the program has sufficient privileges to unpack the libraries.

Troubleshooting: If having problems downloading, installing or running Solo, see the Solo Troubleshooting page.

Solo_Predictor: If installing Solo_Predictor see this page

Troubleshooting Solo

If having problems downloading, installing or running Solo, see the Solo Troubleshooting page.

Starting Solo

On all platforms, Solo can be started using the installed shortcuts (double-clicking the shortcut), or by calling the application directly from either a shortcut or DOS/Linux command window. The application can also take various command-line flags that modify startup behavior.

Python Configuration - PLS_Toolbox and Solo

To configure Solo/PLS_Toolbox to use python methods please see the Python configuration page.

Updating

The most up-to-date version of PLS_Toolbox and Solo will be made available to users on our web site, www.eigenvector.com. Registered users can download new copies of the toolbox that incorporate the latest bug fixes. A username and password is required for access to the upgrades. Usernames and passwords are supplied when licenses are purchased (older version users should have received this information by registering their software). If you have forgotten your username and/or password, please write to helpdesk@eigenvector.com or use the lost username/password page accessible from the download page on the Eigenvector Research website.

To check for updates select Check for Updates from the Help menu of the Workspace Browser or Analysis interface, or, for PLS_Toolbox users, use the command:

>> evriupdate 

at the MATLAB command line. This will bring up a small dialog box indicating the status of your installed products.

Recommendations for Offline Installation

In environments without Internet access the following items can be saved to media and loaded/installed on a remote machine. These items should be installed in order listed:

  1. Copy the MATLAB_Runtime .zip file to the target computer.
  2. Expand this .zip file to any accessible folder. It will create a folder there, for example named: MATLAB_Runtime_R2020b_Update_8_win64.
  3. In the expanded folder double-click the file "setup.exe" to start the installer.": Accept suggested installation folder: C:\Program Files\MATLAB\MATLAB Runtime. This will take several minutes and finishes by installing the Matlab Runtime in: C:\Program Files\MATLAB\MATLAB Runtime\v99
  4. Add the path, in this example: "C:\Program Files\MATLAB\MATLAB Runtime\v99\runtime\win64", to the System PATH environment variable.
  • Miniconda3, Python virtual environment management software to enable python tools in PLS_Toolbox and Solo.
  • PLS_Toolbox, download from your account at the Eigenvector website.
  • Solo_Predictor, request the offline installer (Windows only) from Eigenvector Helpdesk.
  • Solo, Solo_MIA, Solo_Model_Exporter, or Solo_MIA_Model_Exporter: These installers will not work on a computer without internet connectivity. Instead, do the following:
  1. Run the installer on another computer which does have internet connectivity. In the case of Solo 9.3. This will create an installation folder wherever you specified, for example C:\tmp\Solo_93, which contains the "application" folder.
  2. Copy this Solo_93 folder and its contents (create a .zip file for convenience) to the offline computer, for example as C:\evri\Solo_93.
  3. Solo can now be started by double-clicking on the C:\evri\Solo_93\application\Solo.exe file.
  4. For a single-user license enter the license code when prompted. For a floating site license follow the normal floating license instructions (see On_each_client_computer ).

Checking Your Installation

You can check that your software is installed and working correctly by:

  • PLS_Toolbox: Run the "evridebug" MATLAB command. Running this should report that "No PLS_Toolbox installation problems were identified".
  • Solo: Solo should open with the Browser window presented. You can confirm Solo is installed correctly by running any analysis method, for example PCA. See the short video on using PCA at: PCA.


Solo or PLS_Toolbox users can get product information from the Help > About menu in the Workspace Browser or Analysis window.

PLS_Toolbox users can use the following commands to verify a new or existing installation. We request the output from these commands when you submit a request to helpdesk@eigenvector.com.

  • ver - Matlab command show a list of installed products.
  • path - Matlab command showing the current folders on the Matlab path. ALL PLS_Toolbox folders (and sub-folders) should be on the Matlab path.
  • evridebug - PLS_Toolbox command that checks for common installation problems.

Also check our FAQ page, there are several more detailed issues including trouble with the Matlab path discussed there.

Getting Help

Start by checking our FAQ Pages. For Solo: also check the Solo Troubleshooting Pages

If you cannot find the information you need there, send problem reports to helpdesk@eigenvector.com

Please send your message with the following information:

  • Product License/Registration Number
  • Computer type, model and operating system version
  • Exact errors you are receiving (if any)
  • Hardware and memory configuration (if reporting a memory issue)
  • Your contact information including either your Eigenvector Username or the following information
First Name
Last Name
Company Name
Phone Country Code
Phone Area Code
Phone Main
Phone Extension