matlab中codegen是什么,从 MATLAB 代码生成 C/C++ 代码。 - MATLAB codegen - MathWorks 中国...

-c生成 C/C++ 代码,但不调用 make 命令。

-config:dll使用默认配置参数生成动态 C/C++ 库。

-config:exe使用默认配置参数生成静态 C/C++ 可执行文件。

-config:lib使用默认配置参数生成静态 C/C++ 库。

-config:mex使用默认配置参数生成 MEX 函数。

-config:single使用默认配置参数生成单精度 MATLAB 代码。

需要 Fixed-Point Designer。

-config config_object指定包含代码生成参数的配置对象。config_object 是以下配置对象之一:

coder.CodeConfig - 用于独立 C/C++ 库或生成可执行文件的参数(如果 Embedded Coder® 不可用)。

% Configuration object for a dynamic linked library

cfg = coder.config('dll')

% Configuration object for an executable

cfg = coder.config('exe')

% Configuration object for a static standalone library

cfg = coder.config('lib')

coder.EmbeddedCodeConfig - 用于独立 C/C++ 库或生成可执行文件的参数(如果 Embedded Coder 可用)。

% Configuration object for a dynamic linked library

ec_cfg = coder.config('dll')

% Configuration object for an executable

ec_cfg = coder.config('exe')

% Configuration object for a static standalone library

ec_cfg = coder.config('lib')

coder.MexCodeConfig - 用于生成 MEX 代码的参数。

mex_cfg = coder.config

% or

mex_cfg = coder.config('mex')

有关详细信息,请参阅配置编译设置。

-d out_folder将生成的文件存储在 out_folder 指定的绝对或相对路径中。out_folder 不能包含:

空格,因为在某些操作系统配置中空格可能导致代码生成失败。

非 7 位 ASCII 字符,如日语字符。

如果 out_folder 指定的文件夹不存在,codegen 会创建它。

如果不指定文件夹位置,codegen 会在下面的默认文件夹中生成文件:

codegen/target/fcn_name.

target 可以是:

mex(对于 MEX 函数)

exe(对于可嵌入的 C/C++ 可执行文件)

lib(对于可嵌入的 C/C++ 库)

dll(对于 C/C++ 动态库)

fcn_name 是命令行中第一个 MATLAB 函数(按字母顺序排列)的名称。

该函数不支持在文件夹名称中使用以下字符:星号 (*)、问号 (?)、美元符号 ($) 和镑符号 (#)。

注意

每次 codegen 为相同的代码生成相同类型的输出时,都会删除上一次编译生成的文件。如果要保留以前的某次编译生成的文件,请在开始新的编译之前将这些文件复制到其他位置。

-double2single

double2single_cfg_name使用 coder.SingleConfig 对象 double2single_cfg_name 指定的设置生成单精度 MATLAB 代码。codegen 在文件夹 codegen/fcn_name/single 中生成文件。

fcn_name 是入口函数的名称。

当与 -config 选项结合使用时,也会生成单精度 C/C++ 代码。codegen 在文件夹 codegen/target/folder_name 中生成单精度文件。

target 可以是:

mex(对于 MEX 函数)

exe(对于可嵌入的 C/C++ 可执行文件)

lib(对于可嵌入的 C/C++ 库)

dll(对于 C/C++ 动态库)

folder_name 是 fcn_name 和 singlesuffix 的串联。

singlesuffix 是 coder.SingleConfig 属性 OutputFileNameSuffix 指定的后缀。此文件夹中的单精度文件也有此后缀。

有关详细信息,请参阅Generate Single-Precision MATLAB Code。您必须有 Fixed-Point Designer 才能使用此选项。

-float2fixed

float2fixed_cfg_name当与 -config 选项结合使用时,使用浮点到定点转换配置对象 float2fixed_cfg_name 指定的设置生成定点 C/C++ 代码。

codegen 在文件夹 codegen/target/fcn_name_fixpt 中生成文件。target 可以是:

mex(对于 MEX 函数)

exe(对于可嵌入的 C/C++ 可执行文件)

lib(对于可嵌入的 C/C++ 库)

dll(对于 C/C++ 动态库)

fcn_name 是入口函数的名称。

如果不使用 -config 选项,则使用浮点到定点转换配置对象 float2fixed_cfg_name 指定的设置生成定点 MATLAB 代码。codegen 在文件夹 codegen/fcn_name/fixpt 中生成文件。

您必须设置 float2fixed_cfg_name 的 TestBenchName 属性。例如:

fixptcfg.TestBenchName = 'myadd_test';此命令指定 myadd_test 是浮点到定点配置对象 fixptcfg 的测试文件。

有关详细信息,请参阅Convert MATLAB Code to Fixed-Point C Code。您必须有 Fixed-Point Designer 才能使用此选项。

-g指定是否对 C 编译器使用调试选项。如果启用调试模式,C 编译器会禁用一些优化。编译速度会更快,但执行速度会更慢。

-globals

global_values在 MATLAB 文件中指定全局变量的名称和初始值。

global_values 是全局变量名称和初始值组成的元胞数组。global_values 的格式是:

{g1, init1, g2, init2, ..., gn, initn}

gn 是指定为字符向量的全局变量的名称。initn 是初始值。例如:

-globals {'g', 5}

也可以使用以下格式:

-globals {global_var, {type, initial_value}}

type 是类型对象。要创建类型对象,请使用 coder.typeof。对于全局元胞数组变量,必须使用此格式。

在使用 codegen 生成代码之前,需要初始化全局变量。如果您没有使用 -globals 选项为全局变量提供初始值,codegen 会检查 MATLAB 全局工作区中的变量。如果不提供初始值,codegen 会产生错误。

MATLAB Coder 和 MATLAB 各有自己的全局数据副本。为了保持一致性,只要两者有交互,就请同步其全局数据。如果不同步数据,其全局变量可能会不同。

要为全局变量指定常量值,请使用 coder.Constant。例如:

-globals {'g', coder.Constant(v)} 指定 g 为具有常量值 v 的全局变量。

-I include_path将 include_path 添加到代码生成路径的开头。当 codegen 搜索 MATLAB 函数和自定义 C/C++ 文件时,它首先搜索代码生成路径。它不会搜索代码生成路径上的类。类必须位于 MATLAB 搜索路径上。有关详细信息,请参阅Paths and File Infrastructure Setup。

如果路径包含非 7 位 ASCII 字符,如日语字符,则 codegen 可能在此路径上找不到文件。

如果您的 include_path 包含的路径包含空格,请用双引号将每个实例括起来,例如:

'C:\Project "C:\Custom Files"'

-jit使用即时 (JIT) 编译来生成 MEX 函数。JIT 编译可以加速 MEX 函数的生成。此选项仅适用于 MEX 函数生成。此选项与某些代码生成功能或选项不兼容,例如自定义代码或使用 OpenMP 库。

-lang:c将生成代码的目标语言指定为 C 语言。

如果没有指定任何目标语言,代码生成器将生成 C 代码。

-lang:c++将生成代码的目标语言指定为 C++。

-launchreport生成并打开一个代码生成报告。如果未指定此选项,则仅当出现错误或警告消息或者您指定了 -report 选项时,codegen 才会生成报告。

-o output_file_name使用基本名称 output_file_name 和以下扩展名之一生成 MEX 函数、C/C++ 库或 C/C++ 可执行文件:

.a 或 .lib(适用于 C/C++ 静态库)

.exe 或无扩展名(适用于 C/C++ 可执行文件)

.dll(适用于 Microsoft® Windows® 系统上的 C/C++ 动态库)

.so(适用于 Linux® 系统上的 C/C++ 动态库)

.dylib(适用于 Mac 系统上的 C/C++ 动态库)

生成的 MEX 函数的与平台相关的扩展名

output_file_name 可以是文件名,也可以包含现有路径。output_file_name 不能包含空格,因为在某些操作系统配置中空格可能导致代码生成失败。

对于 MEX 函数,output_file_name 必须为有效的 MATLAB 函数名称。

如果没有为库和可执行文件指定输出文件名,则基本名称是 fcn_1。fcn_1 是命令行中指定的第一个 MATLAB 函数的名称。对于 MEX 函数,基本名称是 fcn_1_mex。您可以运行原始 MATLAB 函数和 MEX 函数,并比较结果。

-O

optimization_option根据 optimization_option 的值优化生成的代码:

enable:inline - 启用函数内联。

enable:openmp - 使用 OpenMP 库(如果可用)。使用 codegen 为 parfor 循环生成的 OpenMP 库、MEX 函数或 C/C++ 代码可以在多个线程上运行。

disable:openmp - 禁用 OpenMP 库。禁用 OpenMP 后,codegen 将 parfor 循环视为 for 循环,并生成在单线程上运行的 MEX 函数或 C/C++ 代码。请参阅Control Compilation of parfor-Loops。

在命令行上为每次优化指定一次 -O。

如果没有指定,则 codegen 使用内联和 OpenMP 进行优化。

-package

zip_file_name将生成的独立代码及其依存关系打包到名为 zip_file_name 的压缩 ZIP 文件中。然后,您可以使用该 ZIP 文件以转移到另一个开发环境中进行解包并重新编译代码文件。

packNGo 函数也提供此打包功能。

-profile使用 MATLAB 探查器启用对生成的 MEX 函数的探查。有关详细信息,请参阅使用 MATLAB 探查器探查 MEX 函数。

-report生成代码生成报告。如果未指定此选项,则仅当出现错误或警告消息或者您指定了 -launchreport 选项时,codegen 才会生成报告。

如果您有 Embedded Coder,则此选项还支持生成代码替换报告。

-singleC您必须有 Fixed-Point Designer 才能使用此选项。

-std:c89/90为生成代码使用 C89/90 (ANSI) 标准数学库。

-std:c99为生成代码使用 C99 (ISO) 标准数学库。

-std:c++03为生成代码使用 C++03 (ISO) 标准数学库。仅在生成 C++ 代码时才能使用此库。

-std:c++11为生成代码使用 C++11 (ISO) 标准数学库。仅在生成 C++ 代码时才能使用此库。

-test test_file运行 test_file,将调用原始 MATLAB 函数替换为调用 MEX 函数。使用此选项等效于运行 coder.runTest。

仅当生成 MEX 函数或使用将 VerificationMode 设置为 'SIL' 或 'PIL' 的配置对象时,才支持此选项。创建具有 VerificationMode 参数的配置对象需要 Embedded Coder 产品。

定点转换或单精度转换不支持此选项。

-toproject

project_file_name将 codegen 命令转换为名为 project_file_name 的等效 MATLAB Coder 工程文件。然后,您可以使用另一个 codegen 命令或 MATLAB Coder App 从工程文件中生成代码。

您还可以使用 -toproject 选项将不完整的 codegen 命令转换为工程文件。例如,运行如下命令可创建工程文件 myProjectTemplate.prj,其中仅包含存储在配置对象 cfg 中的代码生成参数:

codegen -config cfg -toproject myProjectTemplate.prj在本例中,myProjectTemplate.prj 不包含入口函数或输入类型的设定。因此,您无法从这个工程文件生成代码。您可以在 MATLAB Coder App 中打开 myProjectTemplate.prj,并将其作为模板来创建可用于生成代码的完整工程文件。

使用 -toproject

project_file_name 选项运行 codegen 不会生成代码。它只创建工程文件。

-v启用详尽模式以显示编译步骤。仅在生成库或可执行文件时使用。

-?显示 codegen 命令的帮助。

  • 0
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值