gridwxcomp

A package for comparing weather station data to gridded weather data that are hosted on Google Earth Engine.
https://github.com/WSWUP/gridwxcomp

Category: Atmosphere
Sub Category: Meteorological Observation and Forecast

Keywords

bias-correction climate data gridded spatial-analysis weather

Last synced: about 7 hours ago
JSON representation

Repository metadata

Comparison of weather station and gridded climate datasets

• Host: GitHub
• URL: https://github.com/WSWUP/gridwxcomp
• Owner: WSWUP
• License: apache-2.0
• Created: 2019-02-01T18:26:16.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-01-20T23:04:54.000Z (3 months ago)
• Last Synced: 2025-04-21T17:01:57.575Z (5 days ago)
• Topics: bias-correction, climate, data, gridded, spatial-analysis, weather
• Language: Python
• Homepage: https://gridwxcomp.readthedocs.io/en/latest/
• Size: 77.1 MB
• Stars: 20
• Watchers: 5
• Forks: 8
• Open Issues: 3
• Releases: 6
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGE_LOG.rst
  • License: LICENSE.txt

README.rst

          gridwxcomp
==========

|Build| |Documentation Status| |Downloads per month| |PyPI version| |JOSS|

-----------

A package for comparing weather station data to gridded weather data that are hosted on Google Earth Engine. Major functionality includes: 

* parsing of multiple weather stations and weather variables and metadata
* downloading point data from gridded datasets on Google Earth Engine at weather station locations 
* temporal pairing of station and gridded data
* unit handling and automated conversions
* calculation of mean bias ratios between station and gridded data and related statistics 
* performing spatial mapping and interpolation of bias ratios with multiple options 
* calculation of residuals between spatially interpolated bias ratios and those computed at station locations 
* building geo-referenced vector and raster data of spatially interpolated and point data
* zonal averaging of spatially interpolated bias results using a fishnet grid  
* interactive graphics (time series, scatter, and bar charts) comparing station and gridded data

Bias ratios calculated by ``gridwxcomp`` can be used to correct bias of grid to station data based on the properties of the stations. For example, monthly humidity ratios between station and grid for stations within agricultural settings can be used to estimate grid bias relative to agricultural locations. 

``gridwxcomp`` has been used to create monthly bias ratios of `gridMET `_ reference evapotranspiration (ETo) data relative to ETo calculated at irrigated weather stations. The bias ratios were subsequently interpolated and used to correct gridMET ETo which is a key scaling flux for most of the remote sensing models that are part of the `OpenET `_ platform. 

Documentation
-------------
`Online documentation `_

Installation
------------

Currently we recommend using the provided conda environment file to install ``gridwxcomp`` and its dependencies in a virtual environment. Download the `environment.yml `_ file and then install and activate it. If you don't have conda `get it here `_. To install dependencies in a virtual environment run 

.. code-block:: bash

    $ conda env create -f environment.yml

To activate the environment before using ``gridwxcomp`` run

.. code-block:: bash

    $ conda activate gridwxcomp

After installing all the dependencies using conda, install ``gridwxcomp`` using `pip `_,

.. code-block:: bash

    $ pip install gridwxcomp

Due to dependency conflicts you may have issues directly installing with pip before activating the conda environment. This is because the package includes several modules that are not pure Python such as GDAL and pyproj which seem to be better handled by conda. 

Alternatively, or if there are installation issues, you can manually install. First activate the ``gridwxcomp`` conda environment (above). Next, clone or download the package from `GitHub `_ or `PyPI `_ and then install locally with pip in "editable" mode. For example with cloning,

.. code-block:: bash

    $ git clone https://github.com/WSWUP/gridwxcomp.git
    $ cd gridwxcomp

If you are experiencing errors on installing the ``gridwxcomp`` conda environment above with dependencies. For example, if the Shapely package is not installing from the enironment.yml file, remove it or modify it from the "setup.py" file in the install requirements section before you install gridwxcomp from source with:

.. code-block:: bash

    $ pip install -e .

More help with installation issues related to dependency conflicts can be found in the ``gridwxcomp`` `issues `_ on GitHub, be sure to check the closed issues as well.

How to contribute
-----------------
We welcome contributions, big or small, from the community to ``gridwxcomp``! Please review our `Contribution and community guidelines `_ for more information. 

How to cite
-----------
If you use ``gridwxcomp`` for research or published works, please use the following citation: 

Volk et al., (2025). *gridwxcomp: A Python package to evaluate and interpolate biases between station and gridded weather data*. Journal of Open Source Software, 10(105), 7178. https://doi.org/10.21105/joss.07178


.. |Build| image:: https://github.com/WSWUP/gridwxcomp/actions/workflows/gridwxcomp_tests.yml/badge.svg
   :target: https://github.com/WSWUP/gridwxcomp/actions

.. |Downloads per month| image:: https://img.shields.io/pypi/dm/gridwxcomp.svg
   :target: https://pypi.python.org/pypi/gridwxcomp/

.. |Documentation Status| image:: https://img.shields.io/website-up-down-green-red/http/shields.io.svg
   :target: https://wswup.github.io/gridwxcomp/

.. |PyPI version| image:: https://img.shields.io/pypi/v/gridwxcomp.svg
   :target: https://pypi.python.org/pypi/gridwxcomp/

.. |JOSS| image:: https://joss.theoj.org/papers/10.21105/joss.07178/status.svg
   :target: https://doi.org/10.21105/joss.07178

        

---

Owner metadata

• Name: Western States Water Use Program (WSWUP)
• Login: WSWUP
• Email:
• Kind: organization
• Description: WSWUP housed at the Desert Research Institute aims to advance crop and open water use estimates through observations and open modeling tools
• Website: https://www.dri.edu/western-states-water-use-program
• Location: Reno, NV
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/23201768?v=4
• Repositories: 9
• Last ynced at: 2023-03-07T14:56:14.002Z
• Profile URL: https://github.com/WSWUP

---

GitHub Events

Total

• Create event: 1
• Release event: 1
• Issues event: 2
• Watch event: 5
• Issue comment event: 1
• Push event: 10
• Pull request event: 2
• Fork event: 1

Last Year

• Create event: 1
• Release event: 1
• Issues event: 2
• Watch event: 5
• Issue comment event: 1
• Push event: 10
• Pull request event: 2
• Fork event: 1

---

Committers metadata

Last synced: 7 days ago

Name	Email	Commits
John Volk	j****8@g****m	238
Chris Pearson	c****n@d****u	26
Christian Dunkerly	2****y	7
Christian Dunkerly	c****n@c****m	1

Committer domains:

• climateengine.com: 1
• dri.edu: 1

---

Issue and Pull Request metadata

Last synced: 2 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/WSWUP/gridwxcomp

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 1,375 last-month
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 35
• Total maintainers: 1

---

Dependencies

Score: 11.74872459554233