LINE Solver
MATLAB API documentation
Loading...
Searching...
No Matches
writeJSIM.m
1function outputFileName = writeJSIM(self, sn, outputFileName)
2% FNAME = WRITEJSIM(SN, FNAME)
3
4% Copyright (c) 2012-2026, Imperial College London
5% All rights reserved.
6
7if nargin<3 || isempty(outputFileName)
8 % Generate default temp path
9 filePath = lineTempName('jsim');
10 outputFileName = [filePath, filesep, 'model.jsim'];
11end
12
13[simXMLElem, simXMLDoc] = saveXMLHeader(self, self.model.getLogPath);
14[simXMLElem, simXMLDoc] = saveClasses(self, simXMLElem, simXMLDoc);
15
16numOfClasses = sn.nclasses;
17numOfNodes = sn.nnodes;
18for i=1:numOfNodes
19 ind = i;
20 currentNode = self.model.nodes{i,1};
21 node = simXMLDoc.createElement('node');
22 node.setAttribute('name', currentNode.name);
23
24 nodeSections = getSections(currentNode);
25 for j=1:length(nodeSections)
26 xml_section = simXMLDoc.createElement('section');
27 currentSection = nodeSections{1,j};
28 if ~isempty(currentSection)
29 sectionClassName = currentSection.className;
30 % Override className for preemptive strategies - JMT requires PreemptiveServer
31 if strcmp(sectionClassName, 'Server') && isa(currentNode, 'Queue')
32 sched = currentNode.schedStrategy;
33 if sched == SchedStrategy.SRPT || sched == SchedStrategy.SRPTPRIO || ...
34 sched == SchedStrategy.LCFSPR || sched == SchedStrategy.LCFSPRPRIO || ...
35 sched == SchedStrategy.LCFSPI || sched == SchedStrategy.LCFSPIPRIO || ...
36 sched == SchedStrategy.FCFSPR || sched == SchedStrategy.FCFSPRPRIO || ...
37 sched == SchedStrategy.FCFSPI || sched == SchedStrategy.FCFSPIPRIO
38 sectionClassName = 'PreemptiveServer';
39 end
40 end
41 xml_section.setAttribute('className', sectionClassName);
42 switch sectionClassName
43 case 'Buffer'
44 xml_section.setAttribute('className', 'Queue'); %overwrite with JMT class name
45 [simXMLDoc, xml_section] = saveBufferCapacity(self, simXMLDoc, xml_section, ind);
46 [simXMLDoc, xml_section] = saveDropStrategy(self, simXMLDoc, xml_section, ind); % unfinished
47 [simXMLDoc, xml_section] = saveGetStrategy(self, simXMLDoc, xml_section, ind);
48 [simXMLDoc, xml_section] = savePutStrategy(self, simXMLDoc, xml_section, ind);
49 [simXMLDoc, xml_section] = saveImpatience(self, simXMLDoc, xml_section, ind);
50 case 'Server'
51 [simXMLDoc, xml_section] = saveNumberOfServers(self, simXMLDoc, xml_section, ind);
52 [simXMLDoc, xml_section] = saveServerVisits(self, simXMLDoc, xml_section);
53 % Heterogeneous server configuration
54 [simXMLDoc, xml_section] = saveServerTypeNames(self, simXMLDoc, xml_section, ind);
55 [simXMLDoc, xml_section] = saveServersPerType(self, simXMLDoc, xml_section, ind);
56 [simXMLDoc, xml_section] = saveServerCompatibilities(self, simXMLDoc, xml_section, ind);
57 [simXMLDoc, xml_section] = saveHeteroSchedPolicy(self, simXMLDoc, xml_section, ind);
58 [simXMLDoc, xml_section] = saveServiceStrategy(self, simXMLDoc, xml_section, ind);
59 [simXMLDoc, xml_section] = saveDelayOffStrategy(self, simXMLDoc, xml_section, ind);
60 % Note: SwitchoverStrategy is only supported by PollingServer in JMT
61 % Regular Server class does not support switchover times
62 if ~isempty(currentNode.switchoverTime)
63 line_warning(mfilename, 'JMT does not support switchover times for non-polling queues. Switchover times will be ignored for node %s.', currentNode.name);
64 end
65 case 'PreemptiveServer'
66 [simXMLDoc, xml_section] = saveNumberOfServers(self, simXMLDoc, xml_section, ind);
67 [simXMLDoc, xml_section] = saveServerVisits(self, simXMLDoc, xml_section);
68 [simXMLDoc, xml_section] = saveServiceStrategy(self, simXMLDoc, xml_section, ind);
69 [simXMLDoc, xml_section] = saveDelayOffStrategy(self, simXMLDoc, xml_section, ind);
70 case 'SharedServer'
71 xml_section.setAttribute('className', 'PSServer'); %overwrite with JMT class name
72 [simXMLDoc, xml_section] = saveNumberOfServers(self, simXMLDoc, xml_section, ind);
73 [simXMLDoc, xml_section] = saveServerVisits(self, simXMLDoc, xml_section);
74 [simXMLDoc, xml_section] = saveServiceStrategy(self, simXMLDoc, xml_section, ind);
75 [simXMLDoc, xml_section] = saveDelayOffStrategy(self, simXMLDoc, xml_section, ind);
76 [simXMLDoc, xml_section] = savePreemptiveStrategy(self, simXMLDoc, xml_section, ind);
77 [simXMLDoc, xml_section] = savePreemptiveWeights(self, simXMLDoc, xml_section, ind);
78 case 'InfiniteServer'
79 xml_section.setAttribute('className', 'Delay'); %overwrite with JMT class name
80 [simXMLDoc, xml_section] = saveServiceStrategy(self, simXMLDoc, xml_section, ind);
81 case 'PollingServer'
82 % we assume identical polling type on each buffer
83 switch sn.nodeparam{ind}{1}.pollingType
84 case PollingType.GATED
85 xml_section.setAttribute('className', 'GatedPollingServer'); %overwrite with JMT class name
86 case PollingType.EXHAUSTIVE
87 xml_section.setAttribute('className', 'ExhaustivePollingServer'); %overwrite with JMT class name
88 case PollingType.KLIMITED
89 xml_section.setAttribute('className', 'LimitedPollingServer'); %overwrite with JMT class name
90 end
91 [simXMLDoc, xml_section] = saveNumberOfServers(self, simXMLDoc, xml_section, ind);
92 [simXMLDoc, xml_section] = saveServerVisits(self, simXMLDoc, xml_section);
93 [simXMLDoc, xml_section] = saveServiceStrategy(self, simXMLDoc, xml_section, ind);
94 [simXMLDoc, xml_section] = saveSwitchoverStrategy(self, simXMLDoc, xml_section, ind);
95 case 'RandomSource'
96 [simXMLDoc, xml_section] = saveArrivalStrategy(self, simXMLDoc, xml_section, ind);
97 case 'Dispatcher'
98 xml_section.setAttribute('className', 'Router'); %overwrite with JMT class name
99 [simXMLDoc, xml_section] = saveRoutingStrategy(self, simXMLDoc, xml_section, ind);
100 case 'StatelessClassSwitcher'
101 xml_section.setAttribute('className', 'ClassSwitch'); %overwrite with JMT class name
102 [simXMLDoc, xml_section] = saveClassSwitchStrategy(self, simXMLDoc, xml_section, ind);
103 case 'Cache'
104 % CacheClassSwitcher section has className='Cache'
105 [simXMLDoc, xml_section] = saveCacheStrategy(self, simXMLDoc, xml_section, ind);
106 case 'LogTunnel'
107 [simXMLDoc, xml_section] = saveLogTunnel(self, simXMLDoc, xml_section, ind);
108 case 'Joiner'
109 xml_section.setAttribute('className', 'Join'); %overwrite with JMT class name
110 [simXMLDoc, xml_section] = saveJoinStrategy(self, simXMLDoc, xml_section, ind);
111 case 'Forker'
112 xml_section.setAttribute('className', 'Fork'); %overwrite with JMT class name
113 [simXMLDoc, xml_section] = saveForkStrategy(self, simXMLDoc, xml_section, ind);
114 case 'Storage'
115 xml_section.setAttribute('className', 'Storage'); %overwrite with JMT class name
116 [simXMLDoc, xml_section] = saveTotalCapacity(self, simXMLDoc, xml_section, ind);
117 [simXMLDoc, xml_section] = savePlaceCapacities(self, simXMLDoc, xml_section, ind);
118 [simXMLDoc, xml_section] = saveDropRule(self, simXMLDoc, xml_section, ind); % unfinished
119 [simXMLDoc, xml_section] = saveGetStrategy(self, simXMLDoc, xml_section, ind);
120 [simXMLDoc, xml_section] = savePutStrategies(self, simXMLDoc, xml_section, ind);
121 case 'Enabling'
122 xml_section.setAttribute('className', 'Enabling'); %overwrite with JMT class name
123 [simXMLDoc, xml_section] = saveEnablingConditions(self, simXMLDoc, xml_section, ind);
124 [simXMLDoc, xml_section] = saveInhibitingConditions(self, simXMLDoc, xml_section, ind);
125 case 'Firing'
126 xml_section.setAttribute('className', 'Firing'); %overwrite with JMT class name
127 [simXMLDoc, xml_section] = saveFiringOutcomes(self, simXMLDoc, xml_section, ind);
128 case 'Timing'
129 xml_section.setAttribute('className', 'Timing'); %overwrite with JMT class name
130 [simXMLDoc, xml_section] = saveModeNames(self, simXMLDoc, xml_section, ind);
131 [simXMLDoc, xml_section] = saveNumbersOfServers(self, simXMLDoc, xml_section, ind);
132 [simXMLDoc, xml_section] = saveTimingStrategies(self, simXMLDoc, xml_section, ind);
133 [simXMLDoc, xml_section] = saveFiringPriorities(self, simXMLDoc, xml_section, ind);
134 [simXMLDoc, xml_section] = saveFiringWeights(self, simXMLDoc, xml_section, ind);
135 end
136 node.appendChild(xml_section);
137 end
138 end
139 simXMLElem.appendChild(node);
140end
141
142[simXMLElem, simXMLDoc] = saveMetrics(self, simXMLElem, simXMLDoc);
143[simXMLElem, simXMLDoc] = saveLinks(self, simXMLElem, simXMLDoc);
144[simXMLElem, simXMLDoc] = saveRegions(self, simXMLElem, simXMLDoc);
145
146hasReferenceNodes = false;
147preloadNode = simXMLDoc.createElement('preload');
148s0 = sn.state;
149numOfStations = sn.nstations;
150for i=1:numOfStations
151 isReferenceNode = false;
152 if sn.nodetype(sn.stationToNode(i))~=NodeType.Source && sn.nodetype(sn.stationToNode(i))~=NodeType.Join
153 [~, nir] = State.toMarginal(sn, sn.stationToNode(i), s0{sn.stationToStateful(i)});
154 stationPopulationsNode = simXMLDoc.createElement('stationPopulations');
155 stationPopulationsNode.setAttribute('stationName', sn.nodenames{sn.stationToNode(i)});
156 % TODO: this assumes that the preloading comes from the first
157 % state, but it could be that stateprior is put on another
158 for r=1:numOfClasses
159 % Skip closed classes with 0 customers, unless state has jobs via class switching
160 if isfinite(sn.njobs(r)) && sn.njobs(r) == 0 && nir(1,r) == 0
161 continue;
162 end
163
164 classPopulationNode = simXMLDoc.createElement('classPopulation');
165 if isinf(sn.njobs(r))
166 % case 'open'
167 isReferenceNode = true;
168 classPopulationNode.setAttribute('population', sprintf('%d',round(nir(1,r))));
169 classPopulationNode.setAttribute('refClass', sn.classnames{r});
170 stationPopulationsNode.appendChild(classPopulationNode);
171 else
172 % case 'closed'
173 isReferenceNode = true;
174 classPopulationNode.setAttribute('population', sprintf('%d',round(nir(1,r))));
175 classPopulationNode.setAttribute('refClass', sn.classnames{r});
176 stationPopulationsNode.appendChild(classPopulationNode);
177 end
178 end
179 end
180 if isReferenceNode
181 preloadNode.appendChild(stationPopulationsNode);
182 end
183 hasReferenceNodes = hasReferenceNodes + isReferenceNode;
184end
185if hasReferenceNodes
186 simXMLElem.appendChild(preloadNode);
187end
188
189try
190 xmlwrite(outputFileName, simXMLDoc);
191catch ME
192 getReport(ME,'basic')
193 javaaddpath(which('xercesImpl-2.11.0.jar'));
194 javaaddpath(which('xml-apis-2.11.0.jar'));
195 pkg load io;
196 xmlwrite(outputFileName, simXMLDoc);
197end
198end