Package jline.lang.layered

Class LayeredNetworkStruct

java.lang.Object

jline.lang.layered.LayeredNetworkStruct

All Implemented Interfaces:

Serializable, Copyable

public class LayeredNetworkStruct
extends Object
implements Copyable

Class summarizing the characteristics of a LayeredNetwork

Index base. Element indices are 0-BASED. A host, task, entry, activity or call has a local index in 0..n-1, and its absolute index is shift + local, so absolute indices run 0..nidx-1 and calls run 0..ncalls-1. The shift values themselves are element COUNTS (hshift=0, tshift=nhosts, eshift=nhosts+ntasks, ...) and are the same numbers they were under the former 1-based numbering; only the local range moved. Matrices carry no padding row or column, and an unset or not-found index is -1, never 0 (0 is the first host). Prefer the hostIdx/taskIdx/entryIdx/actIdx converters and the isHostIdx family below over open-coded shift + local arithmetic.

MATLAB keeps the 1-based numbering; JLINE.from_jline_struct_layered translates. See _kb/04-networkstruct.md.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LayeredNetworkStruct.CallGroupStruct	A caller activity, the strategy, and the entries it dispatches over.
static class	LayeredNetworkStruct.ServerPools	The resolved pool block of one server: compat(t, j) nonzero = pool t may serve operand j.

Field Summary

Fields

Modifier and Type	Field	Description
Matrix	actphase
Matrix	actposttype
Matrix	actpretype
Matrix	actquorum
Map<Integer,List<Integer>>	actsof
Map<Integer,Distribution>	actthink	Deprecated.
Map<Integer,Double>	actthink_mean
Map<Integer,Matrix>	actthink_params
Map<Integer,MatrixCell>	actthink_proc
Map<Integer,Double>	actthink_scv
Map<Integer,ProcessType>	actthink_type
Map<Integer,Distribution>	arrival	Deprecated.
Map<Integer,Double>	arrival_mean
Map<Integer,Matrix>	arrival_params
Map<Integer,MatrixCell>	arrival_proc
Map<Integer,Double>	arrival_scv
Map<Integer,ProcessType>	arrival_type
int	ashift
List<LayeredNetworkStruct.CallGroupStruct>	callgroups	Calls dispatched as a group by a routing strategy.
Map<Integer,String>	callhashnames
Map<Integer,String>	callnames
Matrix	callpair
Map<Integer,Distribution>	callproc	Deprecated.
Map<Integer,Double>	callproc_mean
Map<Integer,Matrix>	callproc_params
Map<Integer,MatrixCell>	callproc_proc
Map<Integer,Double>	callproc_scv
Map<Integer,ProcessType>	callproc_type
Map<Integer,List<Integer>>	callsof
Map<Integer,CallType>	calltype
Map<Integer,SerializableFunction<Matrix,Matrix>>	cdscaling
Map<Integer,Matrix>	cdscalingpeak
Matrix	conntasks
int	cshift
Matrix	dag
Map<Integer,Distribution>	delayofftime	Deprecated.
Map<Integer,Double>	delayofftime_mean
Map<Integer,Matrix>	delayofftime_params
Map<Integer,MatrixCell>	delayofftime_proc
Map<Integer,Double>	delayofftime_scv
Map<Integer,ProcessType>	delayofftime_type
Map<Integer,List<Integer>>	entriesof
int	eshift
Matrix	fanout
Matrix	graph
Map<Integer,String>	hashnames
Matrix	hasretrieval
Matrix	hassetup
Integer	hitaidx
List<Integer>	hitmissaidx
Map<Integer,Distribution>	hostdem	Deprecated.
Map<Integer,Double>	hostdem_mean
Map<Integer,Matrix>	hostdem_params
Map<Integer,MatrixCell>	hostdem_proc
Map<Integer,Double>	hostdem_scv
Map<Integer,ProcessType>	hostdem_type
int	hshift
Matrix	isasynccaller
Matrix	iscache
Matrix	iscaller
Matrix	isref
Matrix	issynccaller
Map<Integer,int[]>	itemcap
Map<Integer,DiscreteDistribution>	itemproc	Deprecated.
Map<Integer,Double>	itemproc_mean
Map<Integer,Matrix>	itemproc_params
Map<Integer,MatrixCell>	itemproc_proc
Map<Integer,Double>	itemproc_scv
Map<Integer,ProcessType>	itemproc_type
Map<Integer,SerializableFunction<Matrix,Matrix>>	jdscaling
Map<Integer,Matrix>	jdscalingpeak
Map<Integer,Matrix[]>	lincon
Map<Integer,Matrix>	lldscaling
Matrix	maxmult
Integer	missaidx
Matrix	mult
int	nacts
Map<Integer,String>	names
int	ncalls
int	nentries
int	nhosts
int	nidx
Matrix	nitems
int	ntasks
Matrix	parent
Map<Integer,LayeredNetworkStruct.ServerPools>	pools	Compatibility pools declared on a layer server, by element index, absent where none.
Matrix	prio	Scheduling priority of a task, 0 on every other index.
Matrix	repl
Matrix	replacement
Matrix	replacestrat
Matrix	replygraph
Map<Integer,SchedStrategy>	sched
Matrix	schedid
Map<Integer,Distribution>	setuptime	Deprecated.
Map<Integer,Double>	setuptime_mean
Map<Integer,Matrix>	setuptime_params
Map<Integer,MatrixCell>	setuptime_proc
Map<Integer,Double>	setuptime_scv
Map<Integer,ProcessType>	setuptime_type
Matrix	taskgraph
Map<Integer,List<Integer>>	tasksof
Map<Integer,Distribution>	think	Deprecated.
Map<Integer,Double>	think_mean
Map<Integer,Matrix>	think_params
Map<Integer,MatrixCell>	think_proc
Map<Integer,Double>	think_scv
Map<Integer,ProcessType>	think_type
int	tshift
Matrix	type

Constructor Summary

Constructors

Constructor	Description
LayeredNetworkStruct()

Method Summary

Modifier and Type	Method	Description
int	actIdx(int a)	Absolute index of activity a, a in 0..nacts-1.
int	actOf(int idx)	Activity-local index of an absolute index, or -1 if it is not an activity.
int	entryIdx(int e)	Absolute index of entry e, e in 0..nentries-1.
int	entryOf(int idx)	Entry-local index of an absolute index, or -1 if it is not an entry.
int	hostIdx(int h)	Absolute index of host h, h in 0..nhosts-1.
int	hostOf(int idx)	Host-local index of an absolute index, or -1 if it is not a host.
double	hostReachMult(int idx)	Servers of the processor hosting element idx that its work can reach: the divisor of every LQN Util column (SolverLN, SolverLQNS, SolverLDES).
boolean	isActIdx(int idx)
boolean	isEntryIdx(int idx)
boolean	isHostIdx(int idx)
boolean	isTaskIdx(int idx)
void	print()
int	taskIdx(int t)	Absolute index of task t, t in 0..ntasks-1.
int	taskOf(int idx)	Task-local index of an absolute index, or -1 if it is not a task.
void	validateIndexSpace()	Checks the index-base invariants of this struct.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface jline.lang.Copyable

copy

Field Details

nidx

public int nidx

nhosts

public int nhosts

ntasks

public int ntasks

nacts

public int nacts

nentries

public int nentries

ncalls

public int ncalls

tshift

public int tshift

eshift

public int eshift

ashift

public int ashift

hshift

public int hshift

cshift

public int cshift

tasksof

public Map<Integer,List<Integer>> tasksof

entriesof

public Map<Integer,List<Integer>> entriesof

actsof

public Map<Integer,List<Integer>> actsof

callsof

public Map<Integer,List<Integer>> callsof

hostdem

@Deprecated
public Map<Integer,Distribution> hostdem

Deprecated.

hostdem_type

public Map<Integer,ProcessType> hostdem_type

hostdem_params

public Map<Integer,Matrix> hostdem_params

hostdem_mean

public Map<Integer,Double> hostdem_mean

hostdem_scv

public Map<Integer,Double> hostdem_scv

hostdem_proc

public Map<Integer,MatrixCell> hostdem_proc

think

@Deprecated
public Map<Integer,Distribution> think

Deprecated.

think_type

public Map<Integer,ProcessType> think_type

think_params

public Map<Integer,Matrix> think_params

think_mean

public Map<Integer,Double> think_mean

think_scv

public Map<Integer,Double> think_scv

think_proc

public Map<Integer,MatrixCell> think_proc

actthink

@Deprecated
public Map<Integer,Distribution> actthink

Deprecated.

actthink_type

public Map<Integer,ProcessType> actthink_type

actthink_params

public Map<Integer,Matrix> actthink_params

actthink_mean

public Map<Integer,Double> actthink_mean

actthink_scv

public Map<Integer,Double> actthink_scv

actthink_proc

public Map<Integer,MatrixCell> actthink_proc

itemcap

public Map<Integer,int[]> itemcap

itemproc

@Deprecated
public Map<Integer,DiscreteDistribution> itemproc

Deprecated.

itemproc_type

public Map<Integer,ProcessType> itemproc_type

itemproc_params

public Map<Integer,Matrix> itemproc_params

itemproc_mean

public Map<Integer,Double> itemproc_mean

itemproc_scv

public Map<Integer,Double> itemproc_scv

itemproc_proc

public Map<Integer,MatrixCell> itemproc_proc

calltype

public Map<Integer,CallType> calltype

callproc

@Deprecated
public Map<Integer,Distribution> callproc

Deprecated.

callproc_type

public Map<Integer,ProcessType> callproc_type

callproc_params

public Map<Integer,Matrix> callproc_params

callproc_mean

public Map<Integer,Double> callproc_mean

callproc_scv

public Map<Integer,Double> callproc_scv

callproc_proc

public Map<Integer,MatrixCell> callproc_proc

callnames

public Map<Integer,String> callnames

callhashnames

public Map<Integer,String> callhashnames

sched

public Map<Integer,SchedStrategy> sched

prio

public Matrix prio

Scheduling priority of a task, 0 on every other index. Lower is served first, the convention sn.classprio uses in a Network. Read by the priority disciplines (HOL) of a host or a task.

names

public Map<Integer,String> names

hashnames

public Map<Integer,String> hashnames

mult

public Matrix mult

maxmult

public Matrix maxmult

repl

public Matrix repl

type

public Matrix type

graph

public Matrix graph

dag

public Matrix dag

replygraph

public Matrix replygraph

actphase

public Matrix actphase

nitems

public Matrix nitems

replacestrat

public Matrix replacestrat

replacement

public Matrix replacement

iscache

public Matrix iscache

hasretrieval

public Matrix hasretrieval

parent

public Matrix parent

schedid

public Matrix schedid

iscaller

public Matrix iscaller

issynccaller

public Matrix issynccaller

isasynccaller

public Matrix isasynccaller

callpair

public Matrix callpair

callgroups

public List<LayeredNetworkStruct.CallGroupStruct> callgroups

Calls dispatched as a group by a routing strategy. Empty for every model that does not use Activity.synchCallRoundRobin. Requires the squashed layering; see SolverLN.assertCallGroups.

taskgraph

public Matrix taskgraph

actpretype

public Matrix actpretype

actposttype

public Matrix actposttype

actquorum

public Matrix actquorum

isref

public Matrix isref

hassetup

public Matrix hassetup

fanout

public Matrix fanout

setuptime

@Deprecated
public Map<Integer,Distribution> setuptime

Deprecated.

setuptime_type

public Map<Integer,ProcessType> setuptime_type

setuptime_params

public Map<Integer,Matrix> setuptime_params

setuptime_mean

public Map<Integer,Double> setuptime_mean

setuptime_scv

public Map<Integer,Double> setuptime_scv

setuptime_proc

public Map<Integer,MatrixCell> setuptime_proc

delayofftime

@Deprecated
public Map<Integer,Distribution> delayofftime

Deprecated.

delayofftime_type

public Map<Integer,ProcessType> delayofftime_type

delayofftime_params

public Map<Integer,Matrix> delayofftime_params

delayofftime_mean

public Map<Integer,Double> delayofftime_mean

delayofftime_scv

public Map<Integer,Double> delayofftime_scv

delayofftime_proc

public Map<Integer,MatrixCell> delayofftime_proc

arrival

@Deprecated
public Map<Integer,Distribution> arrival

Deprecated.

arrival_type

public Map<Integer,ProcessType> arrival_type

arrival_params

public Map<Integer,Matrix> arrival_params

arrival_mean

public Map<Integer,Double> arrival_mean

arrival_scv

public Map<Integer,Double> arrival_scv

arrival_proc

public Map<Integer,MatrixCell> arrival_proc

lincon

public Map<Integer,Matrix[]> lincon

lldscaling

public Map<Integer,Matrix> lldscaling

cdscaling

public Map<Integer,SerializableFunction<Matrix,Matrix>> cdscaling

cdscalingpeak

public Map<Integer,Matrix> cdscalingpeak

jdscaling

public Map<Integer,SerializableFunction<Matrix,Matrix>> jdscaling

jdscalingpeak

public Map<Integer,Matrix> jdscalingpeak

pools

public Map<Integer,LayeredNetworkStruct.ServerPools> pools

Compatibility pools declared on a layer server, by element index, absent where none. SolverLN lowers each to the activated-server rate of SnCompatRate; see _kb/04-networkstruct.md.

conntasks

public Matrix conntasks

hitmissaidx

public List<Integer> hitmissaidx

hitaidx

public Integer hitaidx

missaidx

public Integer missaidx

Constructor Details

LayeredNetworkStruct

public LayeredNetworkStruct()

Method Details

hostReachMult

public double hostReachMult(int idx)

Servers of the processor hosting element idx that its work can reach: the divisor of every LQN Util column (SolverLN, SolverLQNS, SolverLDES). It is maxmult capped by the declared multiplicity, and 1.0 at an infinite server, whose stored multiplicity (MaxInt) is finite but meaningless, or where the element has no host.

Parameters:

idx - absolute 0-based element index

Returns:

the reachable host multiplicity

hostIdx

public int hostIdx(int h)

Absolute index of host h, h in 0..nhosts-1.

taskIdx

public int taskIdx(int t)

Absolute index of task t, t in 0..ntasks-1.

entryIdx

public int entryIdx(int e)

Absolute index of entry e, e in 0..nentries-1.

actIdx

public int actIdx(int a)

Absolute index of activity a, a in 0..nacts-1.

hostOf

public int hostOf(int idx)

Host-local index of an absolute index, or -1 if it is not a host.

taskOf

public int taskOf(int idx)

Task-local index of an absolute index, or -1 if it is not a task.

entryOf

public int entryOf(int idx)

Entry-local index of an absolute index, or -1 if it is not an entry.

actOf

public int actOf(int idx)

Activity-local index of an absolute index, or -1 if it is not an activity.

isHostIdx

public boolean isHostIdx(int idx)

isTaskIdx

public boolean isTaskIdx(int idx)

isEntryIdx

public boolean isEntryIdx(int idx)

isActIdx

public boolean isActIdx(int idx)

validateIndexSpace

public void validateIndexSpace()

Checks the index-base invariants of this struct. The element index space is 0-based and unpadded, so the shifts must partition 0..nidx-1 and every index-valued field must stay inside it. Throws IllegalStateException on the first violation.

print

public void print()