desmoj.extensions.space3D

Class SimpleTrack

java.lang.Object

desmoj.core.simulator.NamedObject

desmoj.core.simulator.ModelComponent

desmoj.extensions.space3D.Track

desmoj.extensions.space3D.SimpleTrack

public class SimpleTrack
extends Track

A SimpleTrack contains a start position and a destiny position. The route between them are modeled through way points. Each point (incl. the start point) is connected with the successor point through a straight line. By following the connected way points from the start point the destiny will be reached at the end.

Author:

Fred Sun

Constructor Summary

Constructors

Constructor and Description
SimpleTrack(Model owner, java.lang.String trackName, Length[] startPosition, Length[] destination, java.util.ArrayList<double[]> wayPoints, boolean showInTrace) Constructs a SimpleTreck object with the start-, the destination position and the way points.
SimpleTrack(Model owner, java.lang.String trackName, java.lang.String startLocationName, java.lang.String destinationLocationName, java.lang.String exitPointName, java.lang.String entryPointName, Length[] startPosition, Length[] destiny, java.util.ArrayList<double[]> wayPoints, boolean showInTrace) Constructs a SimpleTrack with the start- and the destination positions.

Method Summary

Modifier and Type	Method and Description
Vector3d	getDirectionAt(double length) Gets the current moving direction based on the specified length from the start position on the track.
double	getLength() Gives the total length of the Track.
Length[]	getPositionAt(double length) Gets the coordinates (in ExtendedLength) of the current position based on the specified length from the start position on the track.
double[]	getPositionAtValue(double length) Gets the coordinates (in double) of the current position based on the specified length from the start position on the track.
java.util.ArrayList<double[]>	getWayPoints() Gets the way points of this track.

Methods inherited from class desmoj.extensions.space3D.Track

getDestination, getDestinationValue, getDestinyLocationName, getEnrtyPointName, getExitPointName, getStarLengthUnits, getStartLocationName, getStartPositionValue, setDestinyPosition, setStartPosition

Methods inherited from class desmoj.core.simulator.ModelComponent

current, currentEntity, currentEntityAll, currentEvent, currentModel, currentSimProcess, debugIsOn, debugOff, debugOn, getModel, isExperimentCompatible, isModelCompatible, presentTime, sendDebugNote, sendMessage, sendTraceNote, sendWarning, skipTraceNote, skipTraceNote, traceIsOn, traceOff, traceOn

Methods inherited from class desmoj.core.simulator.NamedObject

getName, getQuotedName, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SimpleTrack

public SimpleTrack(Model owner,
                   java.lang.String trackName,
                   Length[] startPosition,
                   Length[] destination,
                   java.util.ArrayList<double[]> wayPoints,
                   boolean showInTrace)

Constructs a SimpleTreck object with the start-, the destination position and the way points.

Each element of the double[] ArrayList will be interpreted as a way point. So the size of the ArrayList must exactly match the number of the way points needed.

Parameters:

owner - The model this entity is associated to.

trackName - The name of this Track.

startPosition - The start position of the Track. It must be a ExtendedLength[] with a length of 3.

destination - The end position of the Track. It must be a ExtendedLength[] with a length of 3.

wayPoints - The way points (double[] with length of 3) which describes the path between the start and the destination.

showInTrace - Flag for showing entity in trace-files. Set it to true if entity should show up in trace. Set to false in entity should not be shown in trace.

SimpleTrack

public SimpleTrack(Model owner,
                   java.lang.String trackName,
                   java.lang.String startLocationName,
                   java.lang.String destinationLocationName,
                   java.lang.String exitPointName,
                   java.lang.String entryPointName,
                   Length[] startPosition,
                   Length[] destiny,
                   java.util.ArrayList<double[]> wayPoints,
                   boolean showInTrace)

Constructs a SimpleTrack with the start- and the destination positions. The way points can be used to describe the path between the start and the destination. The name of the start location, the destination location, the entry point and the exit point are optional and describe where the start- and the destination position are associated to.

Each element of the double[] ArrayList will be interpreted as a way point. So the size of the ArrayList must exactly match the number of the way points needed.

Parameters:

owner - The model this entity is associated to.

trackName - The name of this Track.

startLocationName - The name of the start location.

destinationLocationName - The name of the destiny location.

exitPointName - The name of the exit point.

entryPointName - The name of the entry point.

startPosition - The start position of the Track. It must be a ExtendedLength[] with a length of 3.

destination - The end position of the Track. It must be a ExtendedLength[] with a length of 3.

wayPoints - The way points (double[] with length of 3) which describes the path between the start and the destination.

showInTrace - Flag for showing entity in trace-files. Set it to true if entity should show up in trace. Set to false in entity should not be shown in trace.

Method Detail

getDirectionAt

public Vector3d getDirectionAt(double length)

Description copied from class: Track

Gets the current moving direction based on the specified length from the start position on the track.

Specified by:

getDirectionAt in class Track

Parameters:

length - The length from the start position to the current position.

Returns:

The normalized vector which points to the current moving direction.

getLength

public double getLength()

Description copied from class: Track

Gives the total length of the Track.

Specified by:

getLength in class Track

Returns:

The length of the Track in a double value.

getPositionAt

public Length[] getPositionAt(double length)

Description copied from class: Track

Gets the coordinates (in ExtendedLength) of the current position based on the specified length from the start position on the track.

Specified by:

getPositionAt in class Track

Parameters:

length - The length from the start position to the position which we want to know.

Returns:

A ExtendedLength[3] array which represents the x-, y- and the z-coordinates.

getPositionAtValue

public double[] getPositionAtValue(double length)

Description copied from class: Track

Gets the coordinates (in double) of the current position based on the specified length from the start position on the track.

Parameters:

length - The length from the start position to the position which we want to know.

Returns:

A double[3] array with the X, Y, and Z-coordinates. The value represents meters.

getWayPoints

public java.util.ArrayList<double[]> getWayPoints()

Gets the way points of this track.

Returns:

The way points in double[] of length 3. The first element represents the x-, the second element the y- and the third element the z-coordinate.