Skip to content

The Basics of NASAPrecipitation.jl

There are two essential components in NASAPrecipitation.jl

  • A NASA precipitation dataset of interest (i.e., a NASAPrecipitationDataset npd)

  • 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(npd,geo)

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

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

The NASAPrecipitationDataset Type

All NASAPrecipitationDataset types (except for the Dummy types) contain 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

NASAPrecipitation.NASAPrecipitationDataset Type
julia
NASAPrecipitationDataset{ST<:AbstractString, DT<:TimeType}
    ID    :: ST
    name  :: ST
    doi   :: ST
    start :: DT
    stop  :: DT
    datapath :: ST
    maskpath :: ST
    hroot :: ST
    fpref :: ST
    fsuff :: ST
end

Abstract supertype for NASA Precipitation datasets on NASA OPeNDAP Servers.

Fields:

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

  • name : The name describing the NASAPrecipitationDataset, 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

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

  • maskpath : The directory in which to save our corresponding landsea mask datasets

  • 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

Of these fields, only start, stop, datapath and maskpath are user-defined. All other fields are predetermined depending on the type of NASA Precipitation Dataset called.

source

The AbstractGeoRegion Type

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

GeoRegions.AbstractGeoRegion Type
julia
AbstractGeoRegion

Abstract supertype for geographical regions. All AbstractGeoRegion types contain the following fields:

  • ID - A String Type, the identifier for the GeoRegion.

  • pID - A String Type, the identifier for the parent GeoRegion.

  • name - A String Type, the full name of the GeoRegion.

  • path - A String Type, the path of the file containing information on this GeoRegion.

  • N - A Float Type, contains the northernmost latitude bound.

  • S - A Float Type, contains the southernmost latitude bound.

  • E - A Float Type, contains the easternmost longitude bound.

  • W - A Float Type, contains the westernmost longitude bound.

  • θ - A Float Type, the rotation projection for the data in the GeoRegion

  • geometry - A Geometry or Vector{Geometry} Type

source