Skip to content

Commit 2af2e16

Browse files
committed
Edits to search, discovery, and access sections
1 parent 85400ac commit 2af2e16

File tree

4 files changed

+78
-9
lines changed

4 files changed

+78
-9
lines changed

_quarto.yml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,10 +51,11 @@ website:
5151
- section: "Finding and Accessing Data"
5252
contents:
5353
- text: "Getting an Earthdata Login"
54-
# href: reference-guides/get-edl.qmd
54+
href: reference-guides/get-edl.qmd
5555
- text: "Data search and discovery"
5656
href: reference-guides/dataset-search-and-discovery.qmd
5757
- text: "Data access"
58+
href: reference-guides/data-access.qmd
5859
- section: "Wrangling Data"
5960
contents:
6061
- text: "Subsetting"
@@ -66,7 +67,6 @@ website:
6667
- text: "Plotting data - time series, scatter plots"
6768
- text: "Plotting data on a map"
6869
href: reference-guides/plotting-data.qmd
69-
- text: "Best Practices"
7070
- section: "How do I..."
7171
href: how-to-guides/overview.qmd
7272
contents:
@@ -81,6 +81,7 @@ website:
8181
href: how-to-guides/get_latitude_and_longitude.qmd
8282
- section: "Appendices"
8383
contents:
84+
- text: "Best Practices"
8485
- text: "What is an API?"
8586

8687
format:

reference-guides/data-access.qmd

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: "Data access"
3+
---
4+
5+
#### **Prerequisite reminder**
6+
7+
A [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) is required for all data access methods, including download and direct cloud access.
8+
9+
#### **NASA Earthdata Cloud**
10+
11+
The NASA Earthdata Cloud is NASA’s cloud-based archive of Earth observation data. It is hosted by Amazon Web Services (AWS) in region us-west-2. Downloading data from the Earthdata Cloud to your local computer or storage system is and will continue to be free for users. You don't need an AWS account to download data. Alternatively, you can work directly with NSIDC DAAC holdings stored in Amazon S3 (the object storage service used by NASA Earthdata Cloud). This direct access method allows you stream data into memory and analyze it "in place", avoiding large transfers to your local computer.
12+
13+
Options for accessing NASA Earthdata are outlined below:
14+
15+
#### **Option 1: Browser-Based Download (No Coding Required)**
16+
17+
If you prefer a graphical interface, use one of these web-based tools:
18+
19+
[NASA Earthdata Search](https://search.earthdata.nasa.gov) - Explore, filter and customize data before downloading files. Instructions for using Earthdata Search to find and access data can be found in our Earthdata Search [guide](https://nsidc.org/data/user-resources/help-center/search-order-and-customize-nsidc-daac-data-nasa-earthdata-search).
20+
21+
image
22+
23+
NSIDC Data Access Tool - The NSIDC Data Access Tool can be accessed from a data set's landing page.
24+
Example: [ATLAS/ICESat-2 L2A Global Geolocated Photon Data. (ATL03, Version 7) Landing Page](https://nsidc.org/data/atl03/versions/7). In the right-hand menu on a data set landing page, click "Data Access & Tools". You will be directed to the top of a list of tool and service "cards" with links to various data access methods. Click on the card title "Data Access Tool" to be directed to the Data Access Tool interface for that particular data set. The Data Access Tool allows users to filter files within a data set using spatial bounds, temporal ranges, and filename wildcards.
25+
26+
image
27+
28+
#### **Option 2: Python (earthaccess Library)**
29+
30+
The earthaccess Python library provides a streamlined way to search, authenticate, and download NASA Earthdata. It works both locally and in the cloud (e.g., on EC2 or JupyterHub environments).
31+
32+
earthaccess [documentation](https://earthaccess.readthedocs.io/en/stable/)
33+
34+
*Have reference/link to "how to guide" here?*
35+
36+
#### **Option 3: Command Line Tools (```wget```, ```curl```, PODAAC subscriber)**
37+
38+
If you're comfortable using the terminal, command-line tools allow flexible and efficient downloading.
39+
40+
```wget``` or ```curl``` – Download known files or batch download from an HTTPS URL list.
41+
Learn to create .txt files of download links here: [Creating Text Files of HTTPS and S3 URLs for Earthdata Cloud Data Access](https://nsidc.org/data/user-resources/help-center/creating-text-files-https-and-s3-urls-earthdata-cloud-data-access)
42+
43+
[PODAAC Data Subscriber](https://github.com/podaac/data-subscriber/blob/main/README.md) – A Python-based command-line tool that supports spatial and temporal filtering. Though designed for PODAAC, it can be adapted for NSIDC and other DAACs.
44+
45+
All of these command line options are detailed in this help article: [Downloading Data from Earthdata Cloud to Your Local Computer Using the Command Line](https://nsidc.org/data/user-resources/help-center/downloading-data-earthdata-cloud-your-local-computer-using-command-line)

reference-guides/dataset-search-and-discovery.qmd

Lines changed: 28 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,31 @@
22
title: "Dataset Search and Discovery"
33
---
44

5-
- Getting an EDL
6-
- A simple earthaccess search and download
7-
- EDS
8-
- curl
9-
- wget
5+
### **NASA Common Metadata Repository**
6+
7+
There are a variety of search and discovery methods allowing users to find NASA Earthdata from a graphical user interface (GUI) or using programmatic access methods, depending on preference. Any search and discovery method leverages the [NASA Common Metadata Repository](https://www.earthdata.nasa.gov/about/esdis/eosdis/cmr) to find data of interest.
8+
9+
*NASA's Common Metadata Repository (CMR) is a high-performance, high-quality, continuously evolving metadata system that catalogs all data and service metadata records for NASA's Earth Observing System Data and Information System (EOSDIS) and will be the authoritative management system for all EOSDIS metadata. These metadata records are registered, modified, discovered, and accessed through programmatic interfaces leveraging standard protocols and APIs.*
10+
11+
*CMR is the keystone that makes NASA's Earth observation data discoverable. As a metadata repository, CMR contains Unified Metadata Model (UMM) schema records that describe individual Earth data files (UMM-Granules), collections of files (UMM-Collections), scientific details about the data files (UMM-Variables), related tools and services that act on the data files (UMM-Tools and -Services), and pertinent relationships between these concepts. Using the UMM allows CMR to host its metadata records in several supported native formats, with translation services available between formats.*
12+
13+
### **Search and Discovery Methods**
14+
15+
16+
#### **Graphical User Interfaces**
17+
18+
##### **NASA Earthdata Search**
19+
20+
##### **NSIDC Data Access Tool**
21+
22+
#### **Programmatic**
23+
24+
**earthaccess Python library**
25+
26+
27+
28+
29+
30+
31+
32+

reference-guides/get-edl.qmd

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: "NASA Earthdata Login"
33
---
44

5-
NASA Earthdata are freely accessible to all users, but a NASA Earthdata Login is required for access. Users can register for an Earthdata Login at https://urs.earthdata.nasa.gov/.
5+
NASA Earthdata are freely accessible to all users, but a NASA Earthdata Login is required for access. Users can register for an Earthdata Login at [https://urs.earthdata.nasa.gov/](https://urs.earthdata.nasa.gov/).
66

77

88
Some programmatic data access methods are simplified by setting up your Earthdata Login credentials in a netrc file for easy authentication.
9-
Instructions for creating a netrc file can be found [here](https://nsidc.org/data/user-resources/help-center/creating-netrc-file-earthdata-login)
9+
Instructions for creating a netrc file can be found [here](https://nsidc.org/data/user-resources/help-center/creating-netrc-file-earthdata-login).

0 commit comments

Comments
 (0)