tsgettoolbox.tsgettoolbox.ldas_merra

tsgettoolbox.tsgettoolbox.ldas_merra(lat=None, lon=None, variables=None, startDate=None, endDate=None, variable=None)

global:0.5x0.625deg:1980-:H:MERRA-2 Land surface forcings

The time zone is always UTC.

The Modern-Era Retrospective analysis for Research and Applications, Version 2 (MERRA-2) provides data beginning in 1980. It was introduced to replace the original MERRA dataset because of the advances made in the assimilation system that enable assimilation of modern hyperspectral radiance and microwave observations, along with GPS-Radio Occultation datasets. It also uses NASA’s ozone profile observations that began in late 2004. Additional advances in both the GEOS model and the GSI assimilation system are included in MERRA-2. Spatial resolution remains about the same (about 50 km in the latitudinal direction) as in MERRA. Along with the enhancements in the meteorological assimilation, MERRA-2 takes some significant steps towards GMAO’s target of an Earth System reanalysis. MERRA-2 is the first long-term global reanalysis to assimilate space-based observations of aerosols and represent their interactions with other physical processes in the climate system. MERRA-2 includes a representation of ice sheets over (say) Greenland and Antarctica.

Description/Name	Spatial	Lat Range	Lon Range	Time
MERRA-2 2D, Instantaneous Land Surface Forcings M2I1NXLFO V5.12.4	0.5x0.625	-90, 90	-180, 180	1 hour 1980-01-01 to recent
MERRA-2 2D, Time-averaged Surface Flux Diagnostics M2T1NXFLX V5.12.4	0.5x0.625	-90, 90	-180, 180	1 hour 1980-01-01 to recent
MERRA-2 2D, Time-averaged Land Surface Forcings M2T1NXLFO V5.12.4	0.5x0.625	-90, 90	-180, 180	1 hour 1980-01-01 to recent

Parameters:

• lat (float) – Latitude (required): Enter single geographic latitude point. Use positive values for the northern hemisphere and negative for the southern hemisphere. The valid range is specified in the table above.

• lon (float) – Longitude (required): Enter single geographic longitude point. Use positive for the eastern hemisphere and negative for the western hemisphere. The valid range is specified in the table above.

• variables (str) –

  For the command line a comma separated string of variable codes from the following table. Using the Python API a list of variable strings. Valid variable names are specified in the table below.

  LDAS “variables” string	Description	Units
  M2I1NXLFO_5_12_4_HLML	Surface layer height:instant	m
  M2I1NXLFO_5_12_4_PS	Surface pressure:instant	Pa
  M2I1NXLFO_5_12_4_QLML	Surface specific humidity:instant	1
  M2I1NXLFO_5_12_4_SPEEDLML	Surface wind speed:instant	m/s
  M2I1NXLFO_5_12_4_TLML	Surface air temperature over land:instant	K
  M2T1NXFLX_5_12_4_BSTAR	Surface buoyancy scale:average	m/s**2
  M2T1NXFLX_5_12_4_CDH	Surface exchange coefficient for heat:average	mm/s
  M2T1NXFLX_5_12_4_CDM	Surface exchange coefficient for momentum:average	mm/s
  M2T1NXFLX_5_12_4_CDQ	Surface exchange coefficient for moisture:average	mm/s
  M2T1NXFLX_5_12_4_CN	Surface neutral drag coefficient:average	1
  M2T1NXFLX_5_12_4_DISPH	Zero plane displacement height:average	m
  M2T1NXFLX_5_12_4_EFLUX	Total latent energy flux:average	W/m**2
  M2T1NXFLX_5_12_4_EVAP	Evaporation from turbulence:average	mm/s
  M2T1NXFLX_5_12_4_FRCAN	Areal fraction of anvil showers:average	1
  M2T1NXFLX_5_12_4_FRCCN	Areal fraction of convective showers:average	1
  M2T1NXFLX_5_12_4_FRCLS	Areal fraction of nonanvil large scale showers:average	1
  M2T1NXFLX_5_12_4_FRSEAICE	Ice covered fraction of tile:average	1
  M2T1NXFLX_5_12_4_GHTSKIN	ground heating for skin temp:average	W/m**2
  M2T1NXFLX_5_12_4_HFLUX	Sensible heat flux from turbulence:average	W/m**2
  M2T1NXFLX_5_12_4_HLML	Surface layer height:average	m
  M2T1NXFLX_5_12_4_NIRDF	Surface downwelling nearinfrared diffuse flux:average	W/m**2
  M2T1NXFLX_5_12_4_NIRDR	Surface downwelling nearinfrared beam flux:average	W/m**2
  M2T1NXFLX_5_12_4_PBLH	Planetary boundary layer height:average	m
  M2T1NXFLX_5_12_4_PGENTOT	total column production of precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PRECANV	Anvil precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PRECCON	Convective precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PRECLSC	Non-anvil large scale precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PRECSNO	Snowfall:average	mm/s
  M2T1NXFLX_5_12_4_PRECTOTCORR	Total precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PRECTOT	Total precipitation:average	mm/s
  M2T1NXFLX_5_12_4_PREVTOT	total column re-evap/subl of precipitation:average	mm/s
  M2T1NXFLX_5_12_4_QLML	Surface specific humidity:average	1
  M2T1NXFLX_5_12_4_QSH	Effective surface specific humidity:average	kg/kg
  M2T1NXFLX_5_12_4_QSTAR	Surface moisture scale:average	kg/kg
  M2T1NXFLX_5_12_4_RHOA	Air density at surface:average	kg/m**3
  M2T1NXFLX_5_12_4_RISFC	Surface bulk Richardson number:average	1
  M2T1NXFLX_5_12_4_SPEEDMAX	Surface wind speed:max	m/s
  M2T1NXFLX_5_12_4_SPEED	Surface wind speed:average	m/s
  M2T1NXFLX_5_12_4_TAUGWX	Surface eastward gravity wave stress:average	N/m**2
  M2T1NXFLX_5_12_4_TAUGWY	Surface northward gravity wave stress:average	N/m**2
  M2T1NXFLX_5_12_4_TAUX	Eastward surface stress:average	N/m**2
  M2T1NXFLX_5_12_4_TAUY	Northward surface stress:average	N/m**2
  M2T1NXFLX_5_12_4_TCZPBL	Transcom planetary boundary layer height:average	m
  M2T1NXFLX_5_12_4_TLML	Surface air temperature:average	K
  M2T1NXFLX_5_12_4_TSH	Effective surface skin temperature:average	K
  M2T1NXFLX_5_12_4_TSTAR	Surface temperature scale:average	K
  M2T1NXFLX_5_12_4_ULML	Surface eastward wind:average	m/s
  M2T1NXFLX_5_12_4_USTAR	Surface velocity scale:average	m/s
  M2T1NXFLX_5_12_4_VLML	Surface northward wind:average	m/s
  M2T1NXFLX_5_12_4_Z0H	Surface roughness for heat:average	m
  M2T1NXFLX_5_12_4_Z0M	Surface roughness:average	m
  M2T1NXLFO_5_12_4_LWGAB	Surface absorbed longwave radiation:average	W/m**2
  M2T1NXLFO_5_12_4_PARDF	surface downwelling par diffuse flux:average	W/m**2
  M2T1NXLFO_5_12_4_PARDR	surface downwelling par beam flux:average	W/m**2
  M2T1NXLFO_5_12_4_PRECCUCORR	liquid water convective precipitation:average	mm/s
  M2T1NXLFO_5_12_4_PRECLSCORR	liquid water large scale precipitation:average	mm/s
  M2T1NXLFO_5_12_4_PRECSNOCORR	Snowfall:average	mm/s
  M2T1NXLFO_5_12_4_SWGDN	Incident shortwave radiation land:average	W/m**2
  M2T1NXLFO_5_12_4_SWLAND	Net shortwave land:average	W/m**2
  M2T1NXSLV_5_12_4_CLDPRS	Cloud top pressure	Pa
  M2T1NXSLV_5_12_4_CLDTMP	Cloud top temperature	K
  M2T1NXSLV_5_12_4_DISPH	Zero plane displacement height	m
  M2T1NXSLV_5_12_4_H1000	Height at 1000 mb	m
  M2T1NXSLV_5_12_4_H250	Height at 250 hPa	m
  M2T1NXSLV_5_12_4_H500	Height at 500 hPa	m
  M2T1NXSLV_5_12_4_H850	Height at 850 hPa	m
  M2T1NXSLV_5_12_4_OMEGA500	Omega at 500 hPa	Pa/s
  M2T1NXSLV_5_12_4_PBLTOP	Pbltop pressure	Pa
  M2T1NXSLV_5_12_4_PS	Surface pressure	Pa
  M2T1NXSLV_5_12_4_Q250	Specific humidity at 250 hPa	kg/kg
  M2T1NXSLV_5_12_4_Q500	Specific humidity at 500 hPa	kg/kg
  M2T1NXSLV_5_12_4_Q850	Specific humidity at 850 hPa	kg/kg
  M2T1NXSLV_5_12_4_QV10M	10-meter specific humidity	kg/kg
  M2T1NXSLV_5_12_4_QV2M	2-meter specific humidity	kg/kg
  M2T1NXSLV_5_12_4_SLP	Sea level pressure	Pa
  M2T1NXSLV_5_12_4_T10M	10-meter air temperature	K
  M2T1NXSLV_5_12_4_T250	Air temperature at 250 hPa	K
  M2T1NXSLV_5_12_4_T2M	2-meter air temperature	K
  M2T1NXSLV_5_12_4_T2MDEW	Dew point temperature at 2 m	K
  M2T1NXSLV_5_12_4_T2MWET	Wet bulb temperature at 2 m	K
  M2T1NXSLV_5_12_4_T500	Air temperature at 500 hPa	K
  M2T1NXSLV_5_12_4_T850	Air temperature at 850 hPa	K
  M2T1NXSLV_5_12_4_TO3	Total column ozone	Dobsons
  M2T1NXSLV_5_12_4_TOX	Total column odd oxygen	mm
  M2T1NXSLV_5_12_4_TQI	Total precipitable ice water	mm
  M2T1NXSLV_5_12_4_TQL	Total precipitable liquid water	mm
  M2T1NXSLV_5_12_4_TQV	Total precipitable water vapor	mm
  M2T1NXSLV_5_12_4_TROPPB	Tropopause pressure based on blended estimate	Pa
  M2T1NXSLV_5_12_4_TROPPT	Tropopause pressure based on thermal estimate	Pa
  M2T1NXSLV_5_12_4_TROPPV	Tropopause pressure based on EPV estimate	Pa
  M2T1NXSLV_5_12_4_TROPQ	Tropopause specific humidity using blended TROPP estimate	kg/kg
  M2T1NXSLV_5_12_4_TROPT	Tropopause temperature using blended TROPP estimate	K
  M2T1NXSLV_5_12_4_TS	Surface skin temperature	K
  M2T1NXSLV_5_12_4_U10M	10-meter eastward wind	m/s
  M2T1NXSLV_5_12_4_U250	Eastward wind at 250 hPa	m/s
  M2T1NXSLV_5_12_4_U2M	2-meter eastward wind	m/s
  M2T1NXSLV_5_12_4_U500	Eastward wind at 500 hPa	m/s
  M2T1NXSLV_5_12_4_U50M	50-meter eastward wind:time average	m/s
  M2T1NXSLV_5_12_4_U850	Eastward wind at 850 hPa	m/s
  M2T1NXSLV_5_12_4_V10M	10-meter northward wind	m/s
  M2T1NXSLV_5_12_4_V250	Northward wind at 250 hPa	m/s
  M2T1NXSLV_5_12_4_V2M	2-meter northward wind	m/s
  M2T1NXSLV_5_12_4_V500	Northward wind at 500 hPa	m/s
  M2T1NXSLV_5_12_4_V50M	50-meter northward wind:time average	m/s
  M2T1NXSLV_5_12_4_V850	Northward wind at 850 hPa	m/s
  M2T1NXSLV_5_12_4_ZLCL	Lifting condensation level	m

• 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”.