Si no poded desplazaros hasta el final del texto siguiente, pulsa aquí.

Presentación general

Creación de un fichero cyloop.

Sintaxis : cylcree [nombre_fichero_cyloop]

cylcree es una manda interactiva que pide al usuario de definir todas las características de un fichero cyloop antes de crear este fichero.

El nombre del fichero cyloop a crear puede ser pasado en parámetro (con o sin el sufijo .cyl).
En la ausencia de este parámetro, la manda cylcree comienza por pedir el nombre del fichero a crear.

Luego comienza una serie de cuestiones/respuestas que permite al usuario de definir todas las características del fichero cyloop que quiere crear.

Para más de detalles sobre la creación de un fichero cyloop, ver esta página web.

Marcador de la estructura y del contenido de un fichero cyloop.

Sintaxis : cyldump [nombre_fichero_cyloop]

cyldump anuncie las diferentes características de un fichero cyloop :

• característicos del ciclo en curso,
• característicos de la variable,
• datos almacenado para cada uno de los instantes del ciclo.

El nombre de fichero cyloop a descargador puede ser pasado en parámetro (con o sin el sufijo .cyl).
En la ausencia de este parámetro, la manda cyldump comienza por pedir el nombre de este fichero.

Incrementación de una variable de tipo contador.

Sintaxis : cylincr nombre_fichero_cyloop

El parámetro nombre_fichero_cyloop es obligatorio.

cylincr permite incrementar la variable del fichero nombre_fichero_cyloop al instante corriente del ciclo en curso, cuando esta variable es de tipo contador.

El incrementación del contador es sistemático durante la primera llamada de cylincr para un nuevo instante del ciclo.

Si otras llamadas de cylincr ocurren que duran el mismo instante del ciclo, serán contabilizados o ignorados según los característicos de la variable.

Asimismo, en caso de cambio de ciclo desde la llamada precedente de cylincr, un cálculo de ponderación es efectuado sobre los datos de los ciclos precedentes ya almacenado, cuando este cálculo ha sido previsto para la variable.

Inserción de un nuevo valor en una variable que no es de tipo contador

Sintaxis : cyladdval nombre_fichero_cyloop valor

Los parámetros nombre_fichero_cyloop y valor son obligatorio.

cyladdval permite añadir el dato valor a la variable del fichero nombre_fichero_cyloop al instante corriente del ciclo en curso, cuando esta variable no es de tipo contador.

El adición del dato es sistemático durante la primera llamada de cyladdval para un nuevo instante del ciclo.

Si otras llamadas de cyladdval ocurren que duran el mismo instante del ciclo, serán contabilizados o ignorados según los característicos de la variable.

Asimismo, en caso de cambio de ciclo desde la llamada precedente de cyladdval, un cálculo de ponderación es efectuado sobre los datos de los ciclos precedentes ya almacenado, cuando este cálculo ha sido previsto para la variable.

Generación de gráficos a marchar de un fichero cyloop

Sintaxis : cylgraph

nombre_fichero_cyloop nombre_fichero_imagen opciones_generales descripciones_trazadas

Los parámetros nombre_fichero_cyloop y nombre_fichero_imagen son obligatoria.

cylgraph genera una imagen nombre_fichero_imagen a marchar del fichero nombre_fichero_cyloop.

Opciones generales

Estas primeras opciones son todas facultativas y pueden aparecer en cualquier orden. Implican las propiedades de la imagen generada.

• [-h altura_gráfica]
• [-w anchura_gráfico]
• [-H altura_imagen]
• [-W anchura_imagen]
• [-T título_imagen]
• [-p]

-h permite precisar la altura altura_gráfica en pixels del gráfico integrado a la imagen generada.
Por defecto, esta altura es de 100 pixels, salvo si la altura total de la imagen es fijada a un valor inferior.

-w permite precisar la anchura anchura_gráfico en pixels del gráfico integrado a la imagen generada.
Por defecto, esta anchura es de 400 pixels, salvo si la anchura total de la imagen es fijada a un valor inferior.

-H permite precisar la altura altura_imagen en pixels de la imagen.
Por defecto, esta altura es de 50 pixels además que la altura del gráfico.

-W permite precisar la anchura anchura_image en pixels de la imagen.
Por defecto, esta anchura es de 100 pixels además que la anchura del gráfico. Por informe a la anchura escogida, es redondeada siempre al múltiplo de 8 superior.

-T permite añadir arriba de la imagen generada el título título_imagen

-p demanda de anunciar la escalera vertical del gráfico bajo la forma de porcentajes, antes que bajo la forma de valores numéricos brutos.

Descripción de los trazados

La descripción de los trazados es constituida de una serie de opciones que tienen la forma siguiente :

-[m|M](tespesura|a) color

Las opciones que siguen permiten cada una describir un trazado inclusive en el gráfico.

Puede tener varios trazados (hasta 12). En este caso, los diferentes trazado son insertar en el gráfico en el orden en el cual son mencionados. Cuando varios trazados se coincident en el gráfico, es el último trazado que es prioritario y que dará al pixel su color.

-tespesura color

traza en el gráfico la curva que corresponde al valor mediano de los datos de la variable a los diferentes instantes del ciclo.
La opción -t es seguida inmediatamente (sin ningún espacio) de la cifra espesura (de 1 a 9) que corresponde al espesura del rasgo en pixels.
Sin embargo, la espesura de un rasgo ha limitado a 3 pixels en el sentido horizontal.

El parámetro color que sigue define el color del rasgo. Es expresado bajo la forma de 6 caracteres hexadecimales.

• los 2 primeras caracteres de 00 a FF corresponden a la luminosidad de la componente roja (en síntesis aditiva de los colores),
• los 2 caracteres siguientes, a la luminosidad de la componente verde,
• los 2 últimos, a la luminosidad de la componente azul.

-a color

traza en el gráfico la curva que corresponde al valor mediano de los datos de la variable a los diferentes instantes del ciclo.
Esta curva es representada bajo la forma de una superficie de color uniforme color que comienza al bajo del gráfico.
El color de la superficie es expresada del mismo modo que para la opción -t

-mtespesura color

similar a la opción -t salvo que el trazado implica el valor mínimo del dato para cada instante del ciclo.

-ma color

similar a la opción -a salvo que el trazado de la superficie implica el valor mínimo del dato para cada instante del ciclo.

-Mtespesura color

similar a la opción -t salvo que el trazado implica el valor máximo del dato para cada instante del ciclo.

-Ma color

similar a la opción -a salvo que el trazado de la superficie implica el valor máximo del dato para cada instante del ciclo.

Formatos de imagen

La manda cylgraph puede generar imágenes en de numeroso formato.
El formato de la imagen generada depende del sufijo del fichero nombre_fichero_imagen pasada en parámetro.

Sin embargo, con el fin de dar soporte numerosos formatos de imagen, la manda cylgraph apelado a la manda convert del proyecto ImageMagick.

En la ausencia de este encargo, las imágenes son generadas al formato bmp y los nombres del fichero imagen se terminan por el sufijo .bmp

Configuración : el fichero sysfont

El fichero sysfont es un fichero sistema opcional del proyecto cyloop.

Tiene que ser creado sí necesario en el momento de la instalación de cyloop.

Este fichero no es útil que cuando el computador no utiliza el juego de caracteres UTF-8 (es a decir cuando la variable de medio ambiente $LANG no se termina por UTF-8).

En este caso, es utilizado por la manda cylgraph con el fin de utilizar el buen juego de caracteres para insertar del texto en los gráficos generados.

Implantación

Si los encargos ejecutables del proyecto Cyloop son implantadas en /usr/bin como casi los demás encargos del sistema de explotación, el fichero sysfont tiene que ser implantado en /usr/share/cyloop

En el caso contrario, tiene que ser implantado en el mismo repertorio que los ficheros ejecutables del proyecto Cyloop sea : (...)/cyloop/bin

Contenido

El contenido del fichero sysfont se limita al nombre de un fichero deshielo (sin otra carácter antes o después sobre todo de los blancos).

Los nombres de ficheros deshielo posible están :

iso8859-2	iso8859-3	iso8859-4	iso8859-5
iso8859-6	iso8859-7	iso8859-8	iso8859-9
iso8859-10	iso8859-11	iso8859-13	iso8859-14
iso8859-15	iso8859-16	windows-1252

El nombre iso8859-1 es autorizado igualmente, pero el fichero sysfont no es necesario si se utiliza este juego de caracteres, ya que es el juego de caracteres por defecto.