download_merra2: Download meteorological and atmospheric data

View source: R/download.R

download_merra2R Documentation

Download meteorological and atmospheric data

Description

The download_merra2() function accesses and downloads various meteorological and atmospheric collections from NASA's Modern-Era Retrospective analysis for Research and Applications, Version 2 (MERRA-2) model.

Usage

download_merra2(
  collection = c("inst1_2d_asm_Nx", "inst1_2d_int_Nx", "inst1_2d_lfo_Nx",
    "inst3_3d_asm_Np", "inst3_3d_aer_Nv", "inst3_3d_asm_Nv", "inst3_3d_chm_Nv",
    "inst3_3d_gas_Nv", "inst3_2d_gas_Nx", "inst6_3d_ana_Np", "inst6_3d_ana_Nv",
    "statD_2d_slv_Nx", "tavg1_2d_adg_Nx", "tavg1_2d_aer_Nx", "tavg1_2d_chm_Nx",
    "tavg1_2d_csp_Nx", "tavg1_2d_flx_Nx", "tavg1_2d_int_Nx", "tavg1_2d_lfo_Nx",
    "tavg1_2d_lnd_Nx", "tavg1_2d_ocn_Nx", "tavg1_2d_rad_Nx", "tavg1_2d_slv_Nx",
    "tavg3_3d_mst_Ne", "tavg3_3d_trb_Ne", "tavg3_3d_nav_Ne", "tavg3_3d_cld_Np", 
    
    "tavg3_3d_mst_Np", "tavg3_3d_rad_Np", "tavg3_3d_tdt_Np", "tavg3_3d_trb_Np",
    "tavg3_3d_udt_Np", "tavg3_3d_odt_Np", "tavg3_3d_qdt_Np", "tavg3_3d_asm_Nv",
    "tavg3_3d_cld_Nv", "tavg3_3d_mst_Nv", "tavg3_3d_rad_Nv", "tavg3_2d_glc_Nx"),
  date = c("2018-01-01", "2018-01-01"),
  directory_to_save = NULL,
  acknowledgement = FALSE,
  download = FALSE,
  remove_command = FALSE,
  hash = FALSE
)

Arguments

collection

character(1). MERRA-2 data collection file name.

date

character(1 or 2). length of 10. Date or start/end dates for downloading data. Format "YYYY-MM-DD" (ex. January 1, 2018 = "2018-01-01").

directory_to_save

character(1). Directory to save data.

acknowledgement

logical(1). By setting TRUE the user acknowledges that the data downloaded using this function may be very large and use lots of machine storage and memory.

download

logical(1). FALSE will generate a *.txt file containing all download commands. By setting TRUE the function will download all of the requested data files.

remove_command

logical(1). Remove (TRUE) or keep (FALSE).

hash

logical(1). By setting TRUE the function will return an rlang::hash_file() hash character corresponding to the downloaded files. Default is FALSE. the text file containing download commands.

Value

  • For hash = FALSE, NULL

  • For hash = TRUE, an rlang::hash_file character.

  • netCDF (.nc4) files will be stored in a collection-specific folder within directory_to_save.

Author(s)

Mitchell Manware, Insang Song

References

\insertRef

data_gmao_merra-inst1_2d_asm_Nxamadeus

\insertRef

data_gmao_merra-inst1_2d_int_Nxamadeus

\insertRef

data_gmao_merra-inst1_2d_lfo_Nxamadeus

\insertRef

data_gmao_merra-inst3_3d_asm_Npamadeus

\insertRef

data_gmao_merra-inst3_3d_aer_Nvamadeus

\insertRef

data_gmao_merra-inst3_3d_asm_Nvamadeus

\insertRef

data_gmao_merra-inst3_3d_chm_Nvamadeus

\insertRef

data_gmao_merra-inst3_3d_gas_Nvamadeus

\insertRef

data_gmao_merra-inst3_2d_gas_Nxamadeus

\insertRef

data_gmao_merra-inst6_3d_ana_Npamadeus

\insertRef

data_gmao_merra-inst6_3d_ana_Nvamadeus

\insertRef

data_gmao_merra-statD_2d_slv_Nx_mamadeus

\insertRef

data_gmao_merra-statD_2d_slv_Nx_damadeus

\insertRef

data_gmao_merra-tavg1_2d_adg_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_aer_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_chm_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_csp_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_flx_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_int_Nxamadeus

\insertRef

pawson_merra-2_2020amadeus

\insertRef

data_gmao_merra-tavg1_2d_lnd_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_ocn_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_rad_Nxamadeus

\insertRef

data_gmao_merra-tavg1_2d_slv_Nxamadeus

\insertRef

data_gmao_merra-tavg3_3d_mst_Neamadeus

\insertRef

data_gmao_merra-tavg3_3d_trb_Neamadeus

\insertRef

data_gmao_merra-tavg3_3d_nav_Neamadeus

\insertRef

data_gmao_merra-tavg3_3d_cld_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_mst_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_rad_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_tdt_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_trb_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_udt_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_odt_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_qdt_Npamadeus

\insertRef

data_gmao_merra-tavg3_3d_asm_Nvamadeus

\insertRef

data_gmao_merra-tavg3_3d_cld_Nvamadeus

\insertRef

data_gmao_merra-tavg3_3d_mst_Nvamadeus

\insertRef

data_gmao_merra-tavg3_3d_rad_Nvamadeus

\insertRef

data_gmao_merra-tavg3_2d_glc_Nxamadeus

\insertRef

data_gmao_merra-instM_2d_asm_Nxamadeus

\insertRef

data_gmao_merra-instM_2d_int_Nxamadeus

\insertRef

data_gmao_merra-instM_2d_lfo_Nxamadeus

\insertRef

data_gmao_merra-instM_2d_gas_Nxamadeus

\insertRef

data_gmao_merra-instM_3d_asm_Npamadeus

\insertRef

data_gmao_merra-instM_3d_ana_Npamadeus

\insertRef

data_gmao_merra-tavgM_2d_adg_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_aer_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_chm_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_csp_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_flx_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_int_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_lfo_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_lnd_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_ocn_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_rad_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_slv_Nxamadeus

\insertRef

data_gmao_merra-tavgM_2d_glc_Nxamadeus

\insertRef

data_gmao_merra-tavgM_3d_cld_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_mst_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_rad_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_tdt_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_trb_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_udt_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_odt_Npamadeus

\insertRef

data_gmao_merra-tavgM_3d_qdt_Npamadeus

\insertRef

data_gmao_merra-const_2d_asm_Nxamadeus

\insertRef

data_gmao_merra-instU_2d_asm_Nxamadeus

\insertRef

data_gmao_merra-instU_2d_int_Nxamadeus

\insertRef

data_gmao_merra-instU_2d_lfo_Nxamadeus

\insertRef

data_gmao_merra-instU_2d_gas_Nxamadeus

\insertRef

data_gmao_merra-instU_3d_asm_Npamadeus

\insertRef

data_gmao_merra-instU_3d_ana_Npamadeus

\insertRef

data_gmao_merra-tavgU_2d_adg_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_aer_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_chm_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_csp_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_flx_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_int_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_lfo_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_lnd_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_ocn_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_rad_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_slv_Nxamadeus

\insertRef

data_gmao_merra-tavgU_2d_glc_Nxamadeus

\insertRef

data_gmao_merra-tavgU_3d_cld_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_mst_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_rad_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_tdt_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_trb_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_udt_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_odt_Npamadeus

\insertRef

data_gmao_merra-tavgU_3d_qdt_Npamadeus

Examples

## Not run: 
download_merra2(
  collection = "inst1_2d_int_Nx",
  date = "2024-01-01",
  directory_to_save = tempdir(),
  acknowledgement = TRUE,
  download = FALSE, # NOTE: download skipped for examples,
  remove_command = TRUE,
)

## End(Not run)

amadeus documentation built on April 4, 2025, 12:21 a.m.