function train = HMMTrain(HMM,patrones,iteraciones)

% function train = HMMTrain(HMM,patrones,iteraciones)
%
% HMMTrain entrena un HMM, que previamente ha sido inicializado con
% HMMInit, utilizando el algoritmo Baum-Welch. El resultado se obtiene 
% en el propio HMM que se le pasa.
%
% Para entrenar un HMM hay que especificar los siguientes parametros:
%
% HMM.- Estructura que contiene los valores de un modelo ya inicializado y en
% la que se devolveran los valores del modelo entrenado.
%
% patrones.- Array de celdas que contiene cada uno de los patrones de entrenamiento. 
% se utiliza un array de celdas porque cada uno de estos patrones puede tener una 
% longitud variable. Los patrones podran tomar valores entre 0 y
% (estados_observables -1)
% Por ejemplo en un HMM con 3 estados observables se podria tener el siguiente 
% conjunto de patrones de entrenamiento: patrones={[0 0 0 1 2 1], [0 0 0 1]}
%
% Iteraciones.- Valor entero que especifica el numero de iteraciones que se
% aplicara el algoritmo de entrenamiento.
%
% Esta funcion devuelve un vector con los errores obtenidos durante el
% entrenamiento con vistas a su posterior analisis.