jma_collect: Collect JMA Historical Weather Data

View source: R/jma_collect.R

jma_collectR Documentation

Collect JMA Historical Weather Data

Description

[Stable]

Refer to the data available in the JMA Historical Weather Data Search. Executed by specifying the target location and date. Currently, not all types of data acquisition are supported.

Usage

jma_collect(
  item = NULL,
  block_no,
  year,
  month,
  day,
  cache = TRUE,
  pack = TRUE,
  quiet = FALSE
)

Arguments

item

Type of weather data to be acquired. Mainly specifies the interval between records (e.g. daily or hourly). See NOTE for details.

block_no

Block number of the location to be observed. It is assumed that block_no is input as a string consisting of a 4- or 5-digit number. If a numeric value is specified, it is processed as a string.

year

select year

month

select month

day

select date (default NULL)

cache

use cash and save to cache. (TRUE, the default)

pack

Whether to packing common variables or not. (TRUE, the default)

quiet

Whether to output information on variable and row combinations that were treated as missing values for some reason. (TRUE, the default)

Value

a tbl object

Note

The parameter item chooses one from these:

  • annually: Annual value. Please specify a location by block_no.

  • monthly: Monthly value. Please specify location and year.

  • 3monthly: Value every 3 months. Please specify location and year.

  • 10daily: Seasonal value. Please specify location and year.

  • mb5daily: Semi-seasonal value. Please specify location and year.

  • daily: Daily value. Please specify location, year and month.

  • hourly: Hourly value. Please specify location, year, month and day.

  • rank: Values of the largest in the history of observations.

  • nml_ym: Climatological normals for each year and month.

  • nml_3m: Climatological normals for each 3 months.

  • nml_10d: Climatological normals for each season (almost 10 days).

  • nml_mb5d: Climatological normals for each semi-season (almost 5 days).

  • nml_daily: Daily climatological normals for specific month. for each location.

Examples


# Annually
jma_collect(item = "annually", "1284", year = 2017, month = 11, cache = FALSE)
# Daily
jma_collect(item = "daily", block_no = "0010", year = 2017, month = 11, cache = FALSE)
jma_collect(item = "daily", "0422", year = 2017, month = 11, cache = FALSE)
# Hourly
jma_collect("hourly", "0010", 2018, 7, 30, cache = FALSE)
# Historical Ranking
jma_collect("rank", block_no = "47646", year = 2020, cache = FALSE)
# Climatological normals
jma_collect("nml_ym", block_no = "47646", cache = FALSE, pack = FALSE)
jma_collect("nml_3m", "47646", cache = FALSE, pack = FALSE, quiet = TRUE)
jma_collect("nml_10d", "0228", cache = FALSE, pack = FALSE, quiet = TRUE)
jma_collect("nml_mb5d", "0228", cache = FALSE, pack = FALSE, quiet = FALSE)


jmastats documentation built on April 12, 2025, 1:38 a.m.