From a6c8d0022494a71707eb16c10b00b3ad88e7dcd3 Mon Sep 17 00:00:00 2001 From: John Aiken Date: Mon, 15 Jul 2024 11:46:16 +0200 Subject: [PATCH] updated errors in draft --- man/paper.bib | 60 ++++++++++++++++++++++++++++++++++++--------------- man/paper.md | 8 ++++--- 2 files changed, 48 insertions(+), 20 deletions(-) diff --git a/man/paper.bib b/man/paper.bib index 958f9de..355dcbc 100644 --- a/man/paper.bib +++ b/man/paper.bib @@ -1,5 +1,20 @@ +@article{Aiken:2018, + author={{Aiken}, J.M. and {Aiken}, C. and {Cotton}, F.}, + title = "{A Python Library for Teaching Computation to Seismology Students}", + journal = {Seismological Research Letters}, + volume = {89}, + number = {3}, + pages = {1165-1171}, + year = {2018}, + month = {03}, + issn = {0895-0695}, + doi = {10.1785/0220170246}, + url = {https://doi.org/10.1785/0220170246}, + eprint = {https://pubs.geoscienceworld.org/ssa/srl/article-pdf/89/3/1165/4127200/srl-2017246.1.pdf}, +} + @Article{Bachl:2019, - author = {{Bachl}, F.E., {Lindgren}, F., {Borchers}, D.L. and {Illian}, J.B}, + author = {{Bachl}, F.E. and {Lindgren}, F. and {Borchers}, D.L. and {Illian}, J.B}, title = {{inlabru}: an {R} package for {Bayesian} spatial modelling from ecological survey data}, journal = {Methods in Ecology and Evolution}, volume = {10}, @@ -11,16 +26,6 @@ @Article{Bachl:2019 publisher = {British Ecological Society} } -@Misc{Lindgren:2024, - author = {{Lindgren}, F., {Bachl}, F.E., {Borchers}, D.L., {Simpson}, D., {Scott-Howard}, L., {Seaton}, A., {Sue}, M.H., {Roudier}, P., {Meehan}, T., {Peddinenikalva}, N. and {Perepolkin}, D.}, - title = {inlabru}, - year = {2024}, - month = {}, - journal = {GitHub repository}, - url = {https://inlabru-org.github.io/inlabru}, - publisher = {GitHub} -} - @Online{CORDIS:2024, author = {{CORDIS}}, title = {Global land ice, hydrology and ocean mass trends | GlobalMass}, @@ -35,8 +40,18 @@ @Online{CORDIS:2024 urldate = {2024-05-17} } +@Misc{Lindgren:2024, + author = {{Lindgren}, F. and {Bachl}, F.E. and {Borchers}, D.L. and {Simpson}, D. and {Scott-Howard}, L. and {Seaton}, A. and {Sue}, M.H. and {Roudier}, P. and {Meehan}, T. and {Peddinenikalva}, N. and {Perepolkin}, D.}, + title = {inlabru}, + year = {2024}, + month = {}, + journal = {GitHub repository}, + url = {https://inlabru-org.github.io/inlabru}, + publisher = {GitHub} +} + @Article{Rue:2009, - author = {{Rue}, H., {Martino}, S. and {Chopin}, N.}, + author = {{Rue}, H. and {Martino}, S. and {Chopin}, N.}, title = {Approximate Bayesian inference for latent Gaussian models by using integrated nested Laplace approximations}, journal = {Journal of the Royal Statistical Society: Series B (Statistical Methodology)}, volume = {71}, @@ -48,8 +63,17 @@ @Article{Rue:2009 url = {https://doi.org/10.1111/j.1467-9868.2008.00700.x}, } +@book{Vygotsky:1978, + author = {{Vygotsky}, L.S.}, + title = {Mind in Society: Development of Higher Psychological Processes}, + year = {1978} + Isbn = {9780674576285}, + url = {http://www.jstor.org/stable/j.ctvjf9vz4}, + publisher = {Harvard University Press}, +} + @Article{Woods:2022, - author = {{Woods}, C., {Hedges}, L., {Edsall}, C., {Brooks-Pollock}, E., {Parton-Fenton}, C., {McKinley}, T.J., {Keeling}, M.J. and {Danon}, L.}, + author = {{Woods}, C. and {Hedges}, L. and {Edsall}, C. and {Brooks-Pollock}, E. and {Parton-Fenton}, C. and {McKinley}, T.J. and {Keeling}, M.J. and {Danon}, L.}, title = {MetaWards: A flexible metapopulation framework for modelling disease spread}, journal = {Journal of Open Source Software}, volume = {7}, @@ -57,11 +81,13 @@ @Article{Woods:2022 pages = {3914}, year = {2022}, month = {}, + doi = {10.21105/joss.03914}, + url = {https://doi.org/10.21105/joss.03914}, publisher = {The Open Journal} } @Article{Yin:2023, - author = {{Yin}, X., {Aiken}, J.M. and {Bamber}, J.L.}, + author = {{Yin}, X. and {Aiken}, J.M. and {Bamber}, J.L.}, title = {{4DModeller (fdmr): A Comprehensive R Package for Spatio-Temporal Modelling}}, journal = {Spatial Data Science Symposium 2023 Short Paper Proceedings}, volume = {}, @@ -75,7 +101,7 @@ @Article{Yin:2023 } @Article{Yin:2024, - author = {{Yin}, X., {Aiken}, J.M., {Harris}, R. and {Bamber}, J.L.}, + author = {{Yin}, X. and {Aiken}, J.M. and {Harris}, R. and {Bamber}, J.L.}, title = {{A Bayesian spatio-temporal model of COVID-19 spread in England}}, journal = {Scientific Reports}, volume = {14}, @@ -89,7 +115,7 @@ @Article{Yin:2024 } @Article{Yuan:2017, - author = {{Yuan}, Y., {Bachl}, F.E., {Lindgren}, F., {Borchers}, D.L., {Illian}, J.B., {Buckland}, S.T., {Rue}, H. and {Gerrodette}, T.}, + author = {{Yuan}, Y. and {Bachl}, F.E. and {Lindgren}, F. and {Borchers}, D.L. and {Illian}, J.B. and {Buckland}, S.T. and {Rue}, H. and {Gerrodette}, T.}, title = {Point process models for spatio-temporal distance sampling data from a large-scale survey of blue whales}, journal = {Ann. Appl. Stat.}, volume = {11}, @@ -103,7 +129,7 @@ @Article{Yuan:2017 } @Article{Ziegler:2022, - author = {{Ziegler}, Y., {Vishwakarma}, B.D., {Brady}, A., {Chuter}, S., {Royston}, S., {Westaway}, R.M. and {Bamber}, J.L.}, + author = {{Ziegler}, Y. and {Vishwakarma}, B.D. and {Brady}, A. and {Chuter}, S. and {Royston}, S. and {Westaway}, R.M. and {Bamber}, J.L.}, title = {Can GPS and GRACE data be used to separate past and present-day surface loading in a data-driven approach?}, journal = {Geophysical Journal International}, volume = {232}, diff --git a/man/paper.md b/man/paper.md index f690e82..744fb77 100644 --- a/man/paper.md +++ b/man/paper.md @@ -44,7 +44,7 @@ bibliography: paper.bib # Summary -4DModeller (`fdmr`) is a spatio-temporal modelling package capable of solving a wide range of large-scale space-time (i.e. four-dimensional) problems [@Yin:2023]. It is built around the inlabru framework which is a suite of R codes for fast efficient Bayesian inference [@Yuan:2017; @Bachl:2019]. The `fdmr` package expands the inlabru framework to include specific applications of latent variable modelling for 4-D geophysical problems (e.g. ocean heat content, the earth’s magnetic field, and global sea-level rise). `fdmr` also includes shiny apps that provide tools for data visualization, finite element mesh building and Bayesian hierarchical modelling based on an R package for Bayesian inference inlabru, along with model evaluation and assessment. These shiny apps are designed to make the complex INLA framework [@Rue:2009] and associated concepts accessible to a wider scientific community, including users who have little to no previous experience using R. The tools are designed with new users in mind by leveraging their expertise with their data sets while minimizing the need to develop extensive code in R [@Aiken:2018; @Vygotsky:1979]. They allow users to interact with their data first using the intuitive knowledge of the modelling process (input data, create mesh, calculate statistical model), then auto-generating code that the users can build on. +4DModeller (`fdmr`) is a spatio-temporal modelling package capable of solving a wide range of large-scale space-time (i.e. four-dimensional) problems [@Yin:2023]. It is built around the inlabru framework which is a suite of R codes for fast efficient Bayesian inference [@Yuan:2017; @Bachl:2019]. The `fdmr` package expands the inlabru framework to include specific applications of latent variable modelling for 4-D geophysical problems (e.g. ocean heat content, the Earth’s magnetic field, and global sea-level rise). `fdmr` also includes shiny apps that provide tools for data visualization, finite element mesh building and Bayesian hierarchical modelling based on an R package for Bayesian inference, inlabru, along with model evaluation and assessment. These shiny apps are designed to make the complex INLA framework [@Rue:2009] and associated concepts accessible to a wider scientific community, including users who have little to no previous experience using R. The tools are designed with new users in mind by leveraging their expertise with their data sets while minimizing the need to develop extensive code in R [@Aiken:2018; @Vygotsky:1979]. They allow users to interact with their data first using the intuitive knowledge of the modelling process (input data, create mesh, calculate statistical model), then auto-generating code that the users can build on. This is extended through the Tutorial Driven Software Development practice [@Woods:2022]. This approach is designed to integrate subject matter experts into the code development cycle. It involves the identification of representative and instructive use cases, followed by tutorials that describe how the package could be used to solve them, and then finally code written and tested so that it behaved as described in the tutorials [@Woods:2022]. `fdmr` users have access to a set of domain-specific tutorials as vignettes in R Markdown notebooks; tutorials which are being added to as the user community grows. @@ -58,7 +58,7 @@ The objective of the `fdmr` package is to provide researchers and practitioners `fdmr` reduces the computational complexity for scientific users of handling high-resolution, high-dimensional spatio-temporal data. Spatio-temporal data analysis is crucial in many research fields. However, modelling large-scale spatio-temporal data presents challenges such as high computational demands, complex correlation structures and the separation of mixed sources. Additionally, it requires expert domain knowledge to interpret model results. 4DModeller has been developed to address these issues; a robust and user-friendly R package designed to model spatio-temporal data within a Bayesian framework (inlabru) but without requiring users to have an in-depth knowledge of Bayesian statistics. Users have access to different solvers through the inlabru framework, such as the Integrated Nested Laplace Approximation (INLA) solver for approximate Bayesian inference and the stochastic partial differential equations (SPDE) method for defining a spatial model. Furthermore, `fdmr` provides intuitive and interactive visual analytics tools that facilitate the exploration of data patterns across both space and time. The goal is that `fdmr` will allow such tools to be used for process modelling (via Gaussian and Poisson processes) and for tasks such as latent process source separation [e.g. @Ziegler:2022] which both complements – and distinguishes it – from the existing example applications of inlabru [@Lindgren:2024]. -The work undertaken for 4DModeller extends the Bayesian hierarchical model developed as part of the ERC-funded GlobalMass grant (www.globalmass.eu) that advanced the use of space-time statistical inference to separate global sea level rise into its different sources [@CORDIS:2024]. The `fdmr` package has since been applied to several other use cases including COVID-19 transmission in England [@Yin:2024], streamflow in hydropower catchments in Norway, extreme rainfall in Nepal, estimating changes in the earth’s magnetic field and ocean heat content in the Pacific. +The work undertaken for 4DModeller extends the Bayesian hierarchical model developed as part of the ERC-funded GlobalMass grant (www.globalmass.eu) that advanced the use of space-time statistical inference to separate global sea level rise into its different sources [@CORDIS:2024]. The `fdmr` package has since been applied to several other use cases including COVID-19 transmission in England [@Yin:2024], streamflow in hydropower catchments in Norway, extreme rainfall in Nepal, changes in the Earth’s magnetic field and ocean heat content in the Pacific. # Code Availability @@ -66,4 +66,6 @@ The `fdmr` package and installation instructions are available from the 4DModell # Acknowledgements -This work was supported by UK Research and Innovation grant EP/X022641/1. JLB was also supported by German Federal Ministry of Education and Research (BMBF) in the framework of the international future AI lab “AI4EO - Artificial Intelligence for Earth Observation: Reasoning, Uncertainties, Ethics, and Beyond” (grant number: 01DD20001). Code and tutorial development were aided by two hackathons (in Oslo in November 2023 and in Bristol in March 2024) which were only made possible by funding from the Research Council of Norway through the Svalbard Science Forum's funding program Svalbard Strategic Grant (project number: 344823). \ No newline at end of file +This work was supported by UK Research and Innovation grant EP/X022641/1. JLB was also supported by German Federal Ministry of Education and Research (BMBF) in the framework of the international future AI lab “AI4EO - Artificial Intelligence for Earth Observation: Reasoning, Uncertainties, Ethics, and Beyond” (grant number: 01DD20001). Code and tutorial development were aided by two hackathons (in Oslo in November 2023 and in Bristol in March 2024) which were only made possible by funding from the Research Council of Norway through the Svalbard Science Forum's funding program Svalbard Strategic Grant (project number: 344823). + +# References \ No newline at end of file