Implements a list with integrated statistical probes to provide automatic collection of statistics on the sojourn times of objects in the list and on the size of the list as a function of time given by a simulator. More...

Inheritance diagram for ListWithStat< E >:

[legend]

Collaboration diagram for ListWithStat< E >:

[legend]

Classes
class	Node
	Represents a node that can be part of a list with statistical collecting. More...

Public Member Functions
	ListWithStat (List< Node< E >> nodeList)
	Constructs a new list with internal data structure using the default simulator and implemented by `nodeList`. More...

	ListWithStat (Simulator inSim, List< Node< E >> nodeList)
	Constructs a new list with internal data structure implemented by `nodeList`. More...

	ListWithStat (List< Node< E >> nodeList, Collection<? extends E > c)
	Constructs a list containing the elements of the specified collection, whose elements are stored into `nodeList` and using the default simulator. More...

	ListWithStat (Simulator inSim, List< Node< E >> nodeList, Collection<? extends E > c)
	Constructs a list containing the elements of the specified collection, whose elements are stored into `nodeList`. More...

	ListWithStat (List< Node< E >> nodeList, String name)
	Constructs a new list with name `name`, internal list `nodeList`, and using the default simulator. More...

	ListWithStat (Simulator inSim, List< Node< E >> nodeList, String name)
	Constructs a new list with name `name`, and internal list `nodeList`. More...

	ListWithStat (List< Node< E >> nodeList, Collection<? extends E > c, String name)
	Constructs a new list containing the elements of the specified collection `c`, with name `name`, internal list `nodeList`, and using the default simulator. More...

	ListWithStat (Simulator inSim, List< Node< E >> nodeList, Collection<? extends E > c, String name)
	Constructs a new list containing the elements of the specified collection `c`, with name `name`, and internal list `nodeList`. More...

E	convertFromInnerType (Node< E > node)

Node< E >	convertToInnerType (E element)

Simulator	simulator ()
	Returns the simulator associated with this list. More...

void	setSimulator (Simulator sim)
	Sets the simulator associated with this list. More...

void	clear ()

void	add (int index, E obj)

E	remove (int index)

Iterator< E >	iterator ()

ListIterator< E >	listIterator ()

ListIterator< E >	listIterator (int index)

E	set (int index, E element)

Statistic collection methods
boolean	getStatCollecting ()
	Returns `true` if the list collects statistics about its size and sojourn times of elements, and `false` otherwise. More...

void	setStatCollecting (boolean b)
	Starts or stops collecting statistics on this list. More...

void	initStat ()
	Reinitializes the two statistical probes created by setStatCollecting(true) and makes an update for the probe on the list size. More...

double	getInitTime ()
	Returns the last simulation time initStat was called. More...

Accumulate	statSize ()
	Returns the statistical probe on the evolution of the size of the list as a function of the simulation time. More...

Tally	statSojourn ()
	Returns the statistical probe on the sojourn times of the objects in the list. More...

String	report ()
	Returns a string containing a statistical report on the list, provided that setStatCollecting(true) has been called before for this list. More...

String	getName ()
	Returns the name associated to this list, or `null` if no name was assigned. More...

Public Member Functions inherited from TransformingList< OE, IE >
	TransformingList (List< IE > fromList)
	Creates a new transforming list wrapping the inner list `fromList`. More...

List< IE >	getInnerList ()

abstract OE	convertFromInnerType (IE e)
	Converts an element in the inner list to an element of the outer type. More...

abstract IE	convertToInnerType (OE e)
	Converts an element of the outer type to an element for the inner list. More...

void	add (int index, OE element)

void	clear ()

OE	get (int index)

Iterator< OE >	iterator ()

ListIterator< OE >	listIterator ()

ListIterator< OE >	listIterator (int index)

OE	remove (int index)

OE	set (int index, OE element)

int	size ()

Detailed Description

Implements a list with integrated statistical probes to provide automatic collection of statistics on the sojourn times of objects in the list and on the size of the list as a function of time given by a simulator.

The automatic statistical collection can be enabled or disabled for each list, to reduce overhead. This class extends umontreal.ssj.util.TransformingList and transforms elements into nodes associating insertion times with elements.

Constructor & Destructor Documentation

◆ ListWithStat() [1/8]

ListWithStat ( List< Node< E >> nodeList )

Constructs a new list with internal data structure using the default simulator and implemented by nodeList.

The given list is cleared for the constructed list to be initially empty.

◆ ListWithStat() [2/8]

ListWithStat	(	Simulator	inSim,
		List< Node< E >>	nodeList
	)

Constructs a new list with internal data structure implemented by nodeList.

The given list is cleared for the constructed list to be initially empty.

Parameters

nodeList the list containing the nodes

◆ ListWithStat() [3/8]

ListWithStat	(	List< Node< E >>	nodeList,
		Collection<? extends E >	c
	)

Constructs a list containing the elements of the specified collection, whose elements are stored into nodeList and using the default simulator.

Parameters

nodeList	the list containing the nodes
c	collection containing elements to fill in this list with

◆ ListWithStat() [4/8]

ListWithStat	(	Simulator	inSim,
		List< Node< E >>	nodeList,
		Collection<? extends E >	c
	)

Constructs a list containing the elements of the specified collection, whose elements are stored into nodeList.

Parameters

inSim	simulator associate to the current variable
nodeList	the list containing the nodes
c	collection containing elements to fill in this list with

◆ ListWithStat() [5/8]

ListWithStat	(	List< Node< E >>	nodeList,
		String	name
	)

Constructs a new list with name name, internal list nodeList, and using the default simulator.

This name can be used to identify the list in traces and reports. The given list is cleared for the constructed list to be initially empty.

Parameters

nodeList	the list containing the nodes
name	name for the list object

◆ ListWithStat() [6/8]

ListWithStat	(	Simulator	inSim,
		List< Node< E >>	nodeList,
		String	name
	)

Constructs a new list with name name, and internal list nodeList.

This name can be used to identify the list in traces and reports. The given list is cleared for the constructed list to be initially empty.

Parameters

inSim	simulator associate to the current variable
nodeList	the list containing the nodes
name	name for the list object

◆ ListWithStat() [7/8]

ListWithStat	(	List< Node< E >>	nodeList,
		Collection<? extends E >	c,
		String	name
	)

Constructs a new list containing the elements of the specified collection c, with name name, internal list nodeList, and using the default simulator.

This name can be used to identify the list in traces and reports.

Parameters

nodeList	the list containing the nodes
c	collection containing elements to fill in this list with
name	name for the list object

◆ ListWithStat() [8/8]

ListWithStat	(	Simulator	inSim,
		List< Node< E >>	nodeList,
		Collection<? extends E >	c,
		String	name
	)

Constructs a new list containing the elements of the specified collection c, with name name, and internal list nodeList.

This name can be used to identify the list in traces and reports.

Parameters

inSim	simulator associate to the current variable
nodeList	the list containing the nodes
c	collection containing elements to fill in this list with
name	name for the list object

Member Function Documentation

◆ getInitTime()

double getInitTime ( )

Returns the last simulation time initStat was called.

Returns: the last simulation time initStat was called

◆ getName()

String getName ( )

Returns the name associated to this list, or null if no name was assigned.

Returns: the name associated to this list

◆ getStatCollecting()

boolean getStatCollecting ( )

Returns true if the list collects statistics about its size and sojourn times of elements, and false otherwise.

By default, statistical collecting is turned off.

Returns: the status of statistical collecting

◆ initStat()

void initStat ( )

Reinitializes the two statistical probes created by setStatCollecting(true) and makes an update for the probe on the list size.

Exceptions

IllegalStateException if the statistical collection is disabled

◆ report()

String report ( )

Returns a string containing a statistical report on the list, provided that setStatCollecting(true) has been called before for this list.

Even If setStatCollecting was called with false afterward, the report will be made for the collected observations. If the probes do not exist, i.e., setStatCollecting was never called for this object, an illegal state exception will be thrown.

Returns: a statistical report, represented as a string

Exceptions

IllegalStateException if no statistical probes exist

◆ setSimulator()

void setSimulator ( Simulator sim )

Sets the simulator associated with this list.

This list should be cleared after this method is called.

Parameters

sim	the simulator of this list

◆ setStatCollecting()

void setStatCollecting ( boolean b )

Starts or stops collecting statistics on this list.

If the statistical collection is turned ON, the method creates two statistical probes if they do not exist yet. The first one, of the class Accumulate, measures the evolution of the size of the list as a function of time. It can be accessed by the method statSize. The second one, of the class umontreal.ssj.stat.Tally and accessible via statSojourn, samples the sojourn times in the list of the objects removed during the observation period, i.e., between the last initialization time of this statistical probe and the current time. The method automatically calls initStat to initialize these two probes. When this method is used, it is normally invoked immediately after calling the constructor of the list.

Exceptions

IllegalStateException if the statistical collection is in the same state as the caller requires

◆ simulator()

Simulator simulator ( )

Returns the simulator associated with this list.

Returns: the simulator associated with this list

◆ statSize()

Accumulate statSize ( )

Returns the statistical probe on the evolution of the size of the list as a function of the simulation time.

This probe exists only if setStatCollecting(true) has been called for this list.

Returns: the statistical probe on the evolution of the size of the list

◆ statSojourn()

Tally statSojourn ( )

Returns the statistical probe on the sojourn times of the objects in the list.

This probe exists only if setStatCollecting(true) has been called for this list.

Returns: the statistical probe for the sojourn times in the list

The documentation for this class was generated from the following file:

ListWithStat.java

Classes

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ListWithStat() [1/8]

◆ ListWithStat() [2/8]

◆ ListWithStat() [3/8]

◆ ListWithStat() [4/8]

◆ ListWithStat() [5/8]

◆ ListWithStat() [6/8]

◆ ListWithStat() [7/8]

◆ ListWithStat() [8/8]

Member Function Documentation

◆ getInitTime()

◆ getName()

◆ getStatCollecting()

◆ initStat()

◆ report()

◆ setSimulator()

◆ setStatCollecting()

◆ simulator()

◆ statSize()

◆ statSojourn()