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 intereststop- The end of the date-range of our data of interestpath- The data directory in which our dataset is saved into
NASAMergedTb.TbDataset Type
TbDatasetThe TbDataset Type contains the following fields:
ID: ID for theTbDataset, used in determining containing folders and filenames of the NetCDFname: The name describing theTbDataset, used mostly in Loggingdoi: The DOI identifier, to be saved into the NetCDFstart: The start date (Y,M,D) of our download / analysisstop: The end date (Y,M,D) of our download / analysispath: The directory in which to save our downloads and analysis files tohroot: The URL of the NASA's EOSDIS OPeNDAP server for which this dataset is storedfpref: The prefix component of the NetCDF files to be downloadedfsuff: The suffix component of the NetCDF files to be downloaded
Defining a TbDataset is easy, all you have to define are two things:
Date range, ranging from
starttostopData
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())
[36m[1m[ [22m[39m[36m[1mInfo: [22m[39m2025-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.