evetion / earthdata.jl

Julia interface to https://search.earthdata.nasa.gov

EarthData

A Julia interface to search.earthdata.nasa.gov

Installation

] add EarthData

Usage

julia> using EarthData

# Search for all GEDI L2A granules
julia> gg = granules(short_name="GEDI02_A")
1000-element Vector{EarthData.UMM_G}:
 EarthData.UMM_G
 EarthData.UMM_G
 EarthData.UMM_G
 EarthData.UMM_G
 EarthData.UMM_G
 EarthData.UMM_G
 EarthData.UMM_G

# A single granule, with the non-empty fields shown by default
julia> g[1]
EarthData.UMM_G
        TemporalExtent
        CollectionReference
        RelatedUrls
        GranuleUR
        Platforms
        DataGranule
        MetadataSpecification
        PGEVersionClass
        Projects
        AdditionalAttributes
        ProviderDates
        SpatialExtent
        OrbitCalculatedSpatialDomains
        MeasuredParameters

julia> gg[1].RelatedUrls[1].URL
"https://e4ftl01.cr.usgs.gov//GEDI_L1_L2/GEDI/GEDI02_A.002/2019.04.18/GEDI02_A_2019108002012_O01959_01_T03909_02_003_01_V002.h5"

# To download from this url, one requires an EarthData account
# You can store your credentials on disk with `netrc!(<user>, <password>)`
# which then can be used by `download` and `s3download`.
# One could open the resulting file with SpaceLiDAR.jl
fn = EarthData.download(gg[1].RelatedUrls[1].URL, "test.h5")

Next

Implementing collections will be next on the list to implement.

Other Packages

For access to EarthData with Python see earthaccess.

earthdata.jl's Issues

Search using geojson with POST

As reported by @alex-s-gardner at evetion/SpaceLiDAR.jl#18

Before I take a crack at this I wanted to see if you've already implemented a polygon geojson/shapefile granule search elsewhere?

get_s3_credentials will expire after 1-hour

I believe the temporary credentials issued by nasa expire after 1-hour. I wonder if we should include some auto-renew functionality.

I would also be tempted to keep variable names unchanged, e.g.

expiry = DateTime(body.expiration, dateformat"y-m-d H:M:S+z")

I would change to

expiration = DateTime(body.expiration, dateformat"y-m-d H:M:S+z")

This will make it easier for other to intuit variable names if they come with experience from another language / package

TagBot trigger issue

This issue is used to trigger TagBot; feel free to unsubscribe.

If you haven't already, you should update your TagBot.yml to include issue comment triggers.
Please see this post on Discourse for instructions and more details.

If you'd like for me to do this for you, comment TagBot fix on this issue.
I'll open a PR within a few hours, please be patient!