Skip to content

README.md

Latest commit

 

History

History
112 lines (76 loc) · 3.19 KB

README.md

File metadata and controls

112 lines (76 loc) · 3.19 KB

Giovanni Data Downloader 📡🌍

Python
Jupyter Notebook
License

A Jupyter notebook for downloading and processing data from NASA Giovanni using Python. This tool automates the retrieval of geospatial data and enables efficient analysis.

Table of Contents

  1. Overview
  2. Features
  3. Installation
  4. Usage
  5. Data Requirements
  6. Output
  7. Contributing
  8. License
  9. Acknowledgments

Overview

This project provides a Python-based solution for downloading and analyzing NASA Giovanni data. Implemented as a Jupyter Notebook, the script simplifies access to Earth science data and enables users to automate data retrieval, processing, and visualization.

Features

  • Automated Data Retrieval: Fetches datasets from NASA Giovanni seamlessly.
  • Batch Processing: Supports downloading multiple datasets efficiently.

Installation

To use this script, follow these steps:

  1. Clone the repository: 
    git clone https://github.com/your-username/Giovanni-Data-Downloader.git
  2. Navigate to the project folder: 
    cd Giovanni-Data-Downloader
  3. Create and activate a virtual environment (optional but recommended): 
    python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate     # On Windows
  4. Install the required dependencies: 
    pip install -r requirements.txt

Usage

  1. Open Jupyter Notebook or Visual Studio Code Editor.

  2. Open Giovanni_Data_Downloader.ipynb in Jupyter.

  3. Set Up Authorization:

    • Enter your NASA Earthdata Username & Password.
    • Provide your NASA User Token for authentication.

  4. Configure Download Settings:

    • Specify the directory containing the .txt file with Giovanni data URLs.
    • Set the output directory where the downloaded files will be saved.

  5. Run the Script

Data Requirements

  1. NASA Giovanni .TXT file of direct links (i put the example: 00to24_Kalimantan.txt)

Output

  1. .nc raw data for further analysis process

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new branch (feature-branch).
  3. Commit your changes and push.
  4. Open a Pull Request.

License

This project is licensed under the MIT License.

Acknowledgments

This project utilizes several powerful Python libraries to streamline the Giovanni data download process:

  • os – For handling file paths and directory operations.
  • requests – For making HTTP requests to NASA Giovanni to download data.
  • concurrent.futures – For enabling multithreading to speed up downloads.
  • tqdm – For displaying a progress bar to track download completion.

Special thanks to NASA Giovanni and Earthdata for providing access to valuable geospatial datasets. 🚀