Skip to content

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
julia
TbDataset

The TbDataset Type contains the following fields:

  • ID : ID for the TbDataset, used in determining containing folders and filenames of the NetCDF

  • name : The name describing the TbDataset, used mostly in Logging

  • doi : The DOI identifier, to be saved into the NetCDF

  • start : The start date (Y,M,D) of our download / analysis

  • stop : The end date (Y,M,D) of our download / analysis

  • path : The directory in which to save our downloads and analysis files to

  • hroot : The URL of the NASA's EOSDIS OPeNDAP server for which this dataset is stored

  • fpref : The prefix component of the NetCDF files to be downloaded

  • fsuff : The suffix component of the NetCDF files to be downloaded

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
julia> using NASAMergedTb

julia> npd = TbDataset(start=Date(2017,2,1),stop=Date(2017,2,1),path=homedir())
[ Info: 2025-09-08T20:55:12.284 - 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/mergedIR
    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/mergedIR"

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.