| Type: | Package | 
| Title: | Import Various Northern and Southern Hemisphere Climate Indices | 
| Version: | 0.5.6 | 
| Description: | Downloads Southern Oscillation Index, Oceanic Nino Index, North Pacific Gyre Oscillation data, North Atlantic Oscillation and Arctic Oscillation. Data sources are described in the help files for each function. | 
| License: | GPL-3 | 
| URL: | https://github.com/boshek/rsoi/, https://boshek.github.io/rsoi/ | 
| Depends: | R (≥ 3.3.0) | 
| Imports: | curl, memoise, stats, utils | 
| Suggests: | testthat (≥ 2.1.0), tibble | 
| Encoding: | UTF-8 | 
| RoxygenNote: | 7.2.3 | 
| NeedsCompilation: | no | 
| Packaged: | 2023-11-16 18:30:59 UTC; samalbers | 
| Author: | Sam Albers [aut, cre], Elio Campitelli [ctb] | 
| Maintainer: | Sam Albers <sam.albers@gmail.com> | 
| Repository: | CRAN | 
| Date/Publication: | 2023-11-16 18:40:02 UTC | 
El Nino/Southern Oscillation (ENSO) and Related Climate Indices
Description
Downloads Southern Oscillation Index, Oceanic Nino Index, North Pacific Gyre Oscillation data, North Atlantic Oscillation and Arctic Oscillation. Data sources are described in the help files for each function.
Author(s)
Maintainer: Sam Albers sam.albers@gmail.com
Other contributors:
- Elio Campitelli elio.campitelli@cima.fcen.uba.ar [contributor] 
See Also
Useful links:
Download Antarctic Oscillation data
Description
Projection of the monthly 700 hPa anomaly height field south of 20°S on the first EOF obtained from the monthly 700 hPa height anomaly.
Usage
download_aao(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- AAO: Antarctic Oscillation 
References
https://www.cpc.ncep.noaa.gov/products/precip/CWlink/daily_ao_index/aao/aao.shtml
Examples
## Not run: 
aao <- download_aao()
## End(Not run)
Download Arctic Oscillation data
Description
Projection of the daily 1000 hPa anomaly height field north of 20°N on the first EOF obtained from the monthly 1000 hPa height anomaly.
Usage
download_ao(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- AO: Arctic Oscillation 
References
https://www.ncei.noaa.gov/access/monitoring/ao/
Examples
## Not run: 
ao <- download_ao()
## End(Not run)
Download Asymmetric and Symmetric SAM indices
Description
The Asymmetric and Symmetric SAM indices are computed as the projection of geopotential height anomalies onto the zonally asymmetric and zonally symmetric parts of the SAM field. The detailed methodology can be found in Campitelli et al. (2022). The source of the data is https://www.cima.fcen.uba.ar/~elio.campitelli/asymsam/
Usage
download_asymsam_monthly(use_cache = FALSE, file = NULL)
download_asymsam_daily(levels = 700, use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
| levels | atmospheric levels in hPa to download. 
If  | 
Value
- Lev: Atmospheric level in hPa 
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Index: Type of index. Either "sam", "ssam" or "asam". 
- Value: Value of the index 
- Value_normalized: Value of the index normalized by the standard deviation of the index 
- R.squared: The variance explained by the index (only in the daily version) 
References
Campitelli, E., Díaz, L. B., & Vera, C. (2022). Assessment of zonally symmetric and asymmetric components of the Southern Annular Mode using a novel approach. Climate Dynamics, 58(1), 161–178. doi:10.1007/s00382-021-05896-5
Examples
## Not run: 
asymsam <- download_asymsam_monthly()
## End(Not run)
Download Dipole Mode Index (DMI)
Description
Intensity of the IOD is represented by anomalous SST gradient between the western equatorial Indian Ocean (50E-70E and 10S-10N) and the south eastern equatorial Indian Ocean (90E-110E and 10S-0N). This gradient is named as Dipole Mode Index (DMI). When the DMI is positive then, the phenomenon is refereed as the positive IOD and when it is negative, it is refereed as negative IOD.
Usage
download_dmi(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Year: Year of record 
- Month: Month of record 
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- DMI: Dipole Mode Index 
References
https://psl.noaa.gov/gcos_wgsp/Timeseries/DMI/
Examples
## Not run: 
dmi <- download_dmi()
## End(Not run)
Download Southern Oscillation Index and Oceanic Nino Index data
Description
The Southern Oscillation Index is defined as the standardized difference between barometric readings at Darwin, Australia and Tahiti. The Oceanic Nino Index is average sea surface temperature in the Nino 3.4 region (120W to 170W) averaged over three months. Phases are categorized by Oceanic Nino Index:
- Warm phase of El Nino/ Southern Oscillation when 3-month average sea-surface temperature departure of positive 0.5 degC 
- Cool phase of La Nina/ Southern Oscillation when 3-month average sea-surface temperature departure of negative 0.5 degC 
- Neutral phase is defined as when the three month temperature average is between +0.5 and -0.5 degC 
Usage
download_enso(climate_idx = c("all", "soi", "oni", "npgo"), create_csv = FALSE)
Arguments
| climate_idx | Choose which ENSO related climate index to output. Current arguments supported are soi (the Southern Oscillation Index), oni (the Oceanic Nino Index), npgo (the North Pacific Gyre Oscillation) and all. all outputs each supported index variable as a slimmer dataset than each individual climate index call. | 
| create_csv | Logical option to create a local copy of the data. Defaults to FALSE. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- ONI: Oceanic Oscillation Index 
- phase: ENSO phase 
- SOI: Southern Oscillation Index 
- NPGO: North Pacific Gyre Oscillation 
Examples
## Not run: 
enso <- download_enso()
## End(Not run)
Download Multivariate ENSO Index Version 2 (MEI.v2)
Description
MEI.v2 is based on EOF analysis of level pressure, sea surface temperature, surface zonal winds, surface meridional winds, and Outgoing Longwave Radiation. The analysis is conducted for 12 partially overlapping 2-month "seasons".
Warm phase is defined as MEI index greater or equal to 0.5. Cold phase is defined as MEI index lesser or equal to -0.5.
Usage
download_mei(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Bi-moonthly season of record 
- Year: Year of record 
- MEI: Multivariate ENSO Index Version 2 
- Phase: ENSO phase 
References
https://psl.noaa.gov/enso/mei/
Examples
## Not run: 
mei <- download_mei()
## End(Not run)
Download North Atlantic Oscillation data
Description
surface sea-level pressure difference between the Subtropical (Azores) High and the Subpolar Low.
Usage
download_nao(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Month: Month of record 
- Year: Year of record 
- NAO: North Atlantic Oscillation 
References
https://www.ncei.noaa.gov/access/monitoring/nao/
Examples
## Not run: 
nao <- download_nao()
## End(Not run)
Download North Pacific Gyre Oscillation data
Description
North Pacific Gyre Oscillation data also known as the Victoria mode
Usage
download_npgo(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Year: Year of Record 
- Month: Month of record 
- NPGO: North Pacific Gyre Oscillation 
References
Examples
## Not run: 
npgo <- download_npgo()
## End(Not run)
Download Oceanic Nino Index data
Description
The Oceanic Nino Index is average sea surface temperature in the Nino 3.4 region (120W to 170W) averaged over three months. Phases are categorized by Oceanic Nino Index:
- Warm phase of El Nino/ Southern Oscillation when 3-month average sea-surface temperature departure of positive 0.5 degC 
- Cool phase of La Nina/ Southern Oscillation when 3-month average sea-surface temperature departure of negative 0.5 degC 
- Neutral phase is defined as when the three month temperature average is between +0.5 and -0.5 degC 
Usage
download_oni(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- ONI: Oneanic Oscillation Index 
- ONI_month_window: 3 month period over which the Oneanic Oscillation Index is calculated 
- phase: ENSO phase 
References
https://www.cpc.ncep.noaa.gov/products/precip/CWlink/MJO/enso.shtml
Examples
## Not run: 
oni <- download_oni()
## End(Not run)
Download Pacific Decadal Oscillation Data
Description
The PDO index is derived as the leading principal of monthly SST anomalies in the North Pacific Ocean, poleward of 20N. The monthly mean global average SST anomalies are removed to separate this pattern of variability from any "global warming" signal that may be present in the data.
The NCEI PDO index is based on NOAA's extended reconstruction of SSTs (ERSST Version 4). It is constructed by regressing the ERSST anomalies against the Mantua PDO index for their overlap period, to compute a PDO regression map for the North Pacific ERSST anomalies. The ERSST anomalies are then projected onto that map to compute the NCEI index. The NCEI PDO index closely follows the Mantua PDO index.
Usage
download_pdo(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- PDO: Pacific Decadal Oscillation index 
References
Original PDO: https://oceanview.pfeg.noaa.gov/erddap/info/cciea_OC_PDO/index.html
Examples
## Not run: 
pdo <- download_pdo()
## End(Not run)
Download Southern Oscillation Index data
Description
The Southern Oscillation Index is defined as the standardized difference between barometric readings at Darwin, Australia and Tahiti.
Usage
download_soi(use_cache = FALSE, file = NULL)
Arguments
| use_cache | logical option to save and load from cache. If 'TRUE', results will be cached in memory if 'file' is 'NULL' or on disk if 'file' is not 'NULL'. | 
| file | optional character with the full path of a file to save the data. If 'cache' is 'FALSE' but 'file' is not 'NULL', the results will be downloaded from the internet and saved on disk. | 
Value
- Date: Date object that uses the first of the month as a placeholder. Date formatted as date on the first of the month because R only supports one partial of date time 
- Month: Month of record 
- Year: Year of record 
- SOI: Southern Oscillation Index 
- SOI_3MON_AVG: 3 Month Average Southern Oscillation Index 
References
https://www.cpc.ncep.noaa.gov/data/indices/soi
Examples
## Not run: 
soi <- download_soi()
## End(Not run)