# gemmaemasters-stack/hockey-analytics-project architecture

> Architecture diagram of the GitHub repository gemmaemasters-stack/hockey-analytics-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gemmaemasters-stack/hockey-analytics-project
- Repository: https://github.com/gemmaemasters-stack/hockey-analytics-project

## Overview

This is a small research-analysis project: a researcher uses a prepared Excel dataset and a Python script to examine home/away results, compare match statistics, run hypothesis tests, and produce plots. The sampled script shows these steps and writes three figures; the existing report is an artifact, but its creation process is not shown. The README documents the dataset and methods, while the source does not show additional data collection or report-generation code.

Main entry points: [`hockey_analysis.py`](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py) (Analysis Script), [`hockey_data.xlsx`](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_data.xlsx) (Match Dataset), [`figures`](https://github.com/gemmaemasters-stack/hockey-analytics-project/tree/master/figures) (Figures), [`Hockey_Analytics_Report.docx`](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/Hockey_Analytics_Report.docx) (Analytics Report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Research Data"]
  node_workbook[("Match Dataset<br/>[hockey_data.xlsx]")]
end

subgraph group_analysis["Analysis"]
  node_analysis_script["Analysis Script<br/>[hockey_analysis.py]"]
  node_descriptive["Descriptive Statistics<br/>[hockey_analysis.py]"]
  node_hypothesis_tests["Hypothesis Tests<br/>[hockey_analysis.py]"]
  node_visualizations["Result Plots<br/>[hockey_analysis.py]"]
end

subgraph group_outputs["Results"]
  node_figures["Figures"]
  node_report["Analytics Report"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_analysis_script
node_analysis_script -->|"reads"| node_workbook
node_analysis_script -->|"computes"| node_descriptive
node_analysis_script -->|"tests"| node_hypothesis_tests
node_analysis_script -->|"plots"| node_visualizations
node_visualizations -->|"writes"| node_figures
node_researcher -.->|"reviews"| node_report

click node_workbook "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_data.xlsx"
click node_analysis_script "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py"
click node_descriptive "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py"
click node_hypothesis_tests "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py"
click node_visualizations "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py"
click node_figures "https://github.com/gemmaemasters-stack/hockey-analytics-project/tree/master/figures"
click node_report "https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/Hockey_Analytics_Report.docx"

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_workbook toneBlue
class node_analysis_script,node_descriptive,node_hypothesis_tests,node_visualizations toneAmber
class node_figures,node_report toneMint
class node_researcher toneIndigo
```

## Components

### Research Data

- [Match Dataset](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_data.xlsx): `hockey_data.xlsx`

### Analysis

- [Analysis Script](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py): `hockey_analysis.py`
- [Descriptive Statistics](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py): `hockey_analysis.py`
- [Hypothesis Tests](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py): `hockey_analysis.py`
- [Result Plots](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/hockey_analysis.py): `hockey_analysis.py`

### Results

- [Figures](https://github.com/gemmaemasters-stack/hockey-analytics-project/tree/master/figures): `figures`
- [Analytics Report](https://github.com/gemmaemasters-stack/hockey-analytics-project/blob/master/Hockey_Analytics_Report.docx): `Hockey_Analytics_Report.docx`

### Other components

- **Researcher**

## Connections

- Researcher → Analysis Script: runs
- Analysis Script → Match Dataset: reads
- Analysis Script → Descriptive Statistics: computes
- Analysis Script → Hypothesis Tests: tests
- Analysis Script → Result Plots: plots
- Result Plots → Figures: writes
- Researcher → Analytics Report: reviews