pyclickimage.ClickImageApp

class pyclickimage.ClickImageApp(image: ndarray | None = None, output: str | None = None)

Bases: QMainWindow

PyQt application for collecting precise mouse clicks on images.

Features

• Subpixel precision (float coordinates)

• Optional integer rounding mode

• Multiple click groups

• CSV export/import

• Real-time overlay rendering

_append_log(msg: str)

Append log message.

_format_value(v)

_init_ui()

Build full interface layout.

_process_left_click(x: float, y: float)

Store click.

_process_right_click(x: float, y: float)

Store placeholder click.

choose_color()

clear_logs()

Clear log message.

closeEvent(event)

Confirm exit if unsaved.

crosshair_choose_color()

get_selected_colormap()

Get the selected colormap for displaying the image.

Returns:

The selected colormap.

Return type:

str

on_add_group()

Create a new click group.

on_colormap_changed(index)

Called when the user selects a different colormap.

on_delete_group()

Delete current group with safety checks.

on_display_clicks_changed(state)

Toggle dispaly clicks.

on_group_changed(name)

Switch active group.

on_half_shift_changed(state)

Toggle half-shift mode.

on_load_clicks()

Load clicks from CSV and replace current data.

on_load_image()

Load an image from file dialog.

If clicks already exist, ask user whether to clear them or keep them.

on_marker_size_changed(value: str)

Update marker size.

on_precision_changed(state)

Toggle integer/float precision mode.

on_rename_group()

Rename current group.

on_undo_all_click()

Remove all click from current group.

on_undo_last_click()

Remove last click from current group.

save_as_csv()

save_csv()

Save clicks to CSV.

set_image(image: ndarray | None)

Set image to display.

update()

Refresh UI.

update_groups()

Sync group selector.

update_table()

Update table with current group points.

update_viewer()

Render image + clicks.