The package supports a variety of metrics that help to evaluate and compare estimated models.

Users can implement new metrics through defineInternalMetric() and defineExternalMetric(). Custom-defined metrics are accessible using the same by-name mechanism as the other metrics.

Supported internal metrics

Metric nameDescriptionFunction / Reference
AICAkaike information criterion. A goodness-of-fit estimator that adjusts for model complexity (i.e., the number of parameters). Only available for models that support the computation of the model log-likelihood through logLik.stats::AIC(), akaike1974newlatrend
APPA.meanMean of the average posterior probability of assignment (APPA) across clusters. A measure of the precision of the trajectory classifications. A score of 1 indicates perfect classification.APPA(), nagin2005grouplatrend
APPA.minLowest APPA among the clustersAPPA(), nagin2005grouplatrend
ASWAverage silhouette width based on the Euclidean distancerousseeuw1987silhouetteslatrend
BICBayesian information criterion. A goodness-of-fit estimator that corrects for the degrees of freedom (i.e., the number of parameters) and sample size. Only available for models that support the computation of the model log-likelihood through logLik.stats::BIC(), schwarz1978estimatinglatrend
CAICConsistent Akaike information criterionbozdogan1987modellatrend
CLCClassification likelihood criterionmclachlan2000finitelatrend
convergedWhether the model converged during estimationconverged()
devianceThe model deviancestats::deviance()
DunnThe Dunn indexdunn1974welllatrend
entropyEntropy of the posterior probabilities
estimationTimeThe time needed for fitting the modelestimationTime()
EDEuclidean distance between the cluster trajectories and the assigned observed trajectories
ED.fitEuclidean distance between the cluster trajectories and the assigned fitted trajectories
ICL.BICIntegrated classification likelihood (ICL) approximated using the BICbiernacki2000assessinglatrend
logLikModel log-likelihoodstats::logLik()
MAEMean absolute error of the fitted trajectories (assigned to the most likely respective cluster) to the observed trajectories
MahalanobisMahalanobis distance between the cluster trajectories and the assigned observed trajectoriesmahalanobis1936generalizedlatrend
MSEMean squared error of the fitted trajectories (assigned to the most likely respective cluster) to the observed trajectories
relativeEntropy, REA measure of the precision of the trajectory classification. A value of 1 indicates perfect classification, whereas a value of 0 indicates a non-informative uniform classification. It is the normalized version of entropy, scaled between [0, 1].ramaswamy1993empiricallatrend, muthen2004latentlatrend
RMSERoot mean squared error of the fitted trajectories (assigned to the most likely respective cluster) to the observed trajectories
RSSResidual sum of squares under most likely cluster allocation
scaledEntropySee relativeEntropy
sigmaThe residual standard deviationstats::sigma()
ssBICSample-size adjusted BICsclove1987applicationlatrend
SEDStandardized Euclidean distance between the cluster trajectories and the assigned observed trajectories
SED.fitThe cluster-weighted standardized Euclidean distance between the cluster trajectories and the assigned fitted trajectories
WMAEMAE weighted by cluster-assignment probability
WMSEMSE weighted by cluster-assignment probability
WRMSERMSE weighted by cluster-assignment probability
WRSSRSS weighted by cluster-assignment probability

Supported external metrics

Metric nameDescriptionFunction / Reference
adjustedRandAdjusted Rand index. Based on the Rand index, but adjusted for agreements occurring by chance. A score of 1 indicates a perfect agreement, whereas a score of 0 indicates an agreement no better than chance.mclustcomp::mclustcomp(), hubert1985comparinglatrend
CohensKappaCohen's kappa. A partitioning agreement metric correcting for random chance. A score of 1 indicates a perfect agreement, whereas a score of 0 indicates an agreement no better than chance.psych::cohen.kappa(), cohen1960coefficientlatrend
FF-scoremclustcomp::mclustcomp()
F1F1-score, also referred to as the Sørensen–Dice Coefficient, or Dice similarity coefficientmclustcomp::mclustcomp()
FolkesMallowsFowlkes-Mallows indexmclustcomp::mclustcomp()
HubertHubert indexclusterCrit::extCriteria()
JaccardJaccard indexmclustcomp::mclustcomp()
jointEntropyJoint entropy between model assignmentsmclustcomp::mclustcomp()
KulczynskiKulczynski indexclusterCrit::extCriteria()
MaximumMatchMaximum match measuremclustcomp::mclustcomp()
McNemarMcNemar statisticclusterCrit::extCriteria()
MeilaHeckermanMeila-Heckerman measuremclustcomp::mclustcomp()
MirkinMirkin metricmclustcomp::mclustcomp()
MIMutual informationmclustcomp::mclustcomp()
NMINormalized mutual informationigraph::compare()
NSJNormalized version of splitJoin. The proportion of edits relative to the maximum changes (twice the number of ids)
NVINormalized variation of informationmclustcomp::mclustcomp()
OverlapOverlap coefficient, also referred to as the Szymkiewicz–Simpson coefficientmclustcomp::mclustcomp() vijaymeena2016surveylatrend
PDPartition differencemclustcomp::mclustcomp()
PhiPhi coefficient.clusterCrit::extCriteria()
precisionprecisionclusterCrit::extCriteria()
RandRand indexmclustcomp::mclustcomp()
recallrecallclusterCrit::extCriteria()
RogersTanimotoRogers-Tanimoto dissimilarityclusterCrit::extCriteria()
RusselRaoRussell-Rao dissimilarityclusterCrit::extCriteria()
SMCSimple matching coefficientmclustcomp::mclustcomp()
splitJointotal split-join indexigraph::split_join_distance()
splitJoin.refSplit-join index of the first model to the second model. In other words, it is the edit-distance between the two partitionings.
SokalSneath1Type-1 Sokal-Sneath dissimilarityclusterCrit::extCriteria()
SokalSneath2Type-2 Sokal-Sneath dissimilarityclusterCrit::extCriteria()
VIVariation of informationmclustcomp::mclustcomp()
Wallace1Type-1 Wallace criterionmclustcomp::mclustcomp()
Wallace2Type-2 Wallace criterionmclustcomp::mclustcomp()
WMSSEWeighted minimum sum of squared errors between cluster trajectories
WMMSEWeighted minimum mean of squared errors between cluster trajectories
WMMAEWeighted minimum mean of absolute errors between cluster trajectories