Skip to content

Commit 33b7bed

Browse files
Merge pull request #177 from dpr1005/development
Added some more documentation and tests for instance selection
2 parents 01b2557 + 4ed22a2 commit 33b7bed

22 files changed

+1144
-737
lines changed

docs/anexos.pdf

415 KB
Binary file not shown.

docs/anexos.tex

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
\usepackage{lmodern} % scalable font
99
\usepackage{microtype}
1010
\usepackage{placeins}
11+
\usepackage{tabularx}
1112

1213
\RequirePackage{booktabs}
1314
\RequirePackage[table]{xcolor}
@@ -45,6 +46,31 @@
4546
% Evitar solapes en el header
4647
\nouppercaseheads
4748

49+
% Code
50+
\usepackage{listings}
51+
\usepackage{color}
52+
53+
\definecolor{dkgreen}{rgb}{0,0.6,0}
54+
\definecolor{gray}{rgb}{0.5,0.5,0.5}
55+
\definecolor{mauve}{rgb}{0.58,0,0.82}
56+
\lstset{frame=tb,
57+
aboveskip=3mm,
58+
belowskip=3mm,
59+
showstringspaces=false,
60+
columns=flexible,
61+
basicstyle={\small\ttfamily},
62+
numbers=none,
63+
numberstyle=\tiny\color{gray},
64+
keywordstyle=\color{blue},
65+
commentstyle=\color{red},
66+
stringstyle=\color{mauve},
67+
breaklines=true,
68+
breakatwhitespace=true,
69+
tabsize=3,
70+
captionpos=b
71+
}
72+
73+
4874
% Imagenes
4975
\usepackage{graphicx}
5076
\newcommand{\imagen}[2]{
@@ -56,6 +82,15 @@
5682
\FloatBarrier
5783
}
5884

85+
\newcommand{\imagenRuta}[3]{
86+
\begin{figure}[!h]
87+
\centering
88+
\includegraphics[width=0.9\textwidth]{#1}
89+
\caption{#2}\label{fig:#3}
90+
\end{figure}
91+
\FloatBarrier
92+
}
93+
5994
\newcommand{\imagenflotante}[2]{
6095
\begin{figure}%[!h]
6196
\centering
@@ -65,7 +100,6 @@
65100
}
66101

67102

68-
69103
% El comando \figura nos permite insertar figuras comodamente, y utilizando
70104
% siempre el mismo formato. Los parametros son:
71105
% 1 -> Porcentaje del ancho de página que ocupará la figura (de 0 a 1)

docs/bibliografiaAnexos.bib

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,4 +209,16 @@ @ARTICLE{720574
209209

210210
@ARTICLE{IEEE1220722020, author={}, journal={IEEE Std 12207-2-2020}, title={Systems and software engineering--Software life cycle processes--Part 2: Relation and mapping between ISO/IEC/IEEE 12207:2017 and ISO/IEC 12207:2008}, year={2020}, volume={}, number={}}
211211

212-
@misc{ingenieriasoftwareytiemporeal_2020, title={IEEE830-ESP - ctr.unican.es}, url={https://ctr.unican.es/asignaturas/is1/IEEE830_esp.pdf}, journal={ISTR - Ingeniería Software y Tiempo Real}, author={Ingeniería Software y Tiempo Real, ISTR}, year={2020}}
212+
@misc{ingenieriasoftwareytiemporeal_2020, title={IEEE830-ESP - ctr.unican.es}, url={https://ctr.unican.es/asignaturas/is1/IEEE830_esp.pdf}, journal={ISTR - Ingeniería Software y Tiempo Real}, author={Ingeniería Software y Tiempo Real, ISTR}, year={2020}}
213+
214+
@misc{pythonGetIt, title={Python Download}, url={https://www.python.org/getit/}}
215+
216+
@misc{gitkraken, title={GitKraken}, url={https://www.gitkraken.com/}}
217+
218+
@misc{VSCode, title={Visual Studio Code}, url= {https://code.visualstudio.com/}}
219+
220+
@misc{PyCharm, title={PyCharm}, url= {https://www.jetbrains.com/pycharm/}}
221+
222+
@misc{VSCode-Remote-SSH, title={Remote SSH}, url={https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh}}
223+
224+
@misc{Remote-Development-Tricks-Tips, title={Remote Development Tips and Tricks}, url={https://code.visualstudio.com/docs/remote/troubleshooting#_installing-a-supported-ssh-client}, year={2022}, author={Microsoft}}
69.6 KB
Loading
440 KB
Loading

docs/memoria.pdf

1 KB
Binary file not shown.

docs/misc/survey_steps.pdf

119 KB
Binary file not shown.

docs/misc/survey_steps.tex

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,157 @@
1+
\documentclass[
2+
12pt,
3+
spanish
4+
]{article}
5+
6+
% Template-specific packages
7+
\usepackage[utf8]{inputenc} % Required for inputting international characters
8+
\usepackage[spanish]{babel}
9+
\usepackage{cmbright}
10+
\usepackage{hyperref}
11+
\hypersetup{
12+
colorlinks=true,
13+
linkcolor=red,
14+
filecolor=magenta,
15+
urlcolor=blue,
16+
pdftitle={Overleaf Example},
17+
pdfpagemode=FullScreen,
18+
}
19+
\usepackage[T1]{fontenc} % Output font encoding for international characters
20+
21+
\usepackage{graphicx} % Required for including images
22+
23+
\usepackage{booktabs} % Required for better horizontal rules in tables
24+
25+
\usepackage{listings} % Required for insertion of code
26+
27+
\usepackage{enumerate} % To modify the enumerate environment
28+
\newcommand{\direccion}{http://puenramihome.ddns.net:8081}
29+
\newcommand{\mailUBU}{mailto:[email protected]}
30+
\newcommand{\mailPersonal}{mailto:[email protected]}
31+
32+
%----------------------------------------------------------------------------------------
33+
% ASSIGNMENT INFORMATION
34+
%----------------------------------------------------------------------------------------
35+
36+
\title{
37+
\begin{figure}[h!]
38+
\centering
39+
\includegraphics[width=0.5\linewidth]{../img/escudoInfor.pdf}
40+
\end{figure}
41+
Encuesta de funcionalidad de UBUMLaaS} % Assignment title
42+
43+
\author{Daniel Puente Ramírez} % Student name
44+
45+
%----------------------------------------------------------------------------------------
46+
47+
\begin{document}
48+
49+
\maketitle
50+
\thispagestyle{empty}
51+
\clearpage
52+
\tableofcontents
53+
\thispagestyle{empty}
54+
\clearpage
55+
\setcounter{page}{1}
56+
\section{Objetivo y actores involucrados}
57+
Este documento es una recopilación de la información asociada al proceso de pruebas que se realiza en UBUMLaaS por actores externos, los cuales deben de seguir esta documentación con el fin de realizar las pruebas más importantes y para las cuáles se ha diseñado una \href{https://forms.gle/yUoBxDyR3BaF7TjDA}{encuesta} de satisfacción.
58+
59+
El objetivo principal es conocer la interacción del usuario con la aplicación, recibir una retroalimentación tanto positiva como negativa de forma que sirva de entrada al proceso de calidad que se va a llevar a cabo.
60+
61+
Además, se aprovecha la oportunidad para recuperar información acerca de los posibles fallos que haYa en el sistema que han ido pasando desapercibidos tanto en las pruebas automáticas como durante el proceso de desarrollo <<al ojo>>.
62+
63+
Los actores que se desea participen en esta encuesta han de ser lo más diversos posibles, tanto en estudios, formación, conocimientos técnicos sobre Aprendizaje Máquina (\textit{Machine Learning}). Así como la propia relación con el equipo de desarrollo, de forma que se eviten sesgos y con todo el conjunto de muestras se obtenga una visión suficientemente amplia del estado del proyecto.
64+
65+
Todas las pruebas que se van a documentar a continuación son lo más sencillas posibles para que cualquier usuario, independientemente de sus conocimientos técnicos, sea capaz de llevarlas a cabo. Se deja a libertad del usuario la posibilidad de seguir probando cualquier funcionalidad de la plataforma de ML una vez haya finalizado estas pruebas.
66+
67+
\clearpage
68+
\section{Pruebas de Registro e Inició de Sesión}
69+
A continuación se detallan los pasos deseados a realizar.
70+
\begin{enumerate}
71+
\item Navegar hasta la \href{\direccion}{dirección web} con el navegador de su elección.
72+
\item En caso de no disponer de una cuenta todavía, acceda al registro de nuevos usuarios.
73+
\begin{enumerate}
74+
\item Indique un nombre de usuario, deberá ser único en el sistema por lo que puede ser que se le mande repetir la operación hasta que dé con uno disponible.
75+
\item Se le solicitará un correo electrónico, de igual manera deberá ser un correo electrónico que no exista todavía. Importante que sea un correo electrónico al que tenga acceso pues más adelante deberá utilizarlo.
76+
\item Indique una contraseña, deberá ser de longitud mínima 8 caracteres, no hay longitud máxima, así como contener al menos una letra mayúscula y una minúscula, un carácter especial, y un número.
77+
\item Indique el uso que se le va a dar al sistema.
78+
\item Indique su país de origen o residencia actual.
79+
\item Una vez todos los campos sean correctos, podrá finalizar enviando el formulario.
80+
\item Se le enviará un correo electrónico para que verifique su identidad y active la cuenta que acaba de crear.
81+
\end{enumerate}
82+
\item Una vez que posee una cuenta y ya la ha activado, deberá de volver al \href{\direccion}{índice} y proceder con el inicio de sesión.
83+
\item Cuándo se encuentre en la pantalla correspondiente al inicio de sesión se encontrará con un formulario de nuevo, por favor indique en los correspondientes campos sus credenciales.
84+
\item Este conjunto de pruebas han finalizado, por favor reporte sus resultados en la sección correspondiente.
85+
\end{enumerate}
86+
87+
\clearpage
88+
\section{Pruebas de Uso de UBUMLaaS}
89+
A continuación se detalla el proceso de uso de la plataforma para crear nuevos experimentos. Se detalla el proceso general, se deja a libertad del usuario el indagar en las funcionalidades más específicas del proceso de Aprendizaje Máquina.
90+
91+
\begin{enumerate}
92+
\item Una vez se encuentre en el índice \textbf{después} de haber iniciado sesión, encontrará un botón que indica la creación de un nuevo experimento. Este botón le llevará a una nueva página que deberá completar.
93+
\item Ahora se encuentra en la página de creación de nuevos experimentos. Puede rellenar los campos en cualquier orden, pero debe de tener en cuenta que la elección de determinados valores propiciará cambios en otros campos. Por ejemplo, determinados algoritmos poseen filtros, otros no, etc.
94+
95+
El orden recomendado es el siguiente:
96+
\begin{enumerate}
97+
\item Seleccione el conjunto de datos que desea utilizar, puede también subir uno de su colección personal, tenga en cuenta que deberán de ser complacientes con el estándar esperado por la aplicación para cada tipo de algoritmos o de lo contrario el modelo puede no ser entrenado correctamente o incluso fallar. Al crear la cuenta se le proporcionaron 5 por defecto.
98+
\item Seleccione el tipo de algoritmo que desea utilizar, dispone entre Clasificación, Regresión, Clasificación Semi-Supervisada, Multi-Clasificación, Clustering, o Mixed (Algoritmos compatibles con clasificación y regresión).
99+
\item Seleccione el algoritmo que desea utilizar.
100+
\item Parametrice el algoritmo tal y como considere apropiado para su problema.
101+
\item Seleccione un filtro en caso de desear utilizarlo. Son filtros de selección de instancias.
102+
\item Indique una semilla en caso de querer hacerlo con una no aleatoria.
103+
\item Indique si desea utilizar validación cruzada o partición en entrenamiento y pruebas. E indique el número de \textit{folds} o los porcentajes de partición, respectivamente.
104+
\item Con todos los campos rellenos. Lance el experimento.
105+
\end{enumerate}
106+
\item Se le redirigirá a la página web dónde aparecerán los resultados una vez haya finalizado el experimento. También puede acceder desde su perfil.
107+
\item Se le notificará por correo electrónico cuándo el experimento haya finalizado.
108+
\end{enumerate}
109+
110+
Este es el proceso de lanzar experimentos en la plataforma, se insta al usuario a que pruebe con distintos conjuntos de datos así como tipos de experimentos.
111+
112+
Cuando considere que ha finalizado, reporte los resultados en la sección correspondiente de la encuesta.
113+
\vfill
114+
115+
116+
\textbf{NOTA.} Es normal que algunos experimentos fallen, en caso de que el usuario parametrice mal el experimento para el conjunto de datos con el que se encuentra trabajando. En este punto se recomienda a los usuarios con conocimientos más avanzados en ML y experiencia trabajando con \texttt{Weka} y \texttt{Scikit-Learn} pongan a prueba la funcionalidad esperada bajo sus correspondientes criterios.
117+
\pagebreak
118+
119+
\section{Pruebas de Usuario}
120+
En esta nueva sección se van a realizar pruebas muy sencillas sobre algunas de las funcionalidades que el usuario puede realizar sobre su propio perfil.
121+
122+
\begin{enumerate}
123+
\item En caso de no haber iniciado sesión, por favor inicie sesión.
124+
\item Navegue hasta su perfil, lo puede encontrar como sus experimentos también.
125+
\item La primera de las pruebas que se desea que realice es actualizar su foto de perfil. La plataforma soporta la mayoría de los formatos de \textbf{imagen}.
126+
\item Seguidamente actualice sus datos personales, como por ejemplo podría ser su país.
127+
\item Añada algunos campos adicionales como su Twitter o GitHub.
128+
\item Si lo desea puede cambiar su contraseña.
129+
\end{enumerate}
130+
131+
\pagebreak
132+
\section{Pruebas de Administrador}
133+
No todos los usuarios participantes en esta encuesta tendrán acceso de administrador al sistema por razones más que obvias. En caso de estar entre los elegidos, por favor continue con esta sección, de no estarlo acuda a la sección~\ref{sec:fin}.
134+
135+
Las pruebas que se van a realizar aquí son sencillas, principalmente de visualización. No se espera que conozca al detalle todo lo que aparece en pantalla o lo que hace cada botón. No tenga miedo a romper nada, no lo conseguirá, y de conseguirlo, mejor para el desarrollo de la aplicación, ¡indíquelo en la encuesta!
136+
137+
\begin{enumerate}
138+
\item Con la sesión iniciada notará que hay una barra lateral con diferentes opciones, este es el panel de administración.
139+
\item En dicho panel seleccione el \textit{Dashboard}. Aquí podrá encontrar las estadísticas y analíticas generales de uso del sistema y algunos datos en concreto de uso de los últimos 7 días. ¿Observa algo extraño? ¿Entiende a qué hace referencia cada gráfico?
140+
\item Continúe navegando en el panel lateral a la monitorización del sistema en tiempo real. ¿Observa algo extraño? ¿Entiende a qué hace referencia cada gráfico?
141+
\item Navegue ahora a la administración de usuarios. Pruebe a (de)activar, hacer admin o quitar admin a los usuarios, incluso puede eliminar el usuario que desee. En caso de eliminar usuarios por favor revise la dirección de correo electrónico y elimine aquellas que parezcan falsas.
142+
\end{enumerate}
143+
144+
Como habíamos prometido iban a ser pruebas sencillas.
145+
146+
\pagebreak
147+
\section{Finalizando}\label{sec:fin}
148+
149+
Con el proceso finalizado de insta a rellenar todos aquellos campos en la encuesta que todavía quedaran pendientes y a enviar el resultado. No dude en escribir de forma extensa en aquellos campos que así lo permiten, todo el \textit{feedback} recibido será utilizado en el proceso de mejora de la aplicación para hacerla más intuitiva, fácil de utilizar y por supuesto, libre de errores.
150+
151+
En caso de querer comentar algún aspecto en concreto, por favor no dude en ponerse en contacto a través de cualquiera de los siguientes correos electrónicos.
152+
\begin{itemize}
153+
\item \href{\mailUBU}{Equipo de desarrollo} de la Universidad de Burgos.
154+
\item \href{\mailPersonal}{Dirección del proyecto.}
155+
\end{itemize}
156+
157+
\end{document}

0 commit comments

Comments
 (0)