diff --git a/DESCRIPTION b/DESCRIPTION index 9ffd4b5..1650701 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: ClimMobTools Type: Package Title: Tools for crowdsourcing citizen science in agriculture -Version: 0.2-1 +Version: 0.2-2 Authors@R: c(person("Kaue", "de Sousa", email = "kaue.desousa@inn.no", role = c("aut", "cre"), comment = c(ORCID = "0000-0002-7571-7845")), @@ -13,12 +13,22 @@ Authors@R: c(person("Kaue", "de Sousa", Maintainer: Kaue de Sousa URL: https://agrobioinfoservices.github.io/ClimMobTools/ BugReports: https://github.com/agrobioinfoservices/ClimMobTools/issues -Description: ClimMobTools provides the toolkit for the ClimMob platform in R. +Description: Toolkit for the 'ClimMob' platform in R. 'ClimMob' is an open source software for crowdsourcing citizen science in agriculture . Developed by Bioversity International , it turns the research paradigm on its head; instead of a few researchers designing complicated trials to compare several technologies in search of the best solutions, it enables many farmers to carry out reasonably simple experiments that taken together can offer even more information. The concept behind the methodology applied by ClimMob is demonstrated by van Etten et al. (2019a) , with its applications for crop management demonstrated by van Etten et al (2019b) . License: GPL-3 Encoding: UTF-8 LazyData: true Depends: R (>= 2.10) -Imports: httr, jsonlite, Matrix, methods, nasapower, raster, RSpectra, tibble, tidyr, utils +Imports: + httr, + jsonlite, + Matrix, + methods, + nasapower, + raster, + RSpectra, + tibble, + tidyr, + utils Suggests: PlackettLuce, psychotree, diff --git a/NEWS.md b/NEWS.md index b65a0c1..3204e0d 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,4 +1,20 @@ -# ClimMobTools 0.2-0 +# ClimMobTools 0.2-2 + +## New Features + +* Tests coverage > 90% +* Validations in `temperature`, `rainfall`, `getDataCM`, and `ETo` + +## CRAN issues + +* Non canonical URLs in inst/doc/Environmental_indices.html +* Elaborate what the platform [ClimMob] is, and add web reference +* The Description field should not start with the package name +* Single cote all software names in the Description file + + + +# ClimMobTools 0.2-1 ## New Features diff --git a/README.Rmd b/README.Rmd index 299be0b..dfdbe51 100644 --- a/README.Rmd +++ b/README.Rmd @@ -21,7 +21,7 @@ Package website: https://agrobioinfoservices.github.io/ClimMobTools/ ## Overview -The **ClimMobTools** package provides the toolkit employed in crowdsourcing citizen science projects under the *tricot* approach. Tricot, stands for "triadic comparison of technologies" for the rapid assessment of on-farm evaluation trails in small-scale agriculture. +The **ClimMobTools** package provides the toolkit for the [ClimMob](https://climmob.net/climmob3/) platform in `R`. ClimMob is an open source software for crowdsourcing citizen science in agriculture. Developed by [Bioversity International](https://www.bioversityinternational.org/), it turns the research paradigm on its head; instead of a few researchers designing complicated trials to compare several technologies in search of the best solutions, it enables many farmers to carry out reasonably simple experiments that taken together can offer even more information. The concept behind the methodology applied by ClimMob is demonstrated by van Etten et al. [(2019a)](https://doi.org/10.1017/S0014479716000739), with its applications for crop management demonstrated by van Etten et al [(2019b)](https://doi.org/10.1073/pnas.1813720116). ## Installation diff --git a/README.md b/README.md index e8b4137..69606a7 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ Package website: Overview -------- -The **ClimMobTools** package provides the toolkit employed in crowdsourcing citizen science projects under the *tricot* approach. Tricot, stands for "triadic comparison of technologies" for the rapid assessment of on-farm evaluation trails in small-scale agriculture. +The **ClimMobTools** package provides the toolkit for the [ClimMob](https://climmob.net/climmob3/) platform in `R`. ClimMob is an open source software for crowdsourcing citizen science in agriculture. Developed by [Bioversity International](https://www.bioversityinternational.org/), it turns the research paradigm on its head; instead of a few researchers designing complicated trials to compare several technologies in search of the best solutions, it enables many farmers to carry out reasonably simple experiments that taken together can offer even more information. The concept behind the methodology applied by ClimMob is demonstrated by van Etten et al. [(2019a)](https://doi.org/10.1017/S0014479716000739), with its applications for crop management demonstrated by van Etten et al [(2019b)](https://doi.org/10.1073/pnas.1813720116). Installation ------------ diff --git a/docs/CODE_OF_CONDUCT.html b/docs/CODE_OF_CONDUCT.html index 6e6a063..c99c3c4 100644 --- a/docs/CODE_OF_CONDUCT.html +++ b/docs/CODE_OF_CONDUCT.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2 diff --git a/docs/CONTRIBUTING.html b/docs/CONTRIBUTING.html index 1730564..aed842d 100644 --- a/docs/CONTRIBUTING.html +++ b/docs/CONTRIBUTING.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2 diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html index 247b24f..e971dec 100644 --- a/docs/LICENSE-text.html +++ b/docs/LICENSE-text.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2 diff --git a/docs/LICENSE.html b/docs/LICENSE.html index ab93410..5d3cbbb 100644 --- a/docs/LICENSE.html +++ b/docs/LICENSE.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2 diff --git a/docs/articles/Environmental_indices.html b/docs/articles/Environmental_indices.html index a1624ac..96043f1 100644 --- a/docs/articles/Environmental_indices.html +++ b/docs/articles/Environmental_indices.html @@ -30,7 +30,7 @@ ClimMobTools - 0.2.1 + 0.2.2 @@ -89,24 +89,23 @@

Kauê de Sousa

Introduction

-

Understanding how different crop varieties respond to environmental variation is a valuable approach to provide recommendations based on genotype x environment (GxE) interactions for climate adaptation. ClimMobTools provides the toolkit to compute environmental variables that serves as input for the ranking analysis with explanatory variables using Plackett-Luce1 or Bradley-Terry2 model.

+

Understanding how different crop varieties respond to environmental variation is a valuable approach to provide recommendations based on genotype x environment (GxE) interactions for climate adaptation. ClimMobTools provides the toolkit to compute environmental variables that serves as input for the ranking analysis with explanatory variables using Plackett-Luce1 or Bradley-Terry2 model.

The climatic variables available in ClimMobTools were previously used for the environmental analysis of wheat trial data3 and explain the changes in climatic patterns due to climate change4. In a more advanced analysis, these variables can be applied with seasonal forecasts and risk analysis to provide farm recommendations for climate adaptation5.

Source of data and input

Environmental data can be computed using input from time series databases such as the Climate Hazards Group InfraRed Precipitation with Station data (CHIRPS)6 for rainfall, and MODIS (MYD11A2)7 for land surface temperature. These databases has the advantage to be free and publicly available sources of global coverage and a high resolution (0.05°), and have been used in previous studies with ClimMob data5. However, it requires much computer capacity to extract this information and produce the matrix for the environmental indices. MODIS data also requires some work to reduce noise and fill gaps.

-

The other alternative relies on using NASA POWER. By providing the planting dates and the geographic information (lon and lat), ClimMobTools makes an internal call to nasapower8 to fetch the required time series data and compute the environmental indices. It do not requires much computer capacity but requires a persistent internet connection. NASAPOWER, however has a low grid resolution (0.5°) compared to MODIS and CHIRPS and could not provide the expected results for GxE interactions in a narrow geographical range.

+

The other alternative relies on using NASA POWER. By providing the planting dates and the geographic information (lon and lat), ClimMobTools makes an internal call to nasapower8 to fetch the required time series data and compute the environmental indices. It do not requires much computer capacity but requires a persistent internet connection. NASAPOWER, however has a low grid resolution (0.5°) compared to MODIS and CHIRPS and could not provide the expected results for GxE interactions in a narrow geographical range.

Breadwheat data

-

In this article we use the NASA POWER data via the R package nasapower as external input data for the environmental indices. We use the bread wheat data from Vaishali, India as internal input with planing dates and geographic information. In the Introduction to ClimMobTools article we show how to fetch your ClimMob data into your R section using an API key.

+

In this article we use the NASA POWER data via the R package nasapower as external input data for the environmental indices. We use the bread wheat data from Vaishali, India as internal input with planing dates and geographic information. In the Introduction to ClimMobTools article we show how to fetch the ClimMob data into your R section using an API key.

library("ClimMobTools")
 library("nasapower")
 library("tidyverse")
 library("magrittr")
 
-# fetch ClimMob data from your ClimMob user account
 key <- "d39a3c66-5822-4930-a9d4-50e7da041e77"
 
 data <- ClimMobTools::getDataCM(key = key, 
diff --git a/docs/articles/Overview.html b/docs/articles/Overview.html
index 19ae1c8..a9e23eb 100644
--- a/docs/articles/Overview.html
+++ b/docs/articles/Overview.html
@@ -30,7 +30,7 @@
       
       
         ClimMobTools
-        0.2.1
+        0.2.2
diff --git a/docs/articles/index.html b/docs/articles/index.html index 9ef6ce4..0736619 100644 --- a/docs/articles/index.html +++ b/docs/articles/index.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2
diff --git a/docs/authors.html b/docs/authors.html index 665bd8a..99168c7 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -60,7 +60,7 @@ ClimMobTools - 0.2.1 + 0.2.2
diff --git a/docs/index.html b/docs/index.html index c6719c9..eca36ae 100644 --- a/docs/index.html +++ b/docs/index.html @@ -10,7 +10,7 @@ - +