Skip to content

Julia package which implements and explores the Likelihood-based Profile Wise Analysis workflow for uncertainty quantification

License

Notifications You must be signed in to change notification settings

JoelTrent/LikelihoodBasedProfileWiseAnalysis.jl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LikelihoodBasedProfileWiseAnalysis

Stable Dev Build Status Coverage

This package is an implementation and exploration of the likelihood-based Profile-Wise Analysis (PWA) workflow from Matthew Simpson and Oliver Maclaren. It provides methods for:

  • Maximum Likelihood Estimation.
  • Calculation of the observed Fisher information matrix (FIM) and associated approximation of the log-likelihood function.
  • Parameter identifiability analysis.
  • Parameter confidence intervals.
  • Evaluating univariate profiles.
  • Evaluating the boundaries of bivariate profiles and sampling points within these boundaries.
  • Rejection sampling of full parameter vector confidence sets and profiles.
  • Simultaneous prediction of model solutions/trajectories using approximate profile-wise confidence trajectory sets.
  • Simultaneous prediction of population reference sets using approximate profile-wise reference tolerance sets.

Additionally, to assist with evaluating the frequentist coverage properties of intervals and sets within the PWA workflow on new models it provides methods for the coverage testing of:

  • Parameter confidence intervals.
  • Bivariate confidence profiles.
  • Profile-wise confidence trajectory sets.
  • Profile-wise reference tolerance sets.

To understand the background of the workflow and how it can be used see the Motivation section of the documention. For implementation examples see the examples section, such as on a Logistic Model. To better understand how to interact with the user interface and in particular the LikelihoodModel, which holds all the information on computed profiles and predictions, check out the user interface starting with the Initialisation section.

A package developed to fulfil the requirements of a Masters of Engineering at The University of Auckland by Joel Trent between March 2023 and February 2024.

Supervised by Oliver Maclaren, Ruanui Nicholson and Matthew Simpson.

Getting Started: Installation

To install the package, use the following command inside the Julia REPL. In the future this will be able to be installed directly rather than via the url.

using Pkg
Pkg.add(url="https://github.com/JoelTrent/LikelihoodBasedProfileWiseAnalysis.jl")

To load the package, use the command:

using LikelihoodBasedProfileWiseAnalysis

Alternatives for Likelihood-Based Uncertainty Quantification

If you are solely interested in parameter identifiability analysis and computing parameter confidence intervals we recommend LikelihoodProfiler, which is generally more stable and faster than the implementation in this package on the models we've tested.

ProfileLikelihood is another excellent package which implements the PWA workflow from Simpson and Maclaren - it has a different interface and its own set of heuristics for computing profiles. Prediction of population reference sets was introduced into the PWA workflow in my 2024 Masters Thesis and is not present in that package.

InformationGeometry can compute the exact confidence regions/boundaries of models using differential geometry. It would be an interesting approach which could potentially evaluate confidence set boundaries more efficiently than the heuristics implemented in this package. Resultantly, its use within the PWA workflow may be worth investigating.

Releases

No releases published

Packages

No packages published

Languages