MyGit

alekfal/pynasapower

Fork: 7 Star: 20 (更新于 2024-10-28 19:14:40)

license: GPL-3.0

Language: Python .

Download meteorological data from NASA POWER using a simple Python API client (https://power.larc.nasa.gov/).

最后发布版本: 0.0.1a1 ( 2023-11-13 21:38:29)

官方网址 GitHub网址

pynasapower

nasa

Build Status Documentation Status Code coverage Supported Python versions Overall downloads Last month downloads

Download meteorological data from NASA POWER restful API (https://power.larc.nasa.gov/) using pynasapower API client.

The NASA POWER database is a global database of daily meteorological data designed for agrometeorological applications and more. Data are retrieced from in-situ observations in combination with satellite data. For more information on the NASA POWER database see the documentation at: https://power.larc.nasa.gov/.

Installation from source

git clone https://github.com/alekfal/pynasapower.git
cd pynasapower/
pip install .

Installation from PyPI

pip install pynasapower

NASA POWER API client arguments

  • geometry: Single point or polygon geometry as geopandas.GeoDataFrame. User can use methods pynasapower.geometry.point() or pynasapower.geometry.bbox() to create an input geometry for this client.
  • start: Start date as datetime.date format. In the examples the value is datetime.date(2022, 1, 1).
  • end: End date as datetime.date format. In the examples the value is datetime.date(2022, 2, 1).
  • path: Local path to store the downloaded data. In the examples "./" is used.
  • to_file: Boolean argument to save data locally. By default is True.
  • community: The default POWER community is agroclimatology ("ag"). Other available communities are sustainable buildings ("sb") and renewable energy ("re"). Find more about the POWER communities here.
  • parameters: The default parameters for downloading (["TOA_SW_DWN", "ALLSKY_SFC_SW_DWN", "T2M", "T2M_MIN", "T2M_MAX", "T2MDEW", "WS2M", "PRECTOTCORR"]) are selected for downloading if an empty list ([]) is provided by the user. Find more for the POWER parameters in here.
  • temporal_api: Temporal resolution of the data. The default value is "daily". Other selections are "hourly", "monthly", "climatology". Read more about the temporal resolution of the data here.
  • spatial_api: Spatial resolution of the data. By default "point" is selected, but a user can also use "regional". Note that in order to download a region a polygon geometry must be used in the geometry argument.
  • format: Output format of the data. The default is "csv". Other selections supported by the API client are: "netcdf", "json" and "ascii".

Quickstart

Download meteorological data for a point in Athens, Greece and save result in *.csv format. First, create a "data" folder to hold the POWER data upon download in your current environment.

$ mkdir data

Then, run in Python the following to fetch data from NASA POWER:

from pynasapower.get_data import query_power
from pynasapower.geometry import point, bbox
import datetime

# Run for point in Athens and save the result in csv format
gpoint = point(23.727539, 37.983810, "EPSG:4326")
start = datetime.date(2022, 1, 1)
end = datetime.date(2022, 2, 1)
data = query_power(geometry = gpoint, start = start, end = end, path = "./data", to_file = True, community = "ag", parameters = [], temporal_api = "daily", spatial_api = "point", format = "csv")

Download meteorological data for a polygon in Athens, Greece and save result in *.csv format.

# Run for small bbox in Athens and save the result in csv format
gbbox = bbox(23.727539, 26.73, 37.983810, 40.99, "EPSG:4326")
start = datetime.date(2022, 1, 1)
end = datetime.date(2022, 2, 1)
data = query_power(geometry = gbbox, start = start, end = end, path = "./data", to_file = True, community = "ag", parameters = [], temporal_api = "daily", spatial_api = "point", format = "csv")

Read more about the software in project's readthedocs.

最近版本更新:(数据更新于 2024-08-28 01:09:36)

2023-11-13 21:38:29 0.0.1a1

2023-11-07 18:59:55 0.0.1a0

主题(topics):

meteorological-data, nasa, nasa-api, nasa-power, nasa-power-larc, nasapower, python, python-nasa-api, python3

alekfal/pynasapower同语言 Python最近更新仓库

2024-11-05 16:16:26 Guovin/TV

2024-11-05 15:03:24 Cinnamon/kotaemon

2024-11-05 11:00:51 home-assistant/core

2024-11-04 23:11:11 DS4SD/docling

2024-11-04 10:56:18 open-compass/opencompass

2024-11-04 08:51:21 yt-dlp/yt-dlp