Skip to content

TRMM TMPA Datasets

TRMM TMPA Datasets are represented by the TRMMDataset AbstractType, which in itself is broken into the TRMM3Hourly, TRMMDaily and TRMMMonthly Types. For 3-hourly and daily datsets, NASA provides not just the output from the final processing run, but also near real-time runs.

The Types that each dataset calls are listed below, along with their function calls.

TypeNear Real-TimeFinal
3 HourTRMM3HourlyTRMM3HourlyNRT()TRMM3Hourly()
DailyTRMMDailyTRMMDailyNRT()TRMMDaily()
MonthlyTRMMMonthlyTRMMMonthly()

So, for example, if we wanted to get the the Near Real-Time TRMM 3-Hourly dataset, we would call the function TRMMMonthly(), which would return a TRMMMonthly data structure (see example at the end of the page).

Setup

julia
using NASAPrecipitation

TRMMDataset Types / Objects

There are three different Types of TRMMDataset:

  • TRMM3Hourly, which is used to contain information on half-hourly TRMM TMPA datasets

  • TRMMDaily, which is used to contain information on daily TRMM TMPA datasets

  • TRMMMonthly, which is used to contain information on monthly TRMM TMPA datasets

Creating a TRMM3Hourly dataset

The TRMM3Hourly dataset structure is used to contain information regarding 3-hourly TRMM datasets. There are two functions that create TRMM3Hourly datasets

  • TRMM3HourlyNRT, which is used to retrieve Near Real-Time runs

  • TRMM3Hourly, which is used to retrieve the Final post-processing runs

First, let's define an "Near Real-Time" dataset:

julia
npd = TRMM3HourlyNRT(start=Date(2017,2,1),stop=Date(2017,2,1))
The NASA Precipitation Dataset {String,Date} has the following properties:
    Dataset ID         (ID) : trmm3hourlynrt
    Logging Name       (name) : Near Real-Time TRMM 3-Hourly
    DOI URL              (doi) : 10.5067/TRMM/TMPA/3H-E/7
    Data Directory  (datapath) : /home/runner/trmm3hourlynrt
    Mask Directory  (maskpath) : /home/runner/trmmmask
    Date Begin         (start) : 2017-02-01
    Date End            (stop) : 2017-02-01
    Timestep                   : 3 Hourly
    Data Resolution            : 0.25º
    Data Server        (hroot) : https://disc2.gesdisc.eosdis.nasa.gov/opendap/TRMM_RT/TRMM_3B42RT.7
julia
typeof(npd)
TRMM3Hourly{String, Date}

First, let's define a "Standard" dataset:

julia
npd = TRMM3Hourly(start=Date(2017,2,1),stop=Date(2017,2,1))
The NASA Precipitation Dataset {String,Date} has the following properties:
    Dataset ID         (ID) : trmm3hourly
    Logging Name       (name) : Final TRMM 3-Hourly
    DOI URL              (doi) : 10.5067/TRMM/TMPA/3H/7
    Data Directory  (datapath) : /home/runner/trmm3hourly
    Mask Directory  (maskpath) : /home/runner/trmmmask
    Date Begin         (start) : 2017-02-01
    Date End            (stop) : 2017-02-01
    Timestep                   : 3 Hourly
    Data Resolution            : 0.25º
    Data Server        (hroot) : https://disc2.gesdisc.eosdis.nasa.gov/opendap/TRMM_L3/TRMM_3B42.7
julia
typeof(npd)
TRMM3Hourly{String, Date}

We see as above that whether a dataset is "Near Real-Time" or "Standard/Final" doesn't matter, it will return the same dataset type. What changes will be the values in the fields, not the dataset structure or type itself.

Warning

TRMM3Hourly datasets are designed to select data by entire days, and so here npd.start and npd.stop are defined by the entire days for which data is downloaded.

Creating a TRMMDaily dataset

The TRMMDaily dataset structure is used to contain information regarding Daily TRMM datasets. There are two functions that create TRMMDaily datasets

  • TRMMDailyNRT, which is used to retrieve Near Real-Time runs

  • TRMMDaily, which is used to retrieve the Final post-processing runs

julia
npd = TRMMDailyNRT(start=Date(2017,2,5),stop=Date(2017,2,5))
The NASA Precipitation Dataset {String,Date} has the following properties:
    Dataset ID         (ID) : trmmdailynrt
    Logging Name        (name): Near Real-Time TRMM Daily
    DOI URL              (doi) : 10.5067/TRMM/TMPA/DAY-E/7
    Data Directory  (datapath) : /home/runner/trmmdailynrt
    Mask Directory  (maskpath) : /home/runner/trmmmask
    Date Begin         (start) : 2017-02-01
    Date End            (stop) : 2017-02-28
    Timestep                   : 1 Day
    Data Resolution            : 0.25º
    Data Server        (hroot) : https://disc2.gesdisc.eosdis.nasa.gov/opendap/TRMM_RT/TRMM_3B42RT_Daily.7
julia
typeof(npd)
TRMMDaily{String, Date}

Warning

TRMMDaily datasets are designed to select data by entire months, and so here npd.start and npd.stop define the whole month of Feb 2017.

Creating a TRMMMonthly dataset

The TRMMMonthly dataset structure is used to contain information regarding Monthly TRMM datasets. The function used to create TRMMMonthly datasets is

  • TRMMMonthly, which is used to retrieve the Final post-processing runs
julia
npd = TRMMMonthly(start=Date(2017,6,1),stop=Date(2017,8,15))
The NASA Precipitation Dataset {String,Date} has the following properties:
    Dataset ID         (ID) : trmmmonthly
    Logging Name       (name) : TRMM Monthly (TMPA 3B43)
    DOI URL              (doi) : 10.5067/TRMM/TMPA/MONTH/7
    Data Directory  (datapath) : /home/runner/trmmmonthly
    Mask Directory  (maskpath) : /home/runner/trmmmask
    Date Begin         (start) : 2017-01-01
    Date End            (stop) : 2017-12-31
    Timestep                   : 1 Month
    Data Resolution            : 0.25º
    Data Server        (hroot) : https://disc2.gesdisc.eosdis.nasa.gov/opendap/TRMM_L3/TRMM_3B43.7
julia
typeof(npd)
TRMMMonthly{String, Date}

Warning

TRMMMonthly datasets are designed to select data by entire years, and so here npd.start and npd.stop define the whole year of 2017.