A Python package for computerized adaptive testing (CAT) simulations. It provides multiple methods for:
- test initialization (selecting the initial ability of the examinees)
- item selection
- ability estimation
- test stopping
These methods can either be used in a standalone fashion to power other software or be used with catsim to simulate the application of computerized adaptive tests, given a sample of examinees, represented by their ability levels, and an item bank, represented by their parameters according to some logistic Item Response Theory model.
Installation
Install it using pip install catsim.
Basic Usage
There is a Colab Notebook teaching the basics of catsim!
- Have an item matrix;
- Have a sample of examinee proficiencies, or a number of examinees to be generated;
- Create an initializer, an item selector, a ability estimator and a stopping criterion;
- Pass them to a simulator and start the simulation.
- Access the simulator's properties to get specifics of the results;
- Plot your results.
from catsim.initialization import RandomInitializer
from catsim.selection import MaxInfoSelector
from catsim.estimation import NumericalSearchEstimator
from catsim.stopping import MinErrorStopper
from catsim.simulation import Simulator
from catsim import ItemBank
initializer = RandomInitializer()
selector = MaxInfoSelector()
estimator = NumericalSearchEstimator()
stopper = MinErrorStopper(0.4, max_items=20)
Simulator(ItemBank.generate_item_bank(100), 10).simulate(initializer, selector, estimator, stopper)
Dependencies
All dependencies are listed on setup.py and should be installed automatically.
To run the tests, you will need to install the testing requirements with pip install catsim[testing].
To generate the documentation, install the necessary dependencies with pip install catsim[docs].
To ensure code is valid and formatted before submission, install the necessary development dependencies with pip install catsim[dev].
Compatibility
catsim is compatible and tested against Python 3.7, 3.8, 3.9, 3.10, 3.11, 3.12.
Important links
- Official source code repo: https://github.com/douglasrizzo/catsim
- HTML documentation (stable release): https://douglasrizzo.com.br/catsim
- Issue tracker: https://github.com/douglasrizzo/catsim/issues
Citing catsim
You can cite the package using the following bibtex entry:
@article{catsim,
author = {Meneghetti, Douglas De Rizzo and Aquino Junior, Plinio Thomaz},
title = {Application and simulation of computerized adaptive tests through the package catsim},
year = 2018,
month = jul,
archiveprefix = {arXiv},
eprint = {1707.03012},
eprinttype = {arxiv},
journal = {arXiv:1707.03012 [stat]},
primaryclass = {stat}
}
What's a CAT
Computerized adaptive tests are educational evaluations, usually taken by examinees in a computer or some other digital means, in which the examinee's ability is evaluated after the response of each item. The new ability is then used to select a new item, closer to the examinee's real ability. This method of test application has several advantages compared to the traditional paper-and-pencil method or even linear tests applied electronically, since high-ability examinees are not required to answer all the easy items in a test, answering only the items that actually give some information regarding his or hers true knowledge of the subject at matter. A similar, but inverse effect happens for those examinees of low ability level.
More information is available in the docs and over at Wikipedia.
If you are looking for IRT item parameter estimation
catsim does not implement item parameter estimation. I have had great joy outsourcing that functionality to the mirt R package along the years. However, since many users request packages with item parameter estimation capabilities in the Python ecosystem, here are a few links. While I have not used them personally, specialized packages like these are hard to come by, so I hope these are helpful.
1 maintainer
Release files for catsim 0.21.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| catsim-0.21.0.tar.gz | 69.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| catsim-0.21.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 128.2 kB
Release files / catsim-0.21.0.tar.gz
| Download URL | catsim-0.21.0.tar.gz |
|---|---|
| Size | 69.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
14c125e5d6348711f066cb539ea8fe45f533523a6deea9d435d8ea9528ce7f5e
|
|
BLAKE2b-256 checksum How to use checksums |
2d71b428d96610dd85138e49712374aa2c670ee2c01a29066357ba1fd8830aae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 8, 2026.
Transparency logRelease files / catsim-0.21.0-py3-none-any.whl
| Download URL | catsim-0.21.0-py3-none-any.whl |
|---|---|
| Size | 59.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3ba3d3412578fbf50d42225729462d2f26caa8028704331c82e25feb97532ccc
|
|
BLAKE2b-256 checksum How to use checksums |
b5e19c4fb15938618b43403e1d1e224ee16c5fdd4587c1e5872bb74ca5afdafe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 8, 2026.
Transparency log
