用于测试和演示的示例hep文件
scikit-hep-testdata的Python项目详细描述
SCIKIT HEP测试数据
提供示例文件(e.g的公共包。用于测试和开发包。 文件的示例代表了“在野外”找到的典型文件。
除了直接包含一些根文件外,这个包还添加了一些简单的helper方法 从常见的开放存取数据存储库中获取更大的文件。
安装和使用
要安装:
pip install scikit-hep-testdata
安装后,可以使用helper方法解析绝对文件路径:
fromskhep_testdataimportdata_pathfilename=data_path("some_file.root")
默认情况下,如果请求未知文件,则会引发异常,但可以通过传递上述方法raise_missing=False
:
filename=data_path("unknown_file.root",raise_missing=False)
远程文件与本地文件
例如,一些文件,特别是大文件,不存储在这个包中,而是存在于远程服务器上;我们称这些文件为“远程文件”。
要获得这些文件,请使用与上面相同的data_path
方法,但是这将触发下载和配置远程文件的代码。
第一次可能会比较慢,但随后会像本地文件一样快。
命令行调用
您还可以通过命令行与此软件包进行交互:
python -m skhep_testdata cms_hep_2012_tutorial/data.root
添加新文件
我们正在寻找新的,有趣的文件!
- large files:如果文件特别大,例如>;25 MB,则可能需要将其添加到外部开放访问数据存储库中,并在此处添加配置,以便内部帮助程序方法可以将其下拉。
- 实验数据策略:请确保您具有将文件添加到此集合的权限,并且任何私有或敏感数据都已被适当屏蔽、转换或加扰。
文件列表
以下列表描述了此包已知的文件。
存储在此包中的文件
已知远程文件
致谢
- 这个包中直接收集的许多文件最初是由jim pivarski为uproot 整理的。
运行测试
这个包使用pytest
来运行单元测试。
pytest -vv tests/
使用pytest cov插件获取测试覆盖率报告:
pytest --cov=skhep_testdata --cov-report=html -vv tests/