Fetch last likelihood trajectories

Fetch the last trajectories created by running a likelihood. This errors if the last call to dust_likelihood_run did not use save_trajectories = TRUE. We return the states and groups that were run via the index_state and index_group arguments to dust_likelihood_run.

Usage

dust_likelihood_last_trajectories(obj, select_random_particle = FALSE)

Arguments

obj

A dust_filter object, created by dust_filter_create or a dust_unfilter object created by dust_unfilter_create

select_random_particle

Logical, indicating if we should return a history for one randomly selected particle (rather than the entire set of trajectories over all particles). If this is TRUE, the particle will be selected independently for each group, if the object is grouped. This option is intended to help select a representative trajectory during an MCMC. When TRUE, we drop the particle dimension of the return value.

Value

An array. If ungrouped this will have dimensions state x particle x time, and if grouped then state x particle x group x time. If select_random_particle = TRUE, the second (particle) dimension will be dropped.