-
Notifications
You must be signed in to change notification settings - Fork 6
/
README.Rmd
81 lines (50 loc) · 4.76 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
---
title: CroptimizR
output:
github_document:
html_preview: true
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r setup, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
options(tibble.print_min = 5, tibble.print_max = 5)
```
# CroptimizR: A Package to estimate parameters of Crop Models
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![R build status](https://github.com/SticsRPacks/CroptimizR/workflows/R-CMD-check/badge.svg)](https://github.com/SticsRPacks/CroptimizR/actions)
[![Codecov test coverage](https://codecov.io/gh/SticsRPacks/CroptimizR/branch/master/graph/badge.svg)](https://codecov.io/gh/SticsRPacks/CroptimizR?branch=master)
[![DOI](https://zenodo.org/badge/187874725.svg)](https://zenodo.org/badge/latestdoi/187874725)
The purpose of CroptimizR is to provide functions for estimating crop model parameters from observations of their simulated variables, a process often referred to as calibration. For that, it offers a generic framework for linking crop models with up-to-date and ad-hoc algorithms, as well as a choice of goodness-of-fit criteria and additional features adapted to the problem of crop model calibration. It facilitates the comparison of different types of methods on different models. It is used in this context in the [AgMIP Calibration project](https://agmip.org/crop-model-calibration-3/) on a dozen of crop models.
The [Get started page](https://sticsrpacks.github.io/CroptimizR/articles/CroptimizR.html) describes the main concepts and features of the package and details how to connect its own crop model to CroptimizR.
The list of functions accessible to the users is provided in the [Reference](https://sticsrpacks.github.io/CroptimizR/reference/index.html) tab.
**The package is still under active development, feel free to fill an issue or request a feature [here](https://github.com/SticsRPacks/CroptimizR/issues) at any time.**
If you want to be notified when a new release of this package is made, you can tick the Releases box in the "Watch / Unwatch => Custom" menu at the top right of [this page](https://github.com/SticsRPacks/CroptimizR).
## Installation
Before installing the package, it is recommended to update all already installed R packages. This can be done using the command `update.packages()` or clicking on the Update button of the Packages panel of Rstudio.
The latest released version of the package can be installed from [GitHub](https://github.com/) using:
``` r
devtools::install_github("SticsRPacks/CroptimizR@*release")
```
Or using the lightweight [remotes](https://github.com/r-lib/remotes#readme) package:
``` r
# install.packages("remotes")
remotes::install_github("SticsRPacks/CroptimizR@*release")
```
## Examples
* A simple introductory example of model calibration using the Nelder-Mead simplex method on the STICS model is given in this [vignette](https://SticsRPacks.github.io/CroptimizR/articles/Parameter_estimation_simple_case.html).
* A more complex one with simultaneous estimation of specific and varietal plant parameters is given [here](https://SticsRPacks.github.io/CroptimizR/articles/Parameter_estimation_Specific_and_Varietal.html).
* An example of application of the AgMIP phase III protocol, designed to calibrate phenology of crop models, as described in detail in Wallach et al (2022), is given [here](https://SticsRPacks.github.io/CroptimizR/articles/AgMIP_Calibration_Phenology_protocol.html).
* An example using the ApsimX model is detailed [here](https://SticsRPacks.github.io/CroptimizR/articles/ApsimX_parameter_estimation_simple_case.html).
* An example using the DREAM-zs Bayesian algorithm is detailed [here](https://SticsRPacks.github.io/CroptimizR/articles/Parameter_estimation_DREAM.html).
See [here](https://sticsrpacks.github.io/CroptimizR/reference/estim_param.html) for a detailed description of the input and output arguments of the estim_param function (or type `? estim_param` in an R console after having installed and loaded the CroptimizR package).
## Getting help
If you have any question or suggestion or if you want to report a bug, please do it via the GitHub [issues](https://github.com/SticsRPacks/CroptimizR/issues).
Thanks for that, this would greatly help us to improve this package.
## Citation
If you have used this package for a study that led to a publication or report, please cite us. To get the suggested citation, run `citation("CroptimizR")`.
## Code of conduct
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.