Learn how to use TRACE, features, settings, and limitations.
Click Load example to see a worked case on synthetic data.
Two columns, one row per period, oldest first. TRACE accepts pasted text, CSV, or Excel (.xlsx). The first sheet is used.
| Column | Meaning |
|---|---|
NBRx | New patients (new starts) in the period. Despite the name, this is new patients, not new prescriptions. |
TRx | Total prescriptions in the period, including the first fills of the new patients. |
NBRx and TRx are found by name in any case. Extra columns are ignored.How many months of past cohorts count toward each month's TRx. The default is 36. A cohort older than the lag is treated as gone. Lowering it speeds up the calculation and limits the influence of very old patients. Raising it matters only when your series is longer than 36 months and a meaningful share of patients stay on therapy that long.
How far to project TRx beyond your last month. Set it to 0 for a fit only.
A projection needs an assumption for new patients in the months to come.
The projection is only as good as this assumption. TRACE does not forecast new patients.
| Number | What it tells you |
|---|---|
| α (scale) | The age at which the share still on therapy falls to about 37%. Larger α means patients stay longer. |
| β (shape) | Below 1, most dropout happens early. Near 1, the dropout rate is steady. Above 1, dropout speeds up with time. |
| k (multiplier) | Turns active patients into prescriptions. It absorbs fill length, refill gaps and adherence. It is not refills per patient. |
| R², RMSE, MAPE | How closely the fitted line follows your actual TRx. RMSE is in TRx units. MAPE is the average percentage miss. |
| Median persistence | Months until half of new patients are gone: α × (ln 2)1/β. |
| 6- and 12-month retention | S(6) and S(12): the modelled share of new patients still on therapy at that age. |
In the retention table, Cum. dropout is 1 − S(t) and Monthly is the dropout in that month alone, S(t−1) − S(t).
A high R² does not prove the retention curve is right. Many combinations of α, β and k can fit a short series almost equally well. Compare the curve with anything you know about real persistence before relying on it.
The Method page explains each equation, how the fit is found and what has been verified. In short: retention follows a Weibull survival curve. Total prescriptions come from adding up every past cohort that is still on therapy.
α, β and k are chosen to minimise the squared error between fitted and actual TRx. For any pair of α and β the best k has a closed form, so only α and β are searched, within 0.1 to 240 for α and 0.1 to 10 for β. TRACE tries several starting points to avoid a poor local minimum.
TRACE has been checked against an independent implementation of the same model. On our test datasets the two give the same α, β, k, RMSE and projections to at least five significant figures.
No. The calculation runs in your browser and the page is set up so it cannot send data to other sites. Nothing you paste or upload is stored or sent.
TRx in any month is the sum over all earlier cohorts. If early months are missing, their patients are missing from that sum, and the fit has to compensate with a distorted curve.
The minimum is 6. Twelve or more gives much steadier results. A warning appears under 12 months.
It changes k, which absorbs average fill behaviour. It does not change how α and β are interpreted. Keep the same definition of TRx throughout the series.
The message means α or β reached the edge of the search range. This often happens with very short or very flat data. Add more history, check NBRx and TRx for errors, or treat the result as unreliable.
Yes. Everything is per period, so α will be in weeks, and max lag counts weeks. The axis labels still say months.