C:/programs/etirm/src/swig_etirm.h File Reference

Declarations of functions and classes to generate scripting language wrapper functions for ETIRM using SWIG. More...

#include "swig_etirm_types.h"
#include "etirm/EStepDiscrete.h"
#include "Uncmin.h"
#include <vector>
#include <string>
#include <boost/random/uniform_01.hpp>

Include dependency graph for swig_etirm.h:

Go to the source code of this file.

Namespaces

namespace  etirm

Classes

class  etirm::ItemRespCounts
 Class to hold counts of number of examinees who responded in each response category of an item. More...
class  etirm::SwigEtirmRun
 Class holding information used for one modeling problem. More...
class  etirm::estep
 SWIG wrapper for EStepDiscrete object. More...

Typedefs

typedef RealVector etirm::double_vector
 Vector type for double precision values.
typedef SCPPNT::Vector< int > etirm::int_vector
 Vector type for integer values.
typedef std::vector< item_type * > etirm::ItemVector
 Vector type for item pointers.
typedef EStepDiscrete
< examinee_type, item_type,
ItemVector::iterator,
lvdist_type
etirm::estep_type
 Class used in E-step calculation.
typedef std::vector< Uncmin
< RealVector, RealMatrix,
item_type > * > 
etirm::UncminVector
 Container to hold Uncmin optimization objects.
typedef std::vector
< examinee_type * > 
etirm::ExamineeVector
 Container holding examinee object pointers.
typedef std::vector
< ItemRespCounts * > 
etirm::ItemStatsVector
 Container holding pointers to objects containing item statistics for each item.

Functions

void etirm::CheckRunInit ()
 Check that new_etirm has been called.
void etirm::CheckItemParam (item_type *item, int index, const char *funcname)
 Tests whether item parameter index is valid for the item.
ItemParamPrior * etirm::CreatePrior (const std::string &pstr, const double_vector &priorparam, const char *funcname)
 Create a prior distribution object and return a pointer to it.
template<class V>
etirm::ItemSubset (int_vector *itemnums, V &all, const char *funcname)
 Creates a container holding the elements corresponding to a subset of items.
char etirm::Resp2Char (Response r, const item_type *item)
 Converts a response for an item into a character, where '0' represents the first response, '1' represents the second response, etc.
void etirm::set_missing_resp (char nr)
 Assigns missing response code to identify examinees who did not respond to an item.
int etirm::num_items ()
 Returns the number of items.
int etirm::num_latent_dist_points ()
 Returns number of categories of the discrete theta distribution.
int etirm::num_groups ()
 Returns number of examinee groups.
int etirm::num_examinees ()
 Returns number of examinees.
const char * etirm::item_get_model (int itemno)
 Returns the name of model used for an item.
void etirm::item_set_param (int paramno, int itemno, double paramvalue)
 Assigns a value to one item parameter of an item.
void etirm::item_set_params (int itemno, double_vector *params)
 Assigns values to all item parameters of an item.
void etirm::item_set_all_params (int itemno, double_vector *params)
 Assigns values to all fixed and estimated item parameters of an item.
double etirm::item_get_param (int paramno, int itemno)
 Returns value of one item parameter of an item.
double_vector * etirm::item_get_params (int itemno)
 Returns vector of all estimated item parameters values of an item.
double_vector * etirm::item_get_all_params (int itemno)
 Returns vector of all fixed and estimated item parameters values of an item.
int etirm::item_num_params (int itemno)
 Returns the number of parameters of an item.
int etirm::item_num_resp_cat (int itemno)
 Returns the number of response categories of an item.
void etirm::item_set_prior (int paramno, int itemno, char *priortype, double_vector *dlist)
 Assigns prior distribution parameters for one item parameter.
const char * etirm::item_get_prior_type (int paramno, int itemno)
 Returns type of prior distribution ("normal", "lognormal", "beta", "none") for one item parameter.
double_vector * etirm::item_get_prior_param (int paramno, int itemno)
 Returns vector of prior distribution parameters for one item parameter.
double etirm::item_prob_resp (int itemno, int response, double theta)
 Returns the probability that an examinee with a particular theta value will give a particular response to a particular item.
int etirm::item_scale_params (int itemno, double slope, double intercept, bool ignorePriorError)
 Transforms the parameter estimates of an item to a different latent variable scale.
double_vector * etirm::item_cat_counts (int itemno, int group)
 Returns vector of response counts in each response category of an item.
double etirm::item_resp_count (int itemno, int group)
 Returns the number of examinees responding to an item.
double_vector * etirm::test_characteristic_curve (double_vector *thetas, int_vector *ilist2)
 Returns a vector of values of the test characteristic curve, given a vector of theta values and a selection of items.
void etirm::dist_set_point (int index, double p, int group)
 Assigns a quadrature point value to one discrete category of the discrete latent variable distribution.
void etirm::dist_set_points (double_vector *dlist, int group)
 Assigns quadrature point values to each discrete category of the discrete latent variable distribution.
double etirm::dist_get_point (int index, int group)
 Returns the quadrature point value of one discrete category of the discrete latent variable distribution.
double_vector * etirm::dist_get_points (int group)
 Returns vector of quadrature point values of the discrete latent variable distribution.
void etirm::dist_set_prob (int index, double w, int group)
 Assigns the quadrature weight to one discrete category of the discrete latent variable distribution.
void etirm::dist_set_probs (double_vector *dlist, int group)
 Assigns quadrature weights to the quadrature points of the latent variable distribution.
double etirm::dist_get_prob (int index, int group)
 Returns the quadrature weight of one discrete category of the latent variable distribution for one group of examinees.
double_vector * etirm::dist_get_probs (int group)
 Returns vector of quadrature weights of the latent variable distribution for one group of examinees.
void etirm::dist_transform (double slope, double intercept)
 Transforms the quadrature points of latent variable distribution to a new scale.
double_vector * etirm::dist_scale (double mean, double sd, int group)
 Scales to the quadrature points of latent variable distribution to yield a specfic mean and standard deviation in one group.
double_vector * etirm::dist_mean_sd (int group)
 Returns a vector with the mean and standard deviation of the latent variable distribution for a selected group of examinees.
int etirm::dist_unique_points ()
 Returns 1 if unique sets of quadrature points are used for two or more groups of examinees, or returns 0 otherwise.
double_vector * etirm::normal_dist_prob (int npoints, double minPoint, double maxPoint, double mean, double sd)
 Returns a vector of probabilities for a discrete distribution to approximate a normal distribution over a set of equally spaced points.
double_vector * etirm::normal_dist_points (int npoints, double minPoint, double maxPoint, double mean, double sd)
 Returns a vector of quadrature points for a discrete distribution over a set of equally-spaced points.
int etirm::mstep_items (bool ignore_max_iter, int_vector *itemno)
 CalculateS M-step for a set of items.
double etirm::mstep_max_diff ()
 Returns the maximum relative difference between parameter estimates in two successive EM iterations, as computed in last call to mstep_items.
int etirm::mstep_message (int itemno)
 Returns message from M-step minimization for one item.
void etirm::mstep_max_iter (int itemno, int maxiter)
 Assigns the maximum number of iterations permitted with optimization procedure in mstep_items for one item.
double etirm::mstep_dist (estep *e, int group)
 Executes M-step for the latent distribution in one group.
int etirm::add_examinee (int_vector *responses, int group, double count)
 Add an examinee objec to the end of the examinee vector.
int_vector * etirm::examinee_responses (int examineeno)
 Returns pointer to an integer vector of examinee item responses to all items.
const char * etirm::examinee_response_str (int examineeno)
 Returns string containing (character) examinee responses to all items.
int etirm::examinee_get_group (int examineeno)
 Return the number of the group the examinee belongs to.
void etirm::examinee_set_group (int examineeno, int group)
 Assigns which group the examinee belongs to.
void etirm::examinee_set_count (int examineeno, double count)
 Assigns the count (or weight) of the examinee.
double etirm::examinee_get_count (int examineeno)
 Returns the count (or weight) of the examinee.
double etirm::examinees_count (int group)
 Returns total examinee count in an examinee group (1, 2, ...), or across all groups.
void etirm::examinee_set_posterior (int examineeno, double_vector *posterior)
 Assigns posterior distribution of an examinee.
double_vector * etirm::examinee_get_posterior (int examineeno)
 Returns pointer to vector of the posterior distribution of an examinee.
double etirm::examinee_posterior_mean (int examineeno)
 Returns means of an examinee's posterior distribution.
double etirm::examinee_theta_MLE (int examineeno, double minTheta, double maxTheta, double precision, int_vector *itemno5)
 Returns an examinee's maximum likelihood estimate of theta.
void etirm::bootstrap_seed (unsigned long seed)
 Assigns seed of random number generator used for bootstrap samples.
void etirm::bootstrap_sample ()
 Generate bootstrap sample of examinees.
void etirm::simulate_seed (unsigned long seed)
 Assigns seed of random number generator used for simulating item responses.
int_vector * etirm::simulate_responses (double theta, int_vector *itemno2)
 Simulates item responses (integers) for a specific value of the latent variable.
const char * etirm::simulate_response_str (double theta, int_vector *itemno2)
 Simulates item responses (characters) for a specific value of the latent variable.
int_vector * etirm::get_responses (char *line, int_vector *offset, int_vector *len)
 Reads item responses from an input record.
int_vector * etirm::get_responses_missing (char *line, int_vector *offset, int_vector *len, int_vector *items)
 Read item responses from a string where responses to only some items are present. The responses to the remaining items are assumed to be missing.


Detailed Description

Declarations of functions and classes to generate scripting language wrapper functions for ETIRM using SWIG.

See swig_etirm.cpp for documentation.

Estimation Toolkit for Item Response Models (ETIRM) http://www.smallwaters.com/software/cpp/etirm.html

Author(s): Werner Wothke, maintenance (http://www.smallwaters.com) Brad Hanson (http://www.b-a-h.com/) See the file LICENSE for information on usage and redistribution.

Copyright (C) 2008, Werner Wothke Copyright (c) 2000-2002, Bradley A. Hanson

Definition in file swig_etirm.h.


Generated on Sat Mar 1 21:40:32 2008 for ETIRM by  doxygen 1.5.4