org.opentrafficsim.road.network.sampling

Class Query

java.lang.Object

org.opentrafficsim.road.network.sampling.Query

public final class Query
extends Object

A query defines which subset of trajectory information should be included. This is in terms of space-time regions, and in terms of meta data of trajectories, e.g. only include trajectories of trucks.

Copyright (c) 2013-2016 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Sep 21, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
Query(Sampling sampling, String description, boolean connected, MetaDataSet metaDataSet)
Query(Sampling sampling, String description, boolean connected, MetaDataSet metaDataSet, org.djunits.value.vdouble.scalar.Duration interval)
Query(Sampling sampling, String description, boolean connected, MetaDataSet metaDataSet, org.djunits.value.vdouble.scalar.Frequency updateFrequency)
Query(Sampling sampling, String description, boolean connected, MetaDataSet metaDataSet, org.djunits.value.vdouble.scalar.Frequency updateFrequency, org.djunits.value.vdouble.scalar.Duration interval)

Method Summary

Modifier and Type	Method and Description
void	addSpaceTimeRegion(LaneDirection laneDirection, org.djunits.value.vdouble.scalar.Length xStart, org.djunits.value.vdouble.scalar.Length xEnd, org.djunits.value.vdouble.scalar.Duration tStart, org.djunits.value.vdouble.scalar.Duration tEnd) Defines a region in space and time for which this query is valid.
void	addSpaceTimeRegionLink(CrossSectionLink link, org.opentrafficsim.core.gtu.GTUDirectionality direction, org.djunits.value.vdouble.scalar.Length xStart, org.djunits.value.vdouble.scalar.Length xEnd, org.djunits.value.vdouble.scalar.Duration tStart, org.djunits.value.vdouble.scalar.Duration tEnd) Defines a region in space and time for which this query is valid.
boolean	equals(Object obj)
String	getDescription()
String	getId() return the unique id for the query.
org.djunits.value.vdouble.scalar.Duration	getInterval()
Iterator<Map.Entry<MetaDataType<?>,Set<?>>>	getMetaDataSetIterator()
Iterator<SpaceTimeRegion>	getSpaceTimeIterator()
<T> List<TrajectoryGroup>	getTrajectoryGroups(org.djunits.value.vdouble.scalar.Duration startTime, org.djunits.value.vdouble.scalar.Duration endTime) Returns a list of TrajectoryGroups in accordance with the query.
org.djunits.value.vdouble.scalar.Frequency	getUpdateFrequency()
int	hashCode()
boolean	isConnected()
int	metaDataSize()
int	spaceTimeRegionSize()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Query

public Query(Sampling sampling,
             String description,
             boolean connected,
             MetaDataSet metaDataSet)

Parameters:

sampling - sampling

description - description

connected - whether the space-time regions are longitudinally connected

metaDataSet - meta data

Throws:

NullPointerException - if sampling, description or metaDataSet is null

Query

public Query(Sampling sampling,
             String description,
             boolean connected,
             MetaDataSet metaDataSet,
             org.djunits.value.vdouble.scalar.Duration interval)

Parameters:

sampling - sampling

description - description

connected - whether the space-time regions are longitudinally connected

metaDataSet - meta data

interval - interval to gather statistics over

Throws:

NullPointerException - if sampling, description or metaDataSet is null

Query

public Query(Sampling sampling,
             String description,
             boolean connected,
             MetaDataSet metaDataSet,
             org.djunits.value.vdouble.scalar.Frequency updateFrequency)

Parameters:

sampling - sampling

description - description

connected - whether the space-time regions are longitudinally connected

metaDataSet - meta data

updateFrequency - update frequency

Throws:

NullPointerException - if sampling, description or metaDataSet is null

Query

public Query(Sampling sampling,
             String description,
             boolean connected,
             MetaDataSet metaDataSet,
             org.djunits.value.vdouble.scalar.Frequency updateFrequency,
             org.djunits.value.vdouble.scalar.Duration interval)

Parameters:

sampling - sampling

description - description

connected - whether the space-time regions are longitudinally connected

metaDataSet - meta data

updateFrequency - update frequency

interval - interval to gather statistics over

Throws:

NullPointerException - if sampling, description or metaDataSet is null

Method Detail

getId

public String getId()

return the unique id for the query.

Returns:

String; the unique id for the query

getDescription

public String getDescription()

Returns:

description

isConnected

public boolean isConnected()

Returns:

connected whether the space-time regions are longitudinally connected

getUpdateFrequency

public org.djunits.value.vdouble.scalar.Frequency getUpdateFrequency()

Returns:

updateFrequency.

getInterval

public org.djunits.value.vdouble.scalar.Duration getInterval()

Returns:

interval.

metaDataSize

public int metaDataSize()

Returns:

number of meta data entries

getMetaDataSetIterator

public Iterator<Map.Entry<MetaDataType<?>,Set<?>>> getMetaDataSetIterator()

Returns:

iterator over meta data entries, removal is not allowed

addSpaceTimeRegionLink

public void addSpaceTimeRegionLink(CrossSectionLink link,
                                   org.opentrafficsim.core.gtu.GTUDirectionality direction,
                                   org.djunits.value.vdouble.scalar.Length xStart,
                                   org.djunits.value.vdouble.scalar.Length xEnd,
                                   org.djunits.value.vdouble.scalar.Duration tStart,
                                   org.djunits.value.vdouble.scalar.Duration tEnd)

Defines a region in space and time for which this query is valid. All lanes in the link are included.

Parameters:

link - link

direction - direction

xStart - start position

xEnd - end position

tStart - start time

tEnd - end time

addSpaceTimeRegion

public void addSpaceTimeRegion(LaneDirection laneDirection,
                               org.djunits.value.vdouble.scalar.Length xStart,
                               org.djunits.value.vdouble.scalar.Length xEnd,
                               org.djunits.value.vdouble.scalar.Duration tStart,
                               org.djunits.value.vdouble.scalar.Duration tEnd)

Defines a region in space and time for which this query is valid.

Parameters:

laneDirection - lane direction

xStart - start position

xEnd - end position

tStart - start time

tEnd - end time

spaceTimeRegionSize

public int spaceTimeRegionSize()

Returns:

number of space-time regions

getSpaceTimeIterator

public Iterator<SpaceTimeRegion> getSpaceTimeIterator()

Returns:

iterator over space-time regions, removal is not allowed

getTrajectoryGroups

public <T> List<TrajectoryGroup> getTrajectoryGroups(org.djunits.value.vdouble.scalar.Duration startTime,
                                                     org.djunits.value.vdouble.scalar.Duration endTime)

Returns a list of TrajectoryGroups in accordance with the query. Each TrajectoryGroup contains Trajectory objects pertaining to a SpaceTimeRegion from the query. A Trajectory is only included if all the meta data of this query accepts the trajectory.

Type Parameters:

T - underlying class of meta data type and its value

Parameters:

startTime - start time of interval to get trajectory groups for

endTime - start time of interval to get trajectory groups for

Returns:

list of trajectory groups in accordance with the query

Throws:

RuntimeException - if a meta data type returned a boolean array with incorrect length

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object