https://github.com/robwschlegel/heatwave3

Apply the Hobday et al. (2016, 2018) marine heatwave definition directly to NetCDF files.
https://github.com/robwschlegel/heatwave3

Last synced: about 1 month ago
JSON representation

Apply the Hobday et al. (2016, 2018) marine heatwave definition directly to NetCDF files.

• Host: GitHub
• URL: https://github.com/robwschlegel/heatwave3
• Owner: robwschlegel
• License: other
• Created: 2023-07-29T12:45:06.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-13T16:45:16.000Z (7 months ago)
• Last Synced: 2024-06-28T00:05:51.941Z (6 months ago)
• Language: R
• Homepage: https://robwschlegel.github.io/heatwave3/
• Size: 2.48 MB
• Stars: 6
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• open-sustainable-technology - heatwave3 - The Goal of this package is to make life easier when working with the Hobday et al. marine heatwave definition on large datasets. (Hydrosphere / Ocean Carbon and Temperature)

README

        

# heatwave3 

[![R-CMD-check](https://github.com/robwschlegel/heatwave3/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/robwschlegel/heatwave3/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/robwschlegel/heatwave3/branch/main/graph/badge.svg)](https://app.codecov.io/gh/robwschlegel/heatwave3?branch=main)

Welcome to __`heatwave3`__. The goal of this package is to make life easier when working with the Hobday et al. (2016, 2018) marine heatwave (MHW) definition on large datasets. Traditionally we have had to detect MHWs on one time series at a time. For large gridded datasets this can be technically difficult and very time consuming. Now, thanks to developments in the __`terra`__ package, it is possible to apply any numbers of functions directly to gridded data (e.g. NetCDF files). __`heatwave3`__ therefore serves as an extension to the [__`heatwaveR`__](https://robwschlegel.github.io/heatwaveR/index.html) package and helps the user to easily and quickly detect MHWs within their gridded datasets. The results can be returned as either a stacked raster or data.frame. This package can also save the results directly as a NetCDF or CSV file.

The package is still in its infancy and is being actively developed. Any and all feedback is very welcome!

## Installation

You can install the development version of __`heatwave3`__ from this [GitHub](https://github.com/robwschlegel/heatwave3) repository with:

``` r

# install.packages("devtools")

devtools::install_github("robwschlegel/heatwave3")

```

## Example

The use of __`heatwave3`__ has been designed to be as easy as possible. There is a lot happening behind the scenes that allows this package to determine the structure of the users data without needing to provide any additional arguments. Please see the following example:

``` r

library(heatwave3)

# Run directly on a file without needing to load it first

mhw_cube <- detect3(file_in = system.file("extdata/oisst_short.nc", package = "heatwave3"),

                     return_type = "df", clim_period = c("1982-01-01", "2011-12-31"))

               

# Show the first few rows

head(mhw_cube)

```

Of course, there are possibly more ways to organise a data file than there are stars in the sky. If this function doesn't work on your dataset, please contact us! We are actively looking for ways to improve the usability of __`heatwave3`__

## Code of Conduct

Please note that the heatwave3 project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/1/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.