jaxon-php / jaxon-mono

jaxon-flot/src/Data/Series.php

<?php

/**
 * Series.php - Contains data to be printed in a graph.
 *
 * @package jaxon-flot
 * @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @copyright 2017 Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-flot
 */

namespace Jaxon\Flot\Data;

use JsonSerializable;
use stdClass;

use function count;

class Series implements JsonSerializable
{
    /**
     * The points
     *
     * @var array
     */
    protected $aPoints;

    /**
     * The points values
     *
     * @var array
     */
    protected $aValues;

    /**
     * The points labels
     *
     * @var array
     */
    protected $aLabels;

    /**
     * The constructor.
     */
    public function __construct()
    {
        $this->aPoints = [];
        $this->aValues = ['data' => null, 'func' => null];
        $this->aLabels = ['data' => null, 'func' => null];
    }

    /**
     * Add a point to the series.
     *
     * @param integer       $iXaxis                 The point on the X axis
     * @param string        $sLabel                 The value on the graph
     *
     * @return static
     */
    public function point($iXaxis, $xValue, $sLabel = ''): static
    {
        $this->aPoints[] = $iXaxis;
        if(!$this->aValues['data'])
        {
            $this->aValues['data'] = [];
        }
        $this->aValues['data'][$iXaxis] = $xValue;
        if(($sLabel))
        {
            if(!$this->aLabels['data'])
            {
                $this->aLabels['data'] = [];
            }
            $this->aLabels['data'][$iXaxis] = $sLabel;
        }
        return $this;
    }

    /**
     * Add an array of points to the series.
     *
     * @param array         $aPoints                The points to be added
     *
     * @return int
     */
    public function points($aPoints): int
    {
        foreach($aPoints as $aPoint)
        {
            if(count($aPoint) === 2)
            {
                $this->point($aPoint[0], $aPoint[1]);
            }
            else if(count($aPoint) === 3)
            {
                $this->point($aPoint[0], $aPoint[1], $aPoint[2]);
            }
        }
        return count($this->aPoints);
    }

    /**
     * Add points to the graph series using an expression.
     *
     * @param numeric       $iStart                 The first point
     * @param numeric       $iEnd                   The last point
     * @param numeric       $iStep                  The step between next points

The type Jaxon\Flot\Data\numeric was not found. Maybe you did not declare it correctly or list all dependencies?

     * @param string        $sJsValue               The javascript function to compute points values
     * @param string        $sJsLabel               The javascript function to make points labels
     *
     * The first three parameters are used in a for loop.
     * The x variable is used in the $sJsValue javascript function to represent each point.
     * The series, x and y variables are used in the $sJsLabel javascript function to
     * represent resp. the series label, the xaxis and graph values of the point.
     *
     * @return int
     */
    public function expr($iStart, $iEnd, $iStep, $sJsValue, $sJsLabel = ''): int
    {
        for($x = $iStart; $x < $iEnd; $x += $iStep)
        {
            $this->aPoints[] = $x;
        }
        $this->aValues['func'] = $sJsValue;
        if(($sJsLabel))
        {
            $this->aLabels['func'] = $sJsLabel;
        }
        return count($this->aPoints);
    }

    /**
     * Convert this object to another object more suitable for json format.
     *
     * This is a method of the JsonSerializable interface.
     *
     * @return stdClass
     */
    public function jsonSerialize(): stdClass
    {
        // Surround the js var with a special marker that will later be removed
        // Note: does not work when returning an array
        $json = new stdClass;
        $json->points = $this->aPoints;
        $json->values = $this->aValues;
        $json->labels = $this->aLabels;
        return $json;
    }
}