urls2df: Read AIS text files into data.frame from URL

In mvisalli/shipr: ships for whales functions

Description

Read AIS text files into data.frame from URL

Usage

urls2df(path = NULL)

Arguments

path	URL path to AIS text file.

Details

based on AIS_SBARC_*.txt with possibility for alternate file formats and filtering for class A position reports, ie Message ID 1,2,3 per https://www.navcen.uscg.gov/?pageName=AISMessages. Must provide a url path which leads to an AIS.txt file. AIS data in .txt file must be formatted similarly to those on https://ais.sbarc.org/logs_delimited/ If URL is empty, urls2df() will return a dataframe with 2 observations of 10 variables, but it is essentially to show when there's data gaps from AIS provider.

Value

df data.frame of AIS data.

Examples

 df = urls2df("https://ais.sbarc.org/logs_delimited/2019/190101/AIS_SBARC_190101-00.txt")

Empty file returns small dummy dataframe with date, filename,and system time
df_empty_url = urls2df("https://ais.sbarc.org/logs_delimited/2019/191217/AIS_SBARC_191217-00.txt")

mvisalli/shipr documentation built on Aug. 8, 2020, 8:38 p.m.