Package: rdplot
RDPlotRDPlot is a tool for plotting rate distortion curves.
In particular, it canParse the output of reference software such as HM, SHM, or VTM.Parse data points from xml-formatted files.Parse data from csv-formatted files.Calculate Bjontegaard Delta statistics.Export plots and BD statistics for camera ready presentation.It was developed along the design principle of easy extensibility.
If no parser for your data is available, you can consider to introduce anew parser.
If you feel like your parser would be of interest for others, please submit a PR.Build statusAppVeyorGitHub ActionsCode CoverageInstallationInstallation via pipxWindows installerIn the following sections different installation strategies are outlined:Installation via pipxRDPlot is available onPyPi.
Therefore, you can directly install RDPlot viapipx:pipx install rdplotThis should work on all platforms.
However, on Apple silicon you might have to fiddle a bit and use Rosetta.Windows installerFor Windows an installer is available on the release page.
The installer will install a released version.
If you want to install the most recent (unreleased) version, you can download the installer fromAppveyor’s artifacts.Building from SourceWe assume that you are familiar to Python development for the following sections.
If you run into any problems, don’t hesitate to use theIssue tracker.Virtual EnvironmentMac OS XVirtual EnvironmentIf you need system packages that conflict with the packages required for RDPlot, you can use a python virtual environment (see below).When you are inside a virtual environment, python ignores all system packages and instead uses a dedicated environment, allowing you to install packages with pip that would otherwise conflict with system packages and/or different versions. The pitfall is that you need to activate the environment each time you want to use the program.You can find more info on virtual environments athttps://packaging.python.org/guides/installing-using-pip-and-virtual-environments/.venv is included in python since version 3.3. If your python version is older consider upgrading, or install venv using:sudo pip install virtualenvDownload RDPlot. Make sure you do this at a place where it can stay:git clone --depth 1 https://github.com/IENT/RDPlot
cd RDPlotCreate a virtualenv named “env” inside the RDPlot directory:python3 -m venv envActivate the venv and install dependencies:source env/bin/activate
pip3 install --upgrade pip gitpythonBuild and install RDPlot:python3 setup.py sdist
pip3 install --no-binary rdplot --upgrade dist/rdplot-*.tar.gzLeave the environment:deactivateRemember to activate the environment every time you want to run RDPlot:cd RDPlot
source env/bin/activate
rdplot
deactivateTo uninstall, simply delete the RDPlot directory.Mac OS XNote:things are not tested for Mac. You may have to fiddle a little bit.
Please contribute, if you have ideas for improvements.First of all you need to install python3.
You can get ithere.
If you are using Homebrew you can alternatively install python3 via console:brew install python@3.9Moreover, install all the requirements:cd src/rdplot
pip3 install -r requirements.txtAdditionally install py2app:pip3 install py2appThen navigate back to the top level and build an app in alias mode:cd ../..
python3 setup.py py2app -ANow you should have an app in the dist folder.Note:This app contains hard links to the directory with the source.
It is strongly recommended to clone the whole directory to your Applications folder.
Then you can simply build the app and launch it from the internal search.
Another possibility is to put an alias in your Applications folder and/or attach it to the Dock.If you want to update the app, it is fairly easy:
Navigate to the local copy of the repository (now most probably in your Applications folder) and then:git pull
python3 setup.py py2app -ADone!Uninstall is also simple: Just delete the local copy of the repositories and all aliases.Running from repository without installationIf you want to help improving RDPlot, you most probably need to run it directly from source for development and testing.LinuxYou can start RDPlot from the command line with:PYTHONPATH=~PATH_TO_RDPLOT/src/ python3 PATH_TO_RDPLOT/src/rdplot/__main__.pyIf you want to start the tool out of an IDE, make sure that you have set the PYTHONPATH environment variable correctly.