The Basics of NASAMergedTb.jl

There are two essential components in NASAMergedTb.jl

• The NASA Level 3 Brightness Temperature Dataset (i.e., a TbDataset btd)

• A geographic region of interest (i.e., a GeoRegion geo)

With these two components, you can perform the following actions:

• Download data of interest using download(btd,geo)

• Perform basic analysis on the data using analysis(btd,geo)

• Manipulate the data (e.g., spatiotemporal smoothing using smooth(btd,geo,...))

• Determine regions of shallow and deep convection depending your specified thresholds

The TbDataset Type

The TbDataset type contains the following information:

• start - The beginning of the date-range of our data of interest

• stop - The end of the date-range of our data of interest

• path - The data directory in which our dataset is saved into

NASAMergedTb.TbDataset Type

TbDataset(
    ST = String,
    DT = Date;
    start :: TimeType,
    stop  :: TimeType,
    path :: AbstractString = homedir(),
) -> btd :: TbDataset{ST,DT}

Creates a TbDataset dataset btd to store information on the Brightness Temperature dataset

Keyword Arguments

• start : Date at which download / analysis of the dataset begins

• stop : Date at which download / analysis of the dataset ends

• path : The directory in which the folder imergearlydy will be created for data downloads, storage and analysis, default is the home directoy called by homedir()

The following fields in btd will be fixed as below:

• ID : tb

• name : Brightness Temperature

• doi : 10.5067/P4HZB9N27EKU

• hroot : https://disc2.gesdisc.eosdis.nasa.gov/opendap/MERGED_IR/GPM_MERGIR.1

• fpref : merg

• fsuff : 4km-pixel.nc4

source

Defining a TbDataset is easy, all you have to define are two things:

1. Date range, ranging from start to stop

2. Data path, i.e. where you want to save the NASA Brightness Temperature Data

TbDataset(
    start = Date(),
    stop  = Date(),
    path  = ...
)

See below for an example of defining an TbDataset

julia> using NASAMergedTb

julia> npd = TbDataset(start=Date(2017,2,1),stop=Date(2017,2,1),path=homedir())
[ Info: 2025-07-16T03:24:52.567 - NASAMergedTb.jl - Setting up data structure containing information on NASA Brightness Temperature data to be downloaded
The NASA Brightness Temperature Dataset {String,Date} has the following properties:
    Dataset ID           (ID) : tb
    Logging Name       (name) : Brightness Temperature
    DOI URL             (doi) : 10.5067/P4HZB9N27EKU
    Data Directory     (path) : /home/runner/tb
    Date Begin        (start) : 2017-02-01
    Date End           (stop) : 2017-02-01
    Timestep                  : Half Hourly
    Data Resolution           : 4 km
    Data Server       (hroot) : https://disc2.gesdisc.eosdis.nasa.gov/opendap/MERGED_IR/GPM_MERGIR.1

julia> npd.start
2017-02-01

julia> npd.path
"/home/runner/tb"

The AbstractGeoRegion Type

A GeoRegion defines the geometry/geometries of geograhical region(s) of interest. See the documentation of GeoRegions.jl for more information.

Missing docstring.

Missing docstring for GeoRegions.AbstractGeoRegion. Check Documenter's build log for details.