Skip to content

Commit

Permalink
Merge pull request #65 from nasa/dev
Browse files Browse the repository at this point in the history
Dev
  • Loading branch information
battistowx committed Dec 21, 2023
2 parents d7a3a39 + cf772ba commit cb463b3
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 26 deletions.
36 changes: 18 additions & 18 deletions README.md
Expand Up @@ -6,21 +6,21 @@ A place to find tutorials on how to use GES DISC tools, services, and data.

Most tutorials in this repository take the form of python notebooks. Jupyter is a very popular version of python notebooks, and is used extensively by the GES DISC team.

| Notebook | Summary | Services and Tools |
| ------------- |-------------|:-------------:|
|[How to Access GES DISC Data Using Python](notebooks/How_to_Access_GES_DISC_Data_Using_Python.ipynb) | There are multiple ways to work with GES DISC data resources using Python. For example, the data can accessed using techniques that rely on a native Python code. Still, there are several third-party libraries that can further simplify the access. In the sections below, we describe four techniques that make use of Requests, Pydap, Xarray, and netCDF4-python libraries. | |
|[How to Generate Earthdata Prerequisite Files](notebooks/How_to_Generate_Earthdata_Prerequisite_Files.ipynb) | This notebook demonstrates how to generate three Earthdata prerequisite files (.netrc, .urs_cookies, .dodsrc) needed to access the GES DISC archives manually, or through Python.| |
|[How to Access MERRA2 Using OPeNDAP with Python3 and Calculate Weekly from Hourly Data ](notebooks/How_to_Access_MERRA2_Using_OPeNDAP_with_Python3_Calculate_Weekly_from_Hourly.ipynb) | This notebook is based on Python3 and demonstrates how to remotely access the Modern-Era Retrospective analysis for Research and Applications, Version 2 (MERRA-2) hourly files via OPeNDAP and analyze data such as resample hourly files into daily, weekly, and monthly files and calculate their corresponding statistics, e.g., mean, sum, maximum, and minimum. | |
|[How to Read IMERG Data Using Python ](notebooks/How_to_Read_IMERG_Data_Using_Python.ipynb)| This notebook shows how to read data from the Global Precipitation Measurement (GPM) mission's IMERG dataset using Python. | |
|[How to Read and Plot NetCDF MERRA-2 Data in Python ](notebooks/How_to_Read_and_Plot_NetCDF_MERRA-2_data_in_Python.ipynb)| This How-To shows how to read and plot NetCDF4 data from the Modern-Era Retrospective analysis for Research and Applications version 2 (MERRA-2) using Python. | |
|[How to Use the Web Services API for Dataset Searching ](notebooks/How_to_Use_the_Web_Services_API_for_Dataset_Searching.ipynb) | This example code demonstrates how to use the API to search GES DISC data collections. | |
|[How to Use the Web Services API for Subsetting ](notebooks/How_To_Use_the_Web_Services_API_for_Subsetting.ipynb) | This example code demonstrates how to use the API to subset GES DISC data collections. | |
|[How to Use the Web Services API for Subsetting MERRA-2 Data](notebooks/How_to_Use_the_Web_Services_API_for_Subsetting_MERRA-2_Data.ipynb) | The example code provided below demonstrates three examples on how to use the API to submit an asynchronous request to the GES DISC Subsetting Service in order to obtain subsets of the Modern-Era Retropsective analysis for Research and Applications, Version 2 (MERRA-2). | |
|[How to Use the Web Services API to Validate Point Measurements ](notebooks/How_to_Use_the_Web_Services_API_to_Validate_Point_Measurements.ipynb) | This notebook demonstrates how to use the GES DISC API to retrieve Level 2 subsets of satellite data for the purpose of validation or comparison to ground-based measurements using Python. | |
|[How to Access the Hydrology Data Rods Time Series API Using Python](notebooks/How_to_Access_the_Hydrology_Data_Rods_API_Using_Python.ipynb) | This notebook describes accessing the Hydrology Data Rods Time Series API using Python.| |
|[How to find the max precipitation value of a Region of Interest (ROI) using an ArcGIS image service](notebooks/How_to_Find_the_Max_Precipitation_Value_of_a_ROI_Using_an_ArcGIS_Image_Service.ipynb) | This notebook demonstrates how to calculate and view the maximum precipitation rate value from the GPM IMERGHHE ArcGIS Image Service. | |
|[How to Find and Plot Level 2 Data from Multiple Granules on a Map using Python](notebooks/How_to_Find_and_Plot_Level2_Data_from_Multiple_Granules_on_a_Map_Using_Python.ipynb) | This notebook demonstrates how to aggregate and plot Level 2 granules on a map using Python. | |
|[How to Remotely Access MERRA-2 with Python3 and Calculate Monthly Average Surface PM2.5 for World Countries](notebooks/How_to_MERRA2_PM25_Monthly.ipynb) | This notebook demonstrates how to access MERRA-2 from the THREDDS Data Server, before calculating monthly average surface PM2.5 values for various world countries. | |
|[How to Calculate and Plot Wind Speed using MERRA-2 Wind Component Data using Python](notebooks/How_to_calculate_and_plot_wind_speed_using_MERRA-2_wind_component_data.ipynb) | This tutorial demonstrates how to calculate and plot hourly wind speed using the northward and eastward wind component variables with MERRA-2 data using Python. | |
|[How to Plot Horizontal and Vertical Slices of Swath Data with Python Using GPM_2ADPR](notebooks/How_To_Plot_Horizontal_and_Vertical_Slices_of_Swath_Data_with_Python_Using_GPM_2ADPR.ipynb) | This notebook demonstrates how to use Python for plotting horizontal spatial maps and vertical cross sections (also known as curtain plots) of the Level 2 product [GPM_2ADPR](https://disc.gsfc.nasa.gov/datasets/GPM_2ADPR_07/summary?keywords=GPM_2ADPR_07). | |
|[How to Calculate Greenhouse Gas Growth Rates using Python](notebooks/How_To_Calculate_Greenhouse_Gas_Growth_Rates.ipynb) | This notebook demonstrates how to calculate the growth rate, also known as rate of change, for greenhouse gases using Giovanni and Python. | |
| Notebook | Summary | Services, Tools, Data Types | Actions |
| ------------- |-------------|:-------------:|:-------------:|
|[How to Access GES DISC Data Using Python](notebooks/How_to_Access_GES_DISC_Data_Using_Python.ipynb) | This notebook demonstrates basic methods for accessing GES DISC Data using Python | Python, OPeNDAP, THREDDS | Access, Subset |
|[How to Generate Earthdata Prerequisite Files](notebooks/How_to_Generate_Earthdata_Prerequisite_Files.ipynb) | This notebook demonstrates how to generate three Earthdata prerequisite files (.netrc, .urs_cookies, .dodsrc) needed to access the GES DISC archives manually, or through Python.| Python | Access |
|[How to Access MERRA2 Using OPeNDAP with Python3 and Calculate Weekly from Hourly Data ](notebooks/How_to_Access_MERRA2_Using_OPeNDAP_with_Python3_Calculate_Weekly_from_Hourly.ipynb) | This notebook is based on Python3 and demonstrates how to remotely access the Modern-Era Retrospective analysis for Research and Applications, Version 2 (MERRA-2) hourly files via OPeNDAP and analyze data such as resample hourly files into daily, weekly, and monthly files and calculate their corresponding statistics, e.g., mean, sum, maximum, and minimum. | Python, OPeNDAP, NetCDF | Access, Subset, Plot, Compute |
|[How to Read IMERG Data Using Python ](notebooks/How_to_Read_IMERG_Data_Using_Python.ipynb)| This notebook shows how to read data from the Global Precipitation Measurement (GPM) mission's IMERG dataset using Python. | Python, HDF | Access, Subset, Plot |
|[How to Read and Plot NetCDF MERRA-2 Data in Python ](notebooks/How_to_Read_and_Plot_NetCDF_MERRA-2_data_in_Python.ipynb)| This How-To shows how to read and plot NetCDF4 data from the Modern-Era Retrospective analysis for Research and Applications version 2 (MERRA-2) using Python. | Python, NetCDF | Access, Subset, Plot |
|[How to Use the Web Services API for Dataset Searching ](notebooks/How_to_Use_the_Web_Services_API_for_Dataset_Searching.ipynb) | This example code demonstrates how to use the API to search GES DISC data collections. | Python, Web Services API | Search, Access, Subset |
|[How to Use the Web Services API for Subsetting ](notebooks/How_To_Use_the_Web_Services_API_for_Subsetting.ipynb) | This example code demonstrates how to use the API to subset GES DISC data collections. | Python, Web Services API | Access, Subset |
|[How to Use the Web Services API for Subsetting MERRA-2 Data](notebooks/How_to_Use_the_Web_Services_API_for_Subsetting_MERRA-2_Data.ipynb) | The example code provided below demonstrates three examples on how to use the API to submit an asynchronous request to the GES DISC Subsetting Service in order to obtain subsets of the Modern-Era Retropsective analysis for Research and Applications, Version 2 (MERRA-2). | Python, Web Services API, HDF | Access, Subset |
|[How to Use the Web Services API to Validate Point Measurements ](notebooks/How_to_Use_the_Web_Services_API_to_Validate_Point_Measurements.ipynb) | This notebook demonstrates how to use the GES DISC API to retrieve Level 2 subsets of satellite data for the purpose of validation or comparison to ground-based measurements using Python. | Python, Web Services API, HDF | Access, Subset, Plot, Compute |
|[How to Access the Hydrology Data Rods Time Series API Using Python](notebooks/How_to_Access_the_Hydrology_Data_Rods_API_Using_Python.ipynb) | This notebook describes accessing the Hydrology Data Rods Time Series API using Python.| Python, Hydrology Data Rods | Search, Subset, Plot |
|[How to find the max precipitation value of a Region of Interest (ROI) using an ArcGIS image service](notebooks/How_to_Find_the_Max_Precipitation_Value_of_a_ROI_Using_an_ArcGIS_Image_Service.ipynb) | This notebook demonstrates how to calculate and view the maximum precipitation rate value from the GPM IMERGHHE ArcGIS Image Service. | Python, ArcGIS Image Service | Search, Subset, Compute, Plot |
|[How to Find and Plot Level 2 Data from Multiple Granules on a Map using Python](notebooks/How_to_Find_and_Plot_Level2_Data_from_Multiple_Granules_on_a_Map_Using_Python.ipynb) | This notebook demonstrates how to aggregate and plot Level 2 granules on a map using Python. | Python, NetCDF | Search, Access, Plot |
|[How to Remotely Access MERRA-2 with Python3 and Calculate Monthly Average Surface PM2.5 for World Countries](notebooks/How_to_MERRA2_PM25_Monthly.ipynb) | This notebook demonstrates how to access MERRA-2 from the THREDDS Data Server, before calculating monthly average surface PM2.5 values for various world countries. | Python, NetCDF, GeoJSON, Shapefile | Search, Access, Subset, Compute, Plot |
|[How to Calculate and Plot Wind Speed using MERRA-2 Wind Component Data using Python](notebooks/How_to_calculate_and_plot_wind_speed_using_MERRA-2_wind_component_data.ipynb) | This tutorial demonstrates how to calculate and plot hourly wind speed using the northward and eastward wind component variables with MERRA-2 data using Python. | Python, NetCDF | Compute, Plot |
|[How to Plot Horizontal and Vertical Slices of Swath Data with Python Using GPM_2ADPR](notebooks/How_To_Plot_Horizontal_and_Vertical_Slices_of_Swath_Data_with_Python_Using_GPM_2ADPR.ipynb) | This notebook demonstrates how to use Python for plotting horizontal spatial maps and vertical cross sections (also known as curtain plots) of the Level 2 product [GPM_2ADPR](https://disc.gsfc.nasa.gov/datasets/GPM_2ADPR_07/summary?keywords=GPM_2ADPR_07). | Python, HDF | Compute, Plot |
|[How to Calculate Greenhouse Gas Growth Rates using Python](notebooks/How_To_Calculate_Greenhouse_Gas_Growth_Rates.ipynb) | This notebook demonstrates how to calculate the growth rate, also known as rate of change, for greenhouse gases using Giovanni and Python. | Python, Giovanni, CSV | Search, Access, Subset, Compute, Plot |
16 changes: 8 additions & 8 deletions cloud-tutorials/README.md
Expand Up @@ -14,11 +14,11 @@ Some tutorials can be run locally to take advantage of cloud archives or cloud-b



| Notebook | Summary | Services and Tools |
| ------------- |-------------|:-------------:|
|[How to Create and Store Earthdata Login Credentials Using Python](notebooks/How_to_Create_and_Store_Earthdata_Login_Credentials_Using_Python.ipynb) | This notebook demonstrates how to generate and store your Earthdata Login credentials in a .netrc file. | |
|[How to Directly Access MERRA-2 Data from an S3 Bucket with Python](notebooks/How_to_Directly_Access_MERRA-2_Data_from_an_S3_Bucket.ipynb) | This notebook demonstrates how to access and plot a Modern-Era Retrospective analysis for Research and Applications (MERRA-2) M2T1NXSLV.5.12.4 file hosted via an Amazon S3 bucket. It demonstrates how to access an S3 bucket with the S3FS library and then plot sea-level pressure contours of a single file with Cartopy and Matplotlib.| |
|[How to Obtain a List of S3 URLs for a GES DISC Collection using the CMR API](notebooks/How_to_Obtain_a_List_of_S3_URLs_for_a_GES_DISC_Collection_Using_the_CMR_API.ipynb)| This notebook demonstrates how to obtain a list of S3 URLs for desired cloud-hosted GES DISC granules using the Commmon Metadata Repository (CMR) API. | |
|[How to Retrieve Temporary S3 Credentials for the GES DISC Cloud Archive](notebooks/How_to_Retrieve_Temporary_S3_Credentials_for_the_GES_DISC_Cloud_Archive.ipynb) | This notebook demonstrates how to retrieve GES DISC S3 credentials by using a previously generated netrc file. | |
|[How to Perform Cross-DAAC S3 Bucket Access Using Python](notebooks/How_to_Perform_Cross-DAAC_S3_Bucket_Access_Using_Python.ipynb) | This notebook demonstrates how to access cloud-hosted Earthdata granules from S3 buckets using the CMR API and Python, from two different DAACs (GES DISC and PO.DAAC). | |
|[How to Access and Analyze GPM Data from the S3 Giovanni Cache Zarr Store](notebooks/How_to_Access_and_Analyze_GPM_Zarr_Store.ipynb) | This notebook demonstrates how to access the Giovanni Cache Zarr Store [S3 bucket](https://disc.gsfc.nasa.gov/information/faqs?keywords=%22earthdata%20cloud%22&title=What%20is%20S3%20access%3F) inside the [AWS us-west-2](https://disc.gsfc.nasa.gov/information/documents?title=Migrating%20to%20the%20Cloud) region for performing analysis. | |
| Notebook | Summary | Services, Tools, Data Types | Actions |
| ------------- |-------------|:-------------:|:-------------:|
|[How to Create and Store Earthdata Login Credentials Using Python](notebooks/How_to_Create_and_Store_Earthdata_Login_Credentials_Using_Python.ipynb) | This notebook demonstrates how to generate and store your Earthdata Login credentials in a .netrc file. | Python | Access |
|[How to Directly Access MERRA-2 Data from an S3 Bucket with Python](notebooks/How_to_Directly_Access_MERRA-2_Data_from_an_S3_Bucket.ipynb) | This notebook demonstrates how to access and plot a Modern-Era Retrospective analysis for Research and Applications (MERRA-2) M2T1NXSLV.5.12.4 file hosted via an Amazon S3 bucket. It demonstrates how to access an S3 bucket with the S3FS library and then plot sea-level pressure contours of a single file with Cartopy and Matplotlib.| Python, Direct S3 Access | Access, Subset, Plot |
|[How to Obtain a List of S3 URLs for a GES DISC Collection using the CMR API](notebooks/How_to_Obtain_a_List_of_S3_URLs_for_a_GES_DISC_Collection_Using_the_CMR_API.ipynb)| This notebook demonstrates how to obtain a list of S3 URLs for desired cloud-hosted GES DISC granules using the Commmon Metadata Repository (CMR) API. | Python, CMR | Search |
|[How to Retrieve Temporary S3 Credentials for the GES DISC Cloud Archive](notebooks/How_to_Retrieve_Temporary_S3_Credentials_for_the_GES_DISC_Cloud_Archive.ipynb) | This notebook demonstrates how to retrieve GES DISC S3 credentials by using a previously generated netrc file. | Python | Access |
|[How to Perform Cross-DAAC S3 Bucket Access Using Python](notebooks/How_to_Perform_Cross-DAAC_S3_Bucket_Access_Using_Python.ipynb) | This notebook demonstrates how to access cloud-hosted Earthdata granules from S3 buckets using the CMR API and Python, from two different DAACs (GES DISC and PO.DAAC). | Python, CMR, Direct S3 Access | Search, Access, Subset, Compute, Plot |
|[How to Access and Analyze GPM Data from the S3 Giovanni Cache Zarr Store](notebooks/How_to_Access_and_Analyze_GPM_Zarr_Store.ipynb) | This notebook demonstrates how to access the Giovanni Cache Zarr Store S3 bucket inside the AWS us-west-2 region for performing analysis. | Python, Direct S3 Access | Access, Subset, Compute, Plot |

0 comments on commit cb463b3

Please sign in to comment.