主要内容

生成一个Python包和建立一个Python应用程序

金宝app支持平台:窗户®,Linux®,Mac

这个例子展示了如何创建一个Python®从MATLAB软件包®功能和集成到Python应用程序生成的包。

先决条件

  • 确认您已经安装了Python的一个版本兼容MATLAB编译器SDK™。有关详细信息,请参见MATLAB金宝app支持其他语言的接口。

  • 最终用户必须有一个安装MATLAB运行时运行该应用程序。出于测试目的,您可以使用一个安装MATLAB代替MATLAB运行时。有关详细信息,请参见安装和配置MATLAB运行时。

创建函数MATLAB

在MATLAB中,检查你想要的MATLAB代码打包。对于这个示例,创建一个函数命名makesqr.m包含以下代码:

函数y y = makesqr (x) =魔法(x);

在MATLAB命令提示符,输入makesqr (5)。

输出是一个5-by-5矩阵。

17 24 1 8 15 23 5 7 14 16 4 6 13 20 22 10 12 19 21 3 11 18 25 2 9

创建Python应用程序使用库编译应用程序

编译到一个Python包中使用的函数库的编译器应用。另外,如果你想创建一个Python包的MATLAB命令窗口使用编程方法,明白了使用compiler.build.pythonPackage创建Python包。

  1. 在MATLAB应用程序选项卡,最右边的应用程序部分,单击箭头。在应用程序部署,点击库的编译器。

    或者,您可以打开库的编译器应用MATLAB命令提示符。

    libraryCompiler

    开着库编译器应用程序编译器选项卡

  2. 在类型将来发布的部分,点击Python包。

    在库的编译器应用项目窗口中,指定你想要的文件MATLAB应用程序的部署。

    1. 在导出功能将来发布的部分,点击将导出的函数添加到项目中。

    2. 在添加文件窗口,浏览文件夹,并选择你想要的功能包。点击开放。

    导出函数的函数添加到列表的文件。重复这一步骤将多个文件打包在同一个应用程序中。

    对于这个示例,选择makesqr.m文件,你早些时候写道。

  3. 在包装选项将来发布的部分,决定是否包括MATLAB运行时安装程序在生成的应用程序通过选择其中一个选项:

    • 运行时从web下载——生成一个下载的安装程序MATLAB运行时部署和安装以及MATLAB应用程序。您可以指定安装程序的文件名。

    • 运行时包含在包——包括生成一个应用程序MATLAB运行时安装程序。您可以指定安装程序的文件名。

      请注意

      第一次您选择此选项,提示您下载MATLAB运行时安装程序。

指定包设置

接下来,定义您的Python包的名称。

  • 选择一个名称为您的包。的库名称字段是自动填充makesqr包的名称。重命名它为MagicSquarePkg。有关命名要求Python包的更多信息,见进口编译Python包。

创建示例驱动程序文件

你可以将MATLAB文件添加到项目生成样本Python驱动程序文件。尽管Python驱动程序文件没有必要创建一个包,您可以使用它们来实现一个Python应用程序,如图所示安装和运行MATLAB生成的Python应用程序。

在样品部分中,选择创建新的样本,然后单击makesqr.m。MATLAB文件打开编辑。

%的示例脚本演示执行函数y = makesqr (x)x = 0;%初始化xy = makesqr (x);

改变x = 0来x = 5保存文件,并返回到库的编译器应用程序。

和限制的更多信息,参见示例驱动文件创建。

自定义应用程序和它们的外观

在库的编译器应用程序,您可以自定义安装程序,自定义您的应用程序,并添加更多关于应用程序的信息。

  • 图书馆信息——关于部署的应用程序的信息。你也可以定制应用程序通过改变应用程序的外观图标和闪屏。生成安装程序使用这些信息来填充已安装的应用程序的元数据。看到自定义安装程序。

  • 额外的安装选项——默认安装路径生成安装程序和自定义标识的选择。看到更改安装路径。

  • 你的图书馆运行所需文件——所需的附加文件生成的应用程序运行。这些文件包括在生成的应用程序的安装程序。看到管理所需的文件在编译器项目。

  • 文件为您的终端用户安装——文件安装您的应用程序。

    看到指定文件的安装与应用程序。

编译器在图书馆领域的应用程序定制您的应用程序

打包应用程序

当你选择完你的包装选择,保存库的编译器项目和生成打包应用程序。

  1. 点击包。

    保存项目对话框中,指定位置保存项目。

  2. 在包对话框,确认打开流程完成时输出文件夹被选中。

    包装过程完成时,检查目标文件夹中生成的输出。

    • 三个文件夹生成:for_redistribution,for_redistribution_files_only,for_testing。

      关于生成的文件的更多信息在这些文件夹,看到的文件生成后包装MATLAB函数。

    • 日志文件PackagingLog.html包含包装的结果。

创建Python包使用compiler.build.pythonPackage

作为替代库的编译器应用,您可以创建一个Python包使用编程方法。如果您已经创建了一个包使用库的编译器,请参阅安装和运行MATLAB生成的Python应用程序。

  1. 将下面的代码保存在一个示例文件命名makesqrSample1.m:

    x = 5;y = makesqr (x);

  2. 建立使用Python包compiler.build.pythonPackage函数和makesqr.m文件,你早些时候写道。使用名称-值参数指定包名和添加一个示例文件。

    buildResults = compiler.build.pythonPackage (“makesqr.m”,…“PackageName”,“MagicSquarePkg”,…“SampleGenerationFiles”,“makesqrSample1.m”,…“详细”,“上”);

    您可以指定附加选项compiler.build命令通过使用名称-值参数。有关详细信息,请参见compiler.build.pythonPackage。

    的compiler.build.Results对象buildResults包含在构建信息类型,生成的文件,包括支持包,并构建选项。金宝app

  3. 函数生成下列文件在一个文件夹命名MagicSquarePkgpythonPackage在当前工作目录中:

    • 样品\ makesqrSample1.py——Python示例应用程序文件。

    • GettingStarted.html——HTML文件,其中包含的信息整合您的软件包。

    • included金宝appSupportPackages.txt文本文件,列出所有支持文件包含在包中。金宝app

    • mccExcludedFiles.log日志文件,包含任何工具箱函数的列表,并不包括在应用程序。不受支持的功能的信息,请参阅金宝appMATLAB编译器限制。

    • 固定——文本文件,其中包含包装和接口信息。

    • requiredMCR下载188bet金宝搏Products.txt——文本文件,其中包含产品id所需的产品下载188bet金宝搏MATLAB运行时运行该应用程序。

    • setup . py——Python文件,安装包。

    • unresolvedSymbols.txt——文本文件,其中包含的信息未解决符号。

    请注意

    生成的包不包括MATLAB运行时或一个安装程序。创建一个安装程序使用buildResults对象,看到compiler.package.installer。

安装和运行MATLAB生成的Python应用程序

在创建您的Python包,您可以把它从一个Python程序。下面的例子使用了样品在包装Python代码生成。您可以使用该示例的Python应用程序代码作为一个指南编写自己的应用程序。

  1. 复制和粘贴Python文件生成的makesqrSample1.py从样品包含文件夹的文件夹setup . py文件。

    的项目清单makesqrSample1.py如下所示。

    # !/usr/bin/env python”“”示例脚本,该脚本使用MagicSquarePkg模块使用MATLAB编译器创建的SDK。请参阅MATLAB编译器SDK文档以了解更多信息。”“从__future__进口print_function进口MagicSquarePkg导入matlab my_MagicSquarePkg = MagicSquarePkg.initialize()鑫= matlab.double([5.0],大小=(1,1))你= my_MagicSquarePkg.makesqr(鑫)打印(你,9 = ' \ n ') my_MagicSquarePkg.terminate ()

  2. 在系统命令提示符,导航到包含的文件夹makesqrSample1.py和setup . py。

  3. 安装应用程序使用python命令。

    python的设置。py安装

    除了默认的安装位置,参考“安装Python模块”官方Python文档。

  4. 在系统命令提示符运行应用程序。

    python makesqrSample1.py

    如果你使用MATLAB代码样本包装步骤,这个应用程序返回相同的输出示例代码。

    [[17.0,24.0,1.0,8.0,15.0),(23.0,5.0,7.0,14.0,16.0),(4.0,6.0,13.0,20.0,22.0),(10.0,12.0,19.0,21.0,3.0),(11.0,18.0,25.0,2.0,9.0)]

    请注意

    在macOS,你必须使用mwpython脚本而不是python。例如,mwpython makesqrSample1.py。

    的mwpython脚本位于matlabroot/ bin文件夹,matlabroot的位置是你的MATLAB或吗MATLAB运行时安装。

另请参阅

||||