gca-analyzer 0.4.5

A package for Group Communication Analysis with improved text processing and visualization

English | 简体中文

GCA Analyzer

Introduction

GCA Analyzer is a Python package for analyzing group communication dynamics using NLP techniques and quantitative metrics. It provides comprehensive tools for understanding participation patterns, interaction dynamics, content newness, and communication density in group communications.

Features

• Multi-language Support: Built-in support for Chinese and other languages through LLM models
• Built-in Sample Data: Includes ready-to-use sample conversations for immediate testing
• Comprehensive Metrics: Analyzes group interactions through multiple dimensions
• Automated Analysis: Finds optimal analysis windows and generates detailed statistics
• Flexible Configuration: Customizable parameters for different analysis needs
• Easy Integration: Command-line interface and Python API support

Quick Start

Installation

# Install from PyPI
pip install gca-analyzer

# For development
git clone https://github.com/etShaw-zh/gca_analyzer.git
cd gca_analyzer
pip install -e .

Basic Usage

Option 1: Use Built-in Sample Data (Recommended for First-time Users)

Start immediately with built-in sample data:

# Use built-in sample data
python -m gca_analyzer --sample-data

# Preview the sample data first
python -m gca_analyzer --sample-data --preview

# Interactive mode with sample data (recommended)
python -m gca_analyzer --interactive

Sample Data Contents:

• 3 different conversation types: team_meeting, design_review, brainstorm
• 61 realistic conversation messages
• 10 different participants
• Diverse communication patterns

Option 2: Use Your Own Data

1. Prepare your communication data in CSV format with required columns:

conversation_id,person_id,time,text
1A,student1,0:08,Hello teacher!
1A,teacher,0:10,Hello everyone!

2. Run analysis:

   Interactive Mode:

   python -m gca_analyzer --interactive
   # or
   python -m gca_analyzer -i
   

   Command Line Mode:

   python -m gca_analyzer --data your_data.csv
   

   Advanced Options:

   python -m gca_analyzer --data your_data.csv --output results/ --model-name your-model --console-level INFO
   

Analysis Results

The analyzer generates comprehensive statistics for GCA measures:

• Participation

  • Measures relative contribution frequency
  • Negative values indicate below-average participation
  • Positive values indicate above-average participation

• Responsivity

  • Measures how well participants respond to others
  • Higher values indicate better response behavior

• Internal Cohesion

  • Measures consistency in individual contributions
  • Higher values indicate more coherent messaging

• Social Impact

  • Measures influence on group discussion
  • Higher values indicate a stronger impact on others

• Newness

  • Measures introduction of new content
  • Higher values indicate more novel contributions

• Communication Density

  • Measures information content per message
  • Higher values indicate more information-rich messages

Results are saved as CSV files in the specified output directory.

Visualizations

The analyzer provides interactive and informative visualizations:

• Radar Plots: Compare measures across participants
• Distribution Plots: Visualize measure distributions

Results are saved as interactive HTML files in the specified output directory.

Citation

If you use this tool in your research, please cite:

@software{gca_analyzer,
  title = {GCA Analyzer: Group Communication Analysis Tool},
  author = {Xiao, Jianjun},
  year = {2025},
  url = {https://github.com/etShaw-zh/gca_analyzer}
}