getGPSdata: getGPSdata

Description Usage Arguments Value Note Author(s) See Also

Description

This function reads GNSS data with a GPS-time stamp from a text file and add month-seconds in UTC format. Depending on the time format used in the raw data, the time format is converted to UTC. Month-seconds are required for combining GNSS data with RiverSurveyor data.

Usage

1
2
getGPSdata(data, GPStimeFormat = "UTChhmmss", tab.sep = ",",
  GPS.UTC.leapSeconds = NULL)

Arguments

data

a string containing the path to a text file containing GNSS coordinates and a time stamp.

GPStimeFormat

a string indicating the timestamp format. The following strings are accepted:
"GPSsecs" if the timestamp is in raw GPS seconds,
"UTCsecs" if the time stamp is in UTC seconds,
"UTChhmmss" if the time stamp format is in UTC hours-minutes-seconds format (default).

tab.sep

a string with the tab separator in the text file. Defaults to ",".

GPS.UTC.leapSeconds

Optional: an integer numeral specifying the number of leap seconds between GPS-time and UTC. This is only required if GPStimeFormat == "GPSsecs".

Value

a data.Frame containing the original coordinates and a date and a UTC column with the time stamp as month-seconds.

Note

data should contain at least XYZ coordinates and a timestamp. Generally, these are GNSS coordinates from an external GNSS source. The best input data is a *.csv file with post-processed trajectories exported from Trimble Business Center using UTC time stamps in local format.

this function is primarily intended to import data exported form Trimble Business center as processed baseline trajectories with the times stamp in the form of date (DD.MM.YYYY) followed by time in UTC hhmmss.sss format. For instance: 19.11.2010,090720.500

GPS leap seconds are introduced every now and then in order to align GPS time with UTC. It is not possible to include future leap seconds in the code. Therefore, any leap seconds need to be input by the user for the time period in question.

Author(s)

Claude Flener claude.flener@utu.fi

See Also

points2Plane


RiverSurvey documentation built on May 2, 2019, 5:46 p.m.