collect_from_NOAA: Collect bathymetry from NOAA

Description Usage Arguments Details Value References

View source: R/add_water_depth.R

Description

This function collects NOAA bathymetry with the marmap R-pacakge based on the min and max coordinates in the database.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
collect_from_NOAA(
  stations = NULL,
  buffer = 2,
  resolution = 1,
  data_folder = "data",
  out_folder = "data",
  lats = NULL,
  lons = NULL,
  as_CSV = FALSE
)

Arguments

stations

The initial database for stations with track midpoints (attributes "Lat_DD_midpt" and "Lon_DD_midpt"). If NULL (default) the function will automatically search the data_folder for 'stations_initial.rda'.

buffer

The size of the buffer zone in decimal degrees around the given min and max coordinates. Default = 2.

resolution

The resolution in minutes the bathymetry is collected in. A lower resolution provides better depth estimates from bathymetry, but takes a longer time to collect from the NOAA database. Default resolution is 1 minute.

data_folder

If the stations database is not provided, the function will search for it ('stations_initial.rda') in this folder. Default is 'data'.

out_folder

The external data is stored in this folder. Default is 'data'.

lats

(optional) You can specify latitudes you want to use to collect bathymetry: a numeric vector with latitudes of which the min and max are found and used. If not specified, the latitudes from the database are used.

lons

(optional) You can specify longitudes you want to use to collect bathymetry: a numeric vector with longitudes of which the min and max are found and used. If not specified, the longitudes from the database are used.

as_CSV

If you also want to store the collected external data as CSV, set to TRUE. Default is FALSE.

Details

Bathymetry data is collected from the NOAA database using the marmap R-package. You need internet connection to do this. The default resolution is 1 minute. You can also choose to collect your own bathymetry with a different resolution from NOAA by using the package function collect_bathymetry, or not to collect bathymetry externally at all if you have your own dataset.

Value

This function does not return an object, but stores the information in the specified out_folder under the names 'bathymetry.rda'.

References

marmap R-package


dswdejonge/TripleD documentation built on June 18, 2020, 12:24 p.m.