Package 'nbmecalc'

Title: Convert Practice Assessment Scores for Educational Planning
Description: Converts supported NBME, UWSA, Free 120, AMBOSS, and CMS practice-assessment inputs into deterministic educational estimates. It can also combine multiple observations with recency and source-quality weights and returns an uncertainty interval. All mappings are independent model assumptions and are not official score conversions.
Authors: NBMEcalc Contributors [aut, cre]
Maintainer: NBMEcalc Contributors <[email protected]>
License: Apache License (>= 2)
Version: 0.1.0
Built: 2026-10-15 09:56:00 UTC
Source: https://github.com/jiankn/nbmecalc-r

Help Index

Convert one supported practice-assessment score

Description

Applies the independent NBMEcalc v1.1 model assumptions without making a network request.

Usage

convert_practice_score(source, score, step = "step2", form = NULL)

Arguments

source

One of nbme, uwsa1, uwsa2, free120, amboss, or cms.
score

A finite three-digit score or percentage, according to source.
step

One of step1, step2, or step3.
form

Optional NBME form number.

Value

An integer educational estimate.

Combine multiple practice-assessment scores

Description

Applies source-quality and recency weights to supported practice-assessment inputs.

Usage

predict_practice_scores(exams, step = "step2", days_until_exam = NULL)

Arguments

exams

A non-empty data frame with source and score; optional form and taken_days_ago.
step

One of step1, step2, or step3.
days_until_exam

Optional non-negative examination horizon in days.

Value

A list with the point estimate, interval, probability, input count, freshness, and algorithm version.