![]() |
![]() |
![]() |
liboscats Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
struct OscatsAlgClassRates; void (*OscatsAlgClassRatesForeachPatternFunc) (GBitArray *pattern
,guint num
,guint correct
,gpointer user_data
); guint oscats_alg_class_rates_num_examinees (const OscatsAlgClassRates *alg_data
); gdouble oscats_alg_class_rates_get_pattern_rate (const OscatsAlgClassRates *alg_data
); gdouble oscats_alg_class_rates_get_attribute_rate (const OscatsAlgClassRates *alg_data
,guint i
); gdouble oscats_alg_class_rates_get_misclassify_freq (const OscatsAlgClassRates *alg_data
,guint num
); guint oscats_alg_class_rates_num_examinees_by_pattern (const OscatsAlgClassRates *alg_data
,const OscatsPoint *attr
); gdouble oscats_alg_class_rates_get_rate_by_pattern (const OscatsAlgClassRates *alg_data
,const OscatsPoint *attr
); void oscats_alg_class_rates_foreach_pattern (OscatsAlgClassRates *alg_data
,OscatsAlgClassRatesForeachPatternFunc func
,gpointer user_data
);
"by-pattern" gboolean : Read / Write / Construct Only "estKey" gchar* : Read / Write / Construct Only "simKey" gchar* : Read / Write / Construct Only
struct OscatsAlgClassRates;
Statistics algorithm ("finalize"). Tracks the correct classification rates:
Correct classification by attribute: r_k = N^-1 sum_i I_{alpha.hat_ik = alpha_ik}.
Overall correct pattern classification: r = N^-1 sum_i I_{alpha.hat_i = alpha_i}.
Correct classification by pattern (if "by-pattern"): r_alpha = sum_i I_{alpha.hat_i = alpha_i} / sum_i I_{alpha_i = alpha}.
Frequency of misclassifications: f_j = N^-1 sum_i I_{j = sum_k abs(alpha.hat_ik - alpha_ik)}.
If the test space includes non-binary dimensions, they are silently ignored.
void (*OscatsAlgClassRatesForeachPatternFunc) (GBitArray *pattern
,guint num
,guint correct
,gpointer user_data
);
guint oscats_alg_class_rates_num_examinees
(const OscatsAlgClassRates *alg_data
);
|
the OscatsAlgClassRates data object |
Returns : |
the number of examinees tested |
gdouble oscats_alg_class_rates_get_pattern_rate
(const OscatsAlgClassRates *alg_data
);
The overall pattern classification success rate is: r = N^-1 sum_i I_{alpha.hat_i = alpha_i}.
|
the OscatsAlgClassRates data object |
Returns : |
the overall pattern classification success rate |
gdouble oscats_alg_class_rates_get_attribute_rate (const OscatsAlgClassRates *alg_data
,guint i
);
The attribute classification success rate is: r_k = N^-1 sum_i I_{alpha.hat_ik = alpha_ik}.
|
the OscatsAlgClassRates data object |
|
the index of the attribute for which to query the rate |
Returns : |
the classification success rate for attribute i
|
gdouble oscats_alg_class_rates_get_misclassify_freq (const OscatsAlgClassRates *alg_data
,guint num
);
The frequency of having num
misclassified attributes is:
f_j = N^-1 sum_i I_{j = sum_k abs(alpha.hat_ik - alpha_ik)}.
|
the OscatsAlgClassRates data object |
|
the number of misclassified attributes |
Returns : |
the rate of misclassifying num attributes |
guint oscats_alg_class_rates_num_examinees_by_pattern (const OscatsAlgClassRates *alg_data
,const OscatsPoint *attr
);
Rates for individual patterns are tabulated only if
"by-pattern" is set to TRUE
at registration.
|
the OscatsAlgClassRates data object |
|
the attribute pattern to query |
Returns : |
the number of examinees with true attribute pattern attr . |
gdouble oscats_alg_class_rates_get_rate_by_pattern (const OscatsAlgClassRates *alg_data
,const OscatsPoint *attr
);
The correct classification rate for a given pattern is: r_alpha = sum_i I_{alpha.hat_i = alpha_i} / sum_i I_{alpha_i = alpha}.
Rates for individual patterns are tabulated only if
"by-pattern" is set to TRUE
at registration.
|
the OscatsAlgClassRates data object |
|
the attribute pattern to query |
Returns : |
the number of examinees with true attribute pattern attr . |
void oscats_alg_class_rates_foreach_pattern (OscatsAlgClassRates *alg_data
,OscatsAlgClassRatesForeachPatternFunc func
,gpointer user_data
);
If "by-pattern" is TRUE
for alg_data
, calls func
on
each pattern observed in GBitArray serialized order. The func
takes
four parameters: a pointer to the GBitArray pattern, the number of times
the pattern was observed, the number of times the pattern was correctly
classified, and user_data
.
|
the OscatsAlgClassRates data object |
|
a function to call for each pattern |
|
user data to pass to the function |
"by-pattern"
property"by-pattern" gboolean : Read / Write / Construct Only
Track misclassification rate for each classification pattern observed.
Default value: FALSE
"estKey"
property"estKey" gchar* : Read / Write / Construct Only
Which latent point holds the estimated classification. A NULL
value or
empty string indicates the examinee's estimation default.
Default value: NULL