CLI Module

The CLI module provides the command-line interface for wosecopy.

Commands Reference

extract

Extract wosecopy concepts from CSV file.

wosecopy extract INPUT_FILE [OPTIONS]

Options:

-o, --output PATH: Output CSV file path
--text-column TEXT: Name of column containing text (default: Story)
-l, --language [en|de]: Language (default: en)
--model-size [sm|md|lg]: Spacy model size (default: lg)
--similarity-threshold FLOAT: Minimum similarity (0-1)

metrics

Calculate network metrics.

wosecopy metrics INPUT_FILE [OPTIONS]

Options:

-o, --output PATH: Output JSON file
--concepts-column TEXT: Concepts column name (default: wosecopy_concepts)
--graph-type [chain|dense]: Graph type (default: chain)

export

Export graphs to files.

wosecopy export INPUT_FILE -o OUTPUT_DIR [OPTIONS]

Options:

-o, --output-dir PATH: Output directory (required)
--concepts-column TEXT: Concepts column name
--graph-type [chain|dense]: Graph type
-f, --format [graphml|gexf|gml]: Export format (default: graphml)
--prefix TEXT: Filename prefix (default: graph)

visualize

Visualize a concept network.

wosecopy visualize INPUT_FILE -o OUTPUT [OPTIONS]

Options:

-o, --output PATH: Output image file (required)
--concepts-column TEXT: Concepts column name
--graph-type [chain|dense]: Graph type
--index INTEGER: Story index to visualize (default: 0)

analyze-ratings

Analyze metrics by ratings.

wosecopy analyze-ratings INPUT_FILE --rating-column COLUMN [OPTIONS]

Options:

--rating-column TEXT: Rating column name (required)
--concepts-column TEXT: Concepts column name
-o, --output PATH: Output JSON file
--graph-type [chain|dense]: Graph type

compare

Compare metrics across raters.

wosecopy compare INPUT_FILE -r RATER1 -r RATER2 ... -o OUTPUT_DIR

Options:

-r, --rating-columns TEXT: Rating columns (multiple, required)
--concepts-column TEXT: Concepts column name
-o, --output-dir PATH: Output directory for plots (required)

unexpectedness

Calculate unexpectedness scores.

wosecopy unexpectedness INPUT_FILE [OPTIONS]

Options:

--concepts-column TEXT: Concepts column name
--prompt-column TEXT: Prompt column name (default: prompt)
-l, --language [en|de]: Language
-o, --output PATH: Output CSV file

download-model

Download spaCy language models.

wosecopy download-model --language LANG [OPTIONS]

Options:

-l, --language [en|de]: Language (required)
-s, --size [sm|md|lg]: Model size (default: lg)