Package jline.solvers.jmt.io

Class JMTIO

java.lang.Object

jline.solvers.jmt.io.JMTIO

public class JMTIO
extends Object

Unified I/O handler for JMT (Java Modelling Tools) files.

This class provides both read and write functionality for JMT XML format files (JSIM and JMVA) from LINE network models. It combines the functionality previously split between JMTXMLParser (write) and JMTResultParser (read).

Supported operations:

• Write: Generate JSIM/JMVA XML files from LINE models
• Read: Parse JSIM/JMVA result files and log files

Usage Example:

 JMTIO jmtio = new JMTIO(model, options);
 // Write
 String outputFile = jmtio.writeJSIM(sn, "model.jsim");
 // Read
 JMTResult result = jmtio.parseJSIMResult("model.jsim-result.jsim");
 

See Also:

• SaveHandlers
• JMTResult
• Copyright (c) 2012-2026, Imperial College London All rights reserved.

Constructor Summary

Constructors

Constructor	Description
JMTIO(Network model)	Creates a new JMTIO instance with default settings.
JMTIO(Network model, double simConfInt, double simMaxRelErr, long maxSamples, long maxEvents, double maxSimulatedTime, long seed)	Creates a new JMTIO instance with full parameter control.

Method Summary

Modifier and Type	Method	Description
Network	getModel()
SaveHandlers	getSaveHandlers(SolverAvgHandles avgHandles)	Gets or creates the SaveHandlers instance for XML generation.
long	getSeed()
double	getSimConfInt()
double	getSimMaxRelErr()
List<String[]>	parseCSVLog(String filePath)	Parses a CSV log file from JMT.
JMTResult	parseJMVAResult(String resultFilePath)	Parses a JMVA result XML file.
JMTResult	parseJSIMResult(String resultFilePath)	Parses a JSIM result XML file.
Matrix[][][]	parseLogs(boolean[] isNodeLogged, MetricType metric)	Parses JMT log files for the specified metric type.
Matrix[][]	parseTranRespT(List<String[]> arvData, List<String[]> depData)	Parses transient response time data from arrival and departure logs.
Object[]	parseTranState(List<String[]> arvData, List<String[]> depData, Matrix nodePreload)	Parses transient state data from log files.
DocumentSectionPair	saveArrivalStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveBufferCapacity(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveCacheStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
ElementDocumentPair	saveClasses(SolverAvgHandles avgHandles, ElementDocumentPair elementDocumentPair)	Saves class definitions to the XML document.
DocumentSectionPair	saveClassSwitchStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveDelayOffStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveDropStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveForkStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveGetStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveImpatience(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveJoinStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
ElementDocumentPair	saveLinks(SolverAvgHandles avgHandles, ElementDocumentPair elementDocumentPair)	Saves network links to the XML document.
DocumentSectionPair	saveLogTunnel(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
ElementDocumentPair	saveMetrics(SolverAvgHandles avgHandles, ElementDocumentPair elementDocumentPair)	Saves metrics configuration to the XML document.
DocumentSectionPair	saveNumberOfServers(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	savePreemptiveStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	savePreemptiveWeights(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	savePutStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
ElementDocumentPair	saveRegions(SolverAvgHandles avgHandles, ElementDocumentPair elementDocumentPair)	Saves finite capacity regions to the XML document.
DocumentSectionPair	saveRoutingStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveServerVisits(SolverAvgHandles avgHandles, DocumentSectionPair pair)
DocumentSectionPair	saveServiceStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
DocumentSectionPair	saveSwitchoverStrategy(SolverAvgHandles avgHandles, DocumentSectionPair pair, int ind)
ElementDocumentPair	saveXMLHeader(SolverAvgHandles avgHandles, String logPath)	Generates the XML header for JMT simulation files.
void	updateNetworkStruct(NetworkStruct sn)	Updates the network structure in the SaveHandlers.

Methods inherited from class java.lang.Object

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

Constructor Details

JMTIO

public JMTIO(Network model)

Creates a new JMTIO instance with default settings.

Parameters:

model - The LINE network model

JMTIO

public JMTIO(Network model,
 double simConfInt,
 double simMaxRelErr,
 long maxSamples,
 long maxEvents,
 double maxSimulatedTime,
 long seed)

Creates a new JMTIO instance with full parameter control.

Parameters:

model - The LINE network model

simConfInt - Confidence interval for simulation (e.g., 0.99)

simMaxRelErr - Maximum relative error (e.g., 0.03)

maxSamples - Maximum number of samples

maxEvents - Maximum number of events (-1 for unlimited)

maxSimulatedTime - Maximum simulated time

seed - Random seed for reproducibility

Method Details

getSaveHandlers

public SaveHandlers getSaveHandlers(SolverAvgHandles avgHandles)

Gets or creates the SaveHandlers instance for XML generation.

Parameters:

avgHandles - Performance metric handles

Returns:

SaveHandlers instance

updateNetworkStruct

public void updateNetworkStruct(NetworkStruct sn)

Updates the network structure in the SaveHandlers.

Parameters:

sn - The network structure

saveXMLHeader

public ElementDocumentPair saveXMLHeader(SolverAvgHandles avgHandles,
 String logPath)
                                  throws ParserConfigurationException

Generates the XML header for JMT simulation files.

Parameters:

avgHandles - Performance metric handles

logPath - Path for simulation logs

Returns:

ElementDocumentPair containing the XML structure

Throws:

ParserConfigurationException - if XML parser configuration fails

saveClasses

public ElementDocumentPair saveClasses(SolverAvgHandles avgHandles,
 ElementDocumentPair elementDocumentPair)

Saves class definitions to the XML document.

saveMetrics

public ElementDocumentPair saveMetrics(SolverAvgHandles avgHandles,
 ElementDocumentPair elementDocumentPair)

Saves metrics configuration to the XML document.

saveLinks

public ElementDocumentPair saveLinks(SolverAvgHandles avgHandles,
 ElementDocumentPair elementDocumentPair)

Saves network links to the XML document.

saveRegions

public ElementDocumentPair saveRegions(SolverAvgHandles avgHandles,
 ElementDocumentPair elementDocumentPair)

Saves finite capacity regions to the XML document.

saveArrivalStrategy

public DocumentSectionPair saveArrivalStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveBufferCapacity

public DocumentSectionPair saveBufferCapacity(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveServiceStrategy

public DocumentSectionPair saveServiceStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveRoutingStrategy

public DocumentSectionPair saveRoutingStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveNumberOfServers

public DocumentSectionPair saveNumberOfServers(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveServerVisits

public DocumentSectionPair saveServerVisits(SolverAvgHandles avgHandles,
 DocumentSectionPair pair)

saveDropStrategy

public DocumentSectionPair saveDropStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveGetStrategy

public DocumentSectionPair saveGetStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

savePutStrategy

public DocumentSectionPair savePutStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveClassSwitchStrategy

public DocumentSectionPair saveClassSwitchStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveForkStrategy

public DocumentSectionPair saveForkStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveJoinStrategy

public DocumentSectionPair saveJoinStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveCacheStrategy

public DocumentSectionPair saveCacheStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveLogTunnel

public DocumentSectionPair saveLogTunnel(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveDelayOffStrategy

public DocumentSectionPair saveDelayOffStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveSwitchoverStrategy

public DocumentSectionPair saveSwitchoverStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

savePreemptiveStrategy

public DocumentSectionPair savePreemptiveStrategy(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

savePreemptiveWeights

public DocumentSectionPair savePreemptiveWeights(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

saveImpatience

public DocumentSectionPair saveImpatience(SolverAvgHandles avgHandles,
 DocumentSectionPair pair,
 int ind)

parseLogs

public Matrix[][][] parseLogs(boolean[] isNodeLogged,
 MetricType metric)

Parses JMT log files for the specified metric type.

Parameters:

isNodeLogged - Array indicating which nodes have logging enabled

metric - The metric type to parse (e.g., RespT, QLen)

Returns:

3D array of matrices containing parsed data [nodes][classes][data]

parseCSVLog

public List<String[]> parseCSVLog(String filePath)
                           throws IOException

Parses a CSV log file from JMT.

Parameters:

filePath - Path to the CSV log file

Returns:

List of parsed rows, each as a String array

Throws:

IOException - if file reading fails

parseTranRespT

public Matrix[][] parseTranRespT(List<String[]> arvData,
 List<String[]> depData)

Parses transient response time data from arrival and departure logs.

Parameters:

arvData - Arrival log data

depData - Departure log data

Returns:

2D array of matrices [classes][data matrices]

parseTranState

public Object[] parseTranState(List<String[]> arvData,
 List<String[]> depData,
 Matrix nodePreload)

Parses transient state data from log files.

Parameters:

arvData - Arrival log data

depData - Departure log data

nodePreload - Initial state at the node

Returns:

Array containing [state matrix, event types, event classes, event jobs]

parseJSIMResult

public JMTResult parseJSIMResult(String resultFilePath)

Parses a JSIM result XML file.

Parameters:

resultFilePath - Path to the JSIM result file

Returns:

Parsed JMTResult, or null if parsing fails

parseJMVAResult

public JMTResult parseJMVAResult(String resultFilePath)

Parses a JMVA result XML file.

Parameters:

resultFilePath - Path to the JMVA result file

Returns:

Parsed JMTResult, or null if parsing fails

getModel

public Network getModel()

getSimConfInt

public double getSimConfInt()

getSimMaxRelErr

public double getSimMaxRelErr()

getSeed

public long getSeed()