Skip to content

copick stats meshes

core

Display statistics about meshes.

Usage

copick stats meshes [OPTIONS]

Description

Aggregates mesh annotations across the project and reports the total number of meshes, their distribution by user, session, and pickable object, and the most frequent session/user/object combinations. 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 mesh in the project
copick stats meshes --config config.json

# Filter by user and session
copick stats meshes --config config.json --user-id analyst --session-id session1

# Emit JSON for integration with other tools
copick stats meshes --config config.json --output json

See also