org.opentrafficsim.draw.egtf.Quantity Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of ots-draw Show documentation
OTS drawing classes that can paint themselves using data objects
The newest version!
package org.opentrafficsim.draw.egtf;

/**
 * Defines a quantity that data sources can provide, such as speed, flow, etc.
 * 
 * Copyright (c) 2013-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. 

 * BSD-style license. See OpenTrafficSim License.
 * 
 * @author Wouter Schakel
 * @param  data type
 * @param  grid output format
 */
public class Quantity
{
    /** Standard quantity for speed. */
    public static final Quantity SPEED_SI = new Quantity<>("Speed", true, Converter.SI);

    /** Standard quantity for flow. */
    public static final Quantity FLOW_SI = new Quantity<>("Flow", Converter.SI);

    /** Standard quantity for density. */
    public static final Quantity DENSITY_SI = new Quantity<>("Density", Converter.SI);

    /** Name. */
    private final String name;

    /** Whether this quantity is speed. */
    private final boolean speed;

    /** Converter for output format. */
    private final Converter converter;

    /**
     * Constructor.
     * @param name String; name
     * @param converter Converter<K>; converter for output format
     */
    public Quantity(final String name, final Converter converter)
    {
        this(name, false, converter);
    }

    /**
     * Constructor. Protected so only the default SPEED_SI quantity is speed.
     * @param name String; name
     * @param speed boolean; whether this quantity is speed
     * @param converter Converter<K>; converter for output format
     */
    protected Quantity(final String name, final boolean speed, final Converter converter)
    {
        this.name = name;
        this.speed = speed;
        this.converter = converter;
    }

    /**
     * Returns a quantity with {@code double[][]} containing SI values as output format.
     * @param name String; name
     * @return quantity with {@code double[][]} containing SI values as output format
     */
    public static Quantity si(final String name)
    {
        return new SI<>(name);
    }

    /**
     * Returns the name.
     * @return String; name
     */
    public final String getName()
    {
        return this.name;
    }

    /**
     * Returns whether this quantity is speed.
     * @return boolean; whether this quantity is speed
     */
    final boolean isSpeed()
    {
        return this.speed;
    }

    /**
     * Converts the filtered data to an output format.
     * @param data double[][]; filtered data
     * @return K; output data
     */
    final K convert(final double[][] data)
    {
        return this.converter.convert(data);
    }

    /** {@inheritDoc} */
    @Override
    public int hashCode()
    {
        final int prime = 31;
        int result = 1;
        result = prime * result + ((this.name == null) ? 0 : this.name.hashCode());
        return result;
    }

    /** {@inheritDoc} */
    @Override
    public boolean equals(final Object obj)
    {
        if (this == obj)
        {
            return true;
        }
        if (obj == null)
        {
            return false;
        }
        if (getClass() != obj.getClass())
        {
            return false;
        }
        Quantity other = (Quantity) obj;
        if (this.name == null)
        {
            if (other.name != null)
            {
                return false;
            }
        }
        else if (!this.name.equals(other.name))
        {
            return false;
        }
        return true;
    }

    /** {@inheritDoc} */
    @Override
    public String toString()
    {
        return "Quantity [name=" + this.name + "]";
    }

    /**
     * Class to return in {@code double[][]} output format.
     * @param  data type
     */
    private static class SI extends Quantity
    {

        /**
         * Constructor.
         * @param name String; String name
         */
        SI(final String name)
        {
            super(name, Converter.SI);
        }

        /** {@inheritDoc} */
        @Override
        public String toString()
        {
            return "SI []";
        }

    }

}