Imaris开放-常见问题

系统需求

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

要使用Imaris XT，要求您拥有Imaris 7.3或更高版本。

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

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

如何安装下载的XTension?

个人电脑用户

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

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

Mac用户

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

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

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

在开始页面中，单击位于左侧菜单中的becoming a Developer按钮。一旦你完成了申请表并且被Bitplane支持团队接受，你就可以开始提交你的XTensions了。

编码规则是什么?

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

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

请注意:

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

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

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

由于此MATLAB/Phyton函数不再在MATLAB/Python界面中启动，因此需要调整MATLAB/Python文件中的几行代码:

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

4.将XTension的名称从XT示例更改为您喜欢的名称。这必须在文件开头的XML部分(MatlabXT::XTexample(%i))和函数定义(function XTexample(aImarisApplicationID))中完成。
5.调整工具提示和XTension的描述
6.删除“特定于XTension的代码从这里开始”这一行下面的所有代码。函数定义(函数XTexample(aImarisApplicationID))和这一行之间的整个代码对于所有xtension都是相同的。
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中描述一种使用Imaris中的一个图像来测试XTension的方法。

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

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

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

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

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

审批过程有哪些步骤?

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

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

在审批过程中执行以下步骤:

审查和检查源代码
根据Bitplane需求评估源代码
评估所载信息/重要信息的质量，以确保其与用户的相关性
Imaris集成测试
程序执行
设置验证标志

核实过程需要多长时间?

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

扩展审批状态

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

批准

如果您的XTension符合我们的要求，则该XTension已被批准并可在XTension Exchange列表中使用。

额外的审查

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

如果XTension不符合我们的最低标准和质量指导方针/要求，它将不会被批准。

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

否认

您的XTension评审已经完成，但是您的提交不符合要求。

如何修改上传的XTension?

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

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

但是，如果这些修改被认为是重大的，并且足以证明需要重新上传，技术支持部将拒绝提议的更改，并要求在其位置上传一个新的XTension。在这种情况下，评论和评分将不会被保留。

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

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

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

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

可能是您的电子邮件垃圾邮件或垃圾邮件过滤器捕获了验证邮件，因此请先检查。

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

我能建议对分类做些改变吗?

Imaris Open中的类别在不断发展，以应对不断增加的xtension。我们尽最大努力提供一个好的分类，以适合所列出的所有XTensions。如果你觉得一个XTension应该被归入一个新的类别，请让我们知道你的建议。你也可以在我们的论坛上发表你的反馈。

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