Skip to content

copick stats picks

core

Display statistics about picks.

Usage

copick stats picks [OPTIONS]

Description

Aggregates pick annotations across the project and reports the total number of individual picks and pick files, along with their distribution by run, user, session, and pickable object. Results can be filtered to specific runs, users, sessions, or objects, and printed as a human-readable table or as JSON.

Options

Option Type Default Description
-c, --config path — Path to the configuration file.
--runs text · multiple — Specific run names to analyze. Can be specified multiple times.
--user-id text · multiple — Filter by user ID. Can be specified multiple times.
--session-id text · multiple — Filter by session ID. Can be specified multiple times.
--object-name text · multiple — Filter by pickable object name. Can be specified multiple times.
--parallel / --no-parallel boolean flag True Enable parallel processing.
--workers integer 8 Number of workers for parallel processing.
--output choice (json | table) table Output format.
--debug / --no-debug boolean flag False Enable debug logging.

Examples

# Summarize every pick in the project
copick stats picks --config config.json

# Restrict the summary to specific runs
copick stats picks --config config.json --runs TS_001 --runs TS_002

# Filter by object and user, then emit JSON using parallel workers
copick stats picks --config config.json --object-name ribosome --user-id alice \
    --output json --parallel --workers 12

See also