Vctls\IntervalGraph\IntervalGraph

Complexity

Total Complexity

61

Size/Duplication

Total Lines	551
Duplicated Lines	0 %

Importance

Changes	11
Bugs	0	Features	0

24 Methods

Rating	Name	Duplication	Size	Complexity
A	getFlattener()	0	3	1
A	setFlattener()	0	4	1
A	jsonSerialize()	0	6	2
A	setTemplate()	0	4	1
A	setAggregator()	0	4	1
A	getPalette()	0	3	1
A	getAggregator()	0	3	1
A	setPalette()	0	4	1
A	getValues()	0	3	1
A	getTemplate()	0	3	1
A	setBoundToNumeric()	0	4	1
A	__toString()	0	8	2
B	checkIntervals()	0	55	10
A	draw()	0	17	2
A	__construct()	0	25	4
A	setBoundToString()	0	4	1
A	setValueToNumeric()	0	4	1
F	createView()	0	97	15
A	getIntervals()	0	3	1
A	getFlatIntervals()	0	6	2
A	getAggregatedIntervals()	0	9	2
A	setIntervals()	0	7	1
A	setValueToString()	0	4	1
B	computeNumericValues()	0	51	7

<?php

namespace Vctls\IntervalGraph;

use Closure;
use DateTime;
use Exception;
use InvalidArgumentException;
use JsonSerializable;

/**
 * A class to manipulate and display arrays of weighted intervals.
 *
 * @package Vctls\IntervalGraph
 */
class IntervalGraph implements JsonSerializable
{

    /** @var array Initial intervals */
    protected $intervals = [];

    /** @var array Flattened intervals */
    protected $flattened = [];

    /** @var array Aggregated flat intervals */
    protected $aggregated = [];

    /** @var array Processed values */
    protected $values = [];

    /** @var string Path to the template used for rendering. */
    protected $template = 'template.php';

    /** @var Closure Return a numeric value from the inital bound value. */
    protected $boundToNumeric;

    /** @var Closure Return a string from the initial bound value. */
    protected $boundToString;

    /** @var Closure Return a numeric value from an initial interval value. */
    protected $valueToNumeric;

    /** @var Closure Return a string value from an initial interval value. */
    protected $valueToString;

    /** @var PaletteInterface */
    protected $palette;

    /** @var FlattenerInterface */
    private $flattener;

    /** @var AggregatorInterface */
    private $aggregator;

    /**
     * Create an IntervalGraph from intervals carrying values.
     *
     * @param array[] $intervals An array of intervals,
     * with a low bound, high bound and a value.
     */
    public function __construct($intervals = [])
    {
        if (!empty($intervals)) {
            $this->setIntervals($intervals);
        }

        $this->boundToNumeric = static function (DateTime $bound) {
            return $bound->getTimestamp();
        };

        $this->boundToString = static function (DateTime $bound) {
            return $bound->format('Y-m-d');
        };

        $this->valueToNumeric = static function ($v) {
            return $v === null ? null : (int)($v * 100);
        };

        $this->valueToString = static function ($v) {
            return $v === null ? null : ($v * 100 . '%');
        };

        $this->aggregator = new ArrayReduceAggregator();
        $this->flattener = new Flattener();
        $this->palette = new ClassPalette();
    }

    /**
     * @return FlattenerInterface
     */
    public function getFlattener(): FlattenerInterface
    {
        return $this->flattener;
    }

    /**
     * @param FlattenerInterface $flattener
     * @return IntervalGraph
     */
    public function setFlattener(FlattenerInterface $flattener): IntervalGraph
    {
        $this->flattener = $flattener;
        return $this;
    }

    /**
     * Check that an array of intervals is correctly formatted.
     *
     * The first element must be the low bound.
     *
     * The second element must be the high bound.
     *
     * The third element must be the value.
     *
     * Inverted end and low bounds will be put back in chronological order.
     *
     * @return $this
     */
    public function checkIntervals(): self
    {
        foreach ($this->intervals as $intervalKey => $interval) {
            // Check that the interval is an array.
            if (!is_array($interval)) {
                $t = gettype($interval);
                throw new InvalidArgumentException(
                    "Each element of the '\$intervals' array should be an array, $t given."
                );
            }

            // Check that the bounds and value of the interval can be converted to both a numeric
            // and string value with the given closures.
            foreach ([['Lower bound', 'bound'], ['Higher bound', 'bound'], ['Value', 'value']] as $index => $property) {
                // Skip value property of valueless intervals.
                if ($property[1] === 'value' && !isset($interval[$index])) {
                    continue;
                }

                foreach (['numeric', 'string'] as $expectedType) {
                    $expectedTypeTitle = ucfirst($expectedType);

                    try {
                        $value = ($this->{"$property[1]To$expectedTypeTitle"})($interval[$index]);
                    } catch (Exception $exception) {
                        // FIXME Handle Type errors?
                        throw new PropertyConversionException(
                            "$property[0] of interval $intervalKey cannot be converted to a $expectedType value " .
                            "with the given '$property[1]To$expectedTypeTitle' function. Error : " .
                            $exception->getMessage()
                        );
                    }

                    $actualType = gettype($value);

                    if (!call_user_func("is_$expectedType", $value)) {
                        throw new PropertyConversionException(
                            "$property[0] of interval $intervalKey is not converted to a $expectedType value " .
                            "by the given '$property[1]To$expectedTypeTitle' function. Returned type : $actualType"
                        );
                    }
                }
            }

            // Ensure start and high bounds are in the right order.
            if ($interval[0] > $interval [1]) {
                $a = $interval[0];
                $intervals[$intervalKey][0] = $interval[1];
                $intervals[$intervalKey][1] = $a;
            }
        }

        // TODO Check that the values can be aggregated with the given closure.

        return $this;
    }

    /**
     * Render an HTML view of the intervalGraph.
     *
     * @return string
     */
    public function __toString()
    {
        try {
            $html = $this->draw();
        } catch (Exception $e) {
            $html = 'Error : ' . $e->getMessage();
        }
        return $html;
    }

    /**
     * Render an HTML view of the intervalGraph.
     *
     * @return string
     */
    public function draw(): string
    {
        if (empty($this->values)) {
            $this->createView();
        }

        /** @noinspection PhpUnusedLocalVariableInspection */
        $vs = $this->values;
        ob_start();
        /** @noinspection PhpIncludeInspection */
        include $this->template;

        // Remove all surplus whitespace.
        return preg_replace(
            ['/(?<=>)\s+/', '/\s+(?=<)/', '/\s+/'],
            ['', '', ' '],
            ob_get_clean()
        );
    }

    /**
     * Returns an array of adjacent, non-overlapping intervals.
     * The value of each interval is an array of all the values of the correspondig original intervals.
     *
     * The array can be returned by reference to be modified if needed.
     *
     * ⚠ Flat intervals will be purged when setting new original intervals.
     *
     * @return array[] Array of adjacent, non-overlapping intervals.
     */
    public function &getFlatIntervals(): array
    {
        if (empty($this->flattened)){
            $this->flattened = $this->flattener->flatten($this->intervals);
        }
        return $this->flattened;
    }

    /**
     * Return an array of adjacent, non-overlapping intervals with aggregated values.
     *
     * The array can be returned by reference to be modified if needed.
     *
     * ⚠ Aggregated intervals will be purged when setting new original intervals.
     *
     * @return array[] Array of adjacent, non-overlapping intervals with aggregated values.
     */
    public function &getAggregatedIntervals(): array
    {
        if (empty($this->aggregated)){
            $this->aggregated = $this->aggregator->aggregate(
                $this->getFlatIntervals(),
                $this->intervals
            );
        }
        return $this->aggregated;
    }

    /**
     * Process intervals and store processed values.
     *
     * @return IntervalGraph
     */
    public function createView(): IntervalGraph
    {
        $flatIntervals = $this->getAggregatedIntervals();

        // Extract values.
        $originalValues = array_column($flatIntervals, 2);

        $numVals = [];

        // Change bounds to numeric values.
        foreach ($flatIntervals as $interval) {
            $numVals[] = [
                ($this->boundToNumeric)($interval[0]),
                ($this->boundToNumeric)($interval[1]),
            ];
        }

        // Order by low bound.
        uasort(
            $numVals,
            static function (array $i1, array $i2) {
                return ($i1[0] < $i2[0]) ? -1 : 1;
            }
        );

        // Get the min bound value.
        $min = reset($numVals)[0];

        // Substract min from all bound values.
        foreach ($numVals as $key => $numVal) {
            $numVals[$key] = [
                $numVal[0] - $min,
                $numVal[1] - $min
            ];
        }

        // Order by high bound.
        uasort(
            $numVals,
            static function (array $i1, array $i2) {
                return ($i1[1] < $i2[1]) ? -1 : 1;
            }
        );

        // Get max timestamp.
        $max = end($numVals)[1];

        // Calculate percentages.
        foreach ($numVals as $i => $numVal) {
            foreach ($numVal as $j => $value) {
                $numVal[$j] = $max === 0 ? 0 : round($value * 100 / $max, 2);
            }
            $numVals[$i] = $numVal;
        }

        // Put values back in, along with the formatted bound.
        // Since we're using associative sorting functions, we know the keys haven't changed.
        $numKeys = array_keys($numVals);
        foreach ($numKeys as $numKey) {
            [$lowBound, $highBound] = $flatIntervals[$numKey];
            [$startPercent, $endPercent] = $numVals[$numKey];

            if ($lowBound === $highBound) {
                $numVals[$numKey] = [
                    $startPercent, // Single value position percentage
                    ($this->boundToString)($lowBound), // Single value string
                ];
            } else {
                $colval = isset($originalValues[$numKey]) ? ($this->valueToNumeric)($originalValues[$numKey]) : null;
                $strval = isset($originalValues[$numKey]) ? ($this->valueToString)($originalValues[$numKey]) : null;

                $numVals[$numKey] = [
                    $startPercent, // Interval start percentage
                    100 - $endPercent, // Interval end percentage from right
                    // Note: for some reason, using 'widht' instead of 'right'
                    // causes the right border to be hidden underneath the next interval.
                    !empty($originalValues) ? $this->palette->getColor($colval) : 50, // Interval color
                    ($this->boundToString)($lowBound), // Interval start string value
                    ($this->boundToString)($highBound), // Interval end string value
                    !empty($originalValues) ? $strval : null,// Interval string value
                ];
            }
        }

        // Put discrete values at the end and reset indices.
        // Reseting indices ensures the processed values are
        // serialized as correctly ordered JSON arrays.
        usort(
            $numVals,
            static function ($i) {
                return count($i) === 2 ? 1 : -1;
            }
        );

        $this->values = $numVals;

        return $this;
    }

    /**
     * Compute the numeric values of interval bounds and values.
     *
     * @return array
     */
    public function computeNumericValues(): array
    {
        $intervals = $this->getAggregatedIntervals();

        // Extract interval values.
        $intervalValues = array_column($intervals, 2);
        $numericIntervals = [];
        // Convert bounds to numeric values.
        foreach ($intervals as $interval) {
            $numericIntervals[] = [
                ($this->boundToNumeric)($interval[0]),
                ($this->boundToNumeric)($interval[1]),
            ];
        }

        // Order by high bound.
        uasort(
            $numericIntervals,
            static function (array $i1, array $i2) {
                return ($i1[1] < $i2[1]) ? -1 : 1;
            }
        );


        // Put values back in, along with the formatted bound.
        // Since we're using associative sorting functions, we know the keys haven't changed.
        foreach (array_keys($numericIntervals) as $index => $numKey) {
            [$lowNumericBound, $highNumericBound] = $numericIntervals[$index];

            if ($lowNumericBound === $highNumericBound) {
                $numericIntervals[$index] = $lowNumericBound;
            } else {
                $numericIntervals[$index] = [
                    $lowNumericBound,
                    $highNumericBound,
                    $intervalValues[$index] ?: 0
                ];
            }
        }

        // Put discrete values at the end and reset indices.
        // Reseting indices ensures the processed values are
        // serialized as correctly ordered JSON arrays.
        usort(
            $numericIntervals,
            static function ($i) {
                return !is_array($i) ? 1 : -1;
            }
        );

        return $numericIntervals;
    }

    /**
     * Define the function to convert the interval values to a numeric value
     * in order to match them to a color on the palette.
     *
     * @param Closure $valueToNumeric
     * @return IntervalGraph
     */
    public function setValueToNumeric(Closure $valueToNumeric): IntervalGraph
    {
        $this->valueToNumeric = $valueToNumeric;
        return $this;
    }

    /**
     * Define the  function to convert the interval values to strings
     * in order to display them in the view.
     *
     * @param Closure $valueToString
     * @return IntervalGraph
     */
    public function setValueToString(Closure $valueToString): IntervalGraph
    {
        $this->valueToString = $valueToString;
        return $this;
    }

    /**
     * Set the function to convert interval bound values to string.
     *
     * @param Closure $boundToString
     * @return IntervalGraph
     */
    public function setBoundToString(Closure $boundToString): IntervalGraph
    {
        $this->boundToString = $boundToString;
        return $this;
    }

    /**
     * @return array
     */
    public function getIntervals(): array
    {
        return $this->intervals;
    }

    /**
     * Set the intervals to be processed.
     *
     * ⚠ If another set of intervals was previously processed,
     * stored flat and aggregated intervals and processed values will be deleted.
     *
     * @param array $intervals
     * @return IntervalGraph
     */
    public function setIntervals(array $intervals): IntervalGraph
    {
        $this->intervals = $intervals;
        $this->flattened = [];
        $this->aggregated = [];
        $this->values = [];
        return $this;
    }

    /**
     * @return array
     */
    public function getValues(): array
    {
        return $this->values;
    }

    /**
     * @return string
     */
    public function getTemplate(): string
    {
        return $this->template;
    }

    /**
     * Set the PHP template to use for rendering.
     *
     * @param string $template
     * @return IntervalGraph
     */
    public function setTemplate(string $template): IntervalGraph
    {
        $this->template = $template;
        return $this;
    }

    /**
     * @return PaletteInterface
     */
    public function getPalette(): PaletteInterface
    {
        return $this->palette;
    }

    /**
     * Set the Palette object to be used to determine colors.
     *
     * @param PaletteInterface $palette
     * @return IntervalGraph
     */
    public function setPalette(PaletteInterface $palette): IntervalGraph
    {
        $this->palette = $palette;
        return $this;
    }

    /**
     * @param Closure $boundToNumeric
     * @return IntervalGraph
     */
    public function setBoundToNumeric(Closure $boundToNumeric): IntervalGraph
    {
        $this->boundToNumeric = $boundToNumeric;
        return $this;
    }

    /**
     * Return the array of values to be serialized by json_encode.
     *
     * @return array
     */
    public function jsonSerialize(): array
    {
        if (!isset($this->values)) {
            $this->createView();
        }
        return $this->values;
    }

    /**
     * @return AggregatorInterface
     */
    public function getAggregator(): AggregatorInterface
    {
        return $this->aggregator;
    }

    /**
     * @param AggregatorInterface $aggregator
     * @return IntervalGraph
     */
    public function setAggregator(AggregatorInterface $aggregator): IntervalGraph
    {
        $this->aggregator = $aggregator;
        return $this;
    }

}