fhws 0.3.0

Python Client API for Forecast and Historical Weather Service

Python Client Library for Forecast and Historical Weather Service

About

Forecast and historical weather data comprehend a group of data, such as Land Surface Temperature (LST), meteorological data and historical Enhanced Transparency Framework (ETF) data. These data are composed of satellite thermal bands (MODIS, AVHRR, GOES), weather models/reanalysis (ERA5, GFS) and climatology (10-20 years of previous data).

Called Forecast and Historical Weather Service (FHWS) the software extracts climate data from big EO data collections. It can be (i) cumulative precipitation, (ii) precipitation - daily, (iii) temperature - daily and (iv) climate change projections, all of those as time series. The fhws.py library also allow the creation of labelled multi-dimensional arrays from climate data based on INPE’s data.

We created the fhws.py library from scratch to facilitate climate data analysis operations. This library was developed to be interoperable with other Python libraries, thus enabling users to integrate established libraries into their own workflows for pre- or post-processing and analysis. The fhws.py library has a group of functions, the main ones are:

• data_cube: create multi-dimensional arrays from forecast and historical weather data as xarray.

• get_timeseries_data_cube: returns in list format the climate data time series from FHWS’s data_cube.

Installation

See INSTALL.rst.

Documentation

See https://fhws.readthedocs.io/en/latest.

References

WIP

License

Copyright (C) 2025 INPE.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.