meteostat 1.7.6__py3-none-any.whl → 2.0.1__py3-none-any.whl

meteostat/utilities/aggregations.py

@@ -1,37 +0,0 @@
-"""
-Utilities - Aggregation Methods
-
-Meteorological data provided by Meteostat (https://dev.meteostat.net)
-under the terms of the Creative Commons Attribution-NonCommercial
-4.0 International Public License.
-
-The code is licensed under the MIT license.
-"""
-
-import numpy as np
-import pandas as pd
-
-
-def weighted_average(step: pd.DataFrame) -> pd.DataFrame:
-    """
-    Calculate weighted average from grouped data
-    """
-
-    data = np.ma.masked_array(step, np.isnan(step))
-    data = np.ma.average(data, axis=0, weights=data[:, -2])
-    data = data.filled(np.nan)
-
-    return pd.DataFrame(data=[data], columns=step.columns)
-
-
-def degree_mean(data: pd.Series) -> float:
-    """
-    Return the mean of a list of degrees
-    """
-
-    if data.isnull().all():
-        return np.nan
-
-    rads = np.deg2rad(data)
-    sums = np.arctan2(np.sum(np.sin(rads)), np.sum(np.cos(rads)))
-    return (np.rad2deg(sums) + 360) % 360

meteostat/utilities/endpoint.py

@@ -1,33 +0,0 @@
-"""
-Utilities - Endpoint Helpers
-
-Meteorological data provided by Meteostat (https://dev.meteostat.net)
-under the terms of the Creative Commons Attribution-NonCommercial
-4.0 International Public License.
-
-The code is licensed under the MIT license.
-"""
-
-from typing import Union
-from meteostat.enumerations.granularity import Granularity
-
-
-def generate_endpoint_path(
-    granularity: Granularity,
-    station: str,
-    year: Union[int, None] = None,
-    map_file: bool = False,  # Is a source map file?
-) -> str:
-    """
-    Generate Meteostat Bulk path
-    """
-
-    # Base path
-    path = f"{granularity.value}/"
-
-    if granularity in (Granularity.HOURLY, Granularity.DAILY) and year:
-        path += f"{year}/"
-
-    appendix = ".map" if map_file else ""
-
-    return f"{path}{station}{appendix}.csv.gz"

meteostat/utilities/helpers.py

@@ -1,70 +0,0 @@
-"""
-Utilities - Helpers
-
-Meteorological data provided by Meteostat (https://dev.meteostat.net)
-under the terms of the Creative Commons Attribution-NonCommercial
-4.0 International Public License.
-
-The code is licensed under the MIT license.
-"""
-
-from typing import Optional
-import numpy as np
-
-
-def get_distance(lat1, lon1, lat2, lon2) -> float:
-    """
-    Calculate distance between weather station and geo point
-    """
-    # Earth radius in meters
-    radius = 6371000
-
-    # Degress to radian
-    lat1, lon1, lat2, lon2 = map(np.deg2rad, [lat1, lon1, lat2, lon2])
-
-    # Deltas
-    dlat = lat2 - lat1
-    dlon = lon2 - lon1
-
-    # Calculate distance
-    arch = np.sin(dlat / 2) ** 2 + np.cos(lat1) * np.cos(lat2) * np.sin(dlon / 2) ** 2
-    arch_sin = 2 * np.arcsin(np.sqrt(arch))
-
-    return radius * arch_sin
-
-
-def _get_flag_from_single_source(
-    source: str, source_mappings: dict, model_flag: str
-) -> str:
-    """
-    Get flag from single source
-    """
-    if source in source_mappings:
-        return source_mappings[source]
-    return model_flag
-
-
-def get_flag_from_source_factory(source_mappings: dict, model_flag: str) -> str:
-    """
-    Get flag from source
-    """
-
-    def _get_flag_from_source(source: Optional[str]) -> str:
-        sources = source.split(" ")
-
-        flags = [
-            _get_flag_from_single_source(src, source_mappings, model_flag)
-            for src in sources
-        ]
-
-        return "".join(flags)
-
-    return _get_flag_from_source
-
-
-def with_suffix(items, suffix):
-    """
-    Takes a list of strings and a suffix, returns a new list containing
-    the same items with the suffix added.
-    """
-    return [item + suffix for item in items]

meteostat/utilities/mutations.py

@@ -1,89 +0,0 @@
-"""
-Utilities - DataFrame Mutations
-
-Meteorological data provided by Meteostat (https://dev.meteostat.net)
-under the terms of the Creative Commons Attribution-NonCommercial
-4.0 International Public License.
-
-The code is licensed under the MIT license.
-"""
-
-from datetime import datetime
-from typing import Union
-import numpy as np
-import pandas as pd
-
-
-def localize(df: pd.DataFrame, timezone: str) -> pd.DataFrame:
-    """
-    Convert time data to any time zone
-    """
-
-    return df.tz_localize("UTC", level="time").tz_convert(timezone, level="time")
-
-
-def filter_time(
-    df: pd.DataFrame,
-    start: Union[datetime, None] = None,
-    end: Union[datetime, None] = None,
-) -> pd.DataFrame:
-    """
-    Filter time series data based on start and end date
-    """
-
-    # Get time index
-    time = df.index.get_level_values("time")
-
-    # If no time index, return original DataFrame
-    if len(time) == 0:
-        return df
-
-    # Filter & return
-    return df.loc[(time >= start) & (time <= end)] if start and end else df
-
-
-def adjust_temp(df: pd.DataFrame, alt: int):
-    """
-    Adjust temperature-like data based on altitude
-    """
-
-    # Default temperature difference by 100 meters
-    temp_diff = 0.6
-
-    # Temperature-like columns
-    temp_like = ("temp", "dwpt", "tavg", "tmin", "tmax")
-
-    # Adjust values for all temperature-like data
-    for col_name in temp_like:
-        if col_name in df.columns:
-            df.loc[df[col_name] != np.nan, col_name] = df[col_name] + (
-                temp_diff * ((df["elevation"] - alt) / 100)
-            )
-
-    return df
-
-
-def calculate_dwpt(df: pd.DataFrame, col: str) -> pd.DataFrame:
-    """
-    Calculate dew point temperature
-    """
-    # Check if required columns exist
-    if "temp" not in df.columns or "rhum" not in df.columns:
-        return df
-
-    magnus_const_a = 17.27
-    magnus_const_b = 237.7  # degrees Celsius
-
-    temperature = df["temp"]
-    relative_humidity = df["rhum"]
-
-    alpha = (
-        (magnus_const_a * temperature) / (magnus_const_b + temperature)
-    ) + np.log(relative_humidity / 100.0)
-    df[col] = (magnus_const_b * alpha) / (magnus_const_a - alpha)
-
-    df[col] = df[col].round(1)
-
-    df[f"{col}_flag"] = df[["temp_flag", "rhum_flag"]].max(axis=1, skipna=True)
-
-    return df

meteostat/utilities/validations.py

@@ -1,30 +0,0 @@
-"""
-Utilities - Validations
-
-Meteorological data provided by Meteostat (https://dev.meteostat.net)
-under the terms of the Creative Commons Attribution-NonCommercial
-4.0 International Public License.
-
-The code is licensed under the MIT license.
-"""
-
-import pandas as pd
-
-
-def validate_series(df: pd.DataFrame, station: str) -> pd.DataFrame:
-    """
-    Make sure a series is formatted correctly
-    """
-
-    # Add missing column(s)
-    if "time" not in df.columns:
-        df["time"] = None
-
-    # Add weather station ID
-    df["station"] = station
-
-    # Set index
-    df = df.set_index(["station", "time"])
-
-    # Return DataFrame
-    return df

meteostat-1.7.6.dist-info/METADATA

@@ -1,112 +0,0 @@
-Metadata-Version: 2.1
-Name: meteostat
-Version: 1.7.6
-Summary: Access and analyze historical weather and climate data with Python.
-Home-page: https://github.com/meteostat/meteostat-python
-Author: Meteostat
-Author-email: info@meteostat.net
-License: MIT
-Keywords: weather,climate,data,timeseries,meteorology
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Database
-Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
-Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Classifier: Topic :: Scientific/Engineering :: Visualization
-Requires-Python: >=3.8.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pandas>=2
-Requires-Dist: pytz
-Requires-Dist: numpy
-
-# Meteostat Python Package
-
-The Meteostat Python library provides a simple API for accessing open weather and climate data. The historical observations and statistics are collected by [Meteostat](https://meteostat.net) from different public interfaces, most of which are governmental.
-
-Among the data sources are national weather services like the National Oceanic and Atmospheric Administration (NOAA) and Germany's national weather service (DWD).
-
-Are you looking for a **hosted solution**? Try our [JSON API](https://rapidapi.com/meteostat/api/meteostat/).
-
-## Installation
-
-The Meteostat Python package is available through [PyPI](https://pypi.org/project/meteostat/):
-
-```sh
-pip install meteostat
-```
-
-Meteostat **requires Python 3.6** or higher. If you want to visualize data, please install Matplotlib, too.
-
-## Documentation
-
-The Meteostat Python library is divided into multiple classes which provide access to the actual data. The [documentation](https://dev.meteostat.net/python/) covers all aspects of the library:
-
-* **Selecting Locations**
-  * [Geographical Point](https://dev.meteostat.net/python/point.html)
-  * [Weather Stations](https://dev.meteostat.net/python/stations.html)
-* **Time Series**
-  * [Hourly Data](https://dev.meteostat.net/python/hourly.html)
-  * [Daily Data](https://dev.meteostat.net/python/daily.html)
-  * [Monthly Data](https://dev.meteostat.net/python/monthly.html)
-* **Miscellaneous Data**
-  * [Climate Normals](https://dev.meteostat.net/python/normals.html)
-* **Library**
-  * [Contributing](https://dev.meteostat.net/python/contributing.html)
-  * [Formats & Units](https://dev.meteostat.net/formats.html)
-  * [Data Sources](https://dev.meteostat.net/sources.html)
-  * [Terms & License](https://dev.meteostat.net/terms.html)
-
-## Example
-
-Let's plot 2018 temperature data for Vancouver, BC:
-
-```python
-# Import Meteostat library and dependencies
-from datetime import datetime
-import matplotlib.pyplot as plt
-from meteostat import Point, Daily
-
-# Set time period
-start = datetime(2018, 1, 1)
-end = datetime(2018, 12, 31)
-
-# Create Point for Vancouver, BC
-location = Point(49.2497, -123.1193, 70)
-
-# Get daily data for 2018
-data = Daily(location, start, end)
-data = data.fetch()
-
-# Plot line chart including average, minimum and maximum temperature
-data.plot(y=['tavg', 'tmin', 'tmax'])
-plt.show()
-```
-
-Take a look at the expected output:
-
-![2018 temperature data for Vancouver, BC](https://dev.meteostat.net/assets/img/py-example-chart.046f8b8e.png)
-
-## Contributing
-
-Instructions on building and testing the Meteostat Python package can be found in the [documentation](https://dev.meteostat.net/python/contributing.html). More information about the Meteostat bulk data interface is available [here](https://dev.meteostat.net/bulk/).
-
-## Donating
-
-If you want to support the project financially, you can make a donation using one of the following services:
-
-* [GitHub](https://github.com/sponsors/clampr)
-* [Patreon](https://www.patreon.com/meteostat)
-* [PayPal](https://www.paypal.com/donate?hosted_button_id=MQ67WRDC8EW38)
-
-## Data License
-
-Meteorological data is provided under the terms of the [Creative Commons Attribution-NonCommercial 4.0 International Public License (CC BY-NC 4.0)](https://creativecommons.org/licenses/by-nc/4.0/legalcode). You may build upon the material
-for any purpose, even commercially. However, you are not allowed to redistribute Meteostat data "as-is" for commercial purposes.
-
-By using the Meteostat Python library you agree to our [terms of service](https://dev.meteostat.net/terms.html). All meteorological data sources used by the Meteostat project are listed [here](https://dev.meteostat.net/sources.html).
-
-## Code License
-
-The code of this library is available under the [MIT license](https://opensource.org/licenses/MIT).

meteostat-1.7.6.dist-info/RECORD

@@ -1,39 +0,0 @@
-meteostat/__init__.py,sha256=QnC-Q27sHd1SoDnSB_o8QriQOOPsiyZQKkoViInybu8,989
-meteostat/units.py,sha256=G0vh2tYsp0ESGUpg3ZAE0U-b9Ih_oMtPNDZ71Bbq3iE,2566
-meteostat/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/core/cache.py,sha256=MEC6Hcf2rwg3__zv_Y1nSk16mfdTsrLH9CTraMX7NYw,1764
-meteostat/core/loader.py,sha256=bAItihzJrabglu37NN697WX_csltOviC9u7twAtV8rY,2842
-meteostat/core/warn.py,sha256=K9fBDoY2TIC2HjmCJl0k1Dq-dWA1hNq16OTLoG2F_rI,647
-meteostat/enumerations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/enumerations/granularity.py,sha256=lmhlHDUPvCwb05fDxYNG4GEuYCgy-u-AiZhpXJOj3uY,457
-meteostat/interface/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/interface/base.py,sha256=8ksGkdgyRDw2AA5ZwuES9XuBjseBPoNBBQiNspVp2JA,968
-meteostat/interface/daily.py,sha256=Rx-_U_t2iX-4wtBdieihioeo99mKEplrZaM23YRkwnM,2949
-meteostat/interface/hourly.py,sha256=nP4hIjxYbcZk0ua6m6fclAXfuhrxzB3jHPyiz3dLNs4,3965
-meteostat/interface/interpolate.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/interface/meteodata.py,sha256=Om7570m0LQ0BYyuEirr7zzFZ4r1f28rL1CTk9k_PPTs,6520
-meteostat/interface/monthly.py,sha256=LbeXgodQcVX0h987bv2lEJvewIcQkgt5Co_dyJ14F_A,2577
-meteostat/interface/normals.py,sha256=xBUBCjle8awhHgDWi6FOTfIMN4MdOrYFXuoLceCQVxE,7108
-meteostat/interface/point.py,sha256=lnKyvaclcsOXaErpPpaH0_3T1j2X7kgCKlIhk4s-EGQ,3801
-meteostat/interface/stations.py,sha256=hC2DmtE24u--lb3jbkFVMkFDKCR-LP5h8uXSOIb4_hg,6683
-meteostat/interface/timeseries.py,sha256=Dm8s59X3S9GcSOZ1mSrUv_xxjVOU6XJr06hQjbo73z8,7960
-meteostat/series/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/series/aggregate.py,sha256=dhYx1c2OzOgEcdUNCrmT4zdYY1UuT4PhkWYRirmx7v0,1200
-meteostat/series/convert.py,sha256=Uu76hw-M1QzwYuliA2hp0Dl9f1YyNaLE3AQTyaask60,641
-meteostat/series/count.py,sha256=kV0Oztmy1K0E3Z1h8Na9twxUhujRepRMtGzM_CNInJc,358
-meteostat/series/coverage.py,sha256=76PlEoVPM_-4Oys-6THggV-7gESbPM6Cx0m1n0-1YcM,534
-meteostat/series/fetch.py,sha256=MIrkhhtAucThO06Bcc92c6rrc3v5G31VBI0TkQd0oZ0,620
-meteostat/series/interpolate.py,sha256=tM41T_Hgc4Q2tAlommB5aRLvA3QVjX82WXXLVImSAJ4,1193
-meteostat/series/normalize.py,sha256=-eOa21NbV5vMSy3MSIiKhDbni5KCa2UV_CNf3A_JWTk,2151
-meteostat/series/stations.py,sha256=pHDQR1t7Z7jN5Vaj8wdNnSsZI8s6SiH5bNeTbys3TjA,447
-meteostat/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meteostat/utilities/aggregations.py,sha256=-t4ZBNM8cnwnuiR7Bzt7OlUQxNJMZkqS3E4AIMrJg3M,915
-meteostat/utilities/endpoint.py,sha256=ndHSMGi5LhB1yrjA3f6pDbe-0glnnDAX7IInp0Gscik,806
-meteostat/utilities/helpers.py,sha256=wt11OXHzIDw3DY98XGIfcrh1bPCC9dClVnNdGtqvz4U,1691
-meteostat/utilities/mutations.py,sha256=yzOXJquXGaroDAv_Xb7G4nxQE7vpoQojqGiTJn3cyq0,2274
-meteostat/utilities/validations.py,sha256=MlKY1gkeqmovFr4lR_iM6Bk7yuGdSgy0NGceiqYI7Vs,646
-meteostat-1.7.6.dist-info/LICENSE,sha256=kqpl7FVzWOCe11BZqJBZ1aRQi-aK87j3ljtG7P3VxLc,1066
-meteostat-1.7.6.dist-info/METADATA,sha256=yckdIiOARcU5WqCR5PdSfc9l6Ysxg5H5IXcFTj2O1xE,4633
-meteostat-1.7.6.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-meteostat-1.7.6.dist-info/top_level.txt,sha256=s8LP1xi5iF2zhVv5ULkHwW-tPeMrljxnA8VqZibQqro,10
-meteostat-1.7.6.dist-info/RECORD,,

meteostat-1.7.6.dist-info/top_level.txt

@@ -1 +0,0 @@
-meteostat