Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/umr-amap/StormR
Funtions to quantify and map the tropical storms and cyclones’ winds characteristics'
https://github.com/umr-amap/StormR
cyclones-behaviour r tropical-storms
Last synced: 3 months ago
JSON representation
Funtions to quantify and map the tropical storms and cyclones’ winds characteristics'
- Host: GitHub
- URL: https://github.com/umr-amap/StormR
- Owner: umr-amap
- License: gpl-3.0
- Created: 2022-10-19T12:22:02.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-13T14:57:56.000Z (6 months ago)
- Last Synced: 2024-07-18T04:41:13.314Z (4 months ago)
- Topics: cyclones-behaviour, r, tropical-storms
- Language: R
- Homepage: https://umr-amap.github.io/StormR/
- Size: 99.9 MB
- Stars: 13
- Watchers: 2
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- License: LICENSE.md
- Codemeta: codemeta.json
Awesome Lists containing this project
- open-sustainable-technology - StormR - An R package allowing to easily extract storm track data for given locations or areas of interests, to generate wind speed and direction fields, and to compute summary statistics characterising the behaviour of winds generated by tropical storms and cyclones. (Climate Change / Natural Hazard and Storm)
README
# StormR R package
[![](https://www.r-pkg.org/badges/version/StormR?color=green)](https://cran.r-project.org/package=StormR)
[![](https://cranlogs.r-pkg.org/badges/grand-total/StormR)](https://cran.r-project.org/package=StormR)
[![DOI](https://joss.theoj.org/papers/10.21105/joss.05766/status.svg)](https://doi.org/10.21105/joss.05766)
[![codecov](https://codecov.io/github/umr-amap/StormR/branch/master/graph/badge.svg?token=5YMVL4TFB5)](https://app.codecov.io/github/umr-amap/StormR)
![R-CMD-check](https://github.com/umr-amap/StormR/actions/workflows/check-standard.yaml/badge.svg)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10213689.svg)](https://doi.org/10.5281/zenodo.10213689)
[![SWH](https://archive.softwareheritage.org/badge/origin/https://github.com/umr-amap/StormR/)](https://archive.softwareheritage.org/browse/origin/?origin_url=https://github.com/umr-amap/StormR)## Overview
`StormR` is an R package allowing to easily extract storm track data for given locations or areas of interests, to generate wind speed and direction fields, and to compute summary statistics characterising the behaviour of winds generated by tropical storms and cyclones: maximum sustained wind speed, power dissipation index, and duration of exposure to winds reaching defined speed thresholds.
## Usage
### Installing StormR
`StormR` is now [available on CRAN](https://cran.r-project.org/package=StormR) on version `0.1.1`.
You can install it as follows:``` r
install.packages("StormR")
```The latest development version can be installed from GitHub as follows,
``` r
#install.packages("devtools")
devtools::install_github("umr-amap/StormR")
```### Loading StormR package
``` r
library(StormR)
```## Main functions
| **Name** | **Description** | **Inputs** | **Outputs** |
|:--:|:----:|:-----------:|:-----:|
|`defStormsDataset()`|Creates a `stormsDataset` object|".nc" (NetCDF) file|`stormsDataset` object|
|`defStormsList()`|Extracts storms|`stormsDataset` object|`stormsList` object|
|`plotStorms()`|Plots storms track data|`stormsList` object||
|`temporalBehaviour()`|Computes wind speed, direction time series, and summary statistics for a given set of point coordinates |`stormsList` object|lists of data.frame objects|
|`spatialBehaviour()`|Computes 2D wind fields and summary statistics over a given location of interest |`stormsList` object|`SpatRaster` object|
|`plotBehaviour()`|Plots 2D wind fields and summary statistics|`stormsList` + `SpatRaster` objects||
|`writeRast()`|Exports wind fields and summary statistics to file|`SpatRaster` object|`.tiff` or `.nc` file|## Contributing
You are welcome to contribute to the `StormR` package. Just fork the project and create a pull request with your changes and we will review it as soon as possible.
## Reporting issues
Issues can be reported [here](https://github.com/umr-amap/StormR/issues/new/choose). Simply choose the appropriate template and fill in the requested information.
## Seeking help
If you need help with the `StormR` package, please open a new discussion on the [Q&A section on github](https://github.com/umr-amap/StormR/discussions/categories/q-a). We will do our best to answer your questions. Other users are also welcome to help you.
## Funding
This work was supported by Hermon Slade Foundation, [grant HSF 19105](http://www.hermonslade.org.au/hsf19105/).