The pod5Viewer is a Python application that provides a graphical user interface for viewing and navigating through POD5 files. It allows users to open multiple POD5 files, explore their contents, and display detailed data for selected read IDs.
For Windows systems the pod5Viewer can be installed conveniently via the installer. The installer can be downloaded here:
After downloading the installer and following the steps provided, the pod5Viewer can be accessed and opened from the start menu or the desktop shortcut. It also sets the pod5Viewer as the standard application to open POD5 files, so it is possible to open a file by simply clicking on it.
Note: When running the installer a the Windows defender might open the Window Windows protected your PC
. To continue the installation, press More Info
and Run anyway
.
DEB files are available for Ubuntu 22.04 & 24.04 and Linux Mint 20.3 & 21.3 at the following links:
After downloading use apt to install it on the system:
sudo apt install ./pod5viewer_1.0.2_<SYSTEM>.deb
Like the Windows installation, the pod5Viewer can then be opened like any other installed application.
The pod5Viewer can be installed via the Python packaging index using pip
.
Note that when installing the pod5Viewer via pip, it can only be started from the command line. It is not possible to open POD5 files directly from a file browser.
Here we recommend installing the pod5Viewer into a fresh virtual environment via Conda or a similar environment manager:
conda create -n p5v python==3.11
conda activate p5v
With the virtual environment active, the pod5Viewer can be installed via pip:
pip install pod5Viewer
To start the pod5Viewer from a python environment type:
pod5Viewer
Optionally specify one or more path(s) to POD5 file(s) to open these directly:
pod5Viewer file1.pod5 file2.pod5
Alternatively, the pod5Viewer can be installed from source:
git clone https://github.com/dietvin/pod5Viewer.git
cd pod5Viewer
pip install .
The pod5Viewer is built in Python (v3.11.0) and relies on the following packages:
- pod5 (v0.3.10)
- pyside6 (v6.5.2)
- plotly (v5.22.0)
- pyyaml (v6.0.1)
The compliation for Windows was performed using the pyinstaller (v6.8.0) and the Windows installer was created using the Inno Setup Compiler (v6.3.1).
In the pod5Viewer open files from the menu bar in the top via File > Open file(s)...
(individual file(s)) or File > Open directory
(all files in a directory). All opened files are shown in the left panel. Expanding an entry shows all reads in a given file by their read ID.
A single click on a read ID opens the entry as a preview (i.e. it gets overwritten once another entry is selected). A double click opens it permanently, so multiple reads can be opened at the same time. Tabs can be closed via the X
symbol. A tab shows all attributes stored in a pod5 file as key-value pairs. Nested information can be expanded. Values can be selected via double-click and copied to the clipboard.
Opened files and reads can be cleared from the window through File > Clear
. To exit the app use File > Exit
.
Individual current measurement can be inspected via View > View signal...
. This shows the current values in chunks of 100. Use the scroll bar to scroll through chunks.
To plot the current measurements select View > Plot signal...
, View > Plot pA signal...
or View > Plot normalized signal...
. Signals can be plotted for a single read (Focussed read...
) or all opened reads (All open reads...
). The plots are interactive and allow for zooming, panning, hiding specific reads, and exporting. Downsampling is used for long signals for better performance.
Either all opened reads (Export all opened reads...
) or only the currently focused one (Export current read...
) can be exported to YAML format using via File > Export
. When exporting, the user selects an output directory in the file browser, in which a YAML file is created for each exported read with the read-id as the file name.
Various keyboard shortcuts are available, allowing for all actions to be performed without a mouse. The following shortcuts are implemented:
- Ctrl+O: Open file(s)
- Ctrl+D: Open directory
- Ctrl+S: Export current read
- Ctrl+A: Export all opened reads
- Ctrl+Backspace: Clear viewer
- Ctrl+Q: Exit application
Navigation:
- Tab: Switch between file navigator and data viewer
- Ctrl+Tab: Cycle through tabs in the data viewer
- Ctrl+W: Close the current tab in the data viewer
Menu navigation:
- Alt & F: Open the file menu
- Alt & V: Open the view menu
- Alt & H: Open the help menu
View signal window:
- Pagedown: Scroll down (large steps)
- Pageup: Scroll up (large steps)
- Arrow down: Scroll down
- Arrow up: Scroll up
When plotting many reads at a time the figure can become too large for displaying it in the plot window and it may show a white screen only. This is due to limitations of the plotly framework. The limit for this is around 40000 measurements in one plot, if this number is exceeded a warning pops up when opening the plot window. If a plot does not show, it is recommended to plot fewer reads at a time.
This project is licensed under the GPL3.0 License. See the LICENSE file for details.