Документация

Задайте библиотеку BLAS

Чтобы сгенерировать вызовы BLAS в автономном коде, у вас должен быть доступ к классу коллбэка BLAS. Класс коллбэка BLAS задает библиотеку BLAS, заголовочный файл CBLAS, определенные типы данных C, которые конкретный интерфейс CBLAS использует, и компилятор и опции компоновщика для процесса сборки. Выполнить одно из следующих действий:

Запишите класс коллбэка BLAS

Чтобы сгенерировать вызовы определенной библиотеки BLAS в сгенерированном коде, запишите класс коллбэка BLAS. Совместно используйте класс коллбэка с другими, которые хотят пользоваться этой библиотекой BLAS для вызовов BLAS в автономном коде.

Класс коллбэка должен вывести из абстрактного класса coder.BLASCallback. Этим примером является реализация класса коллбэка mklcallback для интеграции с библиотекой Intel MKL BLAS по платформе Windows^®.

classdef mklcallback < coder.BLASCallback
    methods (Static)
        function updateBuildInfo(buildInfo, ~)
            libPath = fullfile(pwd,'mkl','WIN','lib','intel64');
            libPriority = '';
            libPreCompiled = true;
            libLinkOnly = true;
            libs = {'mkl_intel_ilp64.lib' 'mkl_intel_thread.lib' 'mkl_core.lib'};
            buildInfo.addLinkObjects(libs, libPath, libPriority, libPreCompiled, ...
                                  libLinkOnly);
            buildInfo.addLinkObjects('libiomp5md.lib',fullfile(matlabroot,'bin', ...
                             'win64'), libPriority, libPreCompiled, libLinkOnly);
            buildInfo.addIncludePaths(fullfile(pwd,'mkl','WIN','include'));
            buildInfo.addDefines('-DMKL_ILP64');
        end
        function headerName = getHeaderFilename()
            headerName = 'mkl_cblas.h';
        end
        function intTypeName = getBLASIntTypeName()
            intTypeName = 'MKL_INT';
        end
    end
end

Необходимо обеспечить getHeaderFilename, getBLASIntTypeName, и updateBuildInfo методы. getHeaderFilename метод возвращает имя заголовочного файла CBLAS. Если вы пользуетесь различной библиотекой BLAS, заменяете mkl_cblas.h с именем вашего заголовочного файла CBLAS. getBLASIntTypeName метод возвращает имя целочисленного типа данных, который использует ваш интерфейс CBLAS. Если вы пользуетесь различной библиотекой BLAS, заменяете MKL_INT с именем целочисленного типа данных, характерного для вашего интерфейса CBLAS. updateBuildInfo метод предоставляет информацию, запрошенную для процесса сборки, чтобы соединиться с библиотекой BLAS. Используйте код, который похож на код в классе коллбэка в качестве примера, чтобы задать местоположение заголовочного файла, имя полного пути библиотеки BLAS, и опции компоновщика и компилятор. Если вы пользуетесь библиотекой Intel MKL BLAS, используйте советника по вопросам линии ссылки, чтобы видеть, каким библиотекам и параметрам компилятора рекомендуют для вашего варианта использования.

Существует три других метода, которые уже реализованы в coder.BLASCallback. Этими методами является getBLASDoubleComplexTypeName, getBLASSingleComplexTypeName, и useEnumNameRatherThanTypedef. По умолчанию ваш класс коллбэка наследовал эти реализации от coder.BLASCallback. В определенных ситуациях необходимо заменить эти методы с собственными определениями, когда вы задаете свой класс коллбэка.

getBLASDoubleComplexTypeName метод возвращает тип, используемый в комплексных переменных с двойной точностью в сгенерированном коде. Если ваша библиотека BLAS берет тип кроме double* и void* для аргументов комплексного массива с двойной точностью включайте этот метод в свое определение класса коллбэка.

function doubleComplexTypeName = getBLASDoubleComplexTypeName()
doubleComplexTypeName = 'my_double_complex_type';
end

Замените my_double_complex_type с типом, который ваша библиотека BLAS берет для аргументов комплексного массива с двойной точностью.

getBLASSingleComplexTypeName метод возвращает тип, используемый в комплексных переменных с одинарной точностью в сгенерированном коде. Если ваша библиотека BLAS берет тип кроме float* и void* для аргументов комплексного массива с одинарной точностью включайте этот метод в свое определение класса коллбэка.

function singleComplexTypeName = getBLASSingleComplexTypeName()
doubleComplexTypeName = 'my_single_complex_type';
end

Замените my_single_complex_type с типом, который ваша библиотека BLAS берет для аргументов комплексного массива с одинарной точностью.

useEnumNameRatherThanTypedef метод возвращает false по умолчанию. Если типы для перечислений в вашей библиотеке BLAS включают enum ключевое слово, переопределите этот метод, чтобы возвратить true в вашем определении класса коллбэка.

function p = useEnumNameRatherThanTypedef()
p = true;
end

Выборка из сгенерированного исходного кода C, который включает enum ключевое слово:

enum CBLAS_SIDE t;
enum CBLAS_UPLO b_t;
double temp;
enum CBLAS_TRANSPOSE c_t;
enum CBLAS_DIAG d_t;

Сгенерируйте вызовы BLAS путем определения класса коллбэка BLAS

В этом примере показано, как сгенерировать код, который вызывает функции BLAS в определенной библиотеке BLAS. Класс коллбэка BLAS useMyBLAS задает библиотеку BLAS, которой вы хотите пользоваться в этом примере.

Найдите библиотеку BLAS в среде выполнения

Библиотека BLAS должна быть доступной в вашей среде выполнения. Если ваша библиотека BLAS совместно используется, используйте переменные окружения или опции компоновщика, чтобы задать местоположение библиотеки BLAS.

Задавать rpath опция компоновщика, используйте информацию о сборке addLinkFlags метод в updateBuildInfo метод вашего класса коллбэка BLAS. Например, для компилятора GCC:

buildInfo.addLinkFlags(sprintf('-Wl,-rpath,"%s"',libPath));

Указания и ограничения по применению для библиотеки OpenBLAS

Если вы генерируете код, который включает вызовы библиотечных функций OpenBLAS, следуйте этим инструкциям и ограничениям: