package org.opentrafficsim.draw.graphs.road;
import java.awt.Color;
import java.util.List;
import org.djunits.unit.DurationUnit;
import org.djunits.unit.LinearDensityUnit;
import org.djunits.value.ValueRuntimeException;
import org.djunits.value.storage.StorageType;
import org.djunits.value.vdouble.matrix.DurationMatrix;
import org.djunits.value.vdouble.matrix.base.DoubleMatrix;
import org.djunits.value.vdouble.scalar.Duration;
import org.djunits.value.vdouble.scalar.Length;
import org.djunits.value.vdouble.scalar.Time;
import org.djunits.value.vfloat.vector.FloatSpeedVector;
import org.opentrafficsim.core.dsol.OTSSimulatorInterface;
import org.opentrafficsim.core.egtf.Converter;
import org.opentrafficsim.core.egtf.Quantity;
import org.opentrafficsim.draw.core.BoundsPaintScale;
import org.opentrafficsim.draw.graphs.AbstractContourPlot;
import org.opentrafficsim.draw.graphs.ContourDataSource;
import org.opentrafficsim.draw.graphs.ContourDataSource.ContourDataType;
import org.opentrafficsim.draw.graphs.GraphType;
import org.opentrafficsim.draw.graphs.GraphUtil;
import org.opentrafficsim.kpi.sampling.SamplingException;
import org.opentrafficsim.kpi.sampling.Trajectory;
import org.opentrafficsim.kpi.sampling.TrajectoryGroup;
import org.opentrafficsim.road.network.sampling.GtuData;
import org.opentrafficsim.road.network.sampling.data.ReferenceSpeed;
/**
* Contour plot for delay.
*
* A note on the unit "/km". This unit is derived by measuring the total delay over a cell in space-time, which gives an
* SI value in [s]. With varying granularity, the value needs to be normalized to space-time. Hence, the value is divided by the
* length of the cell [m], and divided by the duration of the cell [s]. This gives a unit of [s/s/m] = [1/m]. This means that a
* traffic state represented by a value of D/km, gives a total amount of delay equal to D * x * t, where x * t is the size of
* the cell, and the resulting value is in the same unit as t. So if D = 50/km, then measuring this state over 2km and during 3
* hours gives 50 * 2 * 3 = 300h of delay.
*
* Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
* BSD-style license. See OpenTrafficSim License.
*
* @version $Revision$, $LastChangedDate$, by $Author$, initial version 10 okt. 2018
* @author Alexander Verbraeck
* @author Peter Knoppers
* @author Wouter Schakel
*/
public class ContourPlotDelay extends AbstractContourPlot
{
/** */
private static final long serialVersionUID = 20181010L;
/** Quantity for the EGTF. */
private static final Quantity QUANTITY = new Quantity<>("delay", new Converter()
{
/** {@inheritDoc} */
@Override
public DurationMatrix convert(final double[][] filteredData)
{
try
{
return DoubleMatrix.instantiate(filteredData, DurationUnit.SI, StorageType.DENSE);
}
catch (ValueRuntimeException exception)
{
// should not happen as filtered data comes from the EGTF
throw new RuntimeException("Unexpected exception while converting duration to output format.", exception);
}
}
});
/** Contour data type. */
private static final ContourDataType CONTOUR_DATA_TYPE = new ContourDataType()
{
/** {@inheritDoc} */
@Override
public Duration identity()
{
return Duration.ZERO;
}
/** {@inheritDoc} */
@Override
public Duration processSeries(final Duration intermediate, final List> trajectories, final List<
Length> xFrom, final List xTo, final Time tFrom, final Time tTo)
{
double sumActualTime = 0.0;
double sumRefTime = 0.0;
for (int i = 0; i < trajectories.size(); i++)
{
TrajectoryGroup> trajectoryGroup = trajectories.get(i);
for (Trajectory> trajectory : trajectoryGroup.getTrajectories())
{
if (GraphUtil.considerTrajectory(trajectory, tFrom, tTo))
{
trajectory = trajectory.subSet(xFrom.get(i), xTo.get(i), tFrom, tTo);
try
{
FloatSpeedVector ref = trajectory.getExtendedData(ReferenceSpeed.INSTANCE);
float[] v = trajectory.getV();
float[] x = trajectory.getX();
for (int j = 0; j < v.length - 1; j++)
{
sumRefTime += (x[j + 1] - x[j]) / ref.get(j).si;
}
}
catch (SamplingException | ValueRuntimeException exception)
{
throw new RuntimeException("Unexpected exception while calculating delay.", exception);
}
sumActualTime += trajectory.getTotalDuration().si;
}
}
}
return Duration.instantiateSI(intermediate.si + sumActualTime - sumRefTime);
}
/** {@inheritDoc} */
@Override
public Duration finalize(final Duration intermediate)
{
return intermediate;
}
/** {@inheritDoc} */
@SuppressWarnings("synthetic-access")
@Override
public Quantity getQuantity()
{
return QUANTITY;
}
};
/**
* Constructor. In case this plot is created live, the sampler of the sample data in the data source needs to have the
* extended data type {@code ReferenceSpeed.INSTANCE} registered.
* @param caption String; caption
* @param simulator OTSSimulatorInterface; simulator
* @param dataPool ContourDataSource<GtuData>; data pool
*/
public ContourPlotDelay(final String caption, final OTSSimulatorInterface simulator, final ContourDataSource<
GtuData> dataPool)
{
super(caption, simulator, dataPool, createPaintScale(), new Duration(0.05, DurationUnit.SI), "%.1f/km",
"delay %.1f /km");
}
/**
* Creates a paint scale from red, via yellow to green.
* @return ContinuousColorPaintScale; paint scale
*/
private static BoundsPaintScale createPaintScale()
{
double[] boundaries = {0.0, 0.05, 0.2};
Color[] colorValues = BoundsPaintScale.GREEN_RED;
return new BoundsPaintScale(boundaries, colorValues);
}
/** {@inheritDoc} */
@Override
public GraphType getGraphType()
{
return GraphType.DELAY_CONTOUR;
}
/** {@inheritDoc} */
@Override
protected double scale(final double si)
{
return LinearDensityUnit.PER_KILOMETER.getScale().fromStandardUnit(si);
}
/** {@inheritDoc} */
@Override
protected double getValue(final int item, final double cellLength, final double cellSpan)
{
return getDataPool().get(item, CONTOUR_DATA_TYPE) / (cellLength * cellSpan);
}
/** {@inheritDoc} */
@Override
protected ContourDataType getContourDataType()
{
return CONTOUR_DATA_TYPE;
}
}