Documentaciónxy(xs, ys, titulo, archivo)

xy(xs,ys,titulo,archivo)\texttt{xy}(xs, ys, titulo, archivo)

Nombre

xy - Grafica una sola serie xy a partir de dos vectores numericos.

Sinopsis

ok = graficos.xy(xs, ys, titulo, archivo)

Descripcion

Es un atajo historico para dibujar una unica serie xy.

Formato general:

ejemplo.blox
ok = graficos.xy(xs, ys, "Serie XY", "salida.png")

La misma idea puede expresarse hoy con graficos.graficar_trayectorias() o graficos.graficar_trayectoria().

Comportamiento

  • Asume una serie de tipo xy.
  • Prepara una configuracion minima de ejes.
  • Delega la generacion real en graficos.graficar_trayectorias().
  • Se mantiene como wrapper de conveniencia, no como punto de entrada principal del grupo.

Funciones API relacionadas

  • graficos.graficar_trayectoria()
  • graficos.xt()
  • graficos.graficar_trayectorias()
  • graficos.graficar_trayectorias_n()
  • graficos.graficar_trayectorias_t()

Parámetros

ParámetroTipoDescripción
xsVECTORVector numerico con valores del eje X.
ysVECTORVector numerico con valores del eje Y.
tituloSTRINGTitulo visible del grafico.
archivoSTRINGNombre o ruta del archivo de entrada o salida.

Valor de retorno

VOID - No retorna valor. Genera el grafico y escribe el archivo PNG indicado.

Ejemplo

ejemplo.blox
INCLUIR "vectores.api"
INCLUIR "graficos.api"


FUNCION PRINCIPAL
INICIO

    STRING   expr, titulo
    NUMERICO dimension
    TABLA    ret, rango
    

    // La funcion carga_formula() es sensible al tipo de variable
    // de la expresion expr, si usa "x", en rango puedes usar "x_min"
    // Y el valor de retorno es {x = ..., y = ...}
    //
    expr = "10*sin(2*pi*x/3)"
    dimension = 300
    rango = {   x_min = 0, 
                x_max = 2*pi }

    ret = vectores.carga_formula(expr, dimension, rango)

    titulo = expr
    graficos.xy(ret.x, ret.y , titulo, "PROG41 - GRAFICO - xy().png")


FINAL```