View source: R/FUN_model_specification.R
| parameter | R Documentation |
Declares a named parameter in a model formula expression. Parameter random effects are added before applying the inverse parameter link. A log-linked rate is therefore positive, independently of the response family's link.
parameter(fixed = ~1, random = NULL, link = "identity")
fixed |
A one-sided fixed coefficient regression, for example |
random |
A one-sided covariance formula using the common |
link |
|
Nonlinear specification models require maximum likelihood. Gaussian identity
models with only additive random effects use exact integration; parameter
random effects and non-Gaussian random effects use conditional-mode Laplace
integration with numerical outer scores, symbolic expression chain rules and
full native family conditional curvature. This bounded dense reference
implementation reuses native Gaussian identity, grouped-binomial
logit/probit/cloglog, Poisson, NB2, ZIP and Gamma-log likelihoods, ordinal
logit/probit, reference-category multinomial, and familym() mixtures.
It supports
independent residuals (rcov=NULL or rcov=~units),
up to 60 mean coefficients, and up to 512 random
coefficients for Laplace integration. It never adds artificial random effects
or regularizes a covariance.
Outer optimization uses nlminb; conditional modes use numerical BFGS.
Numerical conditional scores must meet the requested mode tolerance;
step tolerances detect stalled mode refinement. Non-default solver/update
modules, weights, custom contrasts, covariance constraints and reduced-rank
covariance are explicitly unsupported. familyParameters fixes or
estimates native family nuisances; ordinal thresholds use ordered coordinates.
Separate parameter random records remain independent, even when they share
grouping-factor names. Automatic or central outer gradients are numerical; an explicit
analytic-gradient request is rejected. Iteration limits, convergence
tolerances, and population quadrature controls are supported. Set
mmes_control(optimizer=list(scoreTol=...)) to change the outer
score convergence certificate; its default is 0.001.
Existing scalar expression links outside the native registry retain
their reference semantics through a chain-rule adapter to the native
canonical density. This compatibility does not enable those links for
mixed-family layouts. Ordinary fixed-only lm/glm
models retain their supported links.
Expressions support arithmetic, powers, exp, log, tanh,
sqrt, sin, and cos; data inputs must be finite numeric
columns. Ordinary additive formula terms retain standard R formula semantics.
Unused declarations are errors. The naMethodX, naMethodY,
naMethodRandom, and naMethodR policies accept "exclude"
or "fail". A shared complete-observation mask is applied across the
response, expression inputs, regressions, and random grouping columns.
Fitted values and residuals use the retained rows, recorded in obsInfo.
Natural starts such as start=c(a=3,k=1) initialize parameter intercepts;
other parameter regression coefficients start at zero. Alternatively use
start=list(parameters=c(a=3,k=1)). Regressions without an intercept
require start=list(coefficients=...) containing every mean coefficient.
Those names are fixed:(Intercept), a:(Intercept), or
k:EnvB, and values are on coefficient/link scales.
Prediction distinguishes conditional, zero-random-effect, and population
targets, on response or link scales. Population prediction uses adaptive
Gaussian quadrature over the joint predictor covariance, with dimension and
cost admission against the memory budget. Unknown random levels are rejected for conditional and population
prediction. Coefficient covariance is computed only when vcov() is
requested and requires a stationary converged interior fit, stable numerical
derivatives and identified positive observed curvature.
Fitting and ordinary summary do not compute outer parameter uncertainty;
summary(inference=TRUE) requests it explicitly. Conditional covariance
and estimated-parameter empirical Bayes PEV are reported separately and are
not exact frequentist PEVs. Regression coefficients remain on coefficient
scales; coef(type="group") returns natural parameter values per retained
predictor row. Confidence and prediction intervals are local normal
approximations; categorical outputs admit confidence intervals only.
Simulation accepts target="conditional", "zero", or
"population"; population simulation draws independent declared prior
blocks before applying parameter links. Binomial predictions and simulations
return proportions using the declared trials. Seeds are restored after seeded calls.
Categorical parameter regressions may use .familyCoordinate; nominal
rows follow the declared reference category and preserve full block curvature.
A sommer_parameter declaration, not a fitted model.
curve_term, vsm
parameters <- list(a=parameter(), k=parameter(fixed=~1, link="log"))
parameters$k
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.