Una aplicació web basada en Streamlit per analitzar i visualitzar dades del rendiment acadèmic dels estudiants a partir d'informes escolars.
Metrika funciona en dos passos principals:
-
Convertir CSV a JSON
- Primer, has d'anar a la secció "Convertir CSV" del menú lateral
- Aquí podràs convertir el fitxer CSV extret de les actes d'Esfera a format JSON
- Aquests fitxers JSON són els que Metrika utilitza per mostrar les estadístiques
-
Visualitzar Estadístiques
- Un cop tinguis els fitxers JSON, ves a la secció "Estadístiques"
- Introdueix el path a la carpeta que conté els fitxers JSON (T1.json, T2.json, T3.json)
- Podràs veure totes les estadístiques i visualitzacions disponibles
- Visualització interactiva del rendiment dels estudiants
- Anàlisi i estadístiques per matèria
- Seguiment individual del rendiment dels estudiants
- Visualització detallada de la distribució de notes
- Anàlisi comparatiu entre trimestres
- Seguiment de l'evolució dels estudiants
- Comentaris i retroalimentació detallada per matèria
- Filtre per curs (1r, 2n, 3r) en totes les visualitzacions
- Generació de dades aleatòries per a proves i simulacions
- Exportació de dades a altres formats
- Integració amb sistemes externs
- Gestió d'usuaris i permisos
- Filtres per 4t d'ESO
- Adaptació per Batxillerat i CCFF
├── app.py # Aplicació principal
├── requirements.txt # Dependències del projecte
├── sections/ # Seccions principals de l'aplicació
│ ├── evolution.py # Visualitzacions d'evolució de notes
│ ├── student_marks.py # Visualització de notes per alumne
│ ├── student_selector.py # Selector d'alumnes
│ └── visualization.py # Visualitzacions generals i estadístiques
├── utils/ # Funcions i ajudants d'utilitat
│ ├── constants.py # Constants i configuracions
│ ├── csv_to_json.py # Conversió de CSV a JSON
│ ├── data_loader.py # Càrrega de dades
│ ├── generate_dummy_data.py # Generació de dades de prova
│ └── helpers.py # Funcions auxiliars
└── docs/ # Documentació i fitxers de dades (no traçat en el repositori)
- Clona el repositori:
git clone [url-del-repositori]
cd metrika- Crea i activa un entorn virtual:
python -m venv venv
source venv/bin/activate # A Windows: venv\Scripts\activate- Instal·la les dependències:
pip install -r requirements.txt- Inicia l'aplicació Streamlit:
streamlit run app.py- Accedeix a l'aplicació a través del teu navegador web a
http://localhost:8501
- Taules de rendiment de l'aula
- Estadístiques per matèria
- Visualització de freqüència de notes
- Seguiment individual del rendiment
- Anàlisi comparatiu entre trimestres
- Filtre per curs en totes les visualitzacions
- Seguiment individual del rendiment
- Visualització de l'evolució de notes
- Desglossament de notes per matèria
- Comentaris i retroalimentació detallada
- Evolució temporal per trimestre
- Creació de dades aleatòries per a proves
- Generació de dades per diferents trimestres
- Manteniment de la coherència en les dades generades
El projecte utilitza diversos paquets Python clau:
- Streamlit per a la interfície web
- Pandas per a la manipulació de dades
- Plotly per a visualitzacions interactives
- Biblioteques de processament de PDF (pdfplumber)
- Diverses eines d'anàlisi i visualització de dades
- Fes un fork del repositori
- Crea una branca per a la teva funcionalitat
- Fes commit dels teus canvis
- Fes push a la branca
- Crea una Pull Request
Copyright (C) 2024 Metrika
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.