dannycao4079 / fdmr

The 4DModeller R package, fdmr

4DModeller

4DModeller is a spatio-temporal modelling package that can be applied to problems at any scale from micro to processes that operate at a global scale. It includes data visualization tools, finite element mesh building tools, Bayesian hierarchical modelling based on Bayesian inference packages INLA and inlabru, and model evaluation and assessment tools.

Why should I use 4DModeller?

4DModeller has been designed to make it easy to design spatially distributed, temporally dependent statistical models. Typically, 4DModeller expects tabular data sets with spatial coordinates, time indices, and the values that change or remain constant over those times. It is designed to be used in the modelling process once data has been sufficiently organized from wherever it was gathered from.

4DModeller has a stack of tools that include Shiny apps, tutorials as vignettes in R Markdown notebooks, and the package itself. These tools are designed to help you:

- easily build finite element meshes that models can be calculated on

- specify priors for the model to pick the best model hyperparameters

- evaluate the fully trained model output

Quickstart

To get the 4DModeller R package fdmr installed first you need to make sure you have a recent version of R installed. The easiest way to do this is to install RStudio.

Next start an R session and run

install.packages("devtools")
library(devtools)
devtools::install_github("4DModeller/fdmr")

You should now have fdmr and all its dependencies installed and you can continue on one of our tutorials.

Installation

On most systems the commands above should get you up and running. On some Linux systems we've found the need to install some additional libraries before fdmr's dependencies can be installed.

Ubuntu 20.04

Using a fresh Ubuntu 20.04 install we found we needed to install the C and C++ compilers and some additional libraries. To install GCC, the GNU Compiler Collection and related tools run

sudo apt-get install build-essential

Then install the libraries required by our dependencies

sudo apt-get install libharfbuzz-dev libfribidi-dev libfreetype6-dev \
                        libpng-dev libtiff5-dev libjpeg-dev libudunits2-dev libgdal-dev

Note that on other Linux distributions the names of these packages may differ.