Package org.opentcs.data.model

Klasse Path

java.lang.Object
org.opentcs.data.TCSObject<Path>
org.opentcs.data.model.TCSResource<Path>
org.opentcs.data.model.Path
Alle implementierten Schnittstellen:
Serializable
public class Path extends TCSResource<Path> implements Serializable
Describes a connection between two Points which a Vehicle may traverse.
Siehe auch:

  • Konstruktordetails

    • Path

      public Path(String name, TCSObjectReference<Point> sourcePoint, TCSObjectReference<Point> destinationPoint)
      Creates a new Path.
      Parameter:
      name - The new path's name.
      sourcePoint - A reference to this path's starting point.
      destinationPoint - A reference to this path's destination point.

  • Methodendetails

    • withProperty

      public Path withProperty(String key, String value)
      Beschreibung aus Klasse kopiert: TCSObject
      Creates a copy of this object, with the given property integrated.
      Angegeben von:
      withProperty in Klasse TCSObject<Path>
      Parameter:
      key - The key of the property to be changed.
      value - The new value of the property, or null, if the property is to be removed.
      Gibt zurück:
      A copy of this object, with the given property integrated.

    • withProperties

      public Path withProperties(Map<String,String> properties)
      Beschreibung aus Klasse kopiert: TCSObject
      Creates a copy of this object, with the given properties.
      Angegeben von:
      withProperties in Klasse TCSObject<Path>
      Parameter:
      properties - The properties.
      Gibt zurück:
      A copy of this object, with the given properties.

    • withHistoryEntry

      public TCSObject<Path> withHistoryEntry(ObjectHistory.Entry entry)
      Beschreibung aus Klasse kopiert: TCSObject
      Creates a copy of this object, with the given history entry integrated.
      Angegeben von:
      withHistoryEntry in Klasse TCSObject<Path>
      Parameter:
      entry - The history entry to be integrated.
      Gibt zurück:
      A copy of this object, with the given history entry integrated.

    • withHistory

      public TCSObject<Path> withHistory(ObjectHistory history)
      Beschreibung aus Klasse kopiert: TCSObject
      Creates a copy of this object, with the given history.
      Angegeben von:
      withHistory in Klasse TCSObject<Path>
      Parameter:
      history - The history.
      Gibt zurück:
      A copy of this object, with the given history.

    • getLength

      public long getLength()
      Return the length of this path (in mm).
      Gibt zurück:
      The length of this path (in mm).

    • withLength

      public Path withLength(long length)
      Creates a copy of this object, with the given length.
      Parameter:
      length - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • getSourcePoint

      public TCSObjectReference<Point> getSourcePoint()
      Returns a reference to the point which this path originates in.
      Gibt zurück:
      A reference to the point which this path originates in.

    • getDestinationPoint

      public TCSObjectReference<Point> getDestinationPoint()
      Returns a reference to the point which this path ends in.
      Gibt zurück:
      A reference to the point which this path ends in.

    • getMaxVelocity

      public int getMaxVelocity()
      Return the maximum allowed forward velocity (in mm/s) for this path.
      Gibt zurück:
      The maximum allowed forward velocity (in mm/s). A value of 0 means forward movement is not allowed on this path.

    • withMaxVelocity

      public Path withMaxVelocity(int maxVelocity)
      Creates a copy of this object, with the given maximum velocity.
      Parameter:
      maxVelocity - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • getMaxReverseVelocity

      public int getMaxReverseVelocity()
      Return the maximum allowed reverse velocity (in mm/s) for this path.
      Gibt zurück:
      The maximum allowed reverse velocity (in mm/s). A value of 0 means reverse movement is not allowed on this path.

    • withMaxReverseVelocity

      public Path withMaxReverseVelocity(int maxReverseVelocity)
      Creates a copy of this object, with the given maximum reverse velocity.
      Parameter:
      maxReverseVelocity - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • getPeripheralOperations

      public List<PeripheralOperation> getPeripheralOperations()
      Returns the peripheral operations to be performed when a vehicle travels along this path.
      Gibt zurück:
      The peripheral operations to be performed when a vehicle travels along this path.

    • withPeripheralOperations

      public Path withPeripheralOperations(@Nonnull List<PeripheralOperation> peripheralOperations)
      Creates a copy of this object, with the given peripheral operations.
      Parameter:
      peripheralOperations - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • isLocked

      public boolean isLocked()
      Return the lock status of this path (i.e. whether this path my be used by vehicles or not).
      Gibt zurück:
      true if this path is currently locked (i.e. it may not be used by vehicles), else false.

    • withLocked

      public Path withLocked(boolean locked)
      Creates a copy of this object, with the given locked flag.
      Parameter:
      locked - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • getVehicleEnvelopes

      public Map<String,Envelope> getVehicleEnvelopes()
      Returns a map of envelope keys to envelopes that vehicles traversing this path may occupy.
      Gibt zurück:
      A map of envelope keys to envelopes that vehicles traversing this path may occupy.

    • withVehicleEnvelopes

      public Path withVehicleEnvelopes(Map<String,Envelope> vehicleEnvelopes)
      Creates a copy of this object, with the given vehicle envelopes.
      Parameter:
      vehicleEnvelopes - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • getLayout

      public Path.Layout getLayout()
      Returns the information regarding the grahical representation of this path.
      Gibt zurück:
      The information regarding the grahical representation of this path.

    • withLayout

      public Path withLayout(Path.Layout layout)
      Creates a copy of this object, with the given layout.
      Parameter:
      layout - The value to be set in the copy.
      Gibt zurück:
      A copy of this object, differing in the given value.

    • isNavigableForward

      public boolean isNavigableForward()
      Checks whether this path is navigable in forward direction.
      Gibt zurück:
      true if, and only if, this path is not locked and its maximum forward velocity is not zero.

    • isNavigableReverse

      public boolean isNavigableReverse()
      Checks whether this path is navigable in backward/reverse direction.
      Gibt zurück:
      true if, and only if, this path is not locked and its maximum reverse velocity is not zero.

    • isNavigableTo

      public boolean isNavigableTo(TCSObjectReference<Point> navPoint) throws IllegalArgumentException
      Checks whether this path is navigable towards the given point.
      Parameter:
      navPoint - The point.
      Gibt zurück:
      If navPoint is this path's destination point, returns isNavigableForward(); if navPoint is this path's source point, returns isNavigableReverse().
      Löst aus:
      IllegalArgumentException - If the given point is neither the source point nor the destination point of this path.