Description Usage Arguments Details Value Author(s) References See Also Examples
The data are downloaded with utils::download.file()
pointed to the Environment Canada website (ref 1)
using queries that had to be devised by reverse-engineering, since the agency
does not provide documentation about how to construct queries. Caution: the
query format changes from time to time, so dc.met()
may work one
day, and fail the next.
1 2 3 4 5 6 7 8 9 10 11 |
id |
A number giving the "Station ID" of the station of interest. |
year |
A number giving the year of interest. Ignored unless |
month |
A number giving the month of interest. Ignored unless |
deltat |
Optional character string indicating the time step of the
desired dataset. Only |
destdir |
character value indicating the directory in which to store
downloaded files. The default value of |
destfile |
character value indicating the name of the file. If not supplied, then the file name is constructed from the other parameters of the function call, so that subsequent calls with the same parameters will yield the same result; this is useful for caching. |
force |
A logical value that indicates whether to force the download,
even if the pathname constructed from |
dryrun |
A logical value that indicates whether to return the constructed web query, without attempting to download the file. This can be helpful in designing responses to changing URLs. |
debug |
an integer specifying whether debugging information is
to be printed during processing. The printing is done by
a call to |
The constructed query contains Station ID, as provided in the id
argument.
Note that this seems to be a creation of Environment Canada, alone;
it is distinct from the more standard "Climate ID" and "WMO ID".
To make things more difficult, Environment Canada states that the
Station ID is subject to change over time. (Whether this applies to existing
data is unclear.)
Given these difficulties with Station ID, users are advised to consult
the Environment Canada website (ref 1) before downloading any data,
and to check it from time to time
during the course of a research project, to see if the Station ID has changed.
It can be very helpful to use Gavin Simpson's
canadaHCD
package (ref 2) to look up Station IDs. This package maintains
a copy of the Environment Canada listing of stations, and its
find_station
function provides an easy way to determine Station IDs.
After that, its hcd_hourly
function (and related functions) make
it easy to read data.
String indicating the full pathname to the downloaded file.
Dan Kelley
Dan Kelley 2017-09-16
Environment Canada website for Historical Climate Data http://climate.weather.gc.ca/index_e.html
Gavin Simpson's canadaHCD
package on GitHub
https://github.com/gavinsimpson/canadaHCD
The work is done with dc()
.
Other functions that download ocean-related data:
dc.coastline()
,
dc.g1sst()
,
dc.hydrography()
,
dc.topo()
,
dc.woa()
1 2 3 4 5 6 7 8 9 10 |
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.