ikr.simlib.trace

Class TraceFile

java.lang.Object

ikr.simlib.trace.TraceFile

public class TraceFile
extends java.lang.Object

TraceFile is supportive class which is responsible for handling the trace files. The trace file must have have following make up:

hh:mm:ss.sss length

The time information can either be absolute or relative to the preeceding event (=interarrival time), this can be set by fAbsoluteTime.

Further the behavior at the end of the trace file can be determined. If fWrapFile is set, the trace file is reread from the beginning, but in the case of absolute time only the IAT between two succeeding events is considered. In the other case the simulation interrupts with an error, if the end of the trace file is reached.

Comments are initiated by a leading '#'.

TraceFile is a parseable class. It accepts the following keywords in the parameter file:

FileName

The name of the trace file

AbsoluteTime (boolean, optional)

Set to TRUE if the times in the trace file represent absolute times. Set to FALSE if they represent relative times (i.e., time differences). Default is TRUE

WrapFile (boolean, optional)

Set to TRUE if you want the trace to be reread from the beginning once the end is reached. If set to FALSE, an exception will be thrown when the end of the trace file is reached. Default is FALSE.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	absoluteTime Contains the traceFile absolute or relative times
protected TraceItem	currentItem
protected double	currentTime
protected boolean	endOfFile
protected java.io.RandomAccessFile	file
protected java.lang.String	fileName
protected boolean	firstRunFinished
protected double	iat
protected TraceItem	lastItem
protected double	timeBase Determined from the first value
protected boolean	wrapFile Behavior, if the end of the file is reached

Constructor Summary

Constructors

Constructor and Description
TraceFile(Parameter par)
TraceFile(java.lang.String filename)
TraceFile(java.lang.String filename, boolean absolutetime, boolean wrapfile)

Method Summary

Methods

Modifier and Type	Method and Description
protected double	convertTime(TraceItem item)
java.lang.String	getFileName()
double	getNextEventTime(double _currentTime)
TraceItem	getNextItem()
int	getNextLength()

Methods inherited from class java.lang.Object

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

Field Detail

fileName

protected java.lang.String fileName

file

protected java.io.RandomAccessFile file

absoluteTime

protected boolean absoluteTime

Contains the traceFile absolute or relative times

wrapFile

protected boolean wrapFile

Behavior, if the end of the file is reached

timeBase

protected double timeBase

Determined from the first value

currentTime

protected double currentTime

currentItem

protected TraceItem currentItem

lastItem

protected TraceItem lastItem

iat

protected double iat

endOfFile

protected boolean endOfFile

firstRunFinished

protected boolean firstRunFinished

Constructor Detail

TraceFile

public TraceFile(java.lang.String filename,
         boolean absolutetime,
         boolean wrapfile)

TraceFile

public TraceFile(java.lang.String filename)

TraceFile

public TraceFile(Parameter par)

Method Detail

convertTime

protected double convertTime(TraceItem item)

getNextEventTime

public double getNextEventTime(double _currentTime)

getNextLength

public int getNextLength()

getNextItem

public TraceItem getNextItem()

getFileName

public java.lang.String getFileName()