TideData

TideData[spec]

returns the tidal properties for a location or a set of tidal parameters.

TideData[spec,prop]

returns the specified property for the location or tidal parameters indicated.

TideData[spec,prop,datespec]

returns the value of a specified property for a date or set of dates.

Details and Options

spec can be a location, tide station, a TimeSeries of tidal heights or an association with keys corresponding to the tidal modes, mean tide level and elevation.
For spec that encompass regions, the center of that region is used to determine the tide station.
TimeSeries input is analyzed to determine the best-fit values for tidal modes, which are then used for further calculations.
Tidal modes should be specified as an ordered pair of amplitude and phase. If not specified, they are assumed not to contribute.
Amplitudes and heights can be specified as Quantity objects. If numbers, they are presumed to be in feet.
Phases should be Quantity objects or numbers specifying angular degrees.
The tidal constituents and their symbols are:

"M2"	M₂	principal lunar semidiurnal constituent
"S2"	S₂	principal solar semidiurnal constituent
"N2"	N₂	larger lunar elliptic semidiurnal constituent
"K1"	K₁	lunar diurnal constituent
"M4"	M₄	shallow water overtides of principal lunar constituent
"O1"	O₁	lunar diurnal constituent
"M6"	M₆	shallow water overtides of principal lunar constituent
"MK3"	MK₃	shallow water terdiurnal constituent
"S4"	S₄	shallow water overtides of principal solar constituent
"MN4"	MN₄	shallow water quarter diurnal constituent
"NU2"	ν₂	larger lunar evectional constituent
"S6"	S₆	shallow water overtides of principal solar constituent
"MU2"	MU₂	variational constituent
"2N2"	2"N₂	lunar elliptical semidiurnal second-order constituent
"OO1"	OO₁	lunar diurnal constituent
"LAM2"	λ₂	smaller lunar evectional constituent
"S1"	S₁	solar diurnal constituent
"M1"	M₁	smaller lunar elliptic diurnal constituent
"J1"	J₁	smaller lunar elliptic diurnal constituent
"MM"	M_m	lunar monthly constituent
"SSA"	S_sa	solar semiannual constituent
"SA"	S_a	solar annual constituent
"MSF"	M_sf	lunisolar synodic fortnightly constituent
"MF"	M_f	lunisolar fortnightly constituent
"RHO"	ρ	larger lunar evectional diurnal constituent
"Q1"	Q₁	larger lunar elliptic diurnal constituent
"T2"	T₂	larger solar elliptic constituent
"R2"	R₂	smaller solar elliptic constituent
"2Q1"	2Q₁	larger elliptic diurnal constituent
"P1"	P₁	solar diurnal constituent
"2SM2"	2SM₂	shallow water semidiurnal constituent
"M3"	M₃	lunar terdiurnal constituent
"L2"	L₂	smaller lunar elliptic semidiurnal constituent
"2MK3"	2"MK₃	shallow water terdiurnal constituent
"K2"	K₂	lunisolar semidiurnal constituent
"M8"	M₈	shallow water eighth diurnal constituent
"MS4"	MS₄	shallow water quarter diurnal constituent

A location can be specified by latitude/longitude pairs, assuming degrees as units, a GeoPosition specification or Entity objects, assuming they represent objects with geographic coordinates.
Location-specific properties include:

	"Coordinates"	coordinates of tide station
	"DateEstablished"	date tide station established
	"DateInstalled"	date tide station installed
	"DateRemoved"	date now-defunct tide station removed
	"GreatDiurnalRange"	difference between "MeanHigherHighWater" and "MeanLowerLowWater"
	"HighestWaterLevelOnStationDatum"	highest recorded water level
	"LowestWaterLevelOnStationDatum"	lowest recorded water level
	"MeanDiurnalHighWaterInequality"	average difference in height between high tides
	"MeanDiurnalLowWaterInequality"	average difference in height between low tides
	"MeanDiurnalTideLevel"	average of "MeanHigherHighWater" and "MeanLowerLowWater"
	"MeanHigherHighWater"	average highest high tide of the day
	"MeanHighWater"	average of high tides
	"MeanLowerLowWater"	average lowest low tide of the day
	"MeanLowWater"	average of low tides
	"MeanSeaLevel"	average water level
	"Position"	coordinates of the location
	"Station"	tide station Entity used
	"StationDistance"	distance to tide station used
	"StationName"	name of tide station used

Calculated properties include:

	"HighHighTide"	highest high tide for the day's predicted time and height
	"HighNeapTide"	next high neap tide's predicted time and height
	"HighSpringTide"	next high spring tide's predicted time and height
	"HighTide"	next high tide's predicted time and height
	"LowHighTide"	next low spring tide's predicted time and height
	"LowLowTide"	lowest low tide for the day's predicted time and height
	"LowNeapTide"	next low neap tide's predicted time and height
	"LowTide"	next low tide's predicted time and height
	"WaterLevel"	current water level relative to the mean

General properties include:

	"Elevation"	elevation
	"HarmonicAmplitudes"	amplitudes of harmonic constituents for input
	"HarmonicPhases"	phases of harmonic constituents for input
	"MeanTideLevel"	average level of tide

Universal harmonic constituent properties include:
"HarmonicNames" names of harmonic constituents

"HarmonicSpeeds" angular speeds of harmonic constituents
All heights are measured relative to the tide station datum or fixed-base elevation, often the zero of the first tide staff installed.
datespec should be specified as a specific time using a date list, a DateObject or as a string in DateString format.
datespec can also be specified as {start,end,increment} for compatibility with DateRange specifications. increment can be any valid DateRange increment. A datespec of {start, end} uses an increment of "Minute".
Times are returned in either the local time zone or the time zone of the location specified.
The option UnitSystem is available for controlling the units of the results. The following settings can be used:
"Imperial" return results in imperial units

"Metric" return results in metric units