面向python的oml客户端模块
oml4p的Python项目详细描述
这是基于oml文本的oml度量库的python模块。 协议[OML文本]。
安装
使用pip[oml4py pypi]安装:
$ pip install oml4py
或者下载软件包并运行:
$ python setup.py install
用法
此模块提供omlbase类,该类包含以下方法:
- 初始化
- 开始
- 地址
- 注入
- 关闭
要在python项目中使用oml,请导入omlbase类:
from oml4py import OMLBase
首先初始化omlbase对象。init方法最多需要4个 参数:
- 应用程序的名称,
- 实验名称,
- 节点的名称,
- 以及tcp:hostname:port 格式的oml服务器uri
例如:
x=OMLBase("app", "an-exp","r","tcp:myomlserver.com:3003")
唯一的强制参数是第一个参数( 应用程序)。如果跳过其他任何一个,它们可以定义为 环境变量(oml_domain、oml_name、oml_collect)或通过 命令行选项。如果这些变量未显式传入 命令行选项和环境变量都不是 然后应用程序将在禁用oml的情况下运行,并且 本应发送给OML的测量结果将打印在 取而代之的是标准输出。
接下来,添加一个或多个测量点。传递度量值的名称 指向start方法并指向架构字符串。架构字符串应该 按格式 measurement_name1:measurement_type1 measurement_name2:measurement_type2 例如:
x.addmp("fft", "freq:long amplitude:double fft_val:double")
设置完所有测量点后,请调用start():
x.start()
当你有一个测量点要发送到oml时,将它们存储在 然后传递测量点的名称和 要注入的值,如下所示:
x.inject("fft", (259888, 15, -38))
在程序结束时,调用close以优雅地关闭数据库:
x.close()
许可证
版权所有2012纽约大学保利,弗雷达基金
版权所有2012-2013澳大利亚国家信息通信技术局(NICTA),澳大利亚
兹免费准许任何人取得副本 本软件和相关文档文件(“软件”)的 在软件中不受限制,包括但不限于 使用、复制、修改、合并、发布、分发、再授权和/或出售 软件的副本,并允许软件的用户 在满足以下条件的情况下,可以这样做:
上述版权公告及本许可公告须包括在 软件的所有副本或大部分。
本软件按“原样”提供,无任何形式的保证,明示或 默示的,包括但不限于适销性保证, 适合特定目的和不侵权。在任何情况下 作者或版权所有者应对任何索赔、损害或其他 责任,无论是在合同诉讼、侵权诉讼或其他诉讼中, 不属于或与软件、使用或其他交易有关 软件。
[OML文本]:http://oml.mytestbed.net/projects/oml/wiki/Description_of_Text_protocol [oml4py pypi]:http://pypi.python.org/pypi/oml4py/