率失真曲线的绘图工具
项目描述
RD绘图
RDPlot 是一个绘制率失真曲线的工具。特别是,它可以
解析参考软件的输出,例如 HM、SHM 或 VTM。
从 xml 格式的文件中解析数据点。
从 csv 格式的文件中解析数据。
计算 Bjontegaard Delta 统计数据。
导出绘图和 BD 统计数据以进行相机准备演示。
它是按照易于扩展的设计原则开发的。如果您的数据没有可用的解析器,您可以考虑引入一个新的解析器。如果您觉得您的解析器会引起其他人的兴趣,请提交 PR。
构建状态
应用程序 |
GitHub 操作 |
|---|---|
代码覆盖率
安装
<nav class="本地内容" id="contents"> </nav>以下部分概述了不同的安装策略:
通过 pipx 安装
RDPlot 在PyPi上可用。因此,您可以直接通过 pipx 安装RDPlot:
pipx install rdplot
这应该适用于所有平台。但是,在 Apple 芯片上,您可能需要稍作调整并使用 Rosetta。
Windows 安装程序
对于 Windows,发布页面上提供了安装程序。安装程序将安装已发布的版本。如果要安装最新(未发布)版本,可以从Appveyor 的 artifacts下载安装程序。
从源头构建
我们假设您熟悉以下部分的 Python 开发。如果您遇到任何问题,请不要犹豫,使用问题跟踪器。
<nav class="本地内容" id="topic-1"> </nav>虚拟环境
如果您需要与 RDPlot 所需的包冲突的系统包,您可以使用 python 虚拟环境(见下文)。
当您在虚拟环境中时,python 会忽略所有系统包,而是使用专用环境,允许您使用 pip 安装包,否则会与系统包和/或不同版本发生冲突。陷阱是每次要使用程序时都需要激活环境。
您可以在https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/找到有关虚拟环境的更多信息。
venv 从 3.3 版开始包含在 python 中。如果您的 python 版本较旧,请考虑升级,或使用以下命令安装 venv:
sudo pip install virtualenv
下载 RDPlot。确保在它可以停留的地方执行此操作:
git clone --depth 1 https://github.com/IENT/RDPlot cd RDPlot
在 RDPlot 目录中创建一个名为“env”的虚拟环境:
python3 -m venv env
激活 venv 并安装依赖项:
source env/bin/activate pip3 install --upgrade pip gitpython
构建并安装 RDPlot:
python3 setup.py sdist pip3 install --no-binary rdplot --upgrade dist/rdplot-*.tar.gz
离开环境:
deactivate
记住每次要运行 RDPlot 时都要激活环境:
cd RDPlot 源环境/bin/激活 rdplot deactivate
要卸载,只需删除 RDPlot 目录。
Mac OS X
注意:未针对 Mac 进行测试。你可能需要稍微摆弄一下。请贡献,如果您有改进的想法。
首先你需要安装python3。你可以在这里得到它。如果您使用的是 Homebrew,您也可以通过控制台安装 python3:
brew install python@3.9
此外,安装所有要求:
cd src/rdplot pip3 install -r requirements.txt
另外安装py2app:
pip3 install py2app
然后导航回顶层并以别名模式构建应用程序:
cd ../.. python3 setup.py py2app -A
现在你应该在 dist 文件夹中有一个应用程序。
注意:此应用程序包含指向源目录的硬链接。强烈建议将整个目录克隆到您的 Applications 文件夹。然后,您可以简单地构建应用程序并从内部搜索启动它。另一种可能性是在您的应用程序文件夹中放置一个别名和/或将其附加到 Dock。
如果您想更新应用程序,这很容易:导航到存储库的本地副本(现在很可能在您的 Applications 文件夹中),然后:
git pull python3 setup.py py2app -A
完毕!
卸载也很简单:只需删除存储库的本地副本和所有别名。
从存储库运行而无需安装
如果您想帮助改进 RDPlot,您很可能需要直接从源代码运行它以进行开发和测试。
Linux
您可以使用以下命令从命令行启动 RDPlot:
PYTHONPATH=~PATH_TO_RDPLOT/src/ python3 PATH_TO_RDPLOT/src/rdplot/__main__.py
如果要从 IDE 启动该工具,请确保已正确设置 PYTHONPATH 环境变量。