![]() |
![]() |
![]() |
liboscats Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
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
);
"covariates" OscatsCovariates* : Read / Write "id" gchar* : Read / Write / Construct Only
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.
void oscats_examinee_set_sim_key (OscatsExaminee *e
,GQuark name
);
name
may be 0 to refer to "simDefault".
|
an OscatsExaminee |
|
the GQuark name of the point for simulation |
GQuark oscats_examinee_get_sim_key (const OscatsExaminee *e
);
|
an OscatsExaminee |
Returns : |
the key for the OscatsPoint used by default for simulation |
void oscats_examinee_set_est_key (OscatsExaminee *e
,GQuark name
);
name
may be 0 to refer to "estDefault".
|
an OscatsExaminee |
|
the GQuark name of the point for estimation/item selection |
GQuark oscats_examinee_get_est_key (const OscatsExaminee *e
);
|
an OscatsExaminee |
Returns : |
the key for the OscatsPoint used by default for estimation and item selection |
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
.
|
an OscatsExaminee |
|
an OscatsPoint to use for simulation. [transfer full] |
OscatsPoint * oscats_examinee_get_sim_theta (const OscatsExaminee *e
);
|
an OscatsExaminee |
Returns : |
the OscatsPoint indicated to be used by
default for simulation, or NULL if no point has been assigned. [transfer none]
|
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
.
|
an OscatsExaminee |
|
an OscatsPoint to be used for estimation. [transfer full] |
OscatsPoint * oscats_examinee_get_est_theta (const OscatsExaminee *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]
|
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
);
Note, name
may not be 0.
|
an OscatsExaminee |
|
the key for the OscatsPoint to fetch |
Returns : |
the OscatsPoint for e named name . [transfer none]
|
OscatsPoint * oscats_examinee_get_theta_by_name (OscatsExaminee *e
,const gchar *name
);
Convenience wrapper for oscats_examinee_get_theta()
.
|
an OscatsExaminee |
|
the name of the OscatsPoint to fetch |
Returns : |
the OscatsPoint for e named name . [transfer none]
|
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.
|
an OscatsExaminee |
|
the latent space from which to generate the OscatsPoint. [transfer none] |
Returns : |
the new OscatsPoint. [transfer none] |
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.
|
an OscatsExaminee |
|
the latent space from which to generate the OscatsPoint. [transfer none] |
Returns : |
the new OscatsPoint. [transfer none] |
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.
|
an OscatsExaminee |
|
the GQuark name for the new OscatsPoint |
|
the latent space from which to generate the OscatsPoint. [transfer none] |
Returns : |
the new OscatsPoint. [transfer none] |
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.
|
an OscatsExaminee |
|
guess for test length |
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.
|
an OscatsExaminee |
|
the OscatsItem this examinee has taken. [transfer none] |
|
the examinee's response to the item |
guint oscats_examinee_num_items (const OscatsExaminee *e
);
|
an OscatsExaminee |
Returns : |
the number of items this examinee has been administered |
OscatsItem * oscats_examinee_get_item (OscatsExaminee *e
,guint i
);
|
an OscatsExaminee |
|
the item number |
Returns : |
the OscatsItem i for examinee e . [transfer none]
|
OscatsResponse oscats_examinee_get_resp (OscatsExaminee *e
,guint i
);
|
an OscatsExaminee |
|
the item number |
Returns : |
the response to item i for examineee e
|
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.
|
an OscatsExaminee |
|
an OscatsPoint |
|
the model name to use |
Returns : |
the log-likelihood |
"covariates"
property"covariates" OscatsCovariates* : Read / Write
A set of covariates for the examinee.
"id"
property"id" gchar* : Read / Write / Construct Only
A string identifier for the examinee.
Default value: NULL