Grouped by what the finding is about. Codes are stable; new ones may be added over time. Treat an unrecognised code as a generic finding of its given severity.
Parameters and random effects
A theta, eta, kappa or sigma the model uses is not declared, is declared in the wrong order, or has no data to bind to.
A [parameters] line must also be consumed end to end by exactly one declaration form, at both ends: text before or after a complete declaration is reported as E_PARSE with the offending line quoted, and so is a line matching no form at all. The one shape with a code of its own is a scale tag on a block_* declaration, below. Before 0.4.0 all of it was dropped without a diagnostic — including leading text, which could silently turn block_sigma PROP ~ 0.04 into a diagonal sigma.
E_ETA_NOT_DECLARED |
error |
An unresolved identifier reads as a random effect (ETA… / KAPPA…) but no omega / kappa declaration defines it, and the data carries no such column. Usually a deleted omega line whose exp(ETA_…) term was left behind. |
W_ETA_NOT_DECLARED |
warning |
As E_ETA_NOT_DECLARED, but reported without --data, where ferx cannot yet know whether the dataset supplies the column. |
E_SIGMA_ORDER_MISMATCH |
error |
A single-endpoint [error_model] names its sigmas in an order other than the [parameters] declaration order. These sigmas are consumed positionally, so the written names must match the declared order. Fix by reordering the sigma declarations (permuting a block_sigma’s lower triangle with them) — reordering the arguments also parses but swaps the proportional and additive roles, i.e. changes the model. See #1001 and Error model. |
E_BLOCK_VARIANCE_ONLY |
error |
A scale tag ((sd), (variance) or (var)) on a block_omega, block_sigma or block_kappa declaration. The lower triangle mixes variances and covariances, so one tag cannot say which entry is on which scale. The repair depends on the tag, and the report’s suggestion carries whichever applies: after (sd), square each SD into a variance and write the off-diagonals as covariances; after (variance) or (var), delete the tag - the lower triangle was already on that scale, so the tag said nothing and nothing else needs changing. The code is raised only when deleting the tag leaves a declaration that parses, so the repair is always sufficient; a tag alongside other stray text is E_PARSE. Until 0.4.0 the tag was dropped in silence and the file reported VALID, so an SD-coded block fitted from squared-wrong initial estimates. See #1377 and Parameters. |
E_IOV_MISSING_OCC |
error |
Model declares kappa (IOV) parameters but no occasion labels were found. Set iov_column to read them from a dataset column, or iov_occasion = dose / time(...) to derive them in the model, both in [fit_options]. On --simulate the [simulation] design has no dataset and gives each subject a single dose, so the message names only iov_occasion = time(...), with a breakpoint inside the times grid. It says that iov_occasion = dose derives a single occasion there, and that an iov_column the model sets has no effect (#2005). Not raised for a model with nested levels, whose groups come from its level columns. |
W_IOV_OCC_MISSING |
warning |
Some rows in the IOV occasion column had missing or unparseable values; those rows were assigned occasion=0. |
E_THETA_LEVEL_BINDING |
error |
A theta NAME[COL, ...] level block could not be bound to the data’s levels: a level column missing or non-finite, no row that defines a level (no observation rows, or on data with only binary, Markov, time-to-event or count records, no endpoint that reads the block bare through its implicit index and whose records define levels), or a contrast the data cannot carry. Block parameters. The binders return the same code from a running program, where it also covers binding to a fit’s level layout (a level the fit estimated no θ for), which ferx check cannot reach. |
E_COVARIATE_STATS_BINDING |
error |
A [covariate_model] statistic could not be bound to the data: a levels = auto relation whose data carry one level, or a covariate with no non-missing value. Block covariate_model. The binders return the same code, including for a fit’s statistics that do not match the model. |
Priors, weights and unused parameters
A declared parameter that nothing reads, a prior that names no parameter, or a kappa weight or initial estimate the data make unusable.
E_PRIOR_UNRESOLVED |
error |
A declared prior cannot be applied: it names no theta / omega / sigma / kappa in [parameters], names a FIXed parameter, an element of a block_omega / block_sigma / block_kappa, or a name that resolves to several coordinates; it is declared twice; its central value is not finite (or not positive for a log-packed parameter); or a [priors] from_fit was not expanded. The message names the parameter. |
W_UNUSED_PARAM |
warning |
A user-declared θ, ω or κ is not referenced by any [individual_parameters] or [event_model] expression, or a σ is not referenced in [error_model]. It does not affect predictions and is not meaningfully estimated. Generated θ (NN weights, diffusion) and the iiv_on_ruv η are not checked. |
E_KAPPA_WEIGHT_NONPOSITIVE |
error |
A kappa NAME ~ value weight = W sample-size weight evaluates to zero, a negative number or a non-finite value at some observation or dose record, at the model’s initial θ. κ is applied as κ/√W, so such a weight divides an individual parameter by zero. The usual cause is a missing or non-numeric cell in the covariate the weight reads. The first offending record is reported. |
W_KAPPA_WEIGHT_VARIES_WITHIN_OCCASION |
warning |
A weighted kappa’s weight expression evaluates to different values (relative difference above 1e-9) at two observation records of the same occasion, or of the same group of the kappa’s level when nested levels are declared. κ is drawn once per occasion or group, so its effective variance Ω_IOV/W is ambiguous; each record is scaled by its own weight. Reported once per kappa, naming the first subject. |
W_ZERO_DV_MAGNITUDE_ONLY |
warning |
Observations with DV = 0 are scored by a residual error model whose variance is zero at a zero prediction: proportional, a power(...) magnitude, or a combined model whose additive SD starts at 0. As the prediction approaches 0 the row’s log-variance keeps falling (to about −708 of −2LL per row), so a fit can stop at a wrong optimum that still reports converged. Rows censored under bloq_method = m3, FREM covariate rows and non-Gaussian endpoint rows are not counted. Reported by fit() and ferx check, not by simulate(), where DV = 0 is a template placeholder. Fix: add an additive component, remove the rows (pre-dose or pre-lag zeros), or code below-LLOQ rows as CENS = 1 with DV = LLOQ under bloq_method = m3. |
W_ADDITIVE_INIT_SCALE |
warning |
A combined error model’s additive SD initial estimate is below 1% of the data scale (the median abs(DV) of the observations that endpoint covers). From such a start a multimodal fit can settle where the additive term collapses and the proportional one inflates. The value is not changed; if the fit converges with the additive variance near zero, retry from about 10% of the median abs(DV). |
Covariate statistics and level blocks
A [covariate_model] statistic or a theta NAME[...] level block that has to be bound to the data, and the data it is bound to.
E_COVSTAT_UNRESOLVED |
error |
A [covariate_model] relation still needs statistics derived from the data — center = median, levels = auto, or a form whose default bounds come from the data — and none were bound. Reported with --data, where the binding was attempted. |
W_COVSTAT_UNBOUND |
warning |
As E_COVSTAT_UNRESOLVED, but reported without a --data file: the model is fine, it just cannot be built until a dataset supplies the statistics. |
E_COV_LEVEL_UNKNOWN |
error |
The data carry a value of a categorical [covariate_model] covariate that is not one of the relation’s levels, which the generated factor would silently model as the reference level (#1111, #1740). Raised by fit(), ferx check, the simulate*, adaptive and predict* entry points, compute_npde_npd, run_sir and run_covariance. |
E_THETA_GATHER_INDEX_MISSING |
error |
A theta NAME[...] block gathered by a bare data column, where some observation or dose record of a subject has no value in that column. Every record that reads the block needs one. Reported at most once per block and subject. |
E_THETA_GATHER_INDEX_RANGE |
error |
A theta NAME[...] block’s index column holds a value on some record that is not finite, not a whole number, or outside 1..=N for the block’s N levels. The index is 1-based — a 0-based column is the usual cause — or theta NAME[N] declares too few levels. Reported at most once per block and subject. |
E_THETA_LEVELS_DATA_UNBOUND |
error |
A model whose theta NAME[...] level block is bound was handed a population never bound for it, so no record carries an index into the block’s levels — the usual “fit, then predict or simulate new data” without binding the new data. The message names the binder to call (bind_from_fit after a fit, bind_theta_levels on a fresh parse), or “k of n subjects” and the first such ID when only some subjects carry the index (#1647, #1762). Raised by fit() and the predict*, simulate*, adaptive, NPDE and post-hoc entry points. |
E_THETA_LEVELS_DATA_MISMATCH |
error |
A population that carries a bound level block’s index was bound for other levels than the model’s (#1762): a record’s index is not the position, in the model’s level table, of the label its own level columns spell, or an index arrives without its level column. Unseen labels are listed, or the first misindexed record is named. Refused, never re-indexed. Raised by the same entry points as E_THETA_LEVELS_DATA_UNBOUND. |
Residual correlation
A residual correlation line, or a block_sigma correlated residual, against the rows it correlates.
E_RESIDUAL_CORRELATION_RANGE |
error |
The θ behind a residual correlation <kind>(RHO) by … line can leave the residual covariance R indefinite: a cs ρ at or below −1/(n−1) for the largest block of n rows, a negative car1 ρ, or a fixed / simulated value with abs(ρ) ≥ 1. A free ρ must also be bounded within ±0.995, since R becomes numerically singular as abs(ρ) approaches 1; FIX it to hold a value closer to ±1. |
E_RESIDUAL_CORRELATION_RESET |
error |
Under a residual correlation ar1(…) or car1(…) line, one block holds rows on both sides of a TIME reset (an EVID=3/4 record that restarts TIME), so their order and the lag between them are undefined. Add the occasion column to by so each occasion is its own block, or use cs. |
E_RESIDUAL_CORRELATION_TIES |
error |
Under a residual correlation ar1(…) or car1(…) line, two rows of one block share a TIME. ar1 orders a block by TIME, so tied rows have no order; car1 correlates them by ρ^0 = 1, which makes R singular. Give them distinct times or use cs. |
W_RESIDUAL_CORRELATION_INERT |
warning |
The model declares a serial residual correlation line, but in every subject each block formed by its by column(s) holds at most one observation. No two rows are correlated, so ρ does not enter the likelihood and cannot be estimated. Check that the by columns group the rows meant to be correlated. |
W_BLOCK_SIGMA_L2_ORDER |
warning |
Some subjects with no L2 grouping id have a (time, occasion) group in which one observation shares a block_sigma correlation with two or more others, so the cross covariances are paired one-to-one in CSV row order and reordering rows would change the fit. Add an explicit L2 column giving each correlated unit its own id. |
W_L2_UNUSED |
warning |
The data carry an L2 column, which the reader always treats as the reserved level-2 grouping id for block_sigma pairing, but the model declares no correlated residual. The column therefore does nothing and is not readable as a covariate; rename it if a covariate was meant. |
Profiled level blocks
A level block declared profile (#1065) has its levels solved for at every outer step rather than searched by the optimizer. That needs a linear route to the prediction and the FOCE, FOCEI or Laplace objective, so the check refuses anything else; nothing falls back to ordinary estimation.
E_PROFILE_SCOPE |
error |
A profiled block that cannot be fitted that way: profile on a single θ, or with FIX; a box that is a point, is empty or misses the init; a method other than foce / focei / laplace (at any n_agq); a time-to-event or Markov endpoint (a binary one is in scope, #2111); a residual error that is not additive, or log-transformed; M3 censoring; a [mixture], [diffusion] or FREM model; optimizer = trust_region or mma; global_search; a parameter prior. Block parameters. |
E_PROFILE_NOT_LINEAR |
error |
A profiled block that a prediction does not read as c × block plus terms that do not read it, with c from the data alone, or as one logit link around such a read that is the whole prediction (y = inv_logit(c × block + …), #2111). The message names the construct (a function, power or remainder, a logit link that is not the whole prediction, an inline if or if branch whose condition reads more than data, a product of two reads, a parameter coefficient, a divisor, the states, the residual error, a second profiled block) and where it is, or says that no prediction reads the block. A [binary_model] predictor is a prediction whose logit link is implicit, and a model with an [event_model] or [markov_model] block is left to E_PROFILE_SCOPE rather than called unread (#2562). Block parameters. |
Nested variability levels
A model that declares level lines (nested levels, #1082) is checked for how its levels are declared and whether the data can identify them.
E_LEVEL_MIXED_WITH_IOV_COLUMN |
error |
A level declaration together with iov_column or iov_occasion in [fit_options], an iov_occasion rule other than column in the fit options or SimulateOptions of a model with nested levels (block fit_options), or a kappa with no at LEVEL in a model that declares levels. A level replaces the occasion options, and once levels exist every kappa names its own. Block parameters. |
E_LEVEL_MISSING_LABEL |
error |
A record (observation, dose, EVID=2 / MDV=1 row or reset) has no numeric value in a level column (a blank cell is missing, not carried forward from the row before; a text label such as NCT01 has to be written as a numeric code). Its group at each level is identified by its labels from the outermost level down, so every record needs all of them. The message names the level, the column, the record and its time. Raised by the fit, ferx check --data and every simulate* entry point. Block parameters. |
E_LEVEL_SINGLE_MEMBER |
error |
A level has at most one group inside every group of its parent, and one of its kappas enters the model through the same parameters as a random effect of the parent level (the subject’s η for the first level). The two variances cannot be told apart. A level where some parents hold several groups is not refused. Block parameters. |
W_LEVEL_SUMMARY |
info |
Informational, not a finding, so reported with severity info and not counted as a warning (#2387): one row per level of a model with nested levels, outermost first, e.g. level `ARM`: 7 groups in 3 `STUDY` groups (per `STUDY` group: min 1, median 2, max 4); 1 of 3 `STUDY` groups holds a single `ARM` group; 1 kappa at `ARM` (K_ARM). Counted on the observation records. The parent of the first level is the subject. E_LEVEL_SINGLE_MEMBER refuses a level only when every parent holds a single group and a kappa has a twin; a level where some parents hold one group and others several is identified and fits, and this row is where its count shows. Counted on the observation records, as the refusal counts them; a parent with no observation record is left out. Not reported while a level label is missing (E_LEVEL_MISSING_LABEL). Raised by ferx check --data only, not recorded by fit() (#2035). Block parameters. |
E_RESIDUAL_CORRELATION_GROUPING_AMBIGUOUS |
error |
A residual correlation … by line on a model with nested levels whose grouping a level and a data column would read two ways: a level name inside a list of columns (by (STUDY, ARM)), a level name that is also a different data column, or the by column of a level nested in another level written under another name. by L naming a level groups by that level’s groups, nested by key; a column groups by its value within ID, which merges two groups that share a label in different parents. The message names the level and says what to write. Raised by the fit, ferx check --data and simulate(). Block error_model. |
E_RESIDUAL_CORRELATION_CONFOUNDED_KAPPA |
error |
A correlation cs(…) by … line whose blocks group the observation rows exactly as the groups of a level that carries a kappa (a nested level, or the occasions of a one-level model), compared as partitions in every subject, so cs by ARMID beside kappa … at ARM counts. A kappa gives each group’s rows one shared random effect, which is the correlation cs estimates: ρ and the kappa variance are not identified together. ar1 and car1 are not refused, and neither is cs over a grouping no kappa is at. Block error_model. |
W_RESIDUAL_CORRELATION_PARTLY_CONFOUNDED_KAPPA |
warning |
The same comparison holds in some subjects but not all, e.g. cs by STUDY next to a kappa at ARM where some studies have one arm. The model is identified, from the other subjects, and fits; the message gives the count, since ρ and the kappa variance are separated by those subjects alone. A subject whose partitions agree only trivially (every row its own block, e.g. one observation) counts on neither side, here or for the refusal. Raised by the fit and ferx check --data. |
Initial estimates against the optimizer box
Every initial estimate is packed and compared against the box the optimizer will search inside, before the first objective evaluation. All of the codes below are data-independent, so ferx check model.ferx reports them without a --data file. The two that are not skipped when maxiter = 0 are called out where they appear, and so is the one that becomes a warning there; for the rest the exemption is because an evaluation-only run clamps the start like any other, it just does not hold the clamped value through a search.
Against the box the optimizer searches
E_OMEGA_INIT_AT_RAIL |
error |
A free omega / kappa / [mixture] omega(k) variance whose initial value packs onto the optimizer’s -6 lower rail — every variance ≤ 6.1e-6, and ~ 0.0 in particular (a declared zero is regularised to 1e-8, packing to ln(L) = -9.21). The start is clamped onto the rail and the coordinate cannot be estimated from there: it stays collapsed or runs away to the opposite rail, moving the θ estimates with it. Either FIX it (that is the supported way to declare no variability) or start it at ≥ 1e-5. NM-TRAN rejects the same stream with error 76, INITIAL ESTIMATE OF VARIANCE CANNOT BE ZERO UNLESS FIXED. Σ is not included — a free sigma ~ 0.0 (sd) is clamped onto its own -8 rail and recovers the optimum. Only reported when an optimizer will actually search: maxiter = 0 (NONMEM MAXEVAL=0, as used by ferx gam --no-fit) is not reported — it clamps the start like any other run, but produces one objective and stops, so nothing is trapped on the rail; note that it therefore evaluates a free ~ 0.0 at exp(-12) rather than at the declared value, which FIX avoids. saem / imp / impmap / bayes / vi carry their own iteration counts, and gn_hybrid a fixed polish budget, so they are still checked. A model used only with predict() / simulate() is not exempt on the check path: ferx check reports what fit() would refuse, so such a model is reported here while still simulating fine. Add maxiter = 0 to [fit_options] if the file is genuinely simulation-only. The message is chosen per eta, not per matrix: an eta declared inside a block_omega / block_kappa is told its block is near-singular (in a block it is the correlations that drive L_ii to zero, so raising a declared variance is not the fix), while a diagonally declared one is told to write ~ 0.0 FIX. Mixing a block and diagonal omega lines in the same model — the whole Ω then packs as one Cholesky — does not change what the diagonal eta is told. A one-eta block_omega (NAME) = [...] is correlated with nothing, so it gets the declared-zero explanation rather than the near-singular one, spelled in its own form (write `block_omega (NAME) = [0.0] FIX`) (#1394). See #1229 and Parameters. |
E_THETA_INIT_OUTSIDE_BOUNDS |
error |
A theta whose initial value is strictly outside its own declared range. The optimizer clamps the start into its box, so theta TVCL(0.05, 0.1, 10.0) fits from 0.1 — a factor of two — silently, on every run. NM-TRAN refuses the identical stream before any estimation (error 24). Judged against the declared numbers, not the packed ones: theta TVCL(-5.0, 0.0, 10.0) is reported even though -5 and the declared lower 0 both pack onto the same 1e-10 floor, and the message names where the fit really begins (1e-10, which is neither the declared value nor the declared bound). A start exactly on a bound is not reported: there the clamp is a no-op, so nothing moves. Not an error at maxiter = 0: an evaluation-only run is not refused, it gets W_THETA_INIT_OUTSIDE_BOUNDS below instead. See #1251. |
W_INIT_OUTSIDE_BOUNDS |
warning |
An initial estimate strictly outside one of ferx’s internal rails rather than a declared bound: the hidden 1e9 θ cap, the Ω ±6 (variance ≤ 1.6e5) / off-diagonal ±10 guards, or the Σ [-8, 5] guard. Clamped there before the first objective evaluation. The Σ rails are on the SD scale, which is how ferx stores σ — a plain sigma X ~ v declares the variance v and the message quotes sqrt(v), so sigma PROP_ERR ~ 1e6 reads an SD of 1.000e3. A warning and not an error because these recover: omega ~ 1e8 on examples/warfarin.ferx reaches the base optimum under all eight optimizer × method arms. The Ω lower rail is E_OMEGA_INIT_AT_RAIL instead, where the fit is genuinely trapped. There is no 1e-10 θ counterpart here: a start below the floor packs equal to its floored bound, so it is W_INIT_NOT_REPRESENTABLE below instead, and a range lying entirely below it is E_INIT_BOUNDS_INVERTED. |
On a run that does not search
W_THETA_INIT_OUTSIDE_BOUNDS |
warning |
The same finding as E_THETA_INIT_OUTSIDE_BOUNDS, on a run that does not search: maxiter = 0 with every stage one of foce / focei / laplace / gn. saem, imp, impmap, bayes, vi and gn_hybrid search at maxiter = 0 and keep the error. The start is clamped into its box before the one objective evaluation, so the OFV, predictions and estimates reported are those of the bound and not of the declared start: theta TVCL(0.5, 0.001, 0.2) is scored at 0.2. The message names the theta, the declared start, the bound it lies outside and the value scored; where that value is not the declared bound (a lower bound at or below ferx’s 1e-10 floor, an upper bound above the 1e9 cap) it says so. One warning per theta. A FIXed theta is not reported, because it is scored at its declared value, and neither is a start exactly on a bound. A warning and not an error so that --dofv, ferx gam --no-fit and the bootstrap Δofv sweep, which evaluate machine-produced parameters, keep running. Reported by ferx check and in the fit’s warnings, in the init_outside_bounds category. To score the declared value, widen the range to include it; where ferx could not hold that value even then (a start of 0, below 1e-10 or above 1e9 under a lower bound of 0 or more), the message says so instead of offering the widening. See #2865. |
When the box is empty
E_INIT_BOUNDS_INVERTED |
error |
A coordinate whose packed box is empty, so no start can be placed in it at all. Only a theta can reach this through the parser — every other segment’s bounds are constants — but the code is not θ-specific, and a non-θ coordinate is reported the same way. Three causes: the declared bounds are swapped (theta TVCL(1.0, 5.0, 2.0)); the declared range lies entirely above ferx’s 1e9 packing cap; or it lies entirely below the 1e-10 floor — theta TVCL(1e-12, 1e-13, 1e-11), an ordinary small parameter, is the last. Reported even at maxiter = 0, unlike every other code in this table: an empty box is not clamped, it aborts the clamp, and an evaluation-only run clamps too. Only the affected coordinate is silenced — every other parameter in the file is still reported in the same pass. |
When the packed space cannot represent the declared value
A different question from the three above, and the one they are structurally blind to: pack_params applies its own guards before any box exists, and the box is then built from the already-moved value — so a coordinate reported here is, by construction, perfectly in-box.
W_INIT_NOT_REPRESENTABLE |
warning |
A declared value the packer itself altered, before any box existed (#1307): the 1e-10 log floor on a θ / Ω-diagonal / Σ / [mixture] override, or the Fisher-z ±3 rail on a free block_sigma correlation. The message names the declared value and the value the optimizer actually sees. A separate code from W_INIT_OUTSIDE_BOUNDS because every coordinate it names is, by construction, inside its box — the box is built from the moved value — so a silent W_INIT_OUTSIDE_BOUNDS does not mean the declared values reached the optimizer. Not exempt at maxiter = 0: an evaluation-only run scores the substituted value too. A FIXed correlation is never reported, since #1307 holds it exactly. |
Data and dosing
The dataset could not be read, or a dose / observation record is inconsistent with what the model expects.
Records and observations
E_DATA |
error |
The --data file could not be read or parsed. |
E_MISSING_COVARIATE |
error |
The model references a covariate not present in the data (case-sensitive). On block covariates, a column the [covariates] block declares is missing from the file. On block simulation, run_model_simulate()’s [simulation] design does not state a covariate the model reads (#1788). |
E_COVARIATE_NOT_NUMERIC |
error |
A column the [covariates] block declares holds a value that is not a number. Block covariates. |
E_NONFINITE_DV |
error |
A subject carries a non-finite (NaN/Inf) observation. Usually a population read by read_population_for_simulation() — a simulation input — passed to fit(). |
E_NO_SCORED_OBSERVATIONS |
error |
The population has no record the likelihood scores: no Gaussian observation and no endpoint (TTE / binary / categorical / Markov) record on any subject. The data contribute nothing to the objective of such a fit, so no estimate can move off its initial value except under a [priors] or regularization penalty. fit() refuses it with the same message, where it used to return OFV 0 with the parameters at their initial values. Reported once for the population, after the more specific data codes, so fit() still names an unrouted endpoint (E_ENDPOINT_NO_RECORDS) or a non-finite DV first. When [data_selection] removed rows classed as observations, the message gives what it removed and names its clauses as the thing to check; otherwise it says what makes a row scored (EVID = 0, MDV = 0 and a DV). Only ferx check --data reaches it; without a dataset there is nothing to count (#1491). |
W_MISSING_DV |
warning |
One or more EVID=0 rows had a missing DV (./NA/blank) but were not marked MDV=1; they were skipped rather than scored as DV=0. |
W_COVARIATE_MISSING |
warning |
A covariate column that exists has no value (every cell ., blank or NA) for some subjects, so it is NaN for them. Reported once per covariate, naming it and up to five of the subjects, and only for a covariate the model reads (including [derived], [output] and a numeric [data_selection] test) — a column nothing reads is not reported, even if declared in [covariates] or listed in covariate_columns (#2599). A relation that reads it is then NaN, which makes the objective non-finite, or — through log, sqrt, min, max or a comparison — a finite value with no further warning. Impute the column, exclude the subjects, or guard the relation with present(COV). See Covariate Columns (#2041). |
W_DESIGN_DV |
warning |
Simulation reader only: one or more EVID=0 rows had a missing DV and were kept as design points to simulate at, so the dataset contributes more rows than a fit of the same file would. |
W_CENS_UNEXPECTED |
warning |
An observation row’s CENS cell is a whole number other than -1 (above ULOQ), 0 (quantified) or 1 (below LLOQ), such as 7 or -2. Every engine reads only the flag’s sign, so under bloq_method = m3 a positive flag is scored on the lower tail, like 1, and a negative one on the upper tail, like -1; under bloq_method = drop the row is scored as an ordinary observation. The message quotes the cell as written (200, not the 127 it saturates to) and is reported once per subject for each sign. It is not raised on a simulation design row with no DV, which is never scored. A cell that is not a whole number (1.5, abc, inf) is not this warning but a read error, reported as E_DATA, on a Gaussian observation row that carries a DV and that [data_selection] keeps; on a dose row, a row whose DV is missing, or a row the filter removes, the cell is not read (#1496). |
W_FILTER_COLUMN_ABSENT |
warning |
A [data_selection] condition names a column the dataset does not have. The comparison never matches, so the condition does not select what was meant — and what that costs depends on the key it was written under: an ignore excludes nothing, an accept excludes every row. The message names the missing column(s) and lists the headers the file does have, so a typo (ignore = Coment) is visible rather than silent. ferx check --data reports it since #1465; before that the check never compiled the clauses, so only a fit could raise it. |
W_DATA |
warning |
A warning from the data reader whose message does not begin with its own W_ code. ferx check relays each reader warning under the code its message opens with, and uses W_DATA only when there is none. |
Dose coverage
Whether the dataset delivers any drug at all. These read the dose records as a set, so they say nothing about an individual row — for that see Dose records below.
W_AMT_NOT_DOSED |
warning |
Record(s) carry AMT != 0 but were not read as dose events, because EVID is neither 1 nor 4; their AMT was ignored. In a dataset with no EVID column a nonzero AMT is enough to infer a dose, so this is a file that has one. Reported with the record and subject counts. It wins over W_NO_DOSES, which is the generic backstop for a dataset carrying no AMT signal at all. See #262. |
W_NO_DOSES |
warning |
Zero dose events parsed across every subject, although scored observations are present. Silent when there are no scored observations (an all-EVID=2, covariate-only file is not a fit), and silent when any subject carries a non-Gaussian observation — a TTE / survival or discrete endpoint legitimately has no PK dose, so warning there would be a false positive. See #262. |
W_ALL_DOSES_ZERO |
warning |
An AMT column is present and at least one dose event was parsed, but every parsed amount is exactly zero. No drug enters the system, so the objective is flat and the parameters will not move from their initial values. A warning rather than an error because the column is there and a genuinely dose-free-but-AMT-columned dataset is conceivable. See #753. |
E_DOSE_NO_AMT |
error |
The dataset has dose records (EVID 1 or 4) but no AMT column, so every dose would have amount zero and the fit would run with no drug in the system. Usually the amount column has another name (e.g. DOSE); rename it to AMT. A read error, not a diagnostic of its own: ferx check --data reports it as E_DATA with this text (#753). |
Dose records
W_ADDL_MISSING_II |
warning |
ADDL > 0 on a dose row but II is zero or missing; additional doses were not expanded. |
W_COMPARTMENT_FREE_DOSES |
warning |
The dataset carries dose records but the [structural_model] is compartment-free ($PRED-equivalent), so no dose is applied and AMT / RATE / SS / CMT on those rows have no effect on the prediction. Reported once, with the dose-event count (after ADDL expansion) and the number of dosed subjects. Every dose-level check that would read the model’s compartments is skipped for this class — a coded RATE=-1 / -2 row is not E_MODELED_*_NO_PARAM (a D{n} / R{n} the model cannot consume) and a CMT=2 row is not E_DOSE_CMT_OUT_OF_RANGE (the placeholder one-compartment topology the parser installs) — so the rows land here instead (#1443). |
W_CMT_DEFAULTED |
warning |
Dose and observation rows were assigned compartment 1 because the dataset did not say which one — no CMT column, or a cell that is missing (./blank/NA) or not a compartment index. The message gives the row counts (plus the ADDL-expanded dose count when a defaulted row carried ADDL) and, for a present column, the offending spellings. Reported whenever CMT selects something on the model: more than one compartment a dose can reach — more than one [odes] state, or an analytical model whose CMT=2 is a real target (an oral model’s depot-bypassing central bolus, a 2-cpt model’s peripheral) — or an observation-side dispatcher, a per-CMT [scaling] block, a CMT=N: error model, or a per-CMT y[CMT=N] readout on either engine, or a declared endpoint the row routes to (unless the model is endpoint-only and that endpoint is compartment 1, where the fallback is provably right), or a [data_selection] clause comparing CMT. Silent where CMT chooses nothing: one_cpt_iv, a one-state [odes] model, a compartment-free model, the transit / inverse-Gaussian absorption models, and a [data_selection] clause on any other column. Rows a CMT-reading filter clause removed are counted and named separately, since they never reach the dose / observation counts (#1409). Reporting a declared endpoint duplicates E_ENDPOINT_NO_RECORDS on an absent column, deliberately: an endpoint routes rows by CMT, and suppressing the warning hid a silent re-routing between endpoints on a bad cell, where that error cannot fire. NONMEM has no equivalent finding because $MODEL lets it declare DEFDOSE; ferx has no such declaration, so an absent column is a genuine ambiguity rather than a default (#1009). |
W_STEADY_STATE_II |
warning |
SS=1 doses with missing / non-positive II (treated as non-SS). |
W_STEADY_STATE_INFUSION |
warning |
SS=1 infusion whose length after bioavailability exceeds II (overlapping pulses; SS skipped) — the run-in’s own test (#1281). |
W_STEADY_STATE_ABSOLUTE_TIME |
warning |
An SS=1 dose (II > 0) on a model whose [odes] right-hand side reads an absolute clock — TAFD, T/t, or the bare TIME built-in. The run-in standing in for the infinite past expands the dose train on a clock local to each cycle, so an absolute clock has no periodic steady state to converge to: T/TIME return a finite number that matches NONMEM’s own steady-state routine but is 67 % from the same model’s explicit dose train, and TAFD reads NaN whatever coefficient it carries. TAD is not included — it is bounded inside one dosing interval, so the run-in does reproduce its train and is anchored against NONMEM (#1139). Counted per dose that actually reaches the run-in, so an SS infusion the run-in itself skips — one whose length after bioavailability exceeds its own II — or a dose on a compartment outside the state vector is not swept up. Asked of the PK block only, so a TIME-reading joint PK-TTE hazard does not trigger it, and TIME read from [individual_parameters] is out of scope; one shape over-reports, see Steady state with TAFD or TIME. |
W_STEADY_STATE_INIT |
warning |
The model declares an [initial_conditions] baseline and at least one subject has a steady-state (SS=1) dose. The steady-state closed form already assumes an infinite dose history, and the baseline is superposed on top as a separate decaying transient, which double-counts the starting amount. Remove the SS flag or the baseline unless that superposition is intended. |
Dose compartments
A dose whose CMT the model has no compartment for, or cannot infuse into.
E_DOSE_CMT_OUT_OF_RANGE |
error |
A dose record — bolus or infusion, zero amount included — whose CMT exceeds the number of compartments: the [odes] block’s declared states, or the analytical model’s compartments. Such a dose used to be silently dropped (ODE) or panic the event walk (analytical). Reported once per (bolus/infusion, compartment); not raised on a compartment-free model, nor on an analytical model whose population feeds no PK prediction. |
E_NEGATIVE_CMT |
error |
A negative CMT on anything but an EVID=2 row: NONMEM stops on one on a dose or observation, and ferx refuses one on a reset (#2732). See Compartment on/off. |
E_CMT_TOGGLE_TIE |
error |
A compartment on/off row between two doses, or a reset and a dose, at one TIME: no engine order can place it (#2732). See Compartment on/off. |
E_CMT_TOGGLE_UNSUPPORTED |
error |
A compartment off row (EVID=2, CMT=-N) on a model that cannot honour it: not an [odes] model, an SDE, a declared endpoint, or a compartment fed by a built-in absorption input (#2732). See Compartment on/off. |
E_CMT_TOGGLE_OUT_OF_RANGE |
error |
A CMT=-N off row past the [odes] block’s declared states (#2732). See Compartment on/off. |
E_CMT_TOGGLE_SS |
error |
An SS=1 dose while a compartment is off (#2732). See Compartment on/off. |
E_OBS_CMT_OFF |
error |
An observation of a compartment that is off at that record, as NONMEM refuses (#2732). See Compartment on/off. |
E_DOSE_CMT_NOT_INFUSABLE |
error |
An infusion (RATE > 0 or a modeled rate) with a nonzero AMT that names a compartment the model cannot infuse into — in practice CMT=0, NONMEM’s default dose compartment, which is defined for a bolus but not for a zero-order input. Raised on [odes] models and the event-walk analytical models (not transit / inverse-Gaussian); reported once per compartment, with the subject and time of the first row. |
Dose attributes
Bioavailability F, lag time ALAG/LAGTIME, and the modeled infusion duration D{n} / rate R{n} behind a coded RATE — the values the engine applies at a dose event.
E_DOSE_ATTR_DOUBLE_USE |
error |
A dose attribute the engine applies at the dose event is also read by the model, so its value is applied twice. Bioavailability and lag are caught at parse time on both engines (message names [odes], [scaling] or [adaptive_dosing]) — on ODE models via the name (F, LAGTIME/ALAG, F{n}/ALAG{n}/LAGTIME{n}), on analytical models via the pk(..., f=…) / lagtime=… mapping, where the remedy is to drop the mapping rather than rename. D{n}/R{n} are reported only when a coded RATE=-2/-1 dose in the data lands on them. Initial conditions are exempt on both engines — [odes] init(state) = … and [initial_conditions] seed the state with the raw value and never consult a dose attribute, so a seed that reads one applies it exactly once (#1046). See #993 and #1004. |
E_NEGATIVE_LAGTIME |
error |
A dose lag — lagtime / ALAG{n}, or a per-route fn(..., lag=L) on the compartment the dose lands in — is negative at the initial typical-value point (η = 0), at some dose record’s own snapshot. NONMEM refuses the same run (PK PARAMETER FOR ABSORPTION LAG IS NEGATIVE, PROGRAM TERMINATED BY OBJ), and so do fit() and ferx check. The message names the subject, the compartment and the dose record. Use a positive-link parameterisation or a lower bound of 0 on the lag’s theta. A lag driven negative mid-fit is not rejected; it starts that dose’s input earlier, identically on every engine (#1189). |
W_NEGATIVE_LAGTIME |
warning |
predict() / simulate() only: the same finding as E_NEGATIVE_LAGTIME, on entry points that run no data errors. The lag is applied as written, so the dose’s input starts before its record time (#1189). |
E_DOSE_ATTR_NONFINITE |
error |
A dose attribute the engine applies at the dose event — lag time (lagtime / ALAG{n}), bioavailability (F / F{n}), or a modeled infusion duration D{n} / rate R{n} behind a coded RATE — is NaN or infinite at typical values for some subject. Checked at every dose record’s own snapshot: that record’s covariate values and its TIME, which is where the engine reads the attribute (#1235). The message names the subject, the compartment, the attribute and the record. Usually a covariate relationship undefined for that subject: a covariate missing at that record (a missing value is NaN, which passes through arithmetic, ^ and exp), a fractional power of a negative value (ALAG1 = TVLAG*(WT/70)^0.75 with a negative WT), or an exponential model on an unscaled covariate (ALAG1 = TVLAG*exp(WT)). exp and ^ are the two DSL operations with no domain guard (/ by ~0 returns 0, and log/sqrt floor their argument; see Values outside an operation’s domain). Every attribute now has the same consequence: the subject’s predictions come back NaN, which the estimator reads as a diverged solve. For a lag or F that has always been so — they make dose.time + lag, and every break derived from it, non-finite, so the timeline cannot be ordered. A non-finite D{n}/R{n} used to be the quiet exception, and it was the dangerous one: it never reached you as a NaN at all, because an infinite D{n} gives rate = amt / D = 0 (not an infusion at all) and a NaN was clamped to the transient-D ≤ 0 floor, so the dose was served as an instantaneous bolus and the fit returned finite but silently wrong numbers — measured 2.03x high against the correct infusion at one elimination half-time. Since #1284 a non-finite D{n}/R{n} repels the subject like every other attribute, so this check is the fit-init front door rather than the only line of defence. See #1189. |
Modeled infusion duration and rate
A coded RATE=-2 (modeled duration D{n}) or RATE=-1 (modeled rate R{n}) dose against the parameter that supplies it.
E_MODELED_DURATION_NO_PARAM |
error |
A dose codes RATE=-2 (modeled infusion duration) into compartment n, but the model declares no D{n} in [individual_parameters], so the duration has no value to read. Reported once per compartment, naming the first such dose. Add D{n} = ... or give the dose an explicit positive RATE. Not raised on a compartment-free model, which applies no dose. |
E_MODELED_RATE_NO_PARAM |
error |
A dose codes RATE=-1 (modeled infusion rate) into compartment n, but the model declares no R{n} in [individual_parameters], so the rate has no value to read. Reported once per compartment, naming the first such dose. Add R{n} = ... or give the dose an explicit positive RATE. Not raised on a compartment-free model, which applies no dose. |
W_MODELED_DURATION_NONPOSITIVE |
warning |
For a RATE=-2 dose into compartment n, the modeled duration D{n} evaluated at that dose’s typical-value snapshot (initial θ, η = 0) is at or below 1e-8. It is clamped to that floor, so the dose arrives as a bolus-like spike rather than an infusion and the fit may converge to a wrong optimum. One warning per compartment; use a positive-link parameterisation such as D1 = exp(...). |
W_MODELED_RATE_NONPOSITIVE |
warning |
For a RATE=-1 dose into compartment n, the modeled rate R{n} evaluated at that dose’s typical-value snapshot (initial θ, η = 0) is at or below 1e-8. It is clamped to that floor, so the dose is delivered as a near-zero trickle over a near-infinite duration and the fit may converge to a wrong optimum. One warning per compartment; use a positive-link parameterisation such as R1 = exp(...). |
Endpoint routing
E_ENDPOINT_UNROUTED |
error |
A compartment the model declares as a non-Gaussian endpoint ([event_model], [binary_model], Markov) carries Gaussian observations: the population was read without endpoint routing (read_nonmem_csv() instead of read_population_for()), so the endpoint’s rows would be scored as concentrations and its likelihood would contribute nothing. Raised by fit(), simulate(), predict(), predict_categorical(), run_covariance() and run_sir() (#1199). |
E_ENDPOINT_NO_RECORDS |
error |
A declared non-Gaussian endpoint has no row routed to it anywhere in the data — typically the CMT column is missing, so every row reads as CMT 1. Raised by the entry points that run the likelihood — fit(), ferx check, run_covariance(), run_sir() — not by simulate() / predict(): a simulation template has no event rows by construction (#1199). |
E_ENDPOINT_TV_COVARIATE |
error |
A covariate that varies within a subject — on any row, endpoint rows included (#1854) — is read by an endpoint that evaluates it once, at the subject’s baseline: an analytic hazard’s own parameters, any covariate under an ODE-accumulated (drug-driven) hazard, a [markov_model] CTMM transition intensity, or — on a drug-driven (time-inhomogeneous) CTMM — an individual parameter the [odes] solve feeds into the states the intensities read (#1854). A [binary_model] predictor and a DTMM transition probability read each record’s own covariates, so they are refused only for a subject whose records cannot be lined up with its rows — one that also carries time-to-event records (#2562). The block is the endpoint’s (event_model, binary_model or markov_model), and the message names the covariate and the first subject, or a θ level block whose level changes between records by its name. Raised by fit(), ferx check, predict(), predict_survival(), predict_categorical(), simulate(), and the post-fit re-scorers run_covariance() and run_sir() (#1854); ferx check reports it since #1774, so a model fit() refused is no longer valid: true (#741). |
E_ENDPOINT_TIME_DEPENDENT_PK |
error |
The TIME axis of the same freeze: an ODE-accumulated (drug-driven) hazard integrates the individual parameters at their TIME=0 values, so a [individual_parameters] value that reads TIME and reaches the hazard (through the [odes] right-hand side or an init() seed) would put the PK and hazard halves of the objective on different concentration curves (#1853). Also raised, fail-closed, for a hand-built CompiledModel missing the compiled programs the analysis reads. Block event_model. A function of the model alone, so ferx check reports it without --data (since #1774). Raised by fit(), ferx check, predict(), predict_survival() and simulate(); not by predict_categorical(), which never reads the frozen snapshot. The same code on block markov_model is the freeze on a drug-driven (time-inhomogeneous) CTMM generator, whose [odes] solve runs under the same TIME=0 snapshot (#1918); raised by fit(), ferx check, run_covariance() and run_sir(). |
Endpoint records
Records of a non-Gaussian endpoint that its likelihood cannot score, each of which used to fold into a silent sentinel objective. fit() refuses them, and ferx check --data reports them, since #1788.
E_RTTE_RECORDS |
error |
A repeated-event (type = rtte) endpoint’s records: interval-censored, a non-finite TIME, an entry time after the record’s TIME, or out of time order; under clock = reset also a right-censored row before a later record, or two events at one TIME. The message names the subject. Block event_model. The reader drops some of these rows on load, so mostly a Population built in code reaches it. |
E_BINARY_STATE |
error |
A [binary_model] record whose DV is not 0 or 1. The reader accepts any non-negative integer on a discrete compartment, since it cannot tell binary from ordinal. Block binary_model. |
E_CTMM_RECORDS |
error |
A [markov_model] (CTMM) record whose DV is not one of the declared states, or a subject whose CTMM observation times decrease (the reader sorts doses, not observations). Block markov_model. |
Codes only an entry point raises
ferx check never reports these: they refuse an option, a parameter set, a fit or a call that a model file and its data do not contain, or a model fit() accepts but the entry point cannot run. Each is the code() of the EngineError the entry point returns (#1774). They are not the only codes ferx check cannot reach: the θ length, parameter shape, fit-binding and population codes are too, and matching on the code lists every code an entry point returns.
E_CTMM_UNSUPPORTED |
error |
A [markov_model] endpoint reached predict() with no continuous observation to predict, or simulate() or run_model_simulate(): neither has a state-occupancy path yet (#820). fit() supports the model. Block markov_model. |
E_TTE_NOT_SIMULATABLE |
error |
A TTE endpoint the event-time simulator cannot draw for this population: more than one repeated-event stream on a subject, a repeated-event cause beside a single-event one, an EVID=3/4 reset under a repeated-event or a drug-driven hazard, or left truncation under a drug-driven hazard. Block event_model. |
E_SIMULATE_HORIZON |
error |
The simulation horizon is missing where a repeated-event or drug-driven TTE endpoint needs one, is not finite and positive, or lies below a subject’s entry time. The message names the option of the entry point that was called: [simulation] horizon / SimulateOptions.horizon, or SimulateUncertaintyOptions.horizon on simulate_with_uncertainty() (#2003). run_model_simulate() returns it for a [simulation] block with a TTE endpoint of any kind and no horizon, the time its template rows are censored at (#1788). |
E_PROPENSITY_INPUT |
error |
Propensity-score matching was requested on a population it cannot compute posthoc etas from: empty, a subject with no observations, a subject with a non-finite DV, or a [mixture] model. |
E_NESTED_LEVEL_SIMULATE_UNSUPPORTED |
error |
A model with nested levels (more than one level) reached an adaptive-dosing entry point. Its kappa stream draws one kappa per occasion, and a kappa at an outer level has to be drawn once per group. fit(), simulate() and simulate_with_uncertainty() support the model. Block parameters. |
E_THETA_LENGTH |
error |
An entry point taking a parameter vector was handed a θ whose length is not the model’s, and refused it rather than read it by position. Raised by fit() on its initial parameters, the predict*, simulate* and adaptive entry points, compute_npde_npd, and run_sir / run_covariance on a fit whose θ does not fit the model they run on (#1614, #1615, #1774). On a level-block model the message says the θ count is set by the bound data. |
E_PARAM_SHAPE |
error |
An entry point was handed an Ω, σ or ΩIOV whose dimension is not the model’s, an ΩIOV on a model with no κ, or none on a model with κ, and refused it rather than read it by position (#1764, #1774). Raised by fit(), the simulate* and adaptive entry points, simulate_with_uncertainty, compute_npde_npd, fitted_params_from_result (ΩIOV), and run_sir / run_covariance (σ and ΩIOV). fit() also returns it for init_params with no per-class Ω/Σ on a [mixture] model (#1788). Not by predict*, which read none of the three. |
E_THETA_LEVELS_UNBOUND |
error |
A theta NAME[...] level block was never bound to data, so it has no levels and every value gathered from it is NaN — a CompiledModel assembled in code that skipped the binder. Call bind_theta_levels after reading the population (bind_from_fit with the fit’s data_bindings when predicting with a fit’s θ), use a file entry point that binds for you, or declare the block as theta NAME[N](...) indexed by your own column. |
E_FREM_NON_GAUSSIAN_ENDPOINT |
error |
prepare_frem() or transform_dataset_for_frem() was handed a model that declares a non-Gaussian endpoint ([event_model], [binary_model] or [markov_model]). The FREM dataset is written from Gaussian rows only, so the endpoint’s records would be dropped; the message names the endpoint CMTs. Run FREM on the PK model without that block. |
A missing ΩIOV on simulate() reuses an existing code, since the cause is the same: it is E_PARAM_SHAPE, the parameter-shape code the other entry points return (see matching on the code).
Kaplan–Meier VPC
E_VPC_TTE_INPUT |
error |
An input a TTE VPC (vpc_tte() for a single event, vpc_rtte() for repeated events, vpc_kmmc() for the Kaplan–Meier mean covariate of a single event) would draw a wrong curve or band from: several TTE endpoints and no cmt, a cmt that is not a TTE endpoint, an endpoint of the wrong kind (repeated events for vpc_tte() and vpc_kmmc(), a single event for vpc_rtte()), left truncation, an interval-censored record, a time that is not finite and non-negative, a duplicated subject id, no record on the endpoint, band probabilities not strictly inside (0, 1) and increasing, too few replicates for them, a grid time that is not finite and non-negative, or a stratification covariate a subject lacks or with more than 10 values. For vpc_tte() and vpc_kmmc() also more than one record per subject on the endpoint; for vpc_rtte() also a subject’s records out of time order and max_order = 0; for vpc_kmmc() also an empty covariate, a subject on the endpoint that lacks the covariate or whose baseline value is missing, a level no such subject has, and stratifying on the covariate itself (#1886). See Kaplan–Meier VPC. |
W_VPC_RTTE_ENDS_ON_EVENT |
warning |
In vpc_rtte(), some subjects’ last record on the repeated-events endpoint is an event, so their follow-up ends at that event. Such an observed subject has an event exactly at its follow-up end, which a simulated subject almost never has. The message gives the count. If follow-up went on after the last event, add a censoring record at its end (#1886). |
W_VPC_KMMC_TIME_VARYING_COVARIATE |
warning |
In vpc_kmmc(), the covariate changes over time within some subjects. The curve uses each subject’s first value, not its value at the risk time. The message gives the count (#1886). See The curve. |
Time-to-event npde
E_NPDE_TTE_INPUT |
error |
An input the TTE npde (compute_tte_npde()) would score wrongly: no TTE endpoint, more than one (competing risks), a repeated-events endpoint, left truncation, an interval-censored record, more than one record per subject on the endpoint, a time that is not finite and non-negative, a duplicated subject id, no record on the endpoint, or nsim = 0. A fit with npde_nsim > 0 reports the same input as the warning W_NPDE_TTE_SKIPPED and still succeeds. |
W_NPDE_TTE_SKIPPED |
warning |
A fit with npde_nsim > 0 could not score its time-to-event records: a repeated-events endpoint, competing risks, left truncation, an interval-censored record, or a failed reference simulation. The warning quotes the reason. The NPDE / NPD cells of the TTE rows are blank; every other row is scored as usual and the fit succeeds. |
File entry points
Refusals of the file entry points (fit_from_files(), prepare_run(), run_model_with_data(), run_model_simulate() and their variants, which ferx runs) and of fit() itself, for inputs ferx check does not read (#1788).
E_DATA_PATH_MISSING |
error |
No data path was given and the model file has no [data] path (no [data] block, or one that only maps columns). ferx check without --data skips its data checks instead of refusing. resolve_data_path() returns the same text as a String. |
E_SIMULATION_DESIGN |
error |
A [simulation] design that gives the model nothing to observe: no times for a continuous (residual-error) or [binary_model] endpoint, or no times and no TTE endpoint to observe at a horizon. Block simulation. A design that does not state a covariate the model reads is E_MISSING_COVARIATE on block simulation, and one with a TTE endpoint and no horizon is E_SIMULATE_HORIZON. |
E_IOV_SINGLE_OCCASION |
error |
A derived iov_occasion rule (dose or time(...)) gives every subject at most one occasion, so the per-occasion κ cannot be told from the η. Raised by fit() once it has derived the occasions, by ferx check --data (which derives the model’s rule on the data with the same message), and by run_model_simulate() on its [simulation] template before simulating (#2052), where the message names only iov_occasion = time(...). Block fit_options. |
Simulation warnings
Warnings a simulate* call (or compute_npde_npd_diag, which simulates its reference distribution) returns in its warnings, prefixed with the code. The simulation still completes.
W_IOV_NO_OCCASIONS |
warning |
The model declares kappa (IOV) parameters and an Ω_IOV is supplied, but some subjects carry no occasion label once iov_occasion has been applied. Those subjects get no κ draw and are simulated (or, from compute_npde_npd_diag, have their NPDE/NPD reference distribution simulated) at κ = 0. Silent when no Ω_IOV is supplied. |
W_FREM_DRAWN_ETA |
warning |
A FREM model was simulated with each subject’s η drawn from Ω, covariate η included: by simulate_with_options_diag() without match_method, by simulate_with_uncertainty_diag(), or by an adaptive simulation for the subjects with no supplied η. A FREM model links its covariates to the PK only through Ω, so those subjects’ PK follows the drawn covariate η, not their own covariate values, and their FREMTYPE rows report the drawn covariate value. Silent on a non-FREM model (#2245). |
W_SIMULATED_FLIP_FLOP |
warning |
On a transit or inverse-Gaussian absorption closed form with no ODE twin, some simulated individuals with a positive dose before their last observation were evaluated at a sampled η inside the flip-flop regime (or the 2-cpt confluent-eigenvalue corner). There the closed form clamps the dose-driven concentration to zero, so their rows carry no contribution from their doses and still enter every summary. The message gives the count out of the eligible individuals; rewrite the model as an explicit ODE to simulate them. The NPDE/NPD reference distribution reports the same count for its own replicates (#1928). |
W_UNCERTAINTY_DRAWS_SKIPPED |
warning |
Some parameter draws of simulate_with_uncertainty put a transit or inverse-Gaussian closed form with no ODE twin into the flip-flop regime at typical values, where it has no solution, so those draws were not simulated. The message lists them. The remaining draws exclude that tail of the parameter uncertainty, so prediction intervals built from them are biased. If every draw is skipped the call is refused instead. |
W_RTTE_DEGENERATE |
warning |
While simulating a repeated-event (RTTE) stream, a subject’s expected number of events before the horizon is non-finite or exceeds 1,000,000, so the stream is skipped; or a stream that passed that check produced more than 1,000,000 events, so it is truncated. Either way the subject is censored at the horizon and the rest of the population still simulates. Check the hazard parameters and covariate values. |
W_TTE_DEGENERATE_HAZARD |
warning |
While simulating a time-to-event endpoint with an analytic hazard, a subject drew a non-positive or non-finite effective hazard rate. No event is generated and the subject is censored at the observation window. Under competing risks it is raised for each analytic cause whose draw degenerated when the subject ends censored. A run of several replicates reports each subject and CMT on one line, in population order, with the number of replicates in which the subject ended censored and their sim indices (the first 10); a run with parameter uncertainty names the affected draws instead. Draws are numbered as in the run’s rows, so a skipped draw keeps its number and the count of simulated draws excludes it (#1648). Check the hazard parameters and covariate values. |
W_TTE_SOLVE_FAILED |
warning |
While simulating a time-to-event endpoint with an ODE-accumulated (drug-driven) hazard, the event-time solve failed for a subject: an [odes] state or the cumulative hazard became non-finite, the hazard went negative, or the solver ran out of steps. The message names the subject, the CMT and the solver’s reason. A diverged [odes] state is named by its [odes] name, and a cumulative hazard as “the cumulative hazard” (of another cause: “of CMT=k”). No event time is simulated: the subject is censored at the observation window (every cause, under competing risks) and is not simulated past the failure, so its censoring overstates survival. The rest of the population still simulates. The advice names the block to check: the [odes] right-hand side for a diverged state, the [event_model] hazard expression for a negative hazard, and both otherwise, together with the parameter values, including the drawn random effects. |
Adaptive simulation warnings
Warnings an adaptive simulation (simulate_adaptive(), simulate_adaptive_from_spec()) returns in its warnings, besides the simulation warnings above that apply to it.
W_ADAPTIVE_DECISION_BEFORE_MOVED_RESET |
warning |
An adaptive simulation has a decision point after an EVID=3/4 reset as written, but before that reset on the engine clock. The data reader moves a reset written at or before the end of a running infusion or ADDL train, or at the TIME of the record before it, to just past that point, with every later row (#1609). Decision times are read on the engine clock, so the dose issued at that point lands before the reset and is removed by it. The warning names the subject, the decision times, the reset’s written and engine times, and the shift to add. Silent for a reset whose TIME goes back (a restarting period) and every reset after it, where a written decision time is ambiguous (#2559). |
W_ADAPTIVE_DOSE_ORACLE |
warning |
Under dose_knowledge = oracle, some subjects of an adaptive simulation were dosed from their drawn individual parameters or random effects (#944): a perfect-information comparison arm, since no prescriber has these values. The warning counts those subjects and names each dose key and the value it reads; each one’s metrics row has dose_oracle = true. Silent when no subject was dosed from its drawn values. |
W_ADAPTIVE_STEP_ABSORBED |
warning |
With round_to, the smallest increase N% of an adaptive simulation rounds back to the same dose at a dose some subjects can be at (#2810): the start dose as placed on the grid, or the dose the decrease rules bring it down to. Each time that rule fires there, the dose stays where it is. The warning counts those subjects and names each with its dose (an oracle subject with its replicates), gives the lowest dose the step can raise, and says what to change. A dose at the upper bound is not reported. See Rounding doses to a grid. |
Adaptive dosing
simulate_adaptive() and simulate_adaptive_from_spec() refuse most of these before any subject is simulated. The rest come from the driver once it runs, when they depend on the resolved doses, the break timeline or what the controller returned (#1983).
E_ADAPTIVE_UNSUPPORTED |
error |
A model the adaptive-dosing driver cannot simulate faithfully (no [odes] block, an SDE, a covariate-selected [error_model], a residual correlation line, a log-transformed (LTBS) error model — #2129), refused before any subject is simulated. Once the driver runs (#1983): a base dose under a time-varying covariate or IOV that is not a plain bolus or infusion into a plain compartment, a dose lag or infusion duration that is not finite, or an [odes] right-hand side that reads TAD / TAFD before any dose. The block is the one at fault, when there is one. |
E_ADAPTIVE_OPTIONS |
error |
AdaptiveSimulateOptions with no usable schedule (decision_times empty, not finite, not strictly increasing, or longer than max_decisions), a monitor on a compartment the model does not have, a Dv monitor on a compartment no [error_model] covers, or decision_times / monitors set alongside an [adaptive_dosing] spec that owns them. These are refused before any subject is simulated. Once the driver runs (#1983): two of a subject’s times (decision, observation, EVID=2, reset or base-dose) within 1e-15 of each other without being equal, which the driver cannot tell apart. |
E_ADAPTIVE_CONTROLLER_ACTION |
error |
The controller returned an action the driver refuses (#1983): a dose into compartment 0 or one past the model’s states, an amount that is negative or not finite, an infusion rate that is not positive and finite, a dose into a compartment fed by a built-in input-rate function or carrying a lag, or a Stop followed by another action. The controller is the caller’s code, so this is a refusal of the input, although only a simulation can reach it. On simulate_adaptive_from_spec() the controller is compiled from the spec’s route, so the same refusal is E_ADAPTIVE_SPEC there. A non-finite amount computed from a diverged ODE state is not this code: the driver refuses a non-finite state, or a monitor that reads a non-finite value, before the controller runs, as an uncoded runtime error naming the states or the monitor (#1578). |
E_ADAPTIVE_SPEC |
error |
An [adaptive_dosing] spec that does not compile against the model: an invariant the block parser checks (on a spec built in code), an assay_cmt out of range or with no [error_model] to draw the assay from, a route compartment out of range or fed by a built-in input-rate function, or an observe expression that does not compile. On a spec built in code, a dose expression (start_dose, dose_bounds, levels) that reads a state, TIME, an individual parameter, a random effect, a κ or MIXNUM (#944); in a model file these are parse errors. Once the driver runs, a route dose it refuses, such as one into a compartment with a dose lag. Block adaptive_dosing. |
Per-subject values
These concern one subject: its dose values, or the η supplied for it.
E_ADAPTIVE_DOSE_VALUE |
error |
An [adaptive_dosing] dose expression whose value for one subject breaks a dose invariant (#944): not finite or negative, bounds with low > high, a start dose outside the bounds or not one of the levels, a rung outside the bounds, a ladder that does not increase, no multiple of round_to within the bounds, or a low bound of 0 with round_to under percentage steps. Every subject is checked before any is simulated, except a subject dosed from its drawn values under dose_knowledge = oracle, which is checked in each replicate after its draw. The message names the first subject that fails (and, for an oracle subject, the replicate), the expression, its value and the covariate and individual values it read. Block adaptive_dosing. Raised by simulate_adaptive_from_spec. |
E_ADAPTIVE_DOSE_KNOWLEDGE |
error |
An [adaptive_dosing] dose expression reads a subject’s individual parameter or random effect, and some subjects’ η are drawn by the simulation, under dose_knowledge = known (the default) (#944). A drawn subject’s individual values are the simulated truth, which no prescriber knows at dosing time. The message names the key and the value read, lists the drawn subjects (never a supplied one), and names the three routes: a data column carrying the known value, supplied η, or dose_knowledge = oracle. Checked before any subject is simulated. Block adaptive_dosing. Raised by simulate_adaptive_from_spec. |
E_SUPPLIED_ETAS |
error |
Per-subject η supplied to an adaptive run, or to predict_survival_at_etas_diag, that cannot be used as given (#1594, #1885). From SuppliedEtas::from_table or from_fit: IDs and rows that differ in count, a row that is not one finite value per named η, a repeated subject ID, or a fit whose η names are not the model’s. From simulate_adaptive_with_inputs / simulate_adaptive_from_spec_with_inputs, before any subject runs: a [mixture] model (the run draws each subject’s mixture class, so a fit’s η̂ could be simulated under another class), η names that are not the model’s in the model’s order, or a simulated subject with no supplied η under UnmatchedSubjects::Refuse (the default), listing up to ten IDs. From predict_survival_at_etas_diag, after predict_survival_diag’s checks: the same three, except that a subject with no supplied η is always refused. See Supplied individual values and Individual survival curves at the EBEs. |
An [adaptive_dosing] observe or dose-expression covariate the data lack reuses E_MISSING_COVARIATE (block adaptive_dosing), the code ferx check gives a model covariate missing from the data.
Post-hoc steps on a fit
run_sir() and run_covariance() take a fit, and refuse one whose inputs they cannot recover or verify (#1774). ferx check has no fit, so it raises none of these. simulate_with_uncertainty() also rebuilds a fit’s parameters, and refuses a [mixture] fit’s override values with the same two codes. It draws from the fit’s covariance matrix (asymptotic method) or its kept SIR resamples, and refuses one the fit does not carry, or an empty pool, as E_FIT_INPUT_MISSING, and one that is not the size of the model’s packed parameters as E_FIT_INPUT_MODEL (#2044).
E_FIT_INPUT_MISSING |
error |
An input the step needs was neither passed nor recorded on the fit: the model file’s path (no model passed), the data file’s path (no population passed), SIR’s covariance matrix, the population of an IOV model passed as a model on a fit that records no reader settings, the occasion rule of an IOV fit saved before ferx recorded one, on a population that carries no occasion labels, or the fitted values of a [mixture] fit’s per-class overrides, on a fit that records neither them (mixture_overrides) nor a packed estimate holding them. |
E_FIT_INPUT_CHANGED |
error |
The model or data file the step re-reads no longer has the SHA-256 the fit recorded. |
E_FIT_INPUT_MODEL |
error |
The model the step would run on is not the one the fit was made with: a model passed in bound with other data-derived bindings than the fit’s, a model passed in whose covariate statistics the population does not reproduce (on a fit that records no bindings), a model whose η count is not the width of the fit’s per-subject η̂, a [mixture] fit whose recorded override values are malformed, or which records none and whose packed estimate has another layout or no longer reproduces its reported estimates, or a covariance matrix that is not the size of the model’s packed parameters. |
E_SIR_OPTIONS |
error |
SIR settings run_sir() cannot run with: sir_resamples above sir_samples, a sir_df that is not a valid Student-t degrees of freedom, or sir_scale = natural on a model with prior(...). A sir_df below 1 is refused as [fit_options] refuses it, and is refused by fit() and ferx check up front whenever sir = true or covariance_fallback = sir (#1770); otherwise fit() with sir = true reports the same text as a SIR failed: warning instead. |
E_SIR_NOTHING_TO_SAMPLE |
error |
every estimated parameter of the fit is FIX (θ, Ω and σ, and Ω_IOV, block_sigma correlations and [mixture] overrides where the model has them), so run_sir() has nothing to sample. Block parameters. fit() with sir = true reports the same text as a SIR failed: warning instead. |
E_ODE_SOLVER_OPTIONS |
error |
ODE solver settings on a FitOptions built in code that no solver can run with: an ode_reltol or ode_abstol that is not finite and positive, ode_max_steps = 0 (#2044), or ode_stiff_abort_after = Some(0), which [fit_options] spells as off (#1770). Refused on an analytic model too, since every fit records these settings. Raised by fit(), run_sir() and run_covariance(); run_sir_core() returns the same text as a String. A model file’s [fit_options] never gets this far: the parser refuses the same values as E_PARSE. |
E_LOGIT_THETA_OUT_OF_RANGE |
error |
A free θ used as inv_logit(logit(θ) + ETA) whose estimate is not strictly inside (0, 1), so it has no logit-scale draw (#2044). Only a declared upper bound above 1 lets the estimate get there; the suggestion is to declare one below 1 and refit. Block parameters. Raised by simulate_with_uncertainty() with the asymptotic method and by run_sir(). Its to_string() ends with the suggestion; run_sir_core() returns that text as a String, and fit() with sir = true reports it as a SIR failed: warning. |
The θ count and the Ω, σ and ΩIOV shape of a fit against the model are E_THETA_LENGTH and E_PARAM_SHAPE, the codes every entry point gives a parameter vector of the wrong shape. A population that is not the fit’s is E_POPULATION_MISMATCH, or E_FIT_SUBJECTS_MISMATCH when the fit’s per-subject rows are what is wrong.
When the step re-reads the model or data file, a failure is the one ferx check reports on the same file, with the same code and block: E_MODEL_READ, the parse codes, E_DATA, E_MISSING_COVARIATE, E_COVARIATE_NOT_NUMERIC, and E_PARSE on data_selection for a recorded selection clause that no longer compiles. The message is the read’s own: an E_DATA refusal has no Failed to read data file lead.
The population a step runs on
E_POPULATION_MISMATCH |
error |
A population handed to, or re-read by, a post-hoc step is not the one the fit was given (#1685): another subject list, other covariate columns, or a subject whose records, doses or covariate values differ. Raised by run_sir, run_covariance and PopulationFingerprint::verify; the message names what differs. Pre-empted by E_ENDPOINT_UNROUTED and E_THETA_LEVELS_DATA_UNBOUND, whose fix is a reader or a binder. |
E_FIT_SUBJECTS_MISMATCH |
error |
The population matches the fit’s fingerprint, but the fit’s per-subject results (fit.subjects), which run_sir / run_covariance read by position, are another count or another order (#1868). Reachable when a front end rebuilds a fit from separate fields; a fit() result carries both from one population. Without a current fingerprint the same mismatch is E_POPULATION_MISMATCH. |