1function [ni, nir] = toMarginalAggr(sn, ind, state_i, K, Ks, space_buf, space_srv, space_var) %#ok<INUSD>
2% TOMARGINALAGGR Compute aggregate marginal distributions
for a specific node
4% [NI, NIR] = TOMARGINALAGGR(SN, IND, STATE_I, K, KS, SPACE_BUF, SPACE_SRV, SPACE_VAR)
6% @brief Computes aggregate marginal job counts from state information without phase details
8% This function provides a simplified version of toMarginal that computes
9% aggregate job counts per node and per
class, without considering individual
10% service phases. It
is more efficient when phase-level detail
is not required.
12% @param sn Network structure or Network
object
13% @param ind Node index to extract marginal information
for
14% @param state_i Global state matrix or vector
15% @param K Vector of population
for each class
16% @param Ks Matrix of populations per chain and
class
17% @param space_buf Buffer space configuration
18% @param space_srv Service space configuration
19% @param space_var Variable space configuration
21% @
return ni Total jobs in node IND (aggregate across all
classes)
22% @
return nir Jobs per
class in node IND [vector:
classes]
24% Copyright (c) 2012-2026, Imperial College London
27if ~isstruct(sn) % the input can be a Network object too
31ist = sn.nodeToStation(ind);
32%isf = sn.nodeToStateful(ind);
34if ~sn.isstation(ind) && sn.isstateful(ind) % if stateful node
35 ni = sum(state_i(1:(end-sum(sn.nvars(ind,:)))));
36 nir = state_i(1:(end-sum(sn.nvars(ind,:))));
40% Place
nodes: compute total jobs per class from state
41if sn.nodetype(ind) == NodeType.Place
42 state_len = size(state_i, 2);
43 % Check if this
is queue-based state (FCFS/LCFS/HOL) vs count-based
44 % Queue-based: state contains class indices [1,1,2,1] meaning job arrivals
45 % Count-based: state contains counts per class [n1, n2, ...] or [buf(R), srv]
46 % Detect queue-based: length != R and length != 2*R and all values are valid class indices
47 is_queue_based = state_len ~= R && state_len ~= 2*R;
48 if is_queue_based && state_len > 0
49 % Check all values are valid class indices (1 to R)
50 all_vals = state_i(:);
51 is_queue_based = all(all_vals >= 1 & all_vals <= R);
55 % Queue-based format: count occurrences of each class
56 nir = zeros(size(state_i,1), R);
58 nir(:,r) = sum(state_i == r, 2);
60 elseif nargin >= 4 && ~isempty(K)
61 expected_len = R + sum(K);
62 if state_len == expected_len
63 % State has [buffer, server] format
64 buf_part = state_i(:, 1:R);
65 srv_part = state_i(:, (R+1):end);
69 nir(:,r) = nir(:,r) + srv_part(:, Ks(r)+k);
73 % State
is just counts per class (simple SIRO format)
76 % Unknown format - just take first R columns
77 nir = state_i(:, 1:min(R, state_len));
79 nir = [nir, zeros(size(nir,1), R - size(nir,2))];
83 % No K provided - assume state is counts per class
84 nir = state_i(:, 1:min(R, size(state_i, 2)));
86 nir = [nir, zeros(size(nir,1), R - size(nir,2))];
93% Source nodes have infinite population but report queue length 0 (jobs are external)
94if sn.nodetype(ind) == NodeType.Source
95 nir = zeros(size(state_i,1), R);
96 ni = zeros(size(state_i,1), 1);
101 K = sn.phasessz(ist,:);
104 Ks = sn.phaseshift(ist,:);
108 space_var = state_i(:,(end-sum(sn.nvars(ind,:))+1):end); % server state
109 space_srv = state_i(:,(end-sum(K)+1):(end-sum(sn.nvars(ind,:))));
110 space_buf = state_i(:,1:(end-sum(K)));
113nir = zeros(size(state_i,1),R); % class-r jobs in service
116 nir(:,r) = nir(:,r) + space_srv(:,Ks(r)+k);
120 case SchedStrategy.EXT
124 case SchedStrategy.FCFS
126 nir(:,r) = nir(:,r) + sum(space_buf==r,2); % class-r jobs in station
128 case SchedStrategy.HOL
130 nir(:,r) = nir(:,r) + sum(space_buf==r,2); % class-r jobs in station
132 case SchedStrategy.LCFS
134 nir(:,r) = nir(:,r) + sum(space_buf==r,2); % class-r jobs in station
136 case SchedStrategy.SIRO
138 nir(:,r) = nir(:,r) + space_buf(:,r); % class-r jobs in station
140 case SchedStrategy.SEPT
142 nir(:,r) = nir(:,r) + space_buf(:,r); % class-r jobs in station
144 case SchedStrategy.LEPT
146 nir(:,r) = nir(:,r) + space_buf(:,r); % class-r jobs in station
148 %otherwise % possibly other stateful nodes
153 if isnan(sn.rates(ist,r)) && sn.nodetype(ind) ~= NodeType.Place % if disabled
158ni = sum(nir,2); % total jobs in station