Provides access to data and methods related to AGV travel.
The AGV class is associated with a task executer that has been connected to the AGV network. The AGV is NOT the same as the task executer object. In other words, you can't just set an AGV to the task executer itself.
TaskExecuter te = current; AGV agv = te; // RUN-TIME ERROR
Instead, the AGV is associated with, not the same as the task executer. To access the AGV of a given task executer, use the AGV() constructor.
Also, if you are troubleshooting and want to see this structure as the model is running, you can view it in the tree at MODEL:/AGVNetwork>variables/agvs/<AGVNAME>, where <AGVNAME> is the name of the AGV you want to see.
|accumAheadAGV||Gets the next AGV on an accumulating path.|
|allocationPoints||An array of AGV.AllocationPoints that is the AGV's current set of not-yet-allocated allocation points.|
|ampHours||Gets the number of amp hours remaining in the AGV's battery.|
|batteryLevel||Gets or sets the ratio of (amp hours remaining)/(total amp hours) as a percentage.|
|currentCP||Gets or sets the current control point for this AGV.|
|currentTravelDist||Gets the AGV's current travel distance.|
|currentTravelPathSection||Gets the travel path section that the AGV is currently traveling on.|
|destination||Gets the current destination of the AGV.|
|destinationCP||Gets the current desination control point of the AGV.|
|finalDestinationCP||Gets the final destination control point of the AGV.|
|object||Provides access to Object methods and properties for this AGV.|
|originCP||Gets the origin control point of the AGV.|
|overflowCP||Gets/sets the control point to "overflow" to when the AGV is pushing trailers.|
|proximityState||Gets the current proximity state of the AGV.|
|recentCP||Gets the control point that was most recently the agv's currentCP.|
|resetCP||Gets or sets the control point that the agv connects to when the model is reset.|
|speed||Gets the current speed of the AGV.|
|te||Provides access to TaskExecuter methods and properties for this AGV.|
|trailers||An array of AGV.Trailers comprising the set of trailers attached to this AGV.|
|travelPath||An array of AGV.TravelPathSections that is the AGV's travel path for its current travel operation.|
|traversalPoints||An array of AGV.TraversalPoints that is the AGV's current set of planned 'traversals'.|
|addAllocationPoint||Adds a new allocation point to the AGVs allocationPoints list.|
|attachTrailer||Attaches the given object as a trailer on the AGV.|
|coupleTrain||Attaches a train of trailers to this AGV, automatically calculating gaps, etc. based on network geometry.|
|detachTrailer||Detaches the given trailer from the AGV.|
|getTrailer||Gets a specific trailer based on an ahead/behind parameter, and a rank for the AGV driver.|
|redirect||Redirects the AGV to a new destination, based on the given mode.|
|setDestination||Sets the destination control point.|
|startRecharge||Begins recharging the AGV's battery.|
|stopRecharge||Stops recharging the AGV's battery.|
|uncoupleTrain||Detaches a train of trailers from this AGV, creating a separate AGV train.|
|AGV||Constructs an AGV object based on the given TaskExecuter.|
An array of AGV.AllocationPoints that is the AGV's current set of not-yet-allocated allocation points.
If you are troubleshooting and want to see this structure as the model is running, you can view it in the tree at MODEL:/AGVNetwork>variables/agvs/<AGVNAME>/allocationPoints, where <AGVNAME> is the name of the AGV you want to see.
readonly double currentTravelDist
Gets the AGV's current travel distance.
The current travel distance of the AGV within its current travel operation. The AGV tracks its cumulative travel distance across each of the sections in its travel path. Each travel operation starts at a travel distance of 0, and travel distance increases as it travels along the path.
Gets/sets the control point to "overflow" to when the AGV is pushing trailers.
This is generally only needed if the AGV is pushing trailers. When pushing trailers, overflowCP defines a point on the AGV path network to which the AGV's trailers should "overflow", since those trailers will be pushed past the AGV's target destination.
overflowCP is controlled solely by the user. It is only automatically reset when the model is reset. Thus, if you set this property, you should reset it to 0 after finishing the operation where the it is applicable. If you do not reset it after its applicable travel operation, weird AGV path travel behavior may occur.
agv.overflowCP = Model.find("ControlPoint5");
An array of AGV.TravelPathSections that is the AGV's travel path for its current travel operation.
If you are troubleshooting and want to see this structure as the model is running, you can view it in the tree at MODEL:/AGVNetwork>variables/agvs/<AGVNAME>/travelPath, where <AGVNAME> is the name of the AGV you want to see.
An array of AGV.TraversalPoints that is the AGV's current set of planned 'traversals'.
For the purposes of the FlexScript API, the traversalPoints are the set of allocation points that have been allocated but not yet deallocated, i.e. the AGV's current allocations. See AGV.TraversalPoint for more information.
If you are troubleshooting and want to see this structure as the model is running, you can view it in the tree at MODEL:/AGVNetwork>variables/agvs/<AGVNAME>/traversalPoints, where <AGVNAME> is the name of the AGV you want to see.
|AGV.AllocationPoint addAllocationPoint( AGV.AllocatableObject object , double stopDist , double deallocDist , double arrivalDist )|
|object||The object to be allocated.|
|stopDist||The allocation point's stopDist.|
|stopDist||The allocation point's traversalDist, i.e. the point at which to deallocate the object.|
|arrivalDist||The allocation point's arrivalDist.|
Adds a new allocation point to the AGVs allocationPoints list.
Generally the AGV default behavior properly adds allocation points as part of the AGV's travel path, so you will usually not need to use this method. However, manually adding allocations may be useful in in some special cases. For example, certain spatial configurations of AGVs may require you to allocate points that are not technically on its travel path. If a part of an AGV 'hangs out' away from its body and encroaches on other paths, you may resolve this by adding allocation points on those other paths so that the AGV will avoid collisions with other AGVs.
You should call this method only at defined times in the AGV's travel operation. Specifically, you should only call it after the OnBuildTravelPath event is fired (or as part of that trigger) but before the OnPreAllocate. Calling it at any other time is not guaranteed to work.
|attachTrailer( treenode trailer , double gap , int behind , int detachRule )|
|trailer||The object that will trail the AGV|
|gap||The trailer's distance from the next trailer or AGV|
|behind||Sets the position of the trailer. Can be 0 or 1: 0 is ahead, 1 is behind|
|detachRule||Sets the detach mode of the AGV. Can be 0 or 1: 0 is manual, 1 is automatic|
Attaches the given object as a trailer on the AGV.
If you attach the trailer using the manual detach mode, you must call detachTrailer() to detach the trailer.
agv.attachTrailer(trailerObj, 0.1, 1, 0);
|coupleTrain( treenode trailer )|
|trailer||The object that will be coupled to the AGV. If the trailer is itself an AGV, or is a trailer of an AGV, then the entire AGV train will be attached.|
Attaches a train of trailers to this AGV, automatically calculating gaps, etc. based on network geometry.
coupleTrain() is similar to attachTrailer(), with the following primary differences:
- Whereas attachTrailer() attaches a single trailer to the AGV, coupleTrain() will attach all trailers that are part of another AGV train, if such a train exists.
- While attachTrailer() requires you to define parameters like whether the trailer should be attached ahead or behind, gap distance, etc., coupleTrain(), on the other hand, automatically resolves these parameters based on the location of the trailer/train on the AGV path network.
There are two possible scenarios when coupling the trailer onto the AGV's train. Each scenario effects a different logic for coupling the train, as follows:
- The trailer is an independent object - When the trailer is not associated with another AGV train, the AGV will determine where to couple the trailer by analyzing simple spatial proximity. It retrieves the location of the trailer, and determines whether that location is ahead of the AGV or behind. Then, based on that determination, it resolves the gap between the trailer and the AGV's associated ahead/behind-most trailer by again analyzing spatial proximity. Further, since there is no AGV train associated with the trailer, it will couple only that trailer to the AGV, and no other objects.
- The trailer is itself another AGV, or is a trailer of another AGV - When the trailer is part of another AGV, the AGV will determine couple parameters by analyzing its own location on the AGV path network relative to the location of that other AGV on the path network. Ahead/behind attributes, gap, etc. are determined by doing a path network distance analysis between each end of each AGV, and coupling the train via the shortest resulting path between the train ends. This algorithm assumes that the AGV ends can reach each other via one or more paths that do not require a train direction switch. In other words, the trains' proximity to each on the network should be "close and intuitive", like how you would want to couple trains in a real life situation. Coupling across weird path geometries will result in undetermined behavior.
Use this method in conjunction with uncoupleTrain() to simulate coupling and uncoupling of cars in a train yard.
|AGV.Trailer getTrailer( int isBehind , int rankFromDriver )|
|isBehind||1 if you want to access a trailer behind the AGV, and 0 if you want to access a trailer ahead of the AGV.|
|rankFromDriver||The 1-based rank of the trailer from the AGV driver.|
Gets a specific trailer based on an ahead/behind parameter, and a rank for the AGV driver.
Object trailer = agv.getTrailer(1, 2).object;
|redirect( Object newDest , int mode )|
|newDest||The new desination for the AGV to travel to|
|mode||Determines what happens on redirect. Can have one of 4 values:
REDIRECT_AND_WAIT - if not redirected before arrival, the agv will wait at the destination until redirected
REDIRECT_AS_FINAL - the destination becomes the new final destination for the agv
REDIRECT_AND_CONTINUE_ON_ARRIVAL - the agv will continue to the final destination after arriving at the intermediate destination
REDIRECT_AND_CONTINUE_ON_PRE_ARRIVAL - the agv will continue to the final destination after pre-arriving at the intermediate destination (it will not decelerate to a stop)
Redirects the AGV to a new destination, based on the given mode.
|void setDestination( Object controlPoint , double pathOffset = 0 , Object relativeToTrailer = 0 , Variant agvBodyOffset = 0 )|
|controlPoint||Control point to be set as the destination.|
|pathOffset||How much to offset the destination along the path from the control point.|
|relativeToTrailer||Make the destination relative to a trailer.|
|agvBodyOffset||Specifies amount to offset from the body or one of the AGV.BodyOffset enum values. It may also be an array with 2 elements, the first with one of the AGV.BodyOffset enum values and the second with an additional offset amount.|
Sets the destination control point.
agv.setDestination(Model.find("ControlPoint5"), 0, 0, AGV.BodyOffset.TrailerHeadEdge);
|void stopRecharge( )|
Stops recharging the AGV's battery.
|uncoupleTrain( treenode trailer , treenode newDriver = 0 )|
|trailer||The trailer at which to uncouple from the train.|
|newDriver||The object who will become the new "driver" AGV. If this object
does not already have an AGV instance associated with it, then an AGV will be created. If newDriver is not
passed as a parameter, or is 0, then the first trailer parameter will become the new driver.
If the new driver is not a TaskExecuter, then it will only contain AGV data for storing where the AGV train is on the path network. You will not be able to give the object travel tasks like you would a TaskExecuter.
Detaches a train of trailers from this AGV, creating a separate AGV train.
Use this method in conjunction with coupleTrain() to simulate coupling and uncoupling of cars in a train yard.
|AGV( treenode te , int assert = 0 )|
|te||A TaskExecuter that is connected to the AGV network as an AGV Traveler.|
|assert||If 1, then if the TaskExecuter is not yet connected to the AGV network, it will be connected, and the associated AGV object will be created.|
|AGV||An AGV object|
Constructs an AGV object based on the given TaskExecuter.An AGV object can only be accessed by calling this method. Casting directly from a task executer is not correct.
AGV agv = AGV(te); // correct AGV agv = te; // incorrect