> For the complete documentation index, see [llms.txt](https://docs.assessmentdisaggregation.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.assessmentdisaggregation.org/input-files/assessment-map.md).

# Assessment Map

An assessment map file is any four column CSV file with the following columns: Q (question number), Exam1 (where the question appeared on the pretest), Exam2 (where the question appeared on the posttest), and Options (number of answer options for a given question).  The following table is an example assessment map where the questions appeared in the opposite order on posttest as they did on the pretest.  The output files will be in pretest order as 'Q' and 'Exam1' are in the same order.

| Q | Exam1 | Exam2 | Options |
| - | ----- | ----- | ------- |
| 1 | 1     | 5     | 4       |
| 2 | 2     | 4     | 4       |
| 3 | 3     | 3     | 5       |
| 4 | 4     | 2     | 4       |
| 5 | 5     | 1     | 5       |

Note that alternative column names include 'question' and 'item' for 'Q', 'pretest' and 'pre-test' for 'Exam1', 'posttest' and 'post-test' for 'Exam2', and 'answers' and 'p' for  'Options'.

The 'Options' column supports non-whole numbers.  This might be used if the probability of guessing has been determined empirically (e.g., 3PL with a nationally-normed exam).  If the value in 'Options' is less than one, it will be converted to one over the value specified.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.assessmentdisaggregation.org/input-files/assessment-map.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.