公共D3M原语

为D3M项目维护的一组公共原语。它包含示例原语、各种粘合原语以及其他贡献者的原语。

安装

此包适用于Python 3.6+和pip 19+。

此包有额外的依赖项，这些依赖项在原语的元数据中指定，但如果你是手动安装此包，你首先需要运行，对于Ubuntu

$ apt-get install libopenblas-dev ffmpeg
$ pip3 install python-prctl

要从克隆的存储库内部安装公共原语，请运行

$ pip3 install -e .

在克隆存储库时，递归克隆以获取git子模块

$ git clone --recursive https://gitlab.com/datadrivendiscovery/common-primitives.git

变更日志

查看HISTORY.md了解此包更改的摘要。

存储库结构

master分支包含针对最新稳定版本的D3M核心包（其master分支）的最新公共原语代码。 devel分支包含针对D3M核心包未来版本（其devel分支）的最新公共原语代码。

版本是通过标签进行标记的，但它们并不是定期发布的。每个原始组件都有自己的版本，这些版本与包版本无关。通常，最好是使用master或devel分支（取决于您使用的核心包版本）中可用的最新代码。

本地测试

对于此存储库的每次提交，都会在GitLab CI中自动运行测试。

如果您不想等待GitLab CI测试结果并在本地运行测试，您可以在您的系统中安装并使用GitLab runner。

使用本地GitLab runner，您可以运行此存储库的.gitlab-ci.yml文件中定义的测试，例如

$ gitlab-runner exec docker style_check
$ gitlab-runner exec docker type_check

您也可以通过运行来尝试运行位于/tests下的测试

$ python3 run_tests.py

贡献

欢迎您向此存储库贡献更多原始组件。我们的目标是构建一套通用的原始组件，这不仅可以作为示例，还可以共同维护一些原始组件，特别是胶水原始组件。

所有原始组件都使用Python 3编写，并使用mypy进行类型检查，因此需要类型注解。

关于数据驱动发现计划

DARPA数据驱动发现（D3M）计划正在研究让机器自动构建机器学习管道的方法。它分为三个层次：TA1（原始组件）、TA2（将原始组件自动组合成管道并执行它们的系统）和TA3（最终用户界面）。