Imaris开放-常见问题

系统需求

在这里找到Imaris Open的推荐硬件要求

要使用Imaris XT，你的Imaris 7.3或更高。

最常用的Imaris XTensions是用MATLAB编写的。最近，Imaris添加了Python脚本及其插件的简单集成。

Imaris的可用变量可以在编程参考手册Help > programming Interface中找到。

如何安装下载的XTension?

个人电脑用户

将XTension集成到Imaris中的第一步是指定带有下载的XTension文件的文件夹。为此，在“编辑”菜单下，选择“首选项”，然后选择“自定义工具”选项。在XTension Folders选项下，单击Add按钮将下载的XTension文件路径添加到列表中。之后，就可以使用所选文件夹中的所有xtension了，不需要额外的步骤。

请确保Python可执行文件的路径设置正确。

Mac用户

将XTension集成到Imaris中的第一步是指定带有下载的XTension文件的文件夹。为此，转到首选项，然后选择自定义工具选项。在XTension Folders选项下，单击Add按钮将下载的XTension文件夹的路径添加到列表中。之后，就可以使用所选文件夹中的所有xtension了，不需要额外的步骤。

请确保Matlab/ Python可执行文件的路径设置正确。

如何加入Imaris XT开发者计划?

从起始页，单击位于左手菜单中的“成为开发人员”按钮。一旦您完成了申请表格并被Bitplane支持团队接受，您就可以开始提交您的XTensions。

编码规则是什么?

本指南面向开发人员，涵盖了Imaris中MATLAB/Python脚本集成的技术细节。

它提供了一个循序渐进的过程，如何建立MATLAB/Phyton和Imaris之间的连接，以及如何嵌入一个新开发的MATLAB/Python脚本作为XTension函数。

请注意:

如果您是MATLAB开发人员，请参阅文档中题为MATLAB代码规则的部分。
如果您是Python开发人员，请参阅文档中名为Python代码规则的部分。
当您构建一个扩展时，您可以从头开始，或者下载Matlab / Python XT示例Xtension并修改它
当从零开始构建XTension时，请参考MATLAB/Python代码示例页面，了解如何构建它。
为了确保Imaris可以在用户启动XTension时启动MATLAB/ Python脚本，需要一个安装步骤。
在下一节中，我们将描述这些更改，并展示将Matalb/ Python代码或XT示例转换为新的XTension所需的代码示例。

1.从Imaris Open下载XT示例XTension，并解压。
2.在“Edit -> Preferences -> CustomTools”下添加文件夹位置到Imaris，并将文件夹位置添加到“XTension folders”
3.XTexample开放。在MATLAB

要在预定义配置之外扩展Imaris接口，必须在MATLAB文件中添加一个特殊的头文件。

由于这个MATLAB/Phyton函数不再在MATLAB/Python界面中启动，MATLAB/Python文件中有几行需要调整:

一个注释的xml结构，其中定义了新命令以及Imaris菜单中的位置。
连接到Imaris和MATLAB/Python接口的几行
定义vImarisApplication变量的行
要调用的MATLAB/Python函数必须与包含该函数的MATLAB/Python文件具有相同的名称。它是脚本的入口点。

4.将XTension的名称从XT示例更改为您喜欢的名称。这必须在文件开头的XML部分(MatlabXT::XTexample(%i))和函数定义(function XTexample(aImarisApplicationID))中完成。
5.调整工具提示和XTension的描述
6.删除“XTension特定代码从这里开始”这一行下面的所有代码。对于所有xtension，函数定义(函数XTexample(aImarisApplicationID))和该行之间的整个代码是相同的。
7.实现XTension。有关如何编写XTensions的详细信息，请参阅Imaris Programming Interface或ImarisOpen页面。
8.最后，将您的文件重命名为您在上面步骤中选择的XTension的新名称。注意，文件必须以.m./p结尾

上传XTension的推荐文件有哪些?

要上传新创建的XTension，需要创建一些额外的文件。

如果您有机会编译您的XTension并使其可供其他用户使用，请将已编译的exe/app和xml文件包含在ZIP文件夹中。

即使MATLAB没有安装在终端用户的系统上，也可以使用MATLAB编译器组件生成的XTension。

注意:如果你选择了这个选项，请使用编译好的XTension来部署ImarisLib.jar。

编写您自己的说明文档或修改HowToTest.txt文件，说明如何使用您的XTension。

创建可用于测试XTension的示例图像。或者，在HowToTest.txt中描述一种方法来测试您的XTension与Imaris的一部分的图像之一。

创建一个或几个有意义的屏幕截图来说明XTension结果

创建一个zip文件包含您的XTension(*。M文件，最好编译XTension文件*.exe和*.xml)， HowToTest.txt文件和示例图像。

将zip文件和截图上传到ImarisOpen。

请注意一旦您的XTension被提交，您将不能进行任何修改，直到它通过了审查过程。

在您的XTension被ImarisOpen团队验证后，它将在ImarisOpen XTension Exchange页面上可用。

审批流程有哪些步骤?

xtension审批流程的总体目标是为Imaris用户提供一个全面、安全、结构化的xtension库。

为了满足对信誉度的高要求，我们的手工审批流程涉及到XTensions的验证、验证和验收测试。

后续步骤在审批过程中执行:

检查和检查源代码
根据Bitplane要求评估源代码
评估信息的质量/所包含的与用户相关的基本信息
伊万里瓷器集成测试
程序执行
设置验证标志

核实过程需要多长时间?

所有上传的xtension都需要手动验证，这可能需要几天时间才能完成。如果我们的支持团队在已经提交的信息上还需要额外的信息，这可能会增加我们的验证时间。请确保您所有的联系方式正确，以便我们在需要时与您取得联系。

XTension批准状态

在您的开发人员配置文件页面的顶部，您将发现您提交的XTension的状态。以下标签将解释该状态:

批准

如果您的x张力满足我们的要求，它是批准的，并可在x张力交易所列表。

额外的审查

为了完成审查，我们的支持团队可能会要求提供额外的信息，然后您的XTension将被列出来进行额外审查。请注意，一旦重新提交XTension以进行额外审查，您就不能对它进行任何更改。

如果XTension不满足我们的最低标准和质量准则/要求，它将不会被批准。

如果XTension未能满足标准，我们的支持团队可以拒绝它，或者将其标记为等待反馈，并将其传递给用户进行修改

否认

您的XTension审核已经完成，但您提交的文件不符合要求。

如何修改已上传的XTension?

一旦XTension被批准，用户可以通过进入他们的配置文件在任何时候修改XTension。确认更改将从XTension Exchange列表中删除XTension，并提交给进一步批准。

如果修改被接受，XTension再次被批准，它将再次在Exchange列表中可用，其评论和评级将不受影响。

但是，如果修改被评估为重要且足以支持新的上传，支持部将拒绝提议的修改，并请求在其位置上上传新的XTension。在这种情况下，评论和评分将不会被保留。

所有变更请求必须通过电子邮件发送给我们的支持团队以获得批准。如果您的XTension需要额外的审查，请作出适当的更改，以确保您所做的修改符合我们的指导方针和要求。

任何修改x张力的请求都必须明确定义和描述，包括要进行的更改以及修改的问题或原因。

一旦您的XTension状态发生变化，将发送一封电子邮件通知您这一变化以及任何问题或变化的原因(如果适用)。

如果没有收到验证电子邮件怎么办?

有可能您的电子邮件垃圾或垃圾邮件过滤器已经捕获了验证邮件，所以首先检查那里。

否则，如果您在上传xtension后48小时内没有收到电子邮件，请通过本页面导航栏的“支持”选项卡联系客户服务。

我能对分类提出一些建议吗?

Imaris Open的类别也在不断发展，以应对不断增加的XTensions。我们尽力提供一个很好的分类，以适合所列出的所有XTensions。如果您认为XTension值得在一个新的类别，请让我们知道您的建议。你也可以在我们的论坛上发表你的反馈。

如果您不确定在哪里发布您的XTension，一个好的起点是查看其他相关的XTension，并找出它们是如何列出的。