How maxwshen/piu-annotate works
Main Components to Include:
Core Processing Pipeline
• Input Layer
• Chart structure conversion (formats/ssc_to_chartstruct.py)
• Analysis Engine
• Segment Analysis (piu_annotate/segment/)
• Pattern Recognition (piu_annotate/reasoning/)
• Difficulty Assessment (piu_annotate/difficulty/)
• Limb Usage Prediction (cli/limbuse/)
• Output Formats
• JSON outputs (cli/chartjson/)
• Visualization components (formats/jsplot.py)
Machine Learning Infrastructure
• Feature Engineering (ml/featurizers.py)
• Model Training (ml/models.py)
• Prediction Pipeline (ml/predictor.py)
• Tactics Analysis (ml/tactics.py)
Data Flow Architecture
• Raw input (SSC files) → Chart Structure conversion
• Chart Structure → Various Analysis Modules
• Analysis Results → Output Formats
CLI Interface Layer
• CLI tools into functional categories:
• Ingestion Tools (cli/ingest/)
• Analysis Tools (cli/analysis/)
• Debug Tools (cli/debug/)
• Tools (cli/display_metadata/)
Specific Design Guidelines:
Technical Details
• Use of Python as the primary language
• Libraries (based on imports in the code)
• File format transformations (SSC → ChartStruct → JSON)