跳到目录

:name状态徽章 气象扫描状态徽章 R-CMD检查 编解码器

内政部 内政部

此软件包使搜索和下载多个月/年的历史天气数据变得更加容易加拿大环境与气候变化(ECCC)网站.

请记住,这些下载可能相当大,执行多次下载可能会不必要地占用ECCC的带宽。试着坚持你需要的。

有关详细信息和教程,请查看weathercan网站(或查看开发文档)

查看演示weathercan闪亮仪表板(html格式;来源)

安装

您可以安装气象雷达来自rOpenSci r-Universe:

安装.包(“天气预报员”,
回购= c(c)("https://ropensci.r-universe.dev网址",
                           "https://cloud.r-project.org网站"))

使用查看可用的渐晕图渐晕(package=“weathercan”)

查看特定的小插曲,例如,vignette(“weathercan”,package=“weathecan”)

一般用法

要下载数据,首先需要知道站点id与你感兴趣的电台相关。

车站

气象雷达包括功能站点()它返回电台及其详细信息的列表(包括站点id).

###A台:6×16
##prov station_name station_id climate_id WMO_id TC_id lat lon elev tz interval start-end normals normals_1981_2010 normals-1971_2000
##<chr><chr><dbl><chr><dbl
##1 AB DAYSLAND 1795 301AR54 NA<NA>52.9-112。689.等/格林尼治标准时间+7天1908 1922假假假
##2 AB DAYSLAND 1795 301AR54 NA<NA>52.9-112。689.等/格林威治标准时间+7小时NA NA FALSE FALSE
##3 AB DAYSLAND 1795 301AR54 NA<NA>52.9-112。689.等/格林威治标准时间+7个月1908 1922假假假
##4 AB EDMONTON CORONATION 1796 301BK03 NA<NA>53.6-114。671.等/格林尼治标准时间+7天1978 1979假假假
##5 AB EDMONTON CORONATION 1796 301BK03 NA<NA>53.6-114。671.等/格林威治标准时间+7小时NA NA FALSE FALSE
##6 AB EDMONTON CORONATION 1796 301BK03 NA<NA>53.6-114。671.等/格林尼治标准时间+7个月1978 1979假假假
一瞥(车站())
##行数:26382
##列数:16
##$prov<chr>“AB”、“AB“、”AB“,”AB…
##$station_name<chr>“DAYSLAND”,“DAYSLA”,“DAYSLAND”,“EDMONTON CORONATION”,“埃德蒙顿CORONASION”…
##$station_id<dbl>1795、1795、795、1796、1796和1796、1787、1797、1798、1798和1799、1799、1789、1800、1800和1801、1801、180、1802…
##$climate_id<chr>“301AR54”、“301AR54'”、“302AR54”,“301BK03”、“401BK03“、”301BK03'、“301B6L0”、“305B6LO”、“30B8LR…
##$WMO_id<dbl>不适用,不适用,不适用,不适用,不适用,不适用,不适用,不适用,不适用,不适用,不适用…
##$TC_id<chr>不适用,不适用,NA,NA,不适用…
##美元<dbl>52.87、52.87,52.87和53.57,53.57、53.57和52.15、52.15,53.20、53.20和53.20,52.40、52.40和52.40,52.40,54.08、54.08和53.52,…
##$lon<dbl>-112.28、-112.28和-112.28,-113.57和-113.57、-113.57,-111.73、-111.73和-111.73,-110.15、-110.15和-110.15,-115.20、-115.20和-115.2…
##$elev<dbl>688.8、688.8,688.8和670.6,670.6和670.9,838.2,838.2和838.2,640.0、640.0和640.0,1036.0和1036.0,1036.0,585.2,585.2和585.2,668…
##$tz<chr>“Etc/GTM+7”,“Etc-GTM+7“,”Etc/GMT+7“、”Etc-GMT+7”、“Etc/GMT+7”“、”Etc/GMT+七“、”Etc/GMT%7“、”埃tc/GTM%7“,”埃tc-GTM%7…
##$interval<chr>“天”,“小时”,“月”,“日”,“时”…
##$start<dbl>1908,北美,1908,1978,北美,1978,1987,北美,1987,1987,NA,1987,1980,1980,NA,1980,1986,NA,1986,1987,NA1987,1986…
##$结束<dbl>1922,NA,1922,1979,NA,1979,1990,NA,1990,1998,1998,2009,NA,2007,1981,NA,1981,2019,NA,20071991,NA,1991,1995…
##$normals<lgl>FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,TRUE,TRUE,TRUE,FALSE,FALSE,FALSE,TRUE,TRU…
##$normals_1981_2010<lgl>假、假、假…
##$normals_1971_2000<lgl>假、假、假,…

您可以直接查看此数据框,也可以使用站点搜索功能:

站点搜索(“坎卢普斯”,间隔= “小时”)
###A台:3×16
##prov station_name station_id climate_id WMO_id TC_id lat lon elev tz interval start-end normals normals_1981_2010 normals-1971_2000
##<chr><chr><dbl><chr><dbl
##公元前1年KAMLOOPS A 1275 1163780 71887 YKA 50.7-120。345.等/格林威治标准时间+8小时1953 2013真真真真
##公元前2年KAMLOOPS A 51423 1163781 71887 YKA 50.7-120。345.等/格林尼治标准时间+2013年8小时2023假假假
##3 BC KAMLOOPS AUT 42203 1163842 71741 ZKA 50.7-120。345等/格林尼治标准时间+2006年8小时2023假假假

时间范围必须是“小时”、“天”或“月”之一。

您还可以按距离进行搜索:

站点搜索(坐标= c(c)(50.667492,-120.329049),距离= 20,间隔= “小时”)
###A台:3×17
##prov station_name station_id climate_id WMO_id TC_id lat lon elev tz interval start-end normals normals _1981_2010 normals_1971_2000 distance(prov station名称站_ id气候_ id WMO_id TC _ id纬度高程tz间隔开始-结束法线法线-1981_2000距离)
##<chr><chr><dbl><chr><dbl><chr><dbl><dbl><chr><chr><dbl><dbl><lgl><lgl><dbl>
##公元前1年KAMLOOPS A 1275 1163780 71887 YKA 50.7-120。345.等/格林威治标准时间+8小时1953 2013真真真真8.61
##2 BC KAMLOOPS AUT 42203 1163842 71741 ZKA 50.7-120。345等/格林尼治标准时间+2006年8小时2023假假假8.61
##公元前3年KAMLOOPS A 51423 1163781 71887 YKA 50.7-120。345.等/格林尼治标准时间+2013年8小时2023假假假9.26

您可以使用更新此电台列表

##根据加拿大环境部,修改日期:2023-01-24 23:30 UTC

##加拿大环境部免责声明:
##“电台库存免责声明:请注意,此库存列表是我们网站上截至修改日期的电台快照,可能会随时更改,恕不另行通知。”
##“电台ID免责声明:电台ID是一个内部索引编号系统,如有更改,恕不另行通知。”

##电台数据已保存。。。
##使用“stations()”访问最新版本,使用“stations_meta()”查看上次更新的时间

并检查上次更新的时间

##$ECCC_已修改
##[1]“2023-01-24 23:30:00 UTC”
##
##$weathercan_已修改
## [1] "2023-09-20"

注:为了再现性,如果您使用电台列表收集数据,最好注意ECCC修改日期并将其包含在报告/手稿中。

天气

一旦你拥有了站点id(s) 您可以下载天气数据:

 <- 天气_dl(站点ID= 51423,启动= "2018-02-01",结束= “2018年4月15日”)
##从weathercan v0.3.0开始,时间显示为当地时间或UTC
##请参阅下面的详细信息?weather_dl了解更多信息。
##此消息在每个会话中显示一次
###A藏宝:1776×37
##station_name station_id station_operator prov lat lon elev climate_id WMO_id TC_id日期时间年月日小时天气hmdx
##<chr><dbl><lgl><chr><dbl><dbl><dbl
##1 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887 YKA 2018-02-01 2018-02-01 00:00:00 2018 02 01 00:00<NA>NA
##2 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887 YKA 2018-02-01 2018-02-01 01:00:00 2018 02 01 01:00斯诺NA
##3 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 02:00:00 2018 02 01 02:00<NA>NA
##4坎卢普斯A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 03:00:00 2018 02 01 03:00<NA>NA
##5 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887 YKA 2018-02-01 2018-02-01 04:00:00 2018 02 01 04:00多云NA
##6 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 05:00:00 2018 02 01 05:00<NA>NA
##7 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 06:00:00 2018 02 01 06:00<NA>NA
##8 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887 YKA 2018-02-01 2018-02-01 07:00:00 2018 02 01 07:00多云NA
##9 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 08:00:00 2018 02 01 08:00<NA>NA
##10 KAMLOOPS A 51423 NA BC 50.7-120。345.1163781 71887伊卡2018-02-01 2018-02-01 09:00:00 2018 02 01 09:00<NA>NA
## # 1766行

您还可以同时从多个站点下载数据:

kam_pg(磅) <- 天气_dl(站点ID= c(c)(48248,51423),启动= “2018年02月01日”,结束= "2018-04-15")

气候常态

要访问气候常态,首先需要了解气候_id与你感兴趣的电台相关。

站点_搜索(“温尼伯”,normals_years(正常_年)= “当前”)
###A台:1×13
##prov station_name station_id climate_id WMO_id TC_id lat lon elev tz normals正常值_1981_2010正常值_1971_2000
##<chr><chr><dbl><chr><dbl
##1 MB WINNIPEG RICHARDSON国际A 3698 5023222 71852 YWG 49.9-97.2 239。等/格林威治标准时间+6真真真真

然后您可以使用下载气候法线normals_dl()功能。

n个 <- 法线sdl("5023222")

请参阅入门想了解更多细节。

引用

引用(“天气扫描”)
##要在出版物中引用“weathercan”,请使用:
##
##LaZerte、Stefanie E和Sam Albers(2018年)。weathercan:从加拿大环境与气候变化局下载并格式化天气数据。这个
##开源软件杂志3(22):571。doi:10.21105/joss.00571。
##
##LaTeX用户的BibTeX条目是
##
##@文章{,
##title={{weathercan}:{D} 下载并格式化来自加拿大环境和气候变化的天气数据,
##author={Stefanie E LaZerte和Sam Albers},
##journal={开源软件杂志},
##体积={3},
##数字={22},
##页数={571},
##年份={2018年},
##url={https://joss.theoj.org/papers/10.21105/joss-00571},
##   }

许可证

此存储库中的数据和代码根据多个许可证进行许可。所有代码均已授权GPL-3公司所有天气数据均根据(开放式政府许可证-加拿大).

气象探测器在野外!

类似的包

利马台卡

气象雷达利马台卡开发时间大致相同,因此,两者都提供了从ECCC访问和下载数据的最新方法。两个软件包之间最大的区别是:a)气象雷达包括插值天气数据并将其直接集成到其他数据源的功能。b)气象雷达积极寻求在R中应用整齐的数据原则,并与tidyverse很好地集成,包括使用tibbles和嵌套列表。c)利马台卡包含用于指定短数据格式和长数据格式的参数。d)利马台卡具有使用泥浆2由同一作者打包。

中国大陆

中国大陆是一个较旧的软件包,上次更新时间为2012年。不幸的是,ECCC在过去几年内更新了他们的服务,这导致以前的许多web刮板都失败了。中国依赖于退役较旧的web-scraper所以现在已经坏了。

贡献

我们欢迎所有人的贡献!为了使过程尽可能对所有相关人员无痛,请参阅我们的贡献指南

行为准则

请注意,此项目发布时带有贡献者行为准则。参与此项目即表示您同意遵守其条款。