-
-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
2751477
commit 2007b81
Showing
17 changed files
with
279 additions
and
523 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -16,23 +16,47 @@ knitr::opts_chunk$set( | |
| ) | ||
| ``` | ||
|
|
||
| # AquaBEHER | ||
|
|
||
| <p id="start" align="center"> | ||
| <a href="#start"><img height="300rem" src="inst/www/AquaBEHER.png"></a> | ||
| </p> | ||
|
|
||
| <div align="center"> | ||
|
|
||
| <a href="https://github.com/RobelTakele/AquaBEHER/issues/new?labels=bug&projects=&template=01_BUG-REPORT.yml&title=%5BBUG%5D+%3Ctitle%3E" style="font-size: 20px;">Report a Bug</a> | | ||
| <a href="https://github.com/RobelTakele/AquaBEHER/discussions/new?category=ideas" style="font-size: 20px;">Request a Feature</a> | | ||
| <a href="https://github.com/RobelTakele/AquaBEHER/discussions/new/choose" style="font-size: 20px;">Ask a Question</a> | ||
|
|
||
| <!-- badges: start --> | ||
| [](https://github.com/RobelTakele/AquaBEHER/actions/workflows/R-CMD-check.yaml) | ||
| [](https://www.repostatus.org/#active) | ||
| [](https://lifecycle.r-lib.org/articles/stages.html#stable) | ||
| [](https://www.gnu.org/licenses/gpl-3.0.en.html) | ||
| [](https://cran.r-project.org/package=AquaBEHER) | ||
| <a href="https://github.com/RobelTakele/AquaBEHER"> | ||
| <img src="https://img.shields.io/github/v/release/RobelTakele/AquaBEHER" alt="GitHub release" height="25"> | ||
| </a> | ||
| <a href="https://github.com/RobelTakele/AquaBEHER/actions/workflows/R-CMD-check.yaml"> | ||
| <img src="https://github.com/RobelTakele/AquaBEHER/actions/workflows/R-CMD-check.yaml/badge.svg" alt="R-CMD-check" height="25"> | ||
| </a> | ||
| <a href="https://lifecycle.r-lib.org/articles/stages.html#stable"> | ||
| <img src="https://img.shields.io/badge/lifecycle-stable-brightgreen.svg" alt="Lifecycle: stable" height="25"> | ||
| </a> | ||
| <a href="https://www.gnu.org/licenses/gpl-3.0.en.html"> | ||
| <img src="https://img.shields.io/badge/license-GPL--3-blue.svg" alt="license" height="25"> | ||
| </a> | ||
| <a href="https://www.gnu.org/licenses/gpl-3.0.en.html"> | ||
| <img src="https://cranlogs.r-pkg.org/badges/AquaBEHER" alt="metacran downloads" height="25"> | ||
| </a> | ||
| <!-- badges: end --> | ||
|
|
||
| </div> | ||
|
|
||
| **AquaBEHER** is an R package designed to **estimate** and **predict** the wet season calendar and soil water balance for agricultural applications. The package integrates daily potential evapotranspiration (PET) and soil water balance parameters to compute the wet season calendar (WSC) for crop and soil water management. Using these parameters, AquaBEHER can estimate and predict the onset, cessation, and duration of the wet season based on an agroclimatic approach. | ||
| <p id="start" align="center"> | ||
| <a href="#start"><img height="10rem" src="inst/www/lines/aqua.png"></a> | ||
| </p> | ||
|
|
||
| ### Key Features | ||
| **AquaBEHER** is an R package designed to **estimate** and **predict** the wet season calendar (WSC) and soil water balance for agricultural applications. The package integrates daily potential evapotranspiration (PET) and soil water balance parameters to compute the WSC for crop and soil water management. Using these parameters, AquaBEHER can estimate and predict the onset, cessation, and duration of the wet season based on an agroclimatic approach. | ||
|
|
||
| ### ⛓ Key Features | ||
| - **Daily potential evapotranspiration (PET)** estimation using various methods. | ||
| - **Daily soil water balance** estimation based on customizable soil water holding capacity (soilWHC). | ||
| - **Wet season calendar** estimation including: | ||
| - **Wet season calendar** estimation and seasonal prediction including: | ||
| - Onset of the wet season | ||
| - Cessation of the wet season | ||
| - Duration of the wet season | ||
|
|
@@ -53,6 +77,11 @@ install.packages("AquaBEHER") | |
| # install.packages("devtools") | ||
| devtools::install_github("RobelTakele/AquaBEHER") | ||
| ``` | ||
| To view the vignettes in RStudio, run: | ||
| ```r | ||
| vignette("AquaBEHER", "AquaBEHER") | ||
| ``` | ||
| Further details regarding `AquaBEHER` are available on the package website, visit [here](https://robeltakele.github.io/AquaBEHER/). | ||
|
|
||
| --- | ||
|
|
||
|
|
@@ -82,7 +111,7 @@ head(watBal) | |
|
|
||
| Visualize the daily soil water balance, rainfall, and potential evapotranspiration (Eto) for the climatological year 2019–2020: | ||
|
|
||
| ```{r watBalPlot, fig.height=6, fig.width=8} | ||
| ```{r watBalPlot, fig.height=6, fig.width=8, fig.dpi=400} | ||
| library(ggplot2) | ||
| # Filter the data for 2019 and 2020 | ||
|
|
@@ -115,21 +144,71 @@ ggplot(watBal.19T20, aes(x = date)) + | |
| ) | ||
| ``` | ||
|
|
||
| ## :books: Citation | ||
|
|
||
| If you used `AquaBEHER` in your work, please cite it. You can view the most recent citation by running: | ||
| ```r | ||
| citation(package = "AquaBEHER") | ||
| ``` | ||
|
|
||
| ``` | ||
| To cite AquaBEHER in publications, please use: | ||
| Robel Takele, Matteo Dell'Acqua (2023). AquaBEHER: Estimation and Prediction of Wet Season Calendar and Soil | ||
| Water Balance for Agriculture. R package version 1.0.0. Available at | ||
| https://cran.r-project.org/web/packages/AquaBEHER | ||
| A BibTeX entry for LaTeX users is: | ||
| @Manual{, | ||
| title = {AquaBEHER: Estimation and Prediction of Wet Season Calendar and Soil Water Balance for Agriculture}, | ||
| author = {Robel Takele and Matteo Dell'Acqua}, | ||
| year = {2023}, | ||
| note = {R package version 1.0.0}, | ||
| url = {https://robeltakele.github.io/AquaBEHER/}, | ||
| } | ||
| ``` | ||
| ## :earth_africa: Feedback and Contributions 🤝 | ||
|
|
||
| We appreciate feedback and contributions to improve AquaBEHER. Feel free to report bugs, suggest features, or join discussions. | ||
|
|
||
| Your contributions make a difference! | ||
|
|
||
| > [!IMPORTANT] | ||
| > Submit issues [here](https://github.com/RobelTakele/AquaBEHER/issues/) or join discussions [here](https://github.com/RobelTakele/AquaBEHER/discussions). | ||
| ✤ <i>We appreciate your support and look forward to making our package even better with your help!</i> | ||
|
|
||
| --- | ||
|
|
||
| ## :mailbox_with_mail: Contact Us | ||
|
|
||
| <img align="right" width="200" src="http://www.capitalisegenetics.santannapisa.it/sites/default/files/u65/Logo%20plant%20sciences.png"> | ||
| <img align="right" width="300" src="http://www.capitalisegenetics.santannapisa.it/sites/default/files/u65/Logo%20plant%20sciences.png"> | ||
|
|
||
| The **Genetics Group** at the *Institute of Plant Sciences* is a culturally diverse and research-driven team focused on advancing agricultural innovation. Our interdisciplinary approach combines crop genetics, climate science, and participatory strategies to develop sustainable farming solutions. | ||
| The **Genetics Group** at the *Institute of Plant Sciences* is a culturally diverse, research-driven team focused on advancing agricultural innovation. We combine crop genetics, climate science, and participatory strategies to develop sustainable farming solutions. | ||
|
|
||
| We are based at **Scuola Superiore Sant'Anna**, Pisa, Italy. | ||
|
|
||
| For inquiries, reach out to: | ||
| For inquiries, please reach out to: | ||
| - [Matteo Dell'Acqua](mailto:[email protected]) | ||
| - [Mario Enrico Pè](mailto:[email protected]) | ||
|
|
||
| Learn more about our work on the [group web page](https://www.santannapisa.it/en/institute/plant-sciences). | ||
| Learn more about our work on the [institute web page](https://www.santannapisa.it/en/institute/plant-sciences). | ||
|
|
||
| <div align="center"> | ||
| <a href="https://x.com/intent/tweet?text=Check%20out%20this%20project%20on%20GitHub:%20https://github.com/RobelTakele/AquaBEHER"> | ||
| <img src="https://img.shields.io/badge/share-000000?logo=x&logoColor=white" alt="Share on X"> | ||
| </a> | ||
| <a href="https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/RobelTakele/AquaBEHER"> | ||
| <img src="https://img.shields.io/badge/share-0A66C2?logo=linkedin&logoColor=white" alt="Share on LinkedIn"> | ||
| </a> | ||
| <a href="https://www.facebook.com/sharer/sharer.php?u=https://github.com/RobelTakele/AquaBEHER"> | ||
| <img src="https://img.shields.io/badge/share-1877F2?logo=facebook&logoColor=white" alt="Share on Facebook"> | ||
| </a> | ||
| <a href="https://www.reddit.com/submit?title=Check%20out%20this%20project%20on%20GitHub:%20https://github.com/RobelTakele/AquaBEHER"> | ||
| <img src="https://img.shields.io/badge/share-FF4500?logo=reddit&logoColor=white" alt="Share on Reddit"> | ||
| </a> | ||
| </div> | ||
|
|
||
| --- | ||
|
|
||
|
|
@@ -139,4 +218,41 @@ Learn more about our work on the [group web page](https://www.santannapisa.it/en | |
| - [AquaBEHER GitHub Repository](https://github.com/RobelTakele/AquaBEHER) | ||
| - [Scuola Superiore Sant'Anna](https://www.santannapisa.it/en/institute/plant-sciences) | ||
|
|
||
| ``` | ||
| --- | ||
|
|
||
| ## 🌟 Show Your Support | ||
|
|
||
| If you find **AquaBEHER** helpful or interesting, please consider giving us a star on GitHub. Your support helps promote the project and lets others know it's worth checking out. | ||
|
|
||
| 🙏 Thank you for your support! 👍 | ||
|
|
||
| [](https://github.com/RobelTakele/AquaBEHER/stargazers) | ||
|
|
||
| --- | ||
|
|
||
| ## 👥 Contributors | ||
|
|
||
| <div> | ||
| <p> | ||
| 👨💻 <b>Robel Takele</b><br> | ||
| Email: <a href="mailto:[email protected]">[email protected]</a><br> | ||
| GitHub: <a href="https://github.com/RobelTakele">@RobelTakele</a> | ||
| </p> | ||
|
|
||
| <p> | ||
| 👨💻 <b>Matteo Dell'Acqua</b><br> | ||
| Email: <a href="mailto:[email protected]">[email protected]</a><br> | ||
| GitHub: <a href="https://github.com/mdellh2o">@MatteoDellAcqua</a> | ||
| </p> | ||
| </div> | ||
|
|
||
|
|
||
| ### 🄯 License | ||
|
|
||
| This project is licensed under the GNU General Public License, [GPL-3](https://cran.r-project.org/web/licenses/GPL-3). | ||
|
|
||
| <p align="right"> | ||
| <a href="#start"><img width="75rem" src="inst/www/top.png" alt="Back to top"></a> | ||
| </p> | ||
|
|
||
|
|
||
Oops, something went wrong.