Package org.opentrafficsim.sim0mq.publisher

Class NodeTransceiver

java.lang.Object

org.opentrafficsim.sim0mq.publisher.AbstractTransceiver

org.opentrafficsim.sim0mq.publisher.NodeTransceiver

All Implemented Interfaces:

Identifiable, TransceiverInterface

public class NodeTransceiver
extends AbstractTransceiver

Transceiver for Node data.

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

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors

Constructor	Description
NodeTransceiver(OTSNetwork network, NodeIdTransceiver nodeIdSource)	Construct a new NodeTransceiver.

Method Summary

Modifier and Type	Method	Description
static <U extends Unit<U>,S extends DoubleScalarInterface<U,S>,V extends DoubleVectorInterface<U,S,V>> V	doubleVector(Point3d point, U unit)	Create a DENSE DoubleVector with the x, y and z values of this Point3d.
Object[]	get(Object[] address, ReturnWrapper returnWrapper)	Retrieve the data.
TransceiverInterface	getIdSource(int addressLevel, ReturnWrapper returnWrapper)	Retrieve the TransceiverInterface that can be used to get detailed information about a single object.
boolean	hasIdSource()	Report if this transceiver has an id source.
String	toString()

Methods inherited from class org.opentrafficsim.sim0mq.publisher.AbstractTransceiver

getAddressFields, getId, getResultFields, verifyMetaData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NodeTransceiver

public NodeTransceiver(OTSNetwork network,
                       NodeIdTransceiver nodeIdSource)

Construct a new NodeTransceiver.

Parameters:

network - OTSNetwork; the network

nodeIdSource - NodeIdTransceiver; the transceiver that can produce all Node ids in the Network

Method Detail

doubleVector

public static <U extends Unit<U>,S extends DoubleScalarInterface<U,S>,V extends DoubleVectorInterface<U,S,V>> V doubleVector(Point3d point,
                                                                                                                                                           U unit)

Create a DENSE DoubleVector with the x, y and z values of this Point3d.

Type Parameters:

U - the unit type

S - the corresponding scalar type

V - the corresponding vector type

Parameters:

point - Point3d; the point.

unit - U; unit of the values in this OTSPoint3D (and also the display unit of the returned DoubleVector)

Returns:

DoubleVector; the constructed DoubleVector, size is 3; first value is x, second is y, third is z

get

public Object[] get(Object[] address,
                    ReturnWrapper returnWrapper)
             throws RemoteException,
                    Sim0MQException,
                    SerializationException

Retrieve the data.

Parameters:

address - Object[]; the address of the data to retrieve

returnWrapper - ReturnWrapper; to be used to report problems

Returns:

Object[]; the retrieved data, or null when no object with the address could be found

Throws:

RemoteException - when communication needed to retrieve the data failed

Sim0MQException - when encoding an error message fails

SerializationException - when encoding an error message fails

getIdSource

public TransceiverInterface getIdSource(int addressLevel,
                                        ReturnWrapper returnWrapper)
                                 throws Sim0MQException,
                                        SerializationException

Retrieve the TransceiverInterface that can be used to get detailed information about a single object.

Parameters:

addressLevel - int; index of the argument in the address fields

returnWrapper - ReturnWrapper; to be used to report problems

Returns:

TransceiverInterface; to be used to get valid values for argument addressLevel, or null if valid values for the argument at index addressLevel can not be obtained through a TransceiverInterface object

Throws:

Sim0MQException - when the ReturnWrapper fails

SerializationException - when the ReturnWrapper fails

hasIdSource

public boolean hasIdSource()

Report if this transceiver has an id source.

Returns:

boolean; true if this transceiver has an id source; false if this transceiver does not have an id source

toString

public String toString()

Overrides:

toString in class AbstractTransceiver