Table of Contents

Table of Contents

FlexScript Class - Conveyor

Conveyor

Inherits from Object

Description

A class that provides properties and methods for monitoring and controlling a conveyor.

Properties

acceleration Gets the conveyor's acceleration.
currentSpeed Gets the conveyor's current speed.
deceleration Gets the conveyor's deceleration.
defaultSpeed Gets the conveyor's default speed, which is the speed the conveyor starts with at the beginning of the simulation.
itemData Accesses conveyor-specific data associated with items on the conveyor
length Gets the conveyor's simulated length.
motor Gets the conveyor's assigned motor.
slugBuilder Gets data associated with the conveyor's slug-building status.
targetSpeed Gets or sets the conveyor's current target speed.
width Gets the conveyor's width.

Static Methods

estimateConveyTime Estimates the time for an item to travel from one part of the conveyor system to another.
sendItem Sets an item's target destination in the conveyor system.

Details

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.acceleration

readonly double acceleration

Description

Gets the conveyor's acceleration.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.currentSpeed

readonly double currentSpeed

Description

Gets the conveyor's current speed.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.deceleration

readonly double deceleration

Description

Gets the conveyor's deceleration.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.defaultSpeed

readonly double defaultSpeed

Description

Gets the conveyor's default speed, which is the speed the conveyor starts with at the beginning of the simulation.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.itemData

readonly itemData

Description

Accesses conveyor-specific data associated with items on the conveyor

This gives access to the set of Conveyor.Items associated with the items currently on the conveyor.

Use itemData.length to get the number of items on the conveyor.

Conveyor conveyor = param(1);
int numItems = conveyor.itemData.length;

Note that itemData.length may be different than conveyor.subnodes.length, as some items may be partially on the conveyor, but not in the conveyor's subtree. conveyover.itemData.length should always be greater than or equal to conveyor.subnodes.length.

conveyor.subnodes.length; // the number of items in the conveyor's subtree
conveyor.itemData.length; // the total number of all items partially-or-wholly on the conveyor.

To access item data by rank, you can index into conveyor.itemData with the [ ] operator.

conveyor.itemData[1]; // gets the data associated with the most downstream item on the conveyor
conveyor.itemData[conveyor.itemData.length]; // gets the data associated with the most upstream item on the conveyor

You can also access the itemData associated with a specific item, again using the [ ] operator.

Object item = param(2);
Conveyor.Item conveyorItem = conveyor.itemData[item];

See Conveyor.Item for more information.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.length

readonly double length

Description

Gets the conveyor's simulated length.

If the conveyor does not use a virtual length, this is the geometric length of the conveyor. If the conveyor uses a virtual length, it is the virtual length.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.motor

readonly Object motor

Description

Gets the conveyor's assigned motor.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.slugBuilder

readonly Conveyor.SlugBuilder slugBuilder

Description

Gets data associated with the conveyor's slug-building status.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.targetSpeed

double targetSpeed

Description

Gets or sets the conveyor's current target speed.

If you set this value, the conveyor's speed will change to the target speed. The conveyor's acceleration/deceleration will determine how long it takes to get to the target speed.

Reversing Conveyor Direction

If you set a conveyor's targetSpeed to a non-zero negative value, the conveyor will reverse direction. When a conveyor's direction is reversed the following things happen.

  • All stopped items on the conveyor will be fully resumed.
  • Each item on the conveyor will be set to a moving state.
  • Each item's target destination will be erased. For example, if the item previously had been sent to a point in the system using the Conveyor.sendItem() method, that destination will be forgotten.
  • Each item will regenerate its list of traversal points, e.g. photo eyes, decision points, etc. as if the item is entering the conveyor at the point where it is when the conveyor is reversed.

The functionality for reversing conveyor direction is still in an early stage of maturity. It was designed with a very specific scenario in mind, which is to give modelers the ability to simulate accumulation buffers, where items can be pulled off a main conveyor line when the line gets backed up, and then moved back onto the line when it clears out. The functionality has been tested only for this scenario. Using reversible conveyors for other scenarios has not been tested and thus may not work perfectly.

Specific caveats that you should be aware of:

  • If an item is straddling two inline transfers when direction reversal happens, then both conveyors that the item is straddling must be reversed at the same time. Doing otherwise will result in undefined behavior.
  • An item cannot straddle more than two conveyors when direction reversal happens, or else an exception will be thrown.
  • No updates are made to the internal routing table when a conveyor's direction is reversed. This means, for routing purposes, i.e. when sending an item to a destination point in the system, the conveyor is always assumed to be conveying in its original direction.
Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.width

readonly double width

Description

Gets the conveyor's width.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.estimateConveyTime()

static double estimateConveyTime( Object origin , double n_a , Object dest , double n_a , double itemLength , int flags = 0 )

Parameters

origin The origin point from which to estimate the convey time. This must be either a conveyor or a point on a conveyor, such as a decision point or photo eye.
dest The destination point for the time estimation. This must be either a conveyor or a point on a conveyor, such as a decision point or photo eye.
n_a Reserved for future use. Must be 0.
itemLength Defines an item length for the estimation algorithm. This can affect the result depending on how speeds are defined in conveyor transfers.
flags This can either be 0, or CONV_ESTIMATE_STANDARD_SPEEDS. If 0 (default), the estimation algorithm will assume slug-build conveyors will convey at their slug release speed. If CONV_ESTIMATE_STANDARD_SPEEDS is defined, the estimation algorithm will use normal conveying speeds.

Returns

double The estimated simulation time it will take for an item of the given size to convey from the point where the item's center is at the origin point, to the point where the item's center is at the destination point, assuming no blockage.

Description

Estimates the time for an item to travel from one part of the conveyor system to another.

DecisionPoint src = current;
DecisionPoint dest = current.outObjects[1];
Object item = param(1);
double conveyTime = Conveyor.estimateConveyTime(src, 0, dest, 0, item.size.x);

In making the estimation, the algorithm will always assume default conveyor speeds (not current conveyor speeds). Estimation speeds for slug-building conveyors are determined by the flags parameter.

Do no remove, this fixes the anchor on doc.flexsim.com

Conveyor.sendItem()

static void sendItem( Object item , Object dest )

Parameters

item The item whose target destination is to be set.
dest The target destination. This must be a reference to a point within the conveyor system that is reachable from the item's current position on the conveyor system. This must either be a decision point, a photo eye, a station, or an exit transfer.

Description

Sets an item's target destination in the conveyor system.

Conveyor.sendItem(item, current.outObjects[1]);

Once an item's target destination is set, the item will take the shortest distance route, in the conveyor system, to that defined destination.