One ldes-result document, parsed. More...

#include <line/solvers/wrappers/ldes/ldes_options.h>

Collaboration diagram for line::ldes::LdesResult:

Classes
struct	BusyPeriodTarget
	One measured busy period target (–busyperiod): a station, a station-class pair, or a declared station set. More...

Public Attributes
std::size_t	nstations = 0
std::size_t	nclasses = 0
std::size_t	nchains = 0
std::size_t	nregions = 0
std::vector< std::string >	station_names
std::vector< std::string >	class_names
Matrix< double >	QN
Matrix< double >	UN
Matrix< double >	RN
Matrix< double >	TN
Matrix< double >	AN
Matrix< double >	WN
Matrix< double >	CN
Matrix< double >	XN
	(1 x nclasses), per-class visits and system tput
Matrix< double >	DropRateJoin
	quorum-Join sibling drops, Join rows only
Matrix< double >	QNCI
Matrix< double >	UNCI
Matrix< double >	RNCI
Matrix< double >	TNCI
Matrix< double >	ANCI
Matrix< double >	WNCI
bool	has_run_length_plan = false
	options.config.runLengthPlan: the run length the caller would need for the precision they asked for, from the half-widths above.
sim::RunLengthPlan< double >	run_length_plan
Matrix< double >	QNRelPrec
Matrix< double >	UNRelPrec
Matrix< double >	RNRelPrec
Matrix< double >	TNRelPrec
Matrix< double >	QNSamples
Matrix< double >	UNSamples
Matrix< double >	RNSamples
Matrix< double >	TNSamples
Matrix< double >	QNfcr
Matrix< double >	UNfcr
Matrix< double >	RNfcr
Matrix< double >	TNfcr
Matrix< double >	ANfcr
Matrix< double >	WNfcr
Matrix< double >	WeightNfcr
Matrix< double >	MemOccNfcr
Matrix< double >	DropRateNfcr
Matrix< double >	renegedCustomers
Matrix< double >	avgRenegingWaitTime
Matrix< double >	renegingRate
Matrix< double >	balkedCustomers
Matrix< double >	balkingProbability
Matrix< double >	retriedCustomers
Matrix< double >	retrialDropped
Matrix< double >	avgOrbitSize
std::map< std::string, LdesCacheMetrics >	cache_metrics
	Per-cache metrics, keyed by the Cache NODE name.
Matrix< double >	histogram_space
	The exact joint-state residence-time histogram (–export-histogram).
Matrix< double >	histogram_time
Matrix< double >	traj_space
Matrix< double >	traj_time
std::vector< BusyPeriodTarget >	busy_periods
std::vector< double >	t
	the time vector, empty on a steady-state run
std::vector< std::vector< Matrix< double > > >	QNt
	[STATION][class] -> (npoints x 2), columns [value, time].
std::vector< std::vector< Matrix< double > > >	UNt
std::vector< std::vector< Matrix< double > > >	TNt
std::vector< std::vector< std::vector< double > > >	respTimeSamples
	[station][class] -> the per-job response times the engine recorded.
std::string	method = "default"
double	runtime = 0.0
bool	converged = false
std::string	stopping_reason
	convergence \| max_events \| max_sim_events \| max_time.
long	convergence_batches = 0
long long	total_simulated_events = 0
bool	timed_out = false
	True when the HARD subprocess bound fired, not the cooperative one.
std::string	engine
	"native" or "jar": which runner produced these numbers.

Detailed Description

One ldes-result document, parsed.

A metric the engine did not report stays EMPTY rather than becoming a matrix of zeros: zero is a measurement and absence is not, and the tables below distinguish them.

Definition at line 192 of file ldes_options.h.

Member Data Documentation

◆ AN

Matrix<double> line::ldes::LdesResult::AN

Definition at line 202 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ ANCI

Matrix<double> line::ldes::LdesResult::ANCI

Definition at line 207 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ ANfcr

Matrix<double> line::ldes::LdesResult::ANfcr

Definition at line 219 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ avgOrbitSize

Matrix<double> line::ldes::LdesResult::avgOrbitSize

Definition at line 225 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ avgRenegingWaitTime

Matrix<double> line::ldes::LdesResult::avgRenegingWaitTime

Definition at line 223 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ balkedCustomers

Matrix<double> line::ldes::LdesResult::balkedCustomers

Definition at line 224 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ balkingProbability

Matrix<double> line::ldes::LdesResult::balkingProbability

Definition at line 224 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ busy_periods

std::vector<BusyPeriodTarget> line::ldes::LdesResult::busy_periods

Definition at line 257 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ cache_metrics

std::map<std::string, LdesCacheMetrics> line::ldes::LdesResult::cache_metrics

Per-cache metrics, keyed by the Cache NODE name.

Definition at line 228 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ class_names

std::vector<std::string> line::ldes::LdesResult::class_names

Definition at line 199 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ CN

Matrix<double> line::ldes::LdesResult::CN

Definition at line 203 of file ldes_options.h.

Referenced by line::ldes::ldes_engine_solve(), and line::ldes::parse_ldes_result().

◆ converged

bool line::ldes::LdesResult::converged = false

Definition at line 285 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ convergence_batches

long line::ldes::LdesResult::convergence_batches = 0

Definition at line 288 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ DropRateJoin

Matrix<double> line::ldes::LdesResult::DropRateJoin

quorum-Join sibling drops, Join rows only

Definition at line 204 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ DropRateNfcr

Matrix<double> line::ldes::LdesResult::DropRateNfcr

Definition at line 220 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ engine

std::string line::ldes::LdesResult::engine

"native" or "jar": which runner produced these numbers.

Definition at line 293 of file ldes_options.h.

Referenced by line::ldes::solver_ldes_text().

◆ has_run_length_plan

bool line::ldes::LdesResult::has_run_length_plan = false

options.config.runLengthPlan: the run length the caller would need for the precision they asked for, from the half-widths above.

Empty unless LdesOptions::run_length_plan_precision is positive.

Definition at line 213 of file ldes_options.h.

Referenced by line::ldes::engine::batch_means_ci().

◆ histogram_space

Matrix<double> line::ldes::LdesResult::histogram_space

The exact joint-state residence-time histogram (–export-histogram).

histogram_space is (nstates x nstations*nclasses) in the aggregate layout ctmc_state_space_aggr builds and histogram_time the residence time of each row, so E[r] = sum_s (t_s / sum t) r(state_s) is exact also for a NONLINEAR reward. traj_* is the same encoding along the sampled path, downsampled, and is what the transient reward reads.

Definition at line 239 of file ldes_options.h.

Referenced by line::ldes::ldes_prob_from_histogram(), and line::ldes::parse_ldes_result().

◆ histogram_time

Matrix<double> line::ldes::LdesResult::histogram_time

Definition at line 240 of file ldes_options.h.

Referenced by line::ldes::ldes_prob_from_histogram(), and line::ldes::parse_ldes_result().

◆ MemOccNfcr

Matrix<double> line::ldes::LdesResult::MemOccNfcr

Definition at line 220 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ method

std::string line::ldes::LdesResult::method = "default"

Definition at line 283 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ nchains

std::size_t line::ldes::LdesResult::nchains = 0

Definition at line 196 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ nclasses

std::size_t line::ldes::LdesResult::nclasses = 0

Definition at line 195 of file ldes_options.h.

Referenced by line::ldes::ldes_engine_solve(), and line::ldes::parse_ldes_result().

◆ nregions

std::size_t line::ldes::LdesResult::nregions = 0

Definition at line 197 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ nstations

std::size_t line::ldes::LdesResult::nstations = 0

Definition at line 194 of file ldes_options.h.

Referenced by line::ldes::ldes_engine_solve(), and line::ldes::parse_ldes_result().

◆ QN

Matrix<double> line::ldes::LdesResult::QN

Definition at line 202 of file ldes_options.h.

Referenced by line::ldes::engine::batch_means_ci(), line::ldes::ldes_engine_solve(), and line::ldes::parse_ldes_result().

◆ QNCI

Matrix<double> line::ldes::LdesResult::QNCI

Definition at line 207 of file ldes_options.h.

Referenced by line::ldes::engine::batch_means_ci(), line::ldes::ldes_engine_solve(), and line::ldes::parse_ldes_result().

◆ QNfcr

Matrix<double> line::ldes::LdesResult::QNfcr

Definition at line 219 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ QNRelPrec

Matrix<double> line::ldes::LdesResult::QNRelPrec

Definition at line 215 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ QNSamples

Matrix<double> line::ldes::LdesResult::QNSamples

Definition at line 216 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().

◆ QNt

std::vector<std::vector<Matrix<double> > > line::ldes::LdesResult::QNt

[STATION][class] -> (npoints x 2), columns [value, time].

THE OUTER INDEX IS THE STATION, not the stateful node: the engine builds these as result.QNt = new Matrix[numStations][numClasses] and fills them at serviceStation (Solver_ssj.getTransientLDESResultBody). The two index spaces coincide only when every stateful node is a station, so on a model holding a Router, a Cache or a Place the stateful index selects another station's series or runs off the end. That is the defect recorded as BUG-95 and fixed in the MATLAB and Python clients.

THE VALUES ARE INTERVAL TIME-AVERAGES, not the integer states the path visits: each entry is (integral of the queue length over the sampling interval) / (interval length). They are a trajectory of MEANS, so they must not be compared against a state to estimate a probability – use histogram_space / histogram_time for that.

Definition at line 278 of file ldes_options.h.

Referenced by line::ldes::parse_ldes_result().