KSLCore/ksl.modeling.supplychain.transport/NetworkDemandCarrierByTime

NetworkDemandCarrierByTime

open class NetworkDemandCarrierByTime @JvmOverloads constructor(parent: ModelElement, name: String? = null) : DemandCarrierAbstract(source)

Demand carrier that maps each (supplier, customer) edge to its own TransportDelay. Aggregate statistics across every edge are collected by an internal AggregateTransportResponse.

Default behavior preserves the Java carrier's fallback semantics via capability interfaces: when no TransportDelay is configured for a (supplier, customer) pair, the carrier permits zero-delay transport if the customer is an ExternalDemandConsumer (via demandGeneratorImmediateTransportFlag) or the supplier is an ExternalDemandSupplier (via externalSupplierImmediateTransportFlag); both flags default true. Java tested concrete classes (DemandGenerator and LeadTimeDemandFiller); the Kotlin port tests their capabilities so future external endpoint types slot in without editing the carrier.

Parameters

parent

the parent model element

name

optional model-element name

See sc.transportlayer.NetworkDemandCarrierByTime

Constructors

NetworkDemandCarrierByTime

@JvmOverloads

constructor(parent: ModelElement, name: String? = null)

Properties

aggregateTransportResponse

val aggregateTransportResponse: AggregateTransportResponse

Aggregate network-wide transport statistics.

demandGeneratorImmediateTransportFlag

var demandGeneratorImmediateTransportFlag: Boolean

When true (default), demands whose customer is a DemandGenerator and that lack an explicit (supplier, customer) edge are shipped and delivered immediately. When false, the carrier throws NoCarrierOptionException.

externalSupplierImmediateTransportFlag

var externalSupplierImmediateTransportFlag: Boolean

When true (default), demands whose supplier is a LeadTimeDemandFiller and that lack an explicit (supplier, customer) edge are shipped and delivered immediately. When false, the carrier throws NoCarrierOptionException.

Functions

canShip

open override fun canShip(demand: SupplyChainModel.Demand): Boolean

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.

getTransportDelay

fun getTransportDelay(supplier: DemandFillerIfc, customer: DemandSenderIfc): TransportDelay?

Returns the TransportDelay for the pair, or null if unset.

setTransportTime

fun setTransportTime(supplier: DemandFillerIfc, customer: DemandSenderIfc)

Configure a zero-delay (supplier, customer) edge.

fun setTransportTime(supplier: DemandFillerIfc, customer: DemandSenderIfc, time: Double)

Configure a constant-time (supplier, customer) edge.

fun setTransportTime(supplier: DemandFillerIfc, customer: DemandSenderIfc, time: RVariableIfc)

Configure a (supplier, customer) edge with the supplied transport-time distribution. The first call creates and registers a TransportDelay; later calls reuse the same delay and swap its initial source.

toString

open override fun toString(): String

Includes the model name, the id, the model element name, the parent name, and parent id

transportDemand

open override fun transportDemand(demand: SupplyChainModel.Demand)

Transport demand from its origin to its destination.