OscatsExaminee

OscatsExaminee — Examinee Class

Synopsis

struct              OscatsExaminee;
void                oscats_examinee_set_sim_key         (OscatsExaminee *e,
                                                         GQuark name);
GQuark              oscats_examinee_get_sim_key         (const OscatsExaminee *e);
void                oscats_examinee_set_est_key         (OscatsExaminee *e,
                                                         GQuark name);
GQuark              oscats_examinee_get_est_key         (const OscatsExaminee *e);
void                oscats_examinee_set_sim_theta       (OscatsExaminee *e,
                                                         OscatsPoint *theta);
OscatsPoint *       oscats_examinee_get_sim_theta       (const OscatsExaminee *e);
void                oscats_examinee_set_est_theta       (OscatsExaminee *e,
                                                         OscatsPoint *theta);
OscatsPoint *       oscats_examinee_get_est_theta       (const OscatsExaminee *e);
void                oscats_examinee_set_theta           (OscatsExaminee *e,
                                                         GQuark name,
                                                         OscatsPoint *theta);
void                oscats_examinee_set_theta_by_name   (OscatsExaminee *e,
                                                         const gchar *name,
                                                         OscatsPoint *theta);
OscatsPoint *       oscats_examinee_get_theta           (OscatsExaminee *e,
                                                         GQuark name);
OscatsPoint *       oscats_examinee_get_theta_by_name   (OscatsExaminee *e,
                                                         const gchar *name);
OscatsPoint *       oscats_examinee_init_sim_theta      (OscatsExaminee *e,
                                                         OscatsSpace *space);
OscatsPoint *       oscats_examinee_init_est_theta      (OscatsExaminee *e,
                                                         OscatsSpace *space);
OscatsPoint *       oscats_examinee_init_theta          (OscatsExaminee *e,
                                                         GQuark name,
                                                         OscatsSpace *space);
void                oscats_examinee_prep                (OscatsExaminee *e,
                                                         guint length_hint);
void                oscats_examinee_add_item            (OscatsExaminee *e,
                                                         OscatsItem *item,
                                                         OscatsResponse resp);
guint               oscats_examinee_num_items           (const OscatsExaminee *e);
OscatsItem *        oscats_examinee_get_item            (OscatsExaminee *e,
                                                         guint i);
OscatsResponse      oscats_examinee_get_resp            (OscatsExaminee *e,
                                                         guint i);
gdouble             oscats_examinee_logLik              (const OscatsExaminee *e,
                                                         const OscatsPoint *theta,
                                                         GQuark modelKey);

Object Hierarchy

  GObject
   +----OscatsExaminee

Properties

  "covariates"               OscatsCovariates*     : Read / Write
  "id"                       gchar*                : Read / Write / Construct Only

Description

An OscatsExaminee represents a single examinee taking a single test. That is, a given OscatsExaminee may be administered only one test at a time.

The examinee may be associated with several points in latent space. (Generally, all points will be from the same latent space, but complex simulations may involve a collection of algorithms that operate in several different spaces simulatneously.) Each point in latent space is associated with a name or key.

Each examinee has two special keys: one used as the default for simulation and one used as the default for estimation/item selection. If these keys are not specified explicitly, they are taken as "simDefault" and "estDefault", respectively. Simulation, estimation, and item selection algorithms are not required to use the default keys. Refer to the documentation for particular algorithms for details on which keys are used.

Details

struct OscatsExaminee

struct OscatsExaminee;


oscats_examinee_set_sim_key ()

void                oscats_examinee_set_sim_key         (OscatsExaminee *e,
                                                         GQuark name);

name may be 0 to refer to "simDefault".

e :

an OscatsExaminee

name :

the GQuark name of the point for simulation

oscats_examinee_get_sim_key ()

GQuark              oscats_examinee_get_sim_key         (const OscatsExaminee *e);

e :

an OscatsExaminee

Returns :

the key for the OscatsPoint used by default for simulation

oscats_examinee_set_est_key ()

void                oscats_examinee_set_est_key         (OscatsExaminee *e,
                                                         GQuark name);

name may be 0 to refer to "estDefault".

e :

an OscatsExaminee

name :

the GQuark name of the point for estimation/item selection

oscats_examinee_get_est_key ()

GQuark              oscats_examinee_get_est_key         (const OscatsExaminee *e);

e :

an OscatsExaminee

Returns :

the key for the OscatsPoint used by default for estimation and item selection

oscats_examinee_set_sim_theta ()

void                oscats_examinee_set_sim_theta       (OscatsExaminee *e,
                                                         OscatsPoint *theta);

Sets theta as the point referred to by the simulation key for e. Note that e takes ownership of theta.

e :

an OscatsExaminee

theta :

an OscatsPoint to use for simulation. [transfer full]

oscats_examinee_get_sim_theta ()

OscatsPoint *       oscats_examinee_get_sim_theta       (const OscatsExaminee *e);

e :

an OscatsExaminee

Returns :

the OscatsPoint indicated to be used by default for simulation, or NULL if no point has been assigned. [transfer none]

oscats_examinee_set_est_theta ()

void                oscats_examinee_set_est_theta       (OscatsExaminee *e,
                                                         OscatsPoint *theta);

Set theta as the point referred to by the estimation key for e. Note that e takes ownership of theta.

e :

an OscatsExaminee

theta :

an OscatsPoint to be used for estimation. [transfer full]

oscats_examinee_get_est_theta ()

OscatsPoint *       oscats_examinee_get_est_theta       (const OscatsExaminee *e);

e :

an OscatsExaminee

Returns :

the OscatsPoint indicated to be used by default for estimation and item selection, or NULL if no point has been assigned. [transfer none]

oscats_examinee_set_theta ()

void                oscats_examinee_set_theta           (OscatsExaminee *e,
                                                         GQuark name,
                                                         OscatsPoint *theta);


oscats_examinee_set_theta_by_name ()

void                oscats_examinee_set_theta_by_name   (OscatsExaminee *e,
                                                         const gchar *name,
                                                         OscatsPoint *theta);


oscats_examinee_get_theta ()

OscatsPoint *       oscats_examinee_get_theta           (OscatsExaminee *e,
                                                         GQuark name);

Note, name may not be 0.

e :

an OscatsExaminee

name :

the key for the OscatsPoint to fetch

Returns :

the OscatsPoint for e named name. [transfer none]

oscats_examinee_get_theta_by_name ()

OscatsPoint *       oscats_examinee_get_theta_by_name   (OscatsExaminee *e,
                                                         const gchar *name);

Convenience wrapper for oscats_examinee_get_theta().

e :

an OscatsExaminee

name :

the name of the OscatsPoint to fetch

Returns :

the OscatsPoint for e named name. [transfer none]

oscats_examinee_init_sim_theta ()

OscatsPoint *       oscats_examinee_init_sim_theta      (OscatsExaminee *e,
                                                         OscatsSpace *space);

Generate a new OscatsPoint from space for e to use in simulation. The point is stored under the current simulation key.

e :

an OscatsExaminee

space :

the latent space from which to generate the OscatsPoint. [transfer none]

Returns :

the new OscatsPoint. [transfer none]

oscats_examinee_init_est_theta ()

OscatsPoint *       oscats_examinee_init_est_theta      (OscatsExaminee *e,
                                                         OscatsSpace *space);

Generate a new OscatsPoint from space for e to use in estimation and item selection. The point is stored under the current estimation key.

e :

an OscatsExaminee

space :

the latent space from which to generate the OscatsPoint. [transfer none]

Returns :

the new OscatsPoint. [transfer none]

oscats_examinee_init_theta ()

OscatsPoint *       oscats_examinee_init_theta          (OscatsExaminee *e,
                                                         GQuark name,
                                                         OscatsSpace *space);

Generate a new OscatsPoint from space for e under the key name. Any previous OscatsPoint under name in e is replaced. Note: name may not be 0.

e :

an OscatsExaminee

name :

the GQuark name for the new OscatsPoint

space :

the latent space from which to generate the OscatsPoint. [transfer none]

Returns :

the new OscatsPoint. [transfer none]

oscats_examinee_prep ()

void                oscats_examinee_prep                (OscatsExaminee *e,
                                                         guint length_hint);

Prepares the examinee for the CAT by reseting the item/resp arrays. If the arrays do not already exist, they are preallocated to hold length_hint elements (recommended), the expected length of the test.

e :

an OscatsExaminee

length_hint :

guess for test length

oscats_examinee_add_item ()

void                oscats_examinee_add_item            (OscatsExaminee *e,
                                                         OscatsItem *item,
                                                         OscatsResponse resp);

Adds the (item, resp) pair to the list of items this examinee has been administered. The reference count for item is increased.

e :

an OscatsExaminee

item :

the OscatsItem this examinee has taken. [transfer none]

resp :

the examinee's response to the item

oscats_examinee_num_items ()

guint               oscats_examinee_num_items           (const OscatsExaminee *e);

e :

an OscatsExaminee

Returns :

the number of items this examinee has been administered

oscats_examinee_get_item ()

OscatsItem *        oscats_examinee_get_item            (OscatsExaminee *e,
                                                         guint i);

e :

an OscatsExaminee

i :

the item number

Returns :

the OscatsItem i for examinee e. [transfer none]

oscats_examinee_get_resp ()

OscatsResponse      oscats_examinee_get_resp            (OscatsExaminee *e,
                                                         guint i);

e :

an OscatsExaminee

i :

the item number

Returns :

the response to item i for examineee e

oscats_examinee_logLik ()

gdouble             oscats_examinee_logLik              (const OscatsExaminee *e,
                                                         const OscatsPoint *theta,
                                                         GQuark modelKey);

Computes the log-likelihood of the responses from e, given latent ability theta. The default model is used if model == 0.

e :

an OscatsExaminee

theta :

an OscatsPoint

modelKey :

the model name to use

Returns :

the log-likelihood

Property Details

The "covariates" property

  "covariates"               OscatsCovariates*     : Read / Write

A set of covariates for the examinee.


The "id" property

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

A string identifier for the examinee.

Default value: NULL