Given a prior student ability and uncertainty, this function forecasts the students
performance on an assessment in the future. This calculation takes into
consideration the number of days since the last student assessment and the future
assessment. It also takes into consideration an uncertainty associated with the
assessment.
Outputs include the students projected ability as measured by the assessment as well
as an uncertainty measure associated with this forecast.
Also, this function takes as a parameter an array of cutLevels.
These are in essence performance milestones, ranked from least to greatest. For each
of these cut levels, this function will provide the probability that a student’s
performance on the assessment will fall into that performance band.
URL
POST /api/forecast/reading
Request
Parameter
Type
Description
priorAbility
Integer
The student’s prior ability estimate.
priorUncertainty
Integer
Uncertainty associated with the student’s prior ability
estimate.
testUncertainty
Number
Uncertainty of the difficulty of the test that student
performance is to be forecasted for. MetaMetrics sends this
information in spreadsheet format.
elapsedDays
Integer
Number of days from the date of the priorAbility
to the date of the future test that is being forecasted.
cutLevels
Array
An array of performance levels based on expected future ability
levels, measured in Lexile or Quantile. MetaMetrics sends this
information in spreadsheet format.
Response
Parameter
Type
Description
ability
Integer
The student’s forecasted ability estimate.
uncertainty
Integer
Uncertainty associated with the student’s forecasted ability
estimate.
probabilities
Array
The probabilities that the student will fall into each of the
performance bands, as defined by the
cutLevels.
apiVersion
String
The current version number for the API.
framework
String
Either Lexile or Quantile; framework used to produce the
measure.
Code Examples
The following show an example of the request followed by an example of the response.
The Python example is written for use with Python 3 and above.