Преобразуйте Алгоритмы Нейронной сети в Фиксированную точку с помощью fxpopt и Сгенерируйте HDL-код

Этот пример использует:

Открыть скрипт

В этом примере показано, как преобразовать модель регрессии нейронной сети в Simulink к фиксированной точке с помощью fxpopt функция и Lookup Table Optimizer.

Обзор

Fixed-Point Designer обеспечивает рабочие процессы через Инструмент Фиксированной точки, который может преобразовать проект от типов данных с плавающей точкой до типов данных с фиксированной точкой. fxpopt функция оптимизирует типы данных в основанном на модели в заданной системе поведенческие ограничения. Для получения дополнительной информации отошлите к ссылке на документацию https://www.mathworks.com/help/fixedpoint/ref/fxpopt.html, Lookup Table Optimizer генерирует эффективные памятью замены интерполяционной таблицы для неограниченных функций, таких как exp и log2. Используя эти инструменты, этот пример демонстрирует, как преобразовать обученную модель регрессии нейронной сети с плавающей точкой, чтобы использовать встроено-эффективные типы данных с фиксированной точкой.

Сеть передачи данных и обучение нейронной сети

engine_dataset содержит данные, представляющие отношение между топливным уровнем и скоростью механизма, и его крутящим моментом и выбросами газа.

% Use the function fitting tool (nftool) from Deep Learning Toolbox (TM) to
% train a neural network to estimate torque and gas emissions of an engine
% given the fuel rate and speed. Use the following commands to train
% the neural network.
load engine_dataset;
x = engineInputs;
t = engineTargets;
net = fitnet(10);
net = train(net,x,t);
view(net)

Закройте представление сети.

nnet.guis.closeAllViews();

Подготовка модели к преобразованию фиксированной точки

Если сеть обучена, используйте gensim функция от Deep Learning Toolbox(TM), чтобы сгенерировать модель Simulink.

[sysName, netName] = gensim(net, 'Name', 'mTrainedNN');

Модель сгенерирована gensim функция содержит нейронную сеть с обученными весами и смещениями. Чтобы подготовить эту сгенерированную модель к преобразованию фиксированной точки, выполните шаги подготовки в инструкциях по лучшим практикам. https://www.mathworks.com/help/fixedpoint/ug/best-practices-for-using-the-fixed-point-tool-to-propose-data-types-for-your-simulink-model.html

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

Откройте и смотрите модель.

model = 'ex_fxpdemo_neuralnet_regression';
system_under_design = [model '/Function Fitting Neural Network'];
baseline_output = [model '/yarr'];
open_system(model);

% Set up model for HDL code generation
hdlsetup(model);

### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','SingleTaskRateTransMsg')">SingleTaskRateTransMsg</a> value is set from 'none' to 'error' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','SingleTaskRateTransMsg', 'none')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','Solver')">Solver</a> value is set from 'FixedStepAuto' to 'FixedStepDiscrete' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','Solver', 'FixedStepAuto')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','AlgebraicLoopMsg')">AlgebraicLoopMsg</a> value is set from 'warning' to 'error' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','AlgebraicLoopMsg', 'warning')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','BlockReduction')">BlockReduction</a> value is set from 'on' to 'off' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','BlockReduction', 'on')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','ConditionallyExecuteInputs')">ConditionallyExecuteInputs</a> value is set from 'on' to 'off' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','ConditionallyExecuteInputs', 'on')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','DefaultParameterBehavior')">DefaultParameterBehavior</a> value is set from 'Tunable' to 'Inlined' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','DefaultParameterBehavior', 'Tunable')">revert</a>).
### <a href="matlab:configset.internal.open('ex_fxpdemo_neuralnet_regression','ProdHWDeviceType')">ProdHWDeviceType</a> value is set from 'Intel->x86-64 (Windows64)' to 'ASIC/FPGA->ASIC/FPGA' (<a href="matlab:set_param('ex_fxpdemo_neuralnet_regression','ProdHWDeviceType', 'Intel->x86-64 (Windows64)')">revert</a>).
### The listed configuration parameter values are modified as a part of hdlsetup. Please refer to <a href="matlab:helpview(fullfile(docroot, 'hdlcoder', 'helptargets.map'), 'msg_hdlsetup_function')">hdlsetup</a> document for best practices on model settings.

Симулируйте модель, чтобы наблюдать производительность модели при использовании типов данных с плавающей точкой с двойной точностью.

loggingInfo = get_param(model, 'DataLoggingOverride');
sim_out = sim(model, 'SaveFormat', 'Dataset');

plotRegression(sim_out, baseline_output, system_under_design, 'Regression before conversion');

Задайте систему поведенческие ограничения для преобразования фиксированной точки

opts = fxpOptimizationOptions();
opts.addTolerance(system_under_design, 1, 'RelTol', 0.05);
opts.addTolerance(system_under_design, 1, 'AbsTol', 50)
opts.AllowableWordLengths = 8:32;

Оптимизируйте типы данных

Используйте fxpopt функция, чтобы оптимизировать типы данных в системе в соответствии с проектом и исследовать решение. Программное обеспечение анализирует область значений объектов в system_under_design и wordlength и ограничения допуска заданы в opts применять типы гетерогенных данных к модели при минимизации общей битной ширины.

solution  = fxpopt(model, system_under_design, opts);
best_solution = solution.explore;

	+ Starting data type optimization...
	+ Checking for unsupported constructs.
		- The paths below have constructs that do not support fixed-point data types. These constructs will be surrounded with Data Type Conversion blocks.
    'ex_fxpdemo_neuralnet_regression/Function Fitting Neural Network/Layer 1/tansig/tanh'

	+ Preprocessing
	+ Modeling the optimization problem
		- Constructing decision variables
	+ Running the optimization solver
		- Evaluating new solution: cost 515, does not meet the behavioral constraints.
		- Evaluating new solution: cost 577, does not meet the behavioral constraints.
		- Evaluating new solution: cost 639, does not meet the behavioral constraints.
		- Evaluating new solution: cost 701, does not meet the behavioral constraints.
		- Evaluating new solution: cost 763, does not meet the behavioral constraints.
		- Evaluating new solution: cost 825, does not meet the behavioral constraints.
		- Evaluating new solution: cost 887, does not meet the behavioral constraints.
		- Evaluating new solution: cost 949, meets the behavioral constraints.
		- Updated best found solution, cost: 949
		- Evaluating new solution: cost 945, meets the behavioral constraints.
		- Updated best found solution, cost: 945
		- Evaluating new solution: cost 944, meets the behavioral constraints.
		- Updated best found solution, cost: 944
		- Evaluating new solution: cost 943, meets the behavioral constraints.
		- Updated best found solution, cost: 943
		- Evaluating new solution: cost 942, meets the behavioral constraints.
		- Updated best found solution, cost: 942
		- Evaluating new solution: cost 941, meets the behavioral constraints.
		- Updated best found solution, cost: 941
		- Evaluating new solution: cost 940, meets the behavioral constraints.
		- Updated best found solution, cost: 940
		- Evaluating new solution: cost 939, meets the behavioral constraints.
		- Updated best found solution, cost: 939
		- Evaluating new solution: cost 938, meets the behavioral constraints.
		- Updated best found solution, cost: 938
		- Evaluating new solution: cost 937, meets the behavioral constraints.
		- Updated best found solution, cost: 937
		- Evaluating new solution: cost 936, meets the behavioral constraints.
		- Updated best found solution, cost: 936
		- Evaluating new solution: cost 926, meets the behavioral constraints.
		- Updated best found solution, cost: 926
		- Evaluating new solution: cost 925, meets the behavioral constraints.
		- Updated best found solution, cost: 925
		- Evaluating new solution: cost 924, meets the behavioral constraints.
		- Updated best found solution, cost: 924
		- Evaluating new solution: cost 923, meets the behavioral constraints.
		- Updated best found solution, cost: 923
		- Evaluating new solution: cost 922, meets the behavioral constraints.
		- Updated best found solution, cost: 922
		- Evaluating new solution: cost 917, meets the behavioral constraints.
		- Updated best found solution, cost: 917
		- Evaluating new solution: cost 916, meets the behavioral constraints.
		- Updated best found solution, cost: 916
		- Evaluating new solution: cost 914, meets the behavioral constraints.
		- Updated best found solution, cost: 914
		- Evaluating new solution: cost 909, meets the behavioral constraints.
		- Updated best found solution, cost: 909
		- Evaluating new solution: cost 908, meets the behavioral constraints.
		- Updated best found solution, cost: 908
		- Evaluating new solution: cost 906, meets the behavioral constraints.
		- Updated best found solution, cost: 906
		- Evaluating new solution: cost 898, meets the behavioral constraints.
		- Updated best found solution, cost: 898
		- Evaluating new solution: cost 897, meets the behavioral constraints.
		- Updated best found solution, cost: 897
		- Evaluating new solution: cost 893, does not meet the behavioral constraints.
		- Evaluating new solution: cost 896, meets the behavioral constraints.
		- Updated best found solution, cost: 896
		- Evaluating new solution: cost 895, meets the behavioral constraints.
		- Updated best found solution, cost: 895
		- Evaluating new solution: cost 894, meets the behavioral constraints.
		- Updated best found solution, cost: 894
		- Evaluating new solution: cost 893, meets the behavioral constraints.
		- Updated best found solution, cost: 893
		- Evaluating new solution: cost 892, meets the behavioral constraints.
		- Updated best found solution, cost: 892
		- Evaluating new solution: cost 891, meets the behavioral constraints.
		- Updated best found solution, cost: 891
		- Evaluating new solution: cost 890, meets the behavioral constraints.
		- Updated best found solution, cost: 890
		- Evaluating new solution: cost 889, meets the behavioral constraints.
		- Updated best found solution, cost: 889
		- Evaluating new solution: cost 888, meets the behavioral constraints.
		- Updated best found solution, cost: 888
		- Evaluating new solution: cost 878, meets the behavioral constraints.
		- Updated best found solution, cost: 878
		- Evaluating new solution: cost 877, meets the behavioral constraints.
		- Updated best found solution, cost: 877
		- Evaluating new solution: cost 876, meets the behavioral constraints.
		- Updated best found solution, cost: 876
		- Evaluating new solution: cost 875, meets the behavioral constraints.
		- Updated best found solution, cost: 875
		- Evaluating new solution: cost 874, meets the behavioral constraints.
		- Updated best found solution, cost: 874
		- Evaluating new solution: cost 869, meets the behavioral constraints.
		- Updated best found solution, cost: 869
		- Evaluating new solution: cost 868, does not meet the behavioral constraints.
		- Evaluating new solution: cost 867, meets the behavioral constraints.
		- Updated best found solution, cost: 867
		- Evaluating new solution: cost 862, does not meet the behavioral constraints.
		- Evaluating new solution: cost 866, does not meet the behavioral constraints.
		- Evaluating new solution: cost 865, does not meet the behavioral constraints.
	+ Optimization has finished.
		- Neighborhood search complete.
		- Maximum number of iterations completed.
	+ Fixed-point implementation that satisfies the behavioral constraints found. The best found solution is applied on the model.
		- Total cost: 867
		- Maximum absolute difference: 49.714162
		- Use the explore method of the result to explore the implementation.
Warning: Unrecognized function or variable
'CloneDetectionUI.internal.CloneDetectionPerspective.register'.

Проверьте точность модели после преобразования путем симуляции модели.

set_param(model, 'DataLoggingOverride', loggingInfo);
Simulink.sdi.markSignalForStreaming([model '/yarr'], 1, 'on');
Simulink.sdi.markSignalForStreaming([model '/diff'], 1, 'on');
sim_out = sim(model, 'SaveFormat', 'Dataset');

Постройте точность регрессии модели фиксированной точки.

plotRegression(sim_out, baseline_output, system_under_design, 'Regression after conversion');

Замените функцию активации на оптимизированную интерполяционную таблицу

Функция Активации Tanh в Слое 1 может быть заменена или интерполяционной таблицей или реализацией CORDIC для более эффективной генерации фиксированной точки. В этом примере мы будем использовать Lookup Table Optimizer, чтобы получить интерполяционную таблицу как замену для tanh. Мы будем использовать EvenPow2Spacing для более быстрой скорости выполнения. Для получения дополнительной информации см. https://www.mathworks.com/help/fixedpoint/ref/functionapproximation.options-class.html.

block_path = [system_under_design '/Layer 1/tansig'];
p = FunctionApproximation.Problem(block_path);
p.Options.WordLengths = 8:32;
p.Options.BreakpointSpecification = 'EvenPow2Spacing';
solution  = p.solve;
solution.replaceWithApproximate;

|  ID |  Memory (bits) | Feasible | Table Size | Breakpoints WLs | TableData WL | BreakpointSpecification |             Error(Max,Current) | 
|   0 |             44 |        0 |          2 |              14 |            8 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |
|   1 |           8220 |        1 |       1024 |              14 |            8 |         EvenPow2Spacing |     7.812500e-03, 7.812500e-03 |
|   2 |           8212 |        1 |       1024 |              10 |            8 |         EvenPow2Spacing |     7.812500e-03, 7.812500e-03 |
|   3 |           4124 |        1 |        512 |              14 |            8 |         EvenPow2Spacing |     7.812500e-03, 7.812500e-03 |
|   4 |           4114 |        1 |        512 |               9 |            8 |         EvenPow2Spacing |     7.812500e-03, 7.812500e-03 |
|   5 |             46 |        0 |          2 |              14 |            9 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |
|   6 |             48 |        0 |          2 |              14 |           10 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |
|   7 |             50 |        0 |          2 |              14 |           11 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |
|   8 |             52 |        0 |          2 |              14 |           12 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |
|   9 |             54 |        0 |          2 |              14 |           13 |         EvenPow2Spacing |     7.812500e-03, 1.000000e+00 |

Best Solution
|  ID |  Memory (bits) | Feasible | Table Size | Breakpoints WLs | TableData WL | BreakpointSpecification |             Error(Max,Current) |
|   4 |           4114 |        1 |        512 |               9 |            8 |         EvenPow2Spacing |     7.812500e-03, 7.812500e-03 |

Проверьте точность модели после функциональной замены

sim_out = sim(model, 'SaveFormat', 'Dataset');

Постройте точность регрессии после функциональной замены.

plotRegression(sim_out, baseline_output, system_under_design, 'Regression after function replacement');

Сгенерируйте HDL-код и испытательный стенд

Генерация HDL-кода требует лицензии HDL Coder™.

Выберите модель, для которой можно сгенерировать HDL-код и испытательный стенд.

systemname = 'ex_fxpdemo_neuralnet_regression/Function Fitting Neural Network';

Используйте временную директорию для сгенерированных файлов.

workingdir = tempname;

Можно запустить следующую команду, чтобы проверять на совместимость генерации HDL-кода.

checkhdl(systemname,'TargetDirectory',workingdir);

### Begin compilation of the model 'ex_fxpdemo_neuralnet_regression'...
### Running HDL checks on the model 'ex_fxpdemo_neuralnet_regression'.
### Creating HDL Code Generation Check Report file://C:\Users\jclayton\AppData\Local\Temp\tpd1be65e4_d7a4_4c58_9de3_4d8fc159b4f6\ex_fxpdemo_neuralnet_regression\Function_Fitting_Neural_Network_report.html
### HDL check for 'ex_fxpdemo_neuralnet_regression' complete with 0 errors, 0 warnings, and 0 messages.

Запустите следующую команду, чтобы сгенерировать HDL-код.

makehdl(systemname,'TargetDirectory',workingdir);

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

makehdltb(systemname,'TargetDirectory',workingdir);

Документация Fixed-Point Designer

Поддержка

Для просмотра документации необходимо авторизоваться на сайте