# dewmith/scyseqtools_official architecture

> Architecture diagram of the GitHub repository dewmith/scyseqtools_official, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dewmith/scyseqtools_official
- Repository: https://github.com/dewmith/scyseqtools_official

## Overview

ScySeqTools provides two user-facing workflows: the encoder defines behavioral codes, plays media, records coded observations and saves session data; the analyser loads coded files and supports analysis, including symbolic methods, synchronization and Cohen’s kappa. The graph includes these documented capabilities and the sampled internal layers. Some connections rely on the SOURCE INDEX’s import references; unsampled implementation details and their runtime ordering are not inferred.

Main entry points: [`src/scyseqtools/encoder/encoder.py`](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/encoder.py) (Encoder Application), [`src/scyseqtools/analyser/analyser.py`](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/analyser.py) (Analyser Application), [`src/scyseqtools/encoder/infoframe.py`](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/infoframe.py) (Session Information), [`src/scyseqtools/encoder/playercontrol.py`](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/playercontrol.py) (Media Playback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_encoder["Behavior Encoder"]
  node_encoder_launch["Encoder Launcher<br/>[main.py]"]
  node_encoder_app["Encoder Application<br/>[encoder.py]"]
  node_code_builder["Code Framework Editor<br/>[newcode.py]"]
  node_coding["Coding Framework<br/>[codingframe.py]"]
  node_info["Session Information<br/>[infoframe.py]"]
  node_playback["Media Playback<br/>[playercontrol.py]"]
  node_backend["Player Backends<br/>[playerbackends.py]"]
  node_menu["Application Menu<br/>[applicationmenu.py]"]
  node_report["HTML Report<br/>[htmlreport.py]"]
  node_session_data[("Session Files<br/>[infoframe.py]")]
end

subgraph group_analysis["Behavior Analysis"]
  node_analyser_launch["Analyser Launcher<br/>[main.py]"]
  node_analyser_app["Analyser Application<br/>[analyser.py]"]
  node_methods["Analysis Methods<br/>[methods.py]"]
  node_parameters["Method Parameters<br/>[parameters.py]"]
  node_symbolic["Symbolic Analysis<br/>[symbolix.py]"]
  node_synchronization["Synchronization<br/>[synchronization.py]"]
  node_kappa["Cohen Kappa<br/>[kappa.py]"]
end

subgraph group_support["Shared Product Support"]
  node_config["Encoder Configuration<br/>[config.py]"]
end

node_user(("Researcher"))

node_user -->|"launches"| node_encoder_launch
node_encoder_launch -->|"creates"| node_encoder_app
node_encoder_app -->|"opens"| node_code_builder
node_encoder_app -->|"uses"| node_coding
node_encoder_app -->|"uses"| node_info
node_encoder_app -->|"uses"| node_playback
node_encoder_app -->|"creates"| node_menu
node_code_builder -->|"uses"| node_report
node_info -->|"saves"| node_session_data
node_playback -->|"selects"| node_backend
node_coding -->|"loads"| node_config
node_info -->|"loads"| node_config
node_playback -->|"loads"| node_config
node_user -->|"launches"| node_analyser_launch
node_analyser_launch -->|"creates"| node_analyser_app
node_analyser_app -->|"imports"| node_methods
node_analyser_app -->|"imports"| node_synchronization
node_analyser_app -->|"imports"| node_kappa
node_analyser_app -->|"imports"| node_symbolic
node_methods -->|"uses"| node_parameters
node_parameters -->|"uses"| node_symbolic

click node_encoder_launch "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/main.py"
click node_encoder_app "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/encoder.py"
click node_code_builder "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/newcode.py"
click node_coding "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/codingframe.py"
click node_info "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/infoframe.py"
click node_playback "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/playercontrol.py"
click node_backend "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/playerbackends.py"
click node_menu "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/applicationmenu.py"
click node_report "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/htmlreport.py"
click node_session_data "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/infoframe.py"
click node_analyser_launch "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/main.py"
click node_analyser_app "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/analyser.py"
click node_methods "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/methods.py"
click node_parameters "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/parameters.py"
click node_symbolic "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/symbolix.py"
click node_synchronization "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/synchronization.py"
click node_kappa "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/kappa.py"
click node_config "https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_encoder_launch,node_encoder_app,node_code_builder,node_coding,node_info,node_playback,node_backend,node_menu,node_report,node_session_data toneBlue
class node_analyser_launch,node_analyser_app,node_methods,node_parameters,node_symbolic,node_synchronization,node_kappa toneAmber
class node_config toneMint
class node_user toneIndigo
```

## Components

### Behavior Encoder

- [Encoder Launcher](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/main.py): `src/scyseqtools/encoder/main.py`
- [Encoder Application](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/encoder.py): `src/scyseqtools/encoder/encoder.py`
- [Code Framework Editor](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/newcode.py): `src/scyseqtools/encoder/newcode.py`
- [Coding Framework](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/codingframe.py): `src/scyseqtools/encoder/codingframe.py`
- [Session Information](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/infoframe.py): `src/scyseqtools/encoder/infoframe.py`
- [Media Playback](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/playercontrol.py): `src/scyseqtools/encoder/playercontrol.py`
- [Player Backends](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/playerbackends.py): `src/scyseqtools/encoder/playerbackends.py`
- [Application Menu](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/applicationmenu.py): `src/scyseqtools/encoder/applicationmenu.py`
- [HTML Report](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/htmlreport.py): `src/scyseqtools/encoder/htmlreport.py`
- [Session Files](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/infoframe.py): `src/scyseqtools/encoder/infoframe.py`

### Behavior Analysis

- [Analyser Launcher](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/main.py): `src/scyseqtools/analyser/main.py`
- [Analyser Application](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/analyser.py): `src/scyseqtools/analyser/analyser.py`
- [Analysis Methods](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/methods.py): `src/scyseqtools/analyser/methods.py`
- [Method Parameters](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/parameters.py): `src/scyseqtools/analyser/parameters.py`
- [Symbolic Analysis](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/symbolix.py): `src/scyseqtools/analyser/symbolix.py`
- [Synchronization](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/synchronization.py): `src/scyseqtools/analyser/synchronization.py`
- [Cohen Kappa](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/analyser/kappa.py): `src/scyseqtools/analyser/kappa.py`

### Shared Product Support

- [Encoder Configuration](https://github.com/dewmith/scyseqtools_official/blob/main/src/scyseqtools/encoder/config.py): `src/scyseqtools/encoder/config.py`

### Other components

- **Researcher**

## Connections

- Researcher → Encoder Launcher: launches (evidence: `README.md`)
- Encoder Launcher → Encoder Application: creates (evidence: `src/scyseqtools/encoder/main.py`)
- Encoder Application → Code Framework Editor: opens (evidence: `src/scyseqtools/encoder/encoder.py`)
- Encoder Application → Coding Framework: uses (evidence: `src/scyseqtools/encoder/encoder.py`)
- Encoder Application → Session Information: uses (evidence: `src/scyseqtools/encoder/encoder.py`)
- Encoder Application → Media Playback: uses (evidence: `src/scyseqtools/encoder/encoder.py`)
- Encoder Application → Application Menu: creates (evidence: `src/scyseqtools/encoder/encoder.py`)
- Code Framework Editor → HTML Report: uses (evidence: `src/scyseqtools/encoder/newcode.py`)
- Session Information → Session Files: saves (evidence: `src/scyseqtools/encoder/infoframe.py`)
- Media Playback → Player Backends: selects (evidence: `src/scyseqtools/encoder/playercontrol.py`)
- Coding Framework → Encoder Configuration: loads (evidence: `src/scyseqtools/encoder/codingframe.py`)
- Session Information → Encoder Configuration: loads (evidence: `src/scyseqtools/encoder/infoframe.py`)
- Media Playback → Encoder Configuration: loads (evidence: `src/scyseqtools/encoder/playercontrol.py`)
- Researcher → Analyser Launcher: launches (evidence: `README.md`)
- Analyser Launcher → Analyser Application: creates (evidence: `src/scyseqtools/analyser/main.py`)
- Analyser Application → Analysis Methods: imports (evidence: `src/scyseqtools/analyser/analyser.py`)
- Analyser Application → Synchronization: imports (evidence: `src/scyseqtools/analyser/analyser.py`)
- Analyser Application → Cohen Kappa: imports (evidence: `src/scyseqtools/analyser/analyser.py`)
- Analyser Application → Symbolic Analysis: imports (evidence: `src/scyseqtools/analyser/analyser.py`)
- Analysis Methods → Method Parameters: uses (evidence: `src/scyseqtools/analyser/methods.py`)
- Method Parameters → Symbolic Analysis: uses (evidence: `src/scyseqtools/analyser/parameters.py`)
