Els elements d'aquest repositori constitueixen la resposta a la PAC 4 de l'assignatura Programació per a la ciència de dades del Màster en Ciència de Dades de la Universitat Oberta de Catalunya (UOC), corresponent al segon semestre del curs 2021-2022.
L'objectiu és la realització d'una pràctica que consolidi els coneixements treballats durant el semestre en l'àmbit de l'aprenentatge del llenguatge de programació python (python3), a partir d'una temàtica i unes dades pròpies de la ciència de dades, i fent ús d'eines àmpliament emprades a dia d'avui com són PyCharm i Github.
El projecte es troba en aquest repositori públic de GitHub, i la seva estructura és la següent:
────aprenent-python
│
├───pac
│ │
│ ├─── best_defense.py
│ ├─── bmi.py
│ ├─── constants.py
│ ├─── dictionaries.py
│ ├─── evolution.py
│ ├─── pac4_main.py
│ ├─── preprocessing.py
│ ├─── statistics.py
│ ├─── testing_imports.py
│ ├─── requirements.txt
│ │
│ ├─── data
│ │ BMI*.csv
│ │ *players.csv
│ │
│ ├─── outputs
│ │ *.png
│ │
│ └─── tests
│ test_*.py
│
├─── Enunciat_PAC4.pdf
├─── Informe_PAC4.pdf
├─── LICENSE.txt
├─── README.md
└─── banner-readme.png
- pac/best_defense.py: Codi per resoldre l'exercici 6 (Best Defense).
- pac/bmi.py: Codi de les funcions relatives al càlcul de l'IMC (exercici 3).
- pac/constants.py: Codi que agrupa constants generals del projecte.
- pac/dictionaries.py: Codi de les funcions relatives a la gestió de diccionaris (exercici 4).
- pac/evolution.py: Codi de les funcions relatives a l'evolució de característiques (exercici 5).
- pac/pac4_main.py: Codi del programa principal del projecte (és el fitxer que s'ha d'executar).
- pac/preprocessing.py: Codi de les funcions relatives a lectura i preprocés (exercici 1).
- pac/statistics.py: Codi de les funcions relatives a l'estadística bàsica (exercici 2).
- pac/testing_imports.py: Fitxer auxiliar necessari per poder executar els tests unitaris.
- pac/requirements.txt: Fitxer amb l'inventari de llibreries python necessàries per executar el programa.
- pac/data/BMI*.csv: Datasets d'entrada corresponents a dades sobre l'IMC descarregades de la web de l'INE.
- pac/data/*players.csv: Datasets d'entrada corresponents al joc FIFA obtinguts de kaggle via UOC.
- pac/outputs/*.png: Gràfiques generades per l'execució del programa.
- pac/tests/test_*.py: Fitxers de test unitaris del projecte.
- Enunciat_PAC4.pdf: Document amb l'enunciat de la PAC4.
- Informe_PAC4.pdf: Document amb l'informe requerit a la PAC4.
- LICENSE.txt: Document amb els termes de la llicència aplicada al projecte.
- README.md: Document explicatiu del projecte.
- banner-readme.png: Imatge (banner) incrustada a la capçalera del fitxer README.md.
-
Obrir un terminal i situar-se al directori (carpeta) destinat al projecte
-
git clone https://github.com/ngonzalezs-UOC/aprenent-python.git
-
cd ./aprenent-python/pac
-
[opcional] Crear un entorn virtual i activar-lo
-
pip install -r requirements.txt
-
python3 ./pac4_main.py
(executa seqüencialment tots els exercicis)o alternativament
python3 ./pac4_main.py -m
(mostra un menu per seleccionar un exercici específic a executar)
El programa genera dos tipus de sortides:
- Informació de text, que es mostra en el terminal
- Gràfiques, que es mostren en finestres emergents i addicionalment es desen a la carpeta
/aprenent-python/pac/outputs/
L'exercici 6 de la PAC4 exigeix l'elaboració d'un informe. Aquest document s'anomena Informe_PAC4.pdf i es troba a la carpeta arrel del projecte /aprenent-python/
Totes i cadascuna de les parts d'aquest treball han estat realitzades exclusivament de forma individual per Nicolás González Soler.
Tots i cadascun dels continguts d'aquest projecte estan sotmesos a la llicència Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, excepte pel que respecta als datasets emprats sobre els que caldria observar les llicències eventualment preexistents que són d'aplicació.