Installing NeurEco on RedHat#

To install NeurEco with administrator privileges on RedHat, use the package manager of your choice to install the rpm. For example, when using yum the commands to install NeurEco are as follows:

1sudo yum localinstall adagos-neureco-yourVersion.x86_64.rpm
2sudo yum localinstall adagos-neurecogui-yourVersion.x86_64.rpm

Note

The second command installs the GUI, so it is optional.

Once NeurEco is installed, the user must provide a license. There are two options for providing the license to NeurEco:

  • Create an environment variable called ADAGOS_LICENSE_FILE and make its value the path of the license file.

  • Copy the license file to the home directory.

Note

  • If Python API or NeurEco GUI does not locate the NeurEco libraries, please make sure that the directory “/usr/local/lib” is added to the LD LIBRARY Path.

  • If the file “libgomp1.so” is not found on the machine NeurEco will throw an error. Please make sure to install “libompl”.

To use NeurEco without administrator privileges, the user needs to unzip the installation rpm file. It contains all the files needed for NeurEco to function properly. To unzip the installation rpm file, please use the following command:

rpm2cpio path_to_adagos_neureco_your_version.rpm | cpio -idmv

Warning

In this installation case, and in order to use NeurEco as described in the following chapters, the user must add the NeurEco bin folder to the ENV PATH or do the following:

  • When using the NeurEco python API, always instantiate the NeurEco object with the full path of the NeurEco dll address: “…/bin/libneurecoDNN_backend.so” for the Tabular solution and “…/bin/libneurecoRNN_backend.so” for the Dynamic solution.

  • If the file “libgomp1.so” is not found on the machine NeurEco will throw an error. Please make sure to install “libgomp”.

Installing the Python API#

The Python API is compatible with python 3.x. It provides all the GUI’s features and more.

Two options are available for installing the Python API:

  • Via the NeurEco GUI: Click on Python drop-list in the GUI and select Install NeurEco package to python. A window containing all the python environments found on the machine will appear. Select the environment to add NeurEco wrapper to it, and click on Install package. This will automatically install the python API for the chosen distribution.

    NeurEco GUI main window

  • Via the installation scripts: run the Install.py script that comes with the Python package (this will install it in the environment used to run the installation script).

Note

  • The Python API uses NumPy Python library. Make sure it is installed in the used environment.

Note

The GUI functionality Export NeurEco to Python (see, for example, Export Tabular Regression from the GUI to the Python API) facilitates the initial transition from the usage of NeurEco with the GUI to its usage with the Python API.