Time
Demand carrier that delays each shipment by a per-DemandSenderIfc random transport time. Senders without a configured time are either rejected with NoCarrierOptionException or, if immediateTransportFlag is true, shipped and delivered immediately (zero simulated time).
Statistics: numInTransitResponse (time-weighted by SupplyChainModel.Demand.amountFilled) and transitTimeResponse (per-shipment transit time) are updated for every shipment.
Parameters
the parent model element
optional model-element name
See sc.transportlayer.TimeBasedDemandCarrier
Inheritors
Properties
When true, demands whose sender has no configured transport time are shipped and delivered immediately (zero simulated time) instead of throwing NoCarrierOptionException. Default false. A control; subclasses (e.g. the load carrier) inherit it.
Read-only view of the amount-in-transit response.
Read-only view of the per-shipment transit-time response.
Functions
Side-effect-free probe: returns true iff demand would route successfully under the carrier's current configuration. A false result indicates transportDemand would either throw or silently drop the demand. Useful as a self-guard inside carrier implementations and as a configuration test from external code.
True if a transport time has been configured for sender.
Per-destination demand-shipment count, or 0 if sender is unregistered.
Record that a shipment carrying amountInTransit units has arrived after transitTime in transit: decrements the in-transit response and observes the transit time. Pairs with recordShipmentDeparture.
Record that a shipment carrying amountInTransit units has departed: increments this carrier's in-transit response. A hook for subclasses (e.g. TimeBasedLoadCarrier) that dispatch through their own path but should still feed the inherited numInTransitResponse / transitTimeResponse. Pair every call with a later recordShipmentArrival of the same amount.
Create the per-destination shipment / weight / cube counters for sender if they do not yet exist. KSL forbids new ModelElements after the executive starts, so this is a construction-time operation. Call it for any destination that may receive a shipment under immediateTransportFlag without a configured transport time — otherwise the per-destination counters never get created and the increments in transportDemand silently no-op (audit finding D). setTransportTime already calls this.
Register (or replace) the transport-time distribution used for sender. The supplied distribution is wrapped in a new RandomVariable (per porting plan §4.1) the first time the sender is added; subsequent calls swap the underlying source.
Per-destination cumulative weight of all shipments sent to sender in the current replication (post-warmup), or null if sender is unregistered. In this base class, the shipment unit is a single demand, so the accumulator sums demand.weight across every transportDemand(demand) call. Subclasses (TimeBasedLoadCarrier) override to attribute load-level weight instead.
Transport demand from its origin to its destination.
Lookup hook for subclasses that need to schedule shipments on the same per-sender distributions (e.g. TimeBasedLoadCarrier dispatching load shipments).