rtide - GitLite

KO | EN

gitlite — search

#llm #typescript #electron #claude-code #ai-agent #database #php #sql #csharp #svg

rtide

(★ 15)

R package to calculate tide heights

File Explorer

ZIP Download

- - bug.md
  - feature-request.md
- - pkgdown.yaml
  - R-CMD-check.yaml
  - rhub.yaml
  - test-coverage.yaml
- .gitignore
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- pull_request_template.md
- SUPPORT.md
- brandywine.rda
- harmonics.rda
- monterey.rda
- 8555889.txt
- 9413450.txt
- brandywine.R
- get_timezones.R
- harmonics-20251228.txt
- harmonics-20251228_cleaned.txt
- harmonics-dwf-20151227-free.tar.bz2
- harmonics-dwf-20251228-free.tar.xz
- harmonics.R
- Harmonics_20120302.Rdata
- Harmonics_20251228.Rdata
- monterey.R
- read_harmonicsfile.R
- ref_id_attach.R
- scrape_harmonic_constituents.R
- tide.station.r
- tide_harmonics_parse.R
- WORDLIST
- - lifecycle-deprecated.svg
  - lifecycle-experimental.svg
  - lifecycle-stable.svg
  - lifecycle-superseded.svg
  - README-unnamed-chunk-4-1.png
  - README-unnamed-chunk-6-1.png
  - README-unnamed-chunk-7-1.png
- brandywine.Rd
- harmonics.Rd
- is.tide_harmonics.Rd
- monterey.Rd
- rtide-package.Rd
- tide_datetimes.Rd
- tide_height.Rd
- tide_height_data.Rd
- tide_slack_data.Rd
- tide_stations.Rd
- - apple-touch-icon-120x120.png
  - apple-touch-icon-60x60.png
  - apple-touch-icon-76x76.png
  - apple-touch-icon.png
  - favicon-16x16.png
  - favicon-32x32.png
  - favicon.ico
- data.R
- rtide-package.R
- tide-harmonics.R
- tide-height.R
- tide-slack.R
- utils.R
- zzz.R
- 00check.log
- build.R
- - test-data.R
  - test-tide-harmonics.R
  - test-tide-height.R
  - test-tide-slack.R
  - test-utils.R
- spelling.R
- testthat.R
.gitignore
.Rbuildignore
_pkgdown.yml
codecov.yml
cran-comments.md
DESCRIPTION
LICENSE.md
NAMESPACE
NEWS.md
README.md
README.Rmd
rtide.Rproj

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Lifecycle:
stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)
[![R-CMD-check](https://github.com/millerlp/rtide/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/millerlp/rtide/actions/workflows/R-CMD-check.yaml)

[![License:
GPL3](https://img.shields.io/badge/License-GPL3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)
[![CRAN
status](https://www.r-pkg.org/badges/version/rtide)](https://cran.r-project.org/package=rtide)
![CRAN downloads](https://cranlogs.r-pkg.org/badges/rtide) [![Codecov
test
coverage](https://codecov.io/gh/millerlp/rtide/graph/badge.svg)](https://app.codecov.io/gh/millerlp/rtide)

## Introduction

`rtide` is an R package to calculate tide heights based on tide station
harmonics.

It includes the harmonics data for 1293 US stations.

## Installation

To install the latest release from [CRAN](https://cran.r-project.org)

``` r
install.packages("rtide")
```

To install the developmental version from
[GitHub](https://github.com/millerlp/rtide)

``` r
# install.packages("pak")
pak::pak("millerlp/rtide")
```

## Utilisation

``` r
library(tibble)
library(rtide)
#> rtide is not suitable for navigation

data <- rtide::tide_height(
  "Monterey Harbor",
  from = as.Date("2016-07-13"), to = as.Date("2016-07-15"),
  minutes = 10L, tz = "America/Los_Angeles"
)

print(data)
#> # A tibble: 432 × 3
#>    Station                               DateTime            TideHeight
#>    <chr>                                 <dttm>                   <dbl>
#>  1 Monterey, Monterey Harbor, California 2016-07-13 00:00:00      0.523
#>  2 Monterey, Monterey Harbor, California 2016-07-13 00:10:00      0.505
#>  3 Monterey, Monterey Harbor, California 2016-07-13 00:20:00      0.489
#>  4 Monterey, Monterey Harbor, California 2016-07-13 00:30:00      0.476
#>  5 Monterey, Monterey Harbor, California 2016-07-13 00:40:00      0.465
#>  6 Monterey, Monterey Harbor, California 2016-07-13 00:50:00      0.457
#>  7 Monterey, Monterey Harbor, California 2016-07-13 01:00:00      0.452
#>  8 Monterey, Monterey Harbor, California 2016-07-13 01:10:00      0.449
#>  9 Monterey, Monterey Harbor, California 2016-07-13 01:20:00      0.449
#> 10 Monterey, Monterey Harbor, California 2016-07-13 01:30:00      0.451
#> # ℹ 422 more rows
```

``` r
library(ggplot2)
library(scales)
```

``` r
ggplot(data = data, aes(x = DateTime, y = TideHeight)) +
  geom_line() +
  scale_x_datetime(
    name = "Date",
    labels = date_format("%d %b %Y", tz = "America/Los_Angeles")
  ) +
  scale_y_continuous(name = "Tide Height (m)") +
  ggtitle("Monterey Harbour")
```

![](https://raw.githubusercontent.com/millerlp/rtide/main/man/figures/README-unnamed-chunk-6-1.png)

## Shiny

Tide heights can be also obtained using rtide through a [shiny
interface](https://poissonconsulting.shinyapps.io/rtide/) developed by
Seb Dalgarno.

## Contribution

Please report any [issues](https://github.com/millerlp/rtide/issues).

[Pull requests](https://github.com/millerlp/rtide/pulls) are always
welcome.

## Inspiration

The harmonics data was converted from
<https://github.com/millerlp/rtide/blob/main/data-raw/harmonics-dwf-20251228-free.tar.xz>,
NOAA web site data processed by David Flater for
[`XTide`](https://flaterco.com/xtide/). The code to calculate tide
heights from the harmonics is based on `XTide`.

## Tide prediction updates

The harmonic constituent data for the various tide stations are updated
yearly by the XTide maintainer. The `rtide` package originally used a
harmonic data base from 2015. An updated harmonic constituent database
file from 2025-12-28 has been incorporated into `rtide` as of
v0.0.12.9000 (August 2026), which adds many new tide stations, as well
as slightly changing the harmonic constituent values for many stations.
As a result, tide height predictions produced with earlier versions of
the `rtide` package (v0.0.12 and earlier) may produce slightly different
values than the predictions generated by the new harmonic data base.
Those differences may typically only amount to a centimeter or less.