PyQC

A tool for reviewing QC images and storing ratings.

Installation

This project uses uv for Python package management.

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

Running

# Show help
uv run pyqc --help

# Review specific images
uv run pyqc image1.jpg image2.png

# Review all images in a directory
uv run pyqc --directory /path/to/images

# Load from CSV (resumes from first unrated image)
uv run pyqc --csv ratings.csv

Usage

Load data via either the command line or the open files open directory function.

Use the numeric keys on the keybord to assign that score to current image.

Use w and s or / and * to navigatge up and down the list without assigning a rating. Use . to undo previous rating. + and - control image zoom.

Usage

Load data via the command line or use the GUI menu options:

• Open Directory: Load all images from a folder
• Open Files: Select specific image files
• Open CSV: Load a previous CSV file and resume reviewing

Keyboard Shortcuts

Key(s)	Action
0-9	Assign rating (alternates between QC_Raw and QC_Pre)
W or /	Navigate up without rating
S or *	Navigate down without rating
.	Undo - go back and clear previous ratings
+/-	Zoom in/out
Mouse wheel	Zoom in/out

View Control Settings

• Menu->Fit to page
• Menu->Full size

Development notes

To re-generate GUI:

First, use pyuic5 to automatically generate the python code from the user interface .ui file:

pyuic5 window1.ui -o window1.py

Then, modify window1.py as follows:

• import from image_widgets.py:

# Add the following:
from image_widget import *

• Switch from QtWidgets.QLabel to SaneDefaultsImageLabel:

# Replace (around line 90):
self.label = QtWidgets.QLabel(self.scrollAreaWidgetContents)

# with
self.label = SaneDefaultsImageLabel()

• Switch from scrollAreaWidgetContents to label:

# Replace (around line 100):
self.scrollArea.setWidget(self.scrollAreaWidgetContents)

# with
self.scrollArea.setWidget(self.label)