Librería JPGraph para crear gráficos rápidamente

23 de junio de 20103 min de lectura
JpGraph es una librería PHP que nos permitirá la creación de gráficos de forma sencilla. Soporta una gran cantidad de tipos de gráficos, lineales, de barras, sectores,... y los gráficos que genera rara vez superan los 5 KB de tamaño.

Entre las características de esta librería podemos destacar:

  • Detecta de forma automática la versión de librería GD que tiene instalado.
  • Se puede asignar texto a las imágenes y seleccionar el tipo de letra que queremos ponerle.
  • Manejo de las escalas para los  ejes de las gráficas.
  • Soporta formatos de imágenes PNG, GIF y JPG.
  • Tiene una gran documentación con referencias a todas las funciones disponibles.
  • Se pueden mezclar tipo distintos de gráficas en una misma imagen.

Vamos a ver un ejemplo donde crearemos en una imagen una gráfica de barras y otra lineal con los mismos datos.

Lo primero que hay que hacer es descargarse le librería del sitio oficial y descomprimirla. De todos los archivos que nos traiga el descargable, nos quedamos con el contenido de la carpeta “src”. Nosotros en nuestro ejemplo la hemos llamado “inc”.

El siguiente paso, será incluir en nuestro archivo php los archivos que contienen las funciones para la generación de los gráficos. En nuestro caso hemo incluido los siguientes ficheros:

  • jpgraph.php: Contiene las funciones básicas para la creación del gráfico.
  • jpgraph_bar.php : Contiene las funciones básicas para la generación del gráfico de barras.
  • jpgraph_line.php: Contiene las funciones básicas para la generación del gráfico lineal.

Lo siguiente en crear el array con los datos de la gráfica.

$datos = array(11, 3, 8, 12, 5, 1, 9, 13, 5, 7);

Ya que tenemos los datos que queremos representar en el gráfico, creamos el gráfico donde lo representaremos.

$graph = new Graph(350, 250, "auto");   
$graph->SetScale("textlin");
$graph->img->SetMargin(40, 20, 20, 40);
$graph->title->Set("Gráfico Demostración");
$graph->xaxis->title->Set("Altura" );
$graph->yaxis->title->Set("Total" );

En nuestro caso hemos creado un gráfico de 350 x 250 de tamaño y le hemos indicado los márgenes a partir de donde se pintará el gráfico y el texto de la cabecera y el de los ejes.

A continuación creamos el primer tipo de gráfico, el de barras, y se lo añadimos al gráfico creado.

$barplot =new BarPlot($datos);
$barplot->SetColor("red");
$graph->Add($barplot);

Hacemos lo mismo con el otro tipo de gráfico, el lineal.

$lineplot1 = new LinePlot($datos);
$lineplot1->SetColor("blue");
$graph->Add($lineplot1);

Ya solo nos quedaría mostrarlo en el navegador

$graph->Stroke();

El resultado que se conseguiría sería el siguiente:




Gracias a la documentación que aporta esta librería, no tendréis problemas en crear gráficos más complicados y vistosos.

Sigue leyendo