tsgettoolbox.tsgettoolbox.ldas

tsgettoolbox.tsgettoolbox.ldas(lat=None, lon=None, xindex=None, yindex=None, variables=None, startDate=None, endDate=None, variable=None)

global:grid:::Land Data Assimilation System, includes all ldas_* (NLDAS, GLDAS2, TRMM, SMERGE, GRACE, MERRA)

This will download data from a set of water cycle related variables (Table 1) from the North American and Global Land Data Assimilation Systems (NLDAS and GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment (GRACE) data assimilation. In addition to their access provided by the hydrology community tools, selected data rods variables can be searched and accessed through the GES DISC search and access user interface, and all data rods variables can be accessed via Web services developed by the GES DISC.

The time zone is always UTC.

Description/Name

Spatial

Time

GLDAS Noah Land Surface Model GLDAS_NOAH025_3H V2.1

0.25x0.25 degree

-180,-60 to

180, 90

3 hour

2000-01-01 to recent

Groundwater and Soil Moisture Conditions from GRACE Data Assimilation GRACEDADM_CLSM0125US_7D V4.0

0.125x0.125 degree

-125, 25 to

-67, 53

7 day

2002-10-04 to recent

MERRA-2 2D, Instantaneous, Land Surface Forcings M2I1NXLFO V5.12.4

0.5x0.625 degree

-180,-90 to

180, 90

1 hour

1980-01-01 to recent

MERRA-2 2D, Time-averaged, Surface Flux Diagnostics M2T1NXFLX V5.12.4

0.5x0.625 degree

-180,-90 to

180, 90

1 hour

1980-01-01 to recent

MERRA-2 2D, Time-averaged, Land Surface Forcings M2T1NXLFO V5.12.4

0.5x0.625 degree

-180,-90 to

180, 90

1 hour

1980-01-01 to recent

MERRA 2D Incremental Analysis Update MST1NXMLD V5.12.4

0.5x0.667 degree

-180,-90 to

180, 90

1 hour

1980-01-01 to 2016-02-29

NLDAS Primary Forcing Data NLDAS_FORA0125_H V002

0.125x0.125 degree

-125,25 to

-67,53

1 hour

1979-01-01T13 til recent

NLDAS Noah Land Surface Model NLDAS_NOAH0125_H V002

0.125x0.125 degree

-125,25 to

-67,53

1 hour

1979-01-01T13 til recent

Smerge-Noah-CCI root zone soil moisture 0-40 cm SMERGE_RZSM0_40CM V2.0

0.125x0.125 degree

-125, 25 to

-67, 53

1 day

1979-01-02 to recent

TRMM (TMPA) Rainfall Estimate TRMM_3B42 V7

0.25x0.25 degree

-180,-50 to

180, 50

3 hour

1997-12-31 to recent
Parameters:

  • lat (float) –

    Should use ‘lat’ and ‘lon’ to specify location.

    Latitude (required): Enter single geographic point by latitude.:

    Example: --lat=43.1

    If known, ‘xindex’ and ‘yindex’ can be used for the NLDAS grid only.

  • lon (float) –

    Should use ‘lat’ and ‘lon’ to specify location.

    Longitude (required): Enter single geographic point by longitude:

    Example: --lon=-85.3

    If known, ‘xindex’ and ‘yindex’ can be used for the NLDAS grid only.

  • xindex (int) –

    It lat or lon is None, then will try xindex and yindex.

    Enter the x index of the NLDAS grid.:

    Example: --xindex=301

  • yindex (int) –

    It lat or lon is None, then will try xindex and yindex.

    Enter the y index of the NLDAS grid.:

    Example: --yindex=80

  • variables (str) –

    Use the variable codes from the following table:

    LDAS “variables” string Description

    Units

    NLDAS_FORA0125_H.002:APCPsfc Precipitation hourly total

    mm

    NLDAS_FORA0125_H.002:DLWRFsfc Surface DW longwave radiation flux

    W/m**2

    NLDAS_FORA0125_H.002:DSWRFsfc Surface DW shortwave radiation flux

    W/m**2

    NLDAS_FORA0125_H.002:PEVAPsfc Potential evaporation

    mm

    NLDAS_FORA0125_H.002:SPFH2m 2-m above ground specific humidity

    kg/kg

    NLDAS_FORA0125_H.002:TMP2m 2-m above ground temperature

    K

    NLDAS_FORA0125_H.002:UGRD10m 10-m above ground zonal wind

    m/s

    NLDAS_FORA0125_H.002:VGRD10m 10-m above ground meridional wind

    m/s

    NLDAS_NOAH0125_H.002:EVPsfc Total evapotranspiration

    mm

    NLDAS_NOAH0125_H.002:GFLUXsfc Ground heat flux

    W/m**2

    NLDAS_NOAH0125_H.002:LHTFLsfc Latent heat flux

    W/m**2

    NLDAS_NOAH0125_H.002:SHTFLsfc Sensible heat flux

    W/m**2

    NLDAS_NOAH0125_H.002:SSRUNsfc Surface runoff (non-infiltrating)

    mm

    NLDAS_NOAH0125_H.002:BGRUNsfc Subsurface runoff (baseflow)

    mm

    NLDAS_NOAH0125_H.002:SOILM0-10cm 0-10 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:SOILM0-100cm 0-100 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:SOILM0-200cm 0-200 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:SOILM10-40cm 10-40 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:SOILM40-100cm 40-100 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:SOILM100-200cm 100-200 cm soil moisture content

    mm

    NLDAS_NOAH0125_H.002:TSOIL0-10cm 0-10 cm soil temperature

    K

    GLDAS_NOAH025_3H_v2.1:AvgSurfT_inst Average surface skin temperature

    K

    GLDAS_NOAH025_3H_v2.1:Evap_tavg Evapotranspiration

    mm/s

    GLDAS_NOAH025_3H_v2.1:Psurf_f_inst Surface air pressure

    Pa

    GLDAS_NOAH025_3H_v2.1:Qair_f_inst Specific humidity

    kg/kg

    GLDAS_NOAH025_3H_v2.1:Qs_acc Storm surface runoff

    mm

    GLDAS_NOAH025_3H_v2.1:Qsb_acc Baseflow-groundwater runoff

    mm

    GLDAS_NOAH025_3H_v2.1:Rainf_f_tavg Total precipitation rate

    mm/s

    GLDAS_NOAH025_3H_v2.1:Rainf_tavg Rain precipitation rate

    mm/s

    GLDAS_NOAH025_3H_v2.1:Snowf_tavg Snow precipitation rate

    mm/s

    GLDAS_NOAH025_3H_v2.1:SoilMoi0_10cm_inst Soil moisture content (0-10 cm)

    mm

    GLDAS_NOAH025_3H_v2.1:SoilMoi10_40cm_inst Soil moisture content (10-40 cm)

    mm

    GLDAS_NOAH025_3H_v2.1:SoilMoi40_100cm_inst Soil moisture content (40-100 cm)

    mm

    GLDAS_NOAH025_3H_v2.1:SoilTMP0_10cm_inst Soil temperature (0-10 cm)

    K

    GLDAS_NOAH025_3H_v2.1:Tair_f_inst Near surface air temperature

    K

    GLDAS_NOAH025_3H_v2.1:Wind_f_inst Near surface wind speed

    m/s

    TRMM_3B42.7:precipitation Precipitation

    mm/hr

    SMERGE_RZSM0_40CM_2.0:CCI_ano CCI soil moisture anomalies 0-40 cm

    m3/m3

    SMERGE_RZSM0_40CM_2.0:RZSM Average soil moisture of 0-40 cm layer

    m3/m3

    GRACEDADM_CLSM0125US_7D.4:gws_inst Groundwater storage percentile

    percent

    GRACEDADM_CLSM0125US_7D.4:rtzsm_inst Root zone soil moisture percentile

    percent

    GRACEDADM_CLSM0125US_7D.4:sfsm_inst Surface soil moisture percentile

    percent

    M2I1NXLFO.5124:QLML Surface specific humidity:instant

    1

    M2I1NXLFO.5124:TLML Surface air temperature over land:instant

    K

    M2I1NXLFO.5124:SPEEDLML Surface wind speed:instant

    m/s

    M2T1NXFLX.5124:ULML Surface eastward wind:average

    m/s

    M2T1NXFLX.5124:VLML Surface northward wind:average

    m/s

    M2T1NXLFO.5124:LWGAB Surface absorbed longwave radiation:average

    W/m**2

    M2T1NXLFO.5124:SWGDN Incident shortwave radiation land:average

    W/m**2

    MST1NXMLD.520:BASEFLOW Baseflow

    mm/s

    MST1NXMLD.520:LHLAND Latent heat flux from land

    W/m**2

    MST1NXMLD.520:PRECSNO Surface snowfall

    mm/s

    MST1NXMLD.520:PRECTOT Total surface precipitation

    mm/s

    MST1NXMLD.520:RUNOFF Overland runoff

    mm/s

    MST1NXMLD.520:SFMC Top soil layer soil moisture content

    m3/m3

    MST1NXMLD.520:SHLAND Sensible heat flux from land

    W/m**2

    MST1NXMLD.520:TSOIL1 Soil temperature in layer 1

    K

  • startDate (str) –

    The start date of the time series.:

    Example: --startDate=2001-01-01T05

    If startDate and endDate are None, returns the entire series.

  • endDate (str) –

    The end date of the time series.:

    Example: --endDate=2002-01-05T05

    If startDate and endDate are None, returns the entire series.

  • variable (str) – DEPRECATED: use “variables” instead to be consistent across “tsgettoolbox”.