Metadata-Version: 2.4
Name: imergpyLite
Version: 0.1.0
Summary: Small point-only NASA IMERG rainfall downloader that saves an Excel time series.
Author: Lakshitha S. Senavirathna
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: earthaccess>=0.13
Requires-Dist: netCDF4
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: openpyxl
Requires-Dist: python-dateutil
Requires-Dist: truststore>=0.10; platform_system == "Windows"

# imergpyLite

`imergpyLite` is a very small package for one job:

Download NASA IMERG rainfall for one point and save it as an Excel time series.

No web app. No country average. No square area. No interpolation complexity.

## Install

```bash
pip install imergpyLite
```

## Python Example

```python
import imergpylite as imerg

excel_path, records = imerg.download_point(
    lat=6.9,
    lon=79.8,
    start_datetime="2025-11-25",
    end_datetime="2025-11-26",
    username="EARTHDATA_USERNAME",
    password="EARTHDATA_PASSWORD",
    run_type="late",
    freq="daily",
)

print(excel_path)
```

## Supported Data

- `freq="daily"` with `run_type="early"`, `"late"`, or `"final"`
- `freq="hhr"` with `run_type="early"`, `"late"`, or `"final"`
- `freq="monthly"` with `run_type="final"`

The Excel file includes:

- Start Time
- End Time
- Requested Latitude
- Requested Longitude
- Actual IMERG Grid Latitude
- Actual IMERG Grid Longitude
- Precipitation value

## NASA Account

You need a free NASA Earthdata account and accepted GES DISC data access.

Sign up:

https://urs.earthdata.nasa.gov/users/new

Keep your username and password private.
