NEWS

Two new functions answering yes/no questions of calibrators.
- mp_opt_attempted
- mp_uncertainty_estimated
Check if covariance matrix is singular before simulating and give a more informative error message -- uses the check in MASS::rmvnorm.

Bug Fixes

mp_version wasn't dispatching on simulators.

macpan2 2.6.1

Released [2025-07-09]

source | change list

Behaviour Changes

Stop exporting some developer utilities: make_expr_parser, finalizer_char, finalizer_index, initial_valid_vars.

New Features

Option in mp_tmb_calibrator to return optimized version of a calibrator, rather than needing to use mp_optimize.
New si_example_object function that efficiently generates objects associated with the example SI model, and associated si_example_code function that displays code that could be used to generate these objects.
Uniform priors no longer add -0 terms to the objective function.

macpan2 2.6.0

Released [2025-07-07]

source | change list

New Features

Engine function cumsum.
Warning message when checking for macpan2 version mismatch when macpan2 is loaded but not installed.

macpan2 2.5.0

Released [2025-06-27]

source | change list

New Features

Code of conduct.

macpan2 2.4.1

Released [2025-06-21]

source | change list

Bug Fixes

#326

macpan2 2.4.0

Released [2025-06-16]

source | change list

Bug Fixes

macpan2 2.3.4

Released [2025-06-12]

source | change list

Bug Fixes

Default clamping parameters now ensure that the clamp engine function is twice-differentiable.
Minor enhancements to the docs and handling of mp_version_update and mp_read_rds.

macpan2 2.3.3

Released [2025-06-04]

source | change list

Bug Fixes

Fix regression bug causing mp_absolute_flow to fail.

macpan2 2.3.2

Released [2025-06-03]

source | change list

Bug Fixes

Fix bug in absolute flows and test.

macpan2 2.3.1

Released [2025-06-02]

source | change list

macpan2 2.3.0

Released [2025-06-02]

source | change list

New Features

Absolute flows in model specifications are no longer experimental.

macpan2 2.2.2

Released [2025-06-02]

source | change list

This version patched 2.2.1, which was released in a broken state.

New Features

Build Tools

Avoid source code compilation during roxygen steps, because these steps use low optimization level and therefore results in slower simulations.

macpan2 2.2.0

Released [2025-05-27]

source | change list

macpan2 2.1.0

Released [2025-05-23]

source | change list

New Features

mp_version
mp_inflow (experimental)
mp_outflow (experimental)

Build Tools

Refresh NEWS.md generation tools.

macpan2 2.0.1

Released [2025-05-21]

source | change list

New Features

mp_log1p

macpan2 2.0.0

Released [2025-05-16]

source | change list

Behaviour Changes

macpan2 1.17.0

Released [2025-05-15]

source | change list

New Features

More robust handling of C++ log files, even if simulators are loaded from disk to a file system that does not have (or no longer has) the expected path to the log file.

macpan2 1.16.13

Released [2025-05-15]

source | change list

macpan2 1.16.12

Released [2025-04-17]

source | change list

macpan2 1.16.11

Released [2025-04-09]

source | change list

New Features

Transform parameters when making a calibration by prefixing parameter names with the name of the transformation (e.g., log_beta instead of beta).

macpan2 1.16.10

Released [2025-04-06]

source | change list

macpan2 1.16.9

Released [2025-04-04]

source | change list

macpan2 1.16.8

Released [2025-04-04]

source | change list

macpan2 1.16.7

Released [2025-03-31]

source | change list

macpan2 1.16.6

Released [2025-03-24]

source | change list

macpan2 1.16.5

Released [2025-03-23]

source | change list

macpan2 1.16.4

Released [2025-03-21]

source | change list

macpan2 1.16.3

Released [2025-03-20]

source | change list

macpan2 1.16.2

Released [2025-03-20]

source | change list

macpan2 1.16.1

Released [2025-03-20]

source | change list

macpan2 1.16.0

Released [2025-03-19]

source | change list

macpan2 1.15.3

Released [2025-03-20]

source | change list

macpan2 1.15.2

Released [2025-03-11]

source | change list

macpan2 1.15.1

Released [2025-03-11]

source | change list

macpan2 1.15.0

Released [2025-03-03]

source | change list

macpan2 1.14.4

Released [2025-03-02]

source | change list

macpan2 1.14.3

Released [2025-02-20]

source | change list

macpan2 1.14.2

Released [2025-02-19]

source | change list

macpan2 1.14.1

Released [2025-01-29]

source | change list

macpan2 1.14.0

Released [2025-01-29]

source | change list

macpan2 1.13.0

Released [2025-01-13]

source | change list

macpan2 1.12.0

Released [2024-12-30]

source | change list

macpan2 1.11.1

Released [2024-11-27]

source | change list

macpan2 1.11.0

Released [2024-11-15]

source | change list

macpan2 1.10.0

Released [2024-11-06]

source | change list

macpan2 1.9.1

Released [2024-10-11]

source | change list

macpan2 1.9.0

Released [2024-10-08]

source | change list

macpan2 1.8.1

Released [2024-10-05]

source | change list

macpan2 1.8.0

Released [2024-09-27]

source | change list

macpan2 1.7.2

Released [2024-09-25]

source | change list

macpan2 1.7.1

Released [2024-09-10]

source | change list

macpan2 1.7.0

Released [2024-08-29]

source | change list

macpan2 1.6.1

Released [2024-08-28]

source | change list

macpan2 1.6.0

Released [2024-08-27]

source | change list

macpan2 1.5.6

Released [2024-08-20]

source | change list

macpan2 1.5.5

Released [2024-06-23]

source | change list

macpan2 1.5.4

Released [2024-06-19]

source | change list

macpan2 1.5.3

Released [2024-06-17]

source | change list

macpan2 1.5.2

Released [2024-06-10]

source | change list

macpan2 1.5.1

Released [2024-06-12]

source | change list

macpan2 1.5.0

Released [2024-05-30]

source | change list

New Features

Delete elements from model specifications with mp_tmb_delete.

macpan2 1.4.1

Released [2024-05-16]

source | change list

macpan2 1.4.0

Released [2024-04-25]

source | change list

Behaviour Changes

Repeated calls of an optimizer now start from the previous best parameter vector
No longer fit full covariance matrix in sdreports

Bug Fixes

Row vectors with names no longer break spec print methods

macpan2 1.3.3

Released [2024-04-18]

source | change list

macpan2 1.3.2

Released [2024-04-08]

source | change list

macpan2 1.3.1

Released [2024-03-12]

source | change list

Behaviour Changes

Removing in-place modifications to model specification objects in mp_tmb_insert and mp_tmb_update.

New Features

Define explicit state variable updates, with the choice of applying mp_euler, mp_rk4, or mp_euler_multinomial update methods, the latter generating process error.
New stochasticity engine functions rbinom and reulermultinom.
mp_tmb_fixef_cov function for getting the covariance matrix of fixed effects.
mp_trajectory_ensemble and mp_trajectory_sim functions for summarizing random variation in trajectories.
Unpacking assignment in the engine. This means that you can do things like c(x, y) ~ z, where the values in z are assigned to elements in x, y, etc... in row-major order.
to_name_pairs function for returning all pairwise dot-concatenations of the elements of a character vector without dots.
to_values function for extracting the column from a data frame with only a single numerical column and turning numeric matrices and arrays with dimnames into a flattened numeric vector with labels produced by appropriately dot-concatenating the dimnames.

Bug Fixes

Several bugs related to input handling in mp_tmb_calibrator (#176).

Doc Fixes and Updates

New installation instructions for installing from r-universe.
New vignette: real_data.
Document to_name, to_names, to_labels, which handle naming of structured objects.
Document print function in the ?engine_functions.
simple_sims example in ?engine_functions now runs without error.
Help file examples for mp_tmb_insert and mp_tmb_update.
Readme/vignette examples better expose calls to library for the user.

macpan2 1.3.0

Released [2024-03-11]

source | change list

macpan2 1.2.1

Released [2024-03-05]

source | change list

macpan2 1.2.0

Released [2024-03-11]

source | change list

macpan2 1.1.3

Released [2024-03-01]

source | change list

macpan2 1.1.2

Released [2024-02-26]

source | change list

macpan2 1.1.1

Released [2024-02-25]

source | change list

macpan2 1.1.0

Released [2024-02-23]

source | change list

Behaviour Changes

simple_sims no longer returns outputs for the zeroth time-step.
Using last.par.best to finalize the TMB objective function following optimization.
group_sums now checks for bad group indexes.
rbind_lag now throws an error when lag > 1 because there are conceptual errors with this case. We will get back to this when we can to allow these important cases by adding an argument with initial conditions associated with negative time steps.

New Features

Streamlined installation via r-universe.
mp_tmb_calibrator and mp_tmb_optimize functions for calibration using a simple and restrictive trajectory matching model. Future releases will allow more functionality.
mp_tmb_coef and mp_tmbstan_coef for tables of statistical parameters used in calibration.
mp_trajectory_sd and mp_trajectory_ensemble for getting information about fitted trajectory uncertainty.
mp_tmb_update|insert functions for creating new model specs from existing ones.
Parameters specified as a data frame can now place default values in columns with any of the following names: "default", "Default", "value", "Value", "val", "Val"
mp_tmb_library can return a list of model specs with alternative_specs, if the model makes alternatives available.
time_var engine function is better than the old time_group, which required two expressions rather than one to do the same thing. time_group will remain but is softly deprecated.
Fixed effects extractor and formatter.
mp_default function for extracting spec and simulator defaults in long-format.
rbind_time allows integer vectors for subsetting times
options(macpan2_verbose = FALSE) will turn off the flood of information provided by TMB. Note that this only takes effect if set before creating a TMB simulator.

Bug Fixes

Segfaults for out-of-range assignment.

Doc Fixes and Updates

(in progress) Calibration vignette is updated to be a simpler quick-start, and previous advanced material is moved to an advanced vignette.
mp_tmb_model_spec documentation is filled out.
group_sums TMB engine function third argument updated from old pre-1.0.0 behaviour.

macpan2 1.0.2

Released [2024-02-20]

source | change list

macpan2 1.0.1

Released [2024-02-20]

source | change list

macpan2 1.0.0

Released [2024-02-18]

source | change list

Behaviour Changes

No more flows.csv, derivations.json files in the library, and instead tmb.R files.
No more Compartmental function, and instead mp_tmb_model_spec and mp_tmb_library.
{group|row|col}Sums are now called {group|row|col}_sums.
Final argument of group_sums used to be the length of the output vector, but now it is a vector of the desired output length.
TMBModel and associated classes (ExprList) are no longer exported, in favour of mp_... functions for doing similar things.
Sort simulation output by time step.

New Features

Constant integer vectors can now be passed to C++.
Integer vectors can be used to subset assignment matrices (i.e. integer subsetting on the left-hand-side).
mp_trajectory() function, which is roughly equivalent to model$report(..., .phases = "during").
New print function in the TMB engine.
No need to declare empty matrices when creating TMB model objects, and matrices that are derived are automatically detected.

Experimental Features

Model structure grammar (mp_index(), mp_join(), etc.)
Log files

macpan2 0.0.4

Released [2024-01-18]

source | change list

macpan2 0.0.3

Released [2023-10-25]

source | change list

Optimize C++ simulation history storage by avoiding unnecessary allocations
Use state and flow names in expression inserters
Chattier validity checking
Radial basis functions
New starter models (thanks @mayaearn and @Flynn-Primrose )
- macpan-base -- re-implementation of the McMaster group's COVID-19 model in macpan2
- ww -- wastewater model (doesn't yet have a readme)
- new readme for and clean up of previous models
Report what expression broke on the C++ side
Developer tools for switching between different C++ files and working directories
Package reference organization cleanup (thanks @bbolker )
Time-varying parameters vignette

macpan2 0.0.2

Released [2023-06-06]

source | change list

Interface for optimization of TMB simulation objects
TMB simulation model updating with caching
Parameter transformations
Get initial values of matrices in TMB simulation objects
State and flow variable names can be used in expressions in some contexts
Example model indexing (thank you @bbolker!)
Engine function rbind_time defaults to row binding the full simulation history
Fix bug when the entire model has no inflows or no outflows
Fix bugs in symbolic R-side manipulation of expressions
Fix previously broken argument_dots option in model definition files (thank you @Flynn-Primrose )

macpan2 0.0.1

Released [2023-05-26]

source | change list

Initial release.