Manual de usuario para DVT

Índice

1. Introducción
2. Requerimietnos
3. Instalación
4. Sintáxis
5. Gráficos DVT
6. Fichero de datos DVT
7. Fichero de configuración de gráficos XML
8. Ejecución
9. Ejemplos
10. Solución de problemas

1. Introducción

Este manual pretende introducir al usuario en el uso de la aplicación DVT (Generación dinámica de gráficos). Esta aplicación nos permite generar gráficos a partir de un fichero de datos en formato tabla y un fichero de configuración de gráficos XML.

2. Requerimientos

3. Instalación

Instalación para cualquier plataforma Linux

1. Descargar el fichero dvt_1.2-beta.tar.gz
2. $ tar -xzf dvt_1.2-beta.tar.gz
3. $ cd dvt
4. $ ./install.bash (con permisos de root)

Instalación para la plataforma Fedora / Red Hat:

1. Descargar el fichero dvt_1.2-beta_fedora_i386.rpm
2. $ rpm -ivh dvt_1.2-beta_fedora_i386.rpm

Instalación para la plataforma Debian / Ubuntu:

1. Descargar el fichero dvt_1.2-beta_ubuntu_i386.deb
2. $ apt-get install dvt.deb

4. Sintáxis

SYNOPSIS

dvt -i [INPUT] -o [OUTPUT]

DESCRIPTION

El orden de declaracónn de cada sección es indiferente.

[INPUT]

Esta sección permite definir la entrada de DVT. La aplicación DVT dispone de dos formas de ejecución que tan solo afectan a esta sección definidas en el apartado 8. Ejecución

-i The start of INPUT section

--datafile <datafile>

Directorio y nombre del fichero de texto plano en formato ISO-8859-15 o UTF-8 con una tabla de datos numéricos distribuidos en lineas y columnas. Cada columna representa un dato. Por defecto la primera linea del fichero es la cabecera con los nombres de cada columna de datos. En el caso que el fichero no tenga cabecera se deberá indicar con la opción --noheader (ver mas adelante). Las columnas deben estar separadas por espacios o tabuladores.

Ejemplo:

time	temp	speed
2	34.5	13
3	34.5	14
5	34.3	13

--nonheader

Indica que el datafile no tiene cabecera. Esto repercute en el fichero XML de configuración de gráficos a la hora de definir las variables. En el caso que el fichero de datos tenga cabecera, se utilizarán dichos nombres para especificar qué datos se representarán. Si por el contrarió el fichero de datos no dispone de cabecera, se ha de utilizar este parámetro --noheader y especificar en el fichero los datos a representar en el fichero XML en función del número de columna en la que encuentra el dato (La cabecera numérica será de [1,N] donde N es el número total de columnas de datos).

--xmlfile <file.xml>

Fichero XML de configuración de gráficos. Siempre va acompañado junto a un fichero de datos en la entrada de DVT. El fichero contiene unas instrucciones en forma de etiqueta que permiten configurar qué gráficos se desea realizar.

--inputscript <file.m>

Fichero script <finalscript.m> generado por una anterior ejecución de DVT. Contiene las instrucciones en lenguaje M que permiten indicar a Matlab la carga de un fichero de datos, computación y creación de gráficos.

[OUTPUT]

-o <type> [options_of_type] --path <path>

<type>: modos de salida DVT. (image, html, pdf)

--path <path> : directorio de salida dónde se depositaran los ficheros. Es opcional, el directorio HOME del usuario es directorio definido por defecto. (Opcional)

Opciones de Image:

--imageformat <format_name> : formato del archivo imagen (Opcional)

nombre	formato
png	Portable Network Graphics (por defecto)
jpg	JPEG image
tiff	TIFF image, compressed

NOTA: si no se define el formato, automáticamente los gráficos se realizarán con el formato png.

--resolution <número> : factor que permite dimensionar todos los gráfico. (Opcional)

Este factor representado por un número entero o decimal positivo y superior a 1. Este número es multiplicado sobre la la resolución por defecto (con factor 1): 576x432 píxeles.

Tabla orientativa de factor/resolución:

Factor	Resolución(píxeles)
1	576x432
1.5	864x648
2	1152x864
3	1728x1296

Si en el fichero XML se especifica una resolución diferente para un gráfico determinado, prevalece el valor especificado en en XML.

Opciones de HTML:

--pageformat <web_format> : combinación de ficheros de Imagen y ficheros HTML para facilitar una visualización via navegador Web. (Opcional)

<web_format>

single	Se genera un fichero HTML que contiene un Í­ndice local y todos los gráficos generados.
advance	Se genera un fichero HTML que contiene un Índice y un fichero HTML por cada gráfico generado. Además permite la paginación entre gráficos.

--imageformat <format_name> : formato de la imagen. (Opcional)

<web_format>

nombre	formato
png	Portable Network Graphics (por defecto)
jpg	JPEG image
tiff	TIFF image, compressed

--resolution<número> : factor que permite dimensionar todos los gráfico. (Opcional)

Este factor representado por un número entero o decimal positivo y superior a 1. Este número es multiplicado sobre la la resolución por defecto (con factor 1): 576x432 píxeles.

Tabla orientativa de factor/resolución:

Factor	Resolución(píxeles)
1	576x432
1.5	864x648
2	1152x864
3	1728x1296

Si en el fichero XML se especifica una resolución diferente para un gráfico determinado, prevalece el valor especificado en en XML.

Opciones PDF:

--pageformat <page_format> : formato de salida del modo PDF (Opcional)

<page_format>: formato de página

single	Un fichero PDF por gráfico.
one	Todos los gráficos en un fichero PDF.
advance <advance_format>	Un fichero PDF con los gráficos seleccionados.

NOTA: El modo avanzado utiliza la numeración según el orden de declaración de gráficos.

Ejemplo:

[...] -o pdf --pageformat 3 4 9 Esta orden genera un fichero PDF con los gráficos 3,4 y 9.

5. Gráficos DVT

* opcional

6. Fichero de datos DVT

Características:

• Fichero de texto plano con codificación UTF-8 o ISO-8859-15.
• Contenido con formato de tabla, donde cada columna representa una variable de dato diferente.
• Las columnas estarán separadas por espacios o tabuladores.
• Los datos deben ser numéricos (enteros o con decimales). No acepta formatos fecha, caracteres no numéricos y strings; en cuyo caso deberá ser preprocesado antes de entregarlo a la aplicación DVT.
• Opcionalmente la primera linea del fichero puede representar la cabecera o nombres a los que hace referencia las columnas de datos. Este nombre no debe tener espacios y se utilizará para diseñar los gráficos en el fichero de configuración XML.
  En el caso que no se defina una cabecera, el nombre de cada variable será el número entro de la columna de datos. La numeración se trazará de izquierda a derecha de la tabla y comenzando desde 1 hasta N (donde N es la última columna).

7. Fichero de configuración de gráficos XML

Este fichero contiene un conjunto de etiquetas que bajo unas normas de estructura y jerarquía permiten la especificación de los gráficos que se desean generar a partir del fichero de datos.

Formato del fichero XML:

El fichero XML contiene siempre la etiqueta básica <PLOT>... </PLOT> que permite declarar en su interior las características del gráfico que el usuario desea definir. Para ello hace uso de las siguientes etiquetas:

8. Ejecución

La aplicación DVT dispone de dos caminos de ejecución que difieren de los tipos de ficheros de entrada independientemente del tipo de salida seleccionado.

1. EJECUCIÓN DVT BÁSICA:
   Ficheros de entrada:
   • Fichero de datos DVT.
   • Fichero de configuración de gráficos XML.
   
   Sintáxis: dvt -i --noheader --datafile <datafile> --xmlfile <file.xml> -o [...]


2. EJECUCIÓN DVT ALTERNATIVA:
   Ficheros de entrada:
   • Fichero de datos DVT.
   • Fichero script final "finalscript.m" generado en una anterior ejecución DVT.
   
   Sintáxis: dvt -i --noheader --datafile <datafile> --outputtemplate <file.m> -o [...]

9. Ejemplos

Ejemplo 1

Objetivo:

Obtener un gráfico a partir de los datos discretos y secuenciales de la variable AvgCpu del fichero StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt . Su color será azul, con dimensión y formato por defecto y la información básica como título y etiqueta de los ejes para ofrecer una mayor comprensión de los datos que ofrece el gráfico.

Código del fichero de configuración XML:

NOTA: en este caso se ha definido el tipo de PLOT con la etiqueta <TYPE-DEFAULT>, sin embargo se obtiene el mismo resultado introduciendo la etiqueta <TYPE> dentro del <DATA>.

Linea de comando:
$ dvt --datafile StsMtraceTxNIC_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt --xmlfile NICRx_histogram_CtxPaus.xml -o image

Resultado:

Formato: png (The PNG image format)

Ancho: 1728 píxeles

Alto: 1296 píxeles

Ejemplo 2

Objetivo:

Dibujar una función de probabilidad acumulativa en función de la variable GrxPaus del fichero de salida TRAF llamado StsMtraceTxNIC_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt.
El gráfico ha de ser de color rojo y su dimensión del gráfico de ser la preestablecida por la aplicación.
También debe tener un título e información de los tipos de valores de cada eje.

Código del fichero de configuración XML:

Linea de comando:
$ dvt --datafile StsMtraceTxNIC_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt --xmlfile NICTx_CDF_GrxPaus.xml -o image --imageformat jpg

Resultado:

Formato:jpeg (The JPEG image format)

Ancho: 864 píxeles

Alto: 648 píxeles

Ejemplo 3

Objetivo:

Generar un gráfico con dos escalas diferentes, AvgCPU (uso medio de CPU) y PkSi (Tamaño del paquete) que estarán en función del orden de transmisión del fichero StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt . Sería mas instructivo introducirlo en función de otra variable para así definir una <X> en el código XML, sin embargo los ficheros de salida de TRAF no lo permiten por lo que no se define un un parámetro <X> . El primero estará en color azul y el segundo de verde.
Además de la información básica como el título y etiqueta en los los ejes, al haber dos tipos de información en un mismo gráfico es preciso el uso de la leyenda por lo que es preciso definir las etiquetas <DATA-LABEL> en cada dato y declarar la leyenda y su posición dentro del <PLOT>. La posición de la leyenda será automática pero en el interior del gráfico.

Código del fichero de configuración XML:

Linea de comando:
$ dvt --datafile StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt --xmlfile CPU_plotyy_averageCPU_PkSi.xml -o image

Resultado:

Formato: png (The PNG image format)

Ancho: 864 píxeles

Alto: 648 píxeles

Ejemplo 4

Objetivo:

Obtener un gráfico a partir de los datos discretos y secuenciales de la variable AvgCpu del fichero StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt . Su color será azul, con dimensión y formato por defecto y la información básica como título y etiqueta de los ejes para ofrecer una mayor comprensión de los datos que ofrece el gráfico.

Código del fichero de configuración XML:

Linea de comando:
$ dvt --datafile StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt --xmlfile CPU_stem_averageCPU.xml -o image

Resultado:

Formato: png (The PNG image format)

Ancho: 864 píxeles

Alto: 648 píxeles

Ejemplo 5

Objetivo:

Gráfico con varias lineas de diferentes datos bajo la misma escala en función de la secuencia de datos. El primero del dato MaxCpu de color rojo, MiniCpu de color azul y AvgCpu de color verde. Además para mejorar la comprensión del gráfico se ha de introducir un a leyenda que implica el uso de la etiqueta <DATA-LABEL> en los data implicados. También debe disponer de un título y etiquetas en los ejes.
La dimensión y formato del gráfico es el estipulado por defecto.

Código del fichero de configuración XML:

Linea de comando:
$ dvt --datafile StsMtraceRxCpu_KrnlPFR_GenPC_RxNICD_PseON_SaveNRU_prepro.txt --xmlfile CPU_linesubplot_maxminmediaCPU.xml -o image

Resultado:

Formato: png (The PNG image format)

Ancho: 864 píxeles

Alto: 648 píxeles

10. Solución de problemas

Bloqueo de la aplicación:

Debido a una mala configuración de gráficos en el fichero XML la aplicación Matlab puede bloquearse tras ordenar a Matlab que procese el finalscrip.m. Esto sucede debido a que la aplicación Matlab no finaliza de manera adecuada en modo termina sin prompt durante el procesado del fichero de entrada que DVT le hace entrega. Por consiguiente la aplicación Matlab se queda bloqueada.

SOLUCIÓN:

1. Abrir terminal
2. $ ps -aux | egrep MATLAB
3. $ sudo kill -9 <pid>

Información adicional

Autor: Eloy Asensio

Email de contacto: eloi.asensio@gmail.com

Project Admins:

• Eloy Asensio