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 intereststop- The end of the date-range of our data of interestpath- The data directory in which our dataset is saved into
NASAPrecipitation.NASAPrecipitationDataset Type
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
endAbstract supertype for NASA Precipitation datasets on NASA OPeNDAP Servers.
Fields:
ID: ID for theNASAPrecipitationDataset, used in determining containing folders and filenames of the NetCDFname: The name describing theNASAPrecipitationDataset, 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 / analysisdatapath: The directory in which to save our downloads and analysis files tomaskpath: The directory in which to save our corresponding landsea mask datasetshroot: 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
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.
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
AbstractGeoRegionAbstract supertype for geographical regions. All AbstractGeoRegion types contain the following fields:
ID- AStringType, the identifier for the GeoRegion.pID- AStringType, the identifier for the parent GeoRegion.name- AStringType, the full name of the GeoRegion.path- AStringType, the path of the file containing information on this GeoRegion.N- AFloatType, contains the northernmost latitude bound.S- AFloatType, contains the southernmost latitude bound.E- AFloatType, contains the easternmost longitude bound.W- AFloatType, contains the westernmost longitude bound.θ- AFloatType, the rotation projection for the data in the GeoRegiongeometry- AGeometryorVector{Geometry}Type