You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> Do not use calculations from this project for navigation, or depend on them in any situation where inaccuracies could result in harm to a person or property. Tide predictions are only as good as the harmonics data available, and these can be inconsistent and vary widely based on the accuracy of the source data and local conditions. The tide predictions do not factor events such as storm surge, wind waves, uplift, tsunamis, or sadly, climate change. 😢
**Do not use calculations from this project for navigation, or depend on them in any situation where inaccuracies could result in harm to a person or property.**
12
-
13
-
Tide predictions are only as good as the harmonics data available, and these can be inconsistent and vary widely based on the accuracy of the source data and local conditions.
14
-
15
-
The tide predictions do not factor events such as storm surge, wind waves, uplift, tsunamis, or sadly, climate change. 😢
7
+
> [!WARNING]
8
+
> **Not for navigational use**
9
+
>
10
+
> Do not use calculations from this project for navigation, or depend on them in any situation where inaccuracies could result in harm to a person or property. Tide predictions are only as good as the harmonics data available, and these can be inconsistent and vary widely based on the accuracy of the source data and local conditions. The tide predictions do not factor events such as storm surge, wind waves, uplift, tsunamis, or sadly, climate change. 😢
16
11
17
12
# Installation
18
13
19
-
```
20
-
#npm
14
+
```sh
21
15
npm install @neaps/tide-predictor
22
-
23
-
# yarn
24
-
yarn add @neaps/tide-predictor
25
-
26
16
```
27
17
28
18
# Usage
29
19
30
-
Neaps requires that you [provide your own tidal harmonics information](#constituent-object) to generate a prediction.
31
-
32
-
Because many constituent datum come with multiple phases (in the case of NOAA's data, they are `phase_local` and `phase_GMT`), there is a `phaseKey` option for choosing which to use.
33
-
34
-
Note that, for now, Neaps **will not** do any timezone corrections. This means you need to pass date objects that align with whatever timezone the constituents are in.
20
+
`@neaps/tide-predictor` requires that you [provide your own tidal harmonics information](#constituent-object) to generate a prediction. For a complete tide prediction solution, including finding nearby stations and their harmonics, check out the [`neaps` package](https://github.com/neaps/neaps).
Note that, for now, Neaps **will not** do any timezone corrections. This means you need to pass date objects that align with whatever timezone the constituents are in.
45
+
58
46
## Tide prediction object
59
47
60
48
Calling `tidePredictor` will generate a new tide prediction object. It accepts the following arguments:
61
49
62
50
-`constituents` - An array of [constituent objects](#constituent-object)
63
51
-`options` - An object with one of:
64
-
-`phaseKey` - The name of the parameter within constituents that is considered the "phase"
52
+
-`phaseKey` - The name of the parameter within constituents that is considered the "phase" because many constituent datum come with multiple phases (in the case of NOAA's data, they are `phase_local` and `phase_GMT`).
65
53
-`offset` - A value to add to **all** values predicted. This is useful if you want to, for example, offset tides by mean high water, etc.
0 commit comments