OscatsAlgClassRates

OscatsAlgClassRates

Synopsis

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);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----OscatsAlgorithm
               +----OscatsAlgClassRates

Properties

  "by-pattern"               gboolean              : Read / Write / Construct Only
  "estKey"                   gchar*                : Read / Write / Construct Only
  "simKey"                   gchar*                : Read / Write / Construct Only

Description

Details

struct OscatsAlgClassRates

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.


OscatsAlgClassRatesForeachPatternFunc ()

void                (*OscatsAlgClassRatesForeachPatternFunc)
                                                        (GBitArray *pattern,
                                                         guint num,
                                                         guint correct,
                                                         gpointer user_data);


oscats_alg_class_rates_num_examinees ()

guint               oscats_alg_class_rates_num_examinees
                                                        (const OscatsAlgClassRates *alg_data);

alg_data :

the OscatsAlgClassRates data object

Returns :

the number of examinees tested

oscats_alg_class_rates_get_pattern_rate ()

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}.

alg_data :

the OscatsAlgClassRates data object

Returns :

the overall pattern classification success rate

oscats_alg_class_rates_get_attribute_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}.

alg_data :

the OscatsAlgClassRates data object

i :

the index of the attribute for which to query the rate

Returns :

the classification success rate for attribute i

oscats_alg_class_rates_get_misclassify_freq ()

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)}.

alg_data :

the OscatsAlgClassRates data object

num :

the number of misclassified attributes

Returns :

the rate of misclassifying num attributes

oscats_alg_class_rates_num_examinees_by_pattern ()

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.

alg_data :

the OscatsAlgClassRates data object

attr :

the attribute pattern to query

Returns :

the number of examinees with true attribute pattern attr.

oscats_alg_class_rates_get_rate_by_pattern ()

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.

alg_data :

the OscatsAlgClassRates data object

attr :

the attribute pattern to query

Returns :

the number of examinees with true attribute pattern attr.

oscats_alg_class_rates_foreach_pattern ()

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.

alg_data :

the OscatsAlgClassRates data object

func :

a function to call for each pattern

user_data :

user data to pass to the function

Property Details

The "by-pattern" property

  "by-pattern"               gboolean              : Read / Write / Construct Only

Track misclassification rate for each classification pattern observed.

Default value: FALSE


The "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


The "simKey" property

  "simKey"                   gchar*                : Read / Write / Construct Only

Which latent point to consider the "correct" or "true" value. A NULL value or empty string indicate the examinee's simulation default.

Default value: NULL