Getting Started with Intel® Data Analytics Acceleration Library 2019 for Windows* (Beta)

Install Intel DAAL on Your System

Intel DAAL installs in the directory <install dir>\daal.

By default, <install dir> is C:\Program files (x86)\IntelSWTools\compilers_and_libraries_2019.x.xxx\windows.

For installation details, refer to Intel DAAL Installation Guide.

Set Environment Variables

1. Run the <install dir>\daal\bin\daalvars.bat script as appropriate to your target architecture:

   • IA-32 architecture:

     daalvars.bat ia32

   • Intel® 64 architecture:

     daalvars.bat intel64

2. Optionally: Specify the Java* compiler different from the default compiler:

   set JAVA_HOME=%PATH_TO_JAVA_SDK%

   set PATH=%JAVA_HOME%\bin:%PATH%

Step 1: Configure Automatic Linking of Your Application with Intel DAAL

In Microsoft Visual Studio* Integrated Development environment (IDE), open or create a C++ project for your Intel DAAL application to build.

Specify the /Qdaal option of the Intel® C++ Compiler 16 or higher or configure your project in the IDE:

For more information on the /Qdaal compiler option, see the Intel® Compiler User and Reference Guide.

Step 2: Create and Run Your First Application with Intel DAAL

This short application computes Cholesky decomposition with Intel DAAL.

/*******************************************************************************
!  Copyright(C) 2014-2017 Intel Corporation. All Rights Reserved.
!
!  The source code, information  and  material ("Material") contained herein is
!  owned  by Intel Corporation or its suppliers or licensors, and title to such
!  Material remains  with Intel Corporation  or its suppliers or licensors. The
!  Material  contains proprietary information  of  Intel or  its  suppliers and
!  licensors. The  Material is protected by worldwide copyright laws and treaty
!  provisions. No  part  of  the  Material  may  be  used,  copied, reproduced,
!  modified, published, uploaded, posted, transmitted, distributed or disclosed
!  in any way  without Intel's  prior  express written  permission. No  license
!  under  any patent, copyright  or  other intellectual property rights  in the
!  Material  is  granted  to  or  conferred  upon  you,  either  expressly,  by
!  implication, inducement,  estoppel or  otherwise.  Any  license  under  such
!  intellectual  property  rights must  be express  and  approved  by  Intel in
!  writing.
!
!  *Third Party trademarks are the property of their respective owners.
!
!  Unless otherwise  agreed  by Intel  in writing, you may not remove  or alter
!  this  notice or  any other notice embedded  in Materials by Intel or Intel's
!  suppliers or licensors in any way.
!
!*******************************************************************************
!  Content:
!    Cholesky decomposition sample program.
!******************************************************************************/

#include "daal.h"
#include <iostream>

using namespace daal;
using namespace daal::algorithms;
using namespace daal::data_management;
using namespace daal::services;

const size_t dimension = 3;
double inputArray[dimension *dimension] =
{
    1.0,  2.0,  4.0,
    2.0, 13.0, 23.0,
    4.0, 23.0, 77.0
};

int main(int argc, char *argv[])
{
    /* Create input numeric table from array */
    SharedPtr<NumericTable> inputData = SharedPtr<NumericTable>(new Matrix<double>(dimension, dimension, inputArray));

    /*  Create the algorithm object for computation of the Cholesky decomposition using the default method */
    cholesky::Batch<> algorithm;

    /* Set input for the algorithm */
    algorithm.input.set(cholesky::data, inputData);

    /* Compute Cholesky decomposition */
    algorithm.compute();

    /* Get pointer to Cholesky factor */
    SharedPtr<Matrix<double> > factor =
        staticPointerCast<Matrix<double>, NumericTable>(algorithm.getResult()->get(cholesky::choleskyFactor));

    /* Print the first element of the Cholesky factor */
    std::cout << "The first element of the Cholesky factor: "<< (*factor)[0][0];

    return 0;
}

1. Add a new C++ file to your project and paste the application code into it.

2. Save the file.

3. Compile and run the application.

Step 3 (Optional): Build Your Application with Different Compilers

If you did not install the C++ Integration(s) in Microsoft Visual Studio* component of the Intel® Parallel Studio XE or need more control over Intel DAAL libraries to link with your application, directly configure your Visual Studio project.

Add the following libraries to your project, depending on Intel DAAL threading mode and linking method:

Regardless of the linking method, also add to your project the library on which Intel DAAL libraries depend:

• Intel® Threading Building Blocks run-time library of the Intel® compiler tbb.lib

To configure your project, follow these steps, which may slightly differ in some versions of Visual Studio:

1. In Solution Explorer, right-click your project and click Properties

2. Select Configuration Properties> VC++ Directories

3. Select Include Directories. Add the directory for the Intel DAAL include files, that is, %DAALROOT%\include

4. Select Library Directories. Add the architecture-specific directory with Intel DAAL libraries that matches the architecture parameter provided to the daalvar.bat script.
   For example: %DAALROOT%\lib\intel64_win.

   Add the architecture-specific directory with the threading run-time library tbb.lib.
   For example: <install dir>\tbb\lib\intel64_win\vc_mt.

5. Select Executable Directories. Add the architecture-specific directory with Intel DAAL dynamic-link libraries.
   For example: <install dir>\redist\intel64_win\daal.

   Add architecture-specific directories with threading run-time dynamic-link libraries.
   For example: <install dir>\redist\intel64_win\compiler and <install dir>\redist\intel64_win\tbb\vc_mt.

6. Select Configuration Properties> Custom Build Setup> Additional Dependencies. Add the libraries required.
   For example: to build your application for Intel® 64 architecture by statically linking with multi-threaded Intel DAAL, add daal_core.lib daal_thread.libtbb.lib

In the case of dynamic linking with Intel DAAL, to change the default multi-threaded mode to single-threaded, precede the first call to Intel DAAL with the call right under the "Set single-threaded mode" comment:

...
int main(int argc, char *argv[])
{
    /* Set single-threaded mode */
    Environment::getInstance()->setDynamicLibraryThreadingTypeOnWindows(Environment::SingleThreaded); 

    /* Create input numeric table from array */
    SharedPtr<NumericTable> inputData = SharedPtr<NumericTable>(new Matrix<double>(dimension, dimension, inputArray));
...

Step 4: Build and Run Intel DAAL Code Examples

In Visual Studio*, use DAALExamples.sln solution file available in <install dir>\daal\examples\cpp.

Build and Run Intel DAAL Code Examples

To build and run Java code examples, use the version of the Java Virtual Machine* corresponding to the architecture parameter you provided to the daalvars.bat script during setting environment variables.

1. Free 4 gigabytes of memory on your system.

2. Build examples:

   Go to the Java examples directory and execute the launcher command with the build parameter:

   cd <install dir>\daal\examples\java

   launcher.bat build %PATH_TO_JAVAC%

   The command builds executables *.class (for example, CholeskyBatch.class) in the

   <install dir>\daal\examples\java\com\intel\daal\examples\<example name> directory.

3. Run examples:

   Go to the Java examples directory and execute the launcher command with the run parameter:

   cd <install dir>\daal\examples\java

   launcher.bat {ia32|intel64} run %PATH_TO_JAVAC%

   Choose the same architecture parameter as you provided to the daalvars.bat script.

   The output for each example is written to the file <example name>.res located in the .\_results\ia32 or .\_results\intel64 directory, depending on the specified architecture.

Step 1: Set Up the Build Environment

Set up the C++ build environment as explained under C++ Language.

Step 2: Install Intel DAAL for Python

Go to the directory with Python sources of Intel DAAL and run the install script:

cd <install dir>\pydaal_sources

<python home>\python setup.py install

This script compiles code using Intel DAAL for C++. It builds and installs the pyDAAL package for using Intel DAAL in Python programs.

Step 3: Run Intel DAAL Code Examples

To run Intel DAAL code examples, use the same version of Python as you used to install pyDAAL.

• Go to the directory with Intel DAAL Python examples:

  cd <install dir>\examples\python

• To run all the examples, execute the command:

  <python home>\python run_examples.py

  The output for each example is written to the .\_results\intel64\<example name>.res file.

• To run one specific example, execute the command:

  <python home>\python <algorithm name>\<example name>.py

  For example: C:\python3.5.1\python cholesky\cholesky_batch.py

  This command prints the output to your console.