ECOv002-calval-tables 1.0.1__py3-none-any.whl → 1.2.0__py3-none-any.whl

ECOv002_calval_tables/ECOv002_calval_tables.py

@@ -1,6 +1,10 @@
+import os
 
+import numpy as np
 import pandas as pd
-import os
+import geopandas as gpd
+
+from shapely.geometry import Point
 
 def load_combined_eco_flux_ec_filtered() -> pd.DataFrame:
     """
@@ -12,11 +16,49 @@ def load_combined_eco_flux_ec_filtered() -> pd.DataFrame:
     return pd.read_csv(os.path.join(os.path.dirname(__file__), 'combined_eco_flux_EC_filtered.csv'))
 
 
-def load_metadata_ebc_filt() -> pd.DataFrame:
+def load_metadata_ebc_filt() -> gpd.GeoDataFrame:
     """
     Load the metadata for the filtered eddy covariance (EC) flux sites used in the ECOSTRESS Collection 2 validation study.
     This table provides site information (location, climate, land cover, etc.) for interpreting and grouping the flux data in the validation analysis.
     Returns:
         pd.DataFrame: DataFrame of site metadata for the filtered EC flux dataset.
     """
-    return pd.read_csv(os.path.join(os.path.dirname(__file__), 'metadata_ebc_filt.csv'))
+    df = pd.read_csv(os.path.join(os.path.dirname(__file__), 'metadata_ebc_filt.csv'))
+    
+    if 'Lat' not in df.columns or 'Long' not in df.columns:
+        raise ValueError("metadata_ebc_filt.csv must contain 'Lat' and 'Long' columns.")
+    
+    geometry = [Point(xy) for xy in zip(df['Long'], df['Lat'])]
+    gdf = gpd.GeoDataFrame(df, geometry=geometry, crs="EPSG:4326")
+
+    return gdf
+
+def load_calval_table() -> gpd.GeoDataFrame:
+    """
+    Load the combined ECOSTRESS Collection 2 validation table, which includes both the filtered eddy covariance flux data
+    and the associated site metadata.
+    
+    Returns:
+        gpd.GeoDataFrame: Combined GeoDataFrame of EC flux data and site metadata for validation analysis.
+    """
+    tower_locations_gdf = load_metadata_ebc_filt()
+    tower_data_df = load_combined_eco_flux_ec_filtered()
+
+    # Merge all columns from both tables, matching tower_data_df.ID to tower_locations_gdf["Site ID"]
+    merged_df = pd.merge(
+        tower_data_df,
+        tower_locations_gdf,
+        left_on="ID",
+        right_on="Site ID",
+        how="left",
+        suffixes=("", "_meta")
+    )
+
+    merged_df["time_UTC"] = merged_df["eco_time_utc"]
+    merged_df["ST_K"] = np.array(merged_df.LST)
+    merged_df["ST_C"] = merged_df.ST_K - 273.15
+    merged_df["Ta_C"] = np.array(merged_df.Ta)
+
+    # Convert merged DataFrame to GeoDataFrame
+    gdf = gpd.GeoDataFrame(merged_df, geometry=merged_df["geometry"], crs="EPSG:4326")
+    return gdf

ECOv002_calval_tables/version.py

@@ -0,0 +1,3 @@
+from importlib.metadata import version
+
+__version__ = version("ECOv002-calval-tables")

{ecov002_calval_tables-1.0.1.dist-info → ecov002_calval_tables-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ECOv002-calval-tables
-Version: 1.0.1
+Version: 1.2.0
 Summary: Priestley-Taylor Jet Propulsion Laboratory Soil Moisutre Evapotranspiration Model
 Author-email: Gregory Halverson <gregory.h.halverson@jpl.nasa.gov>, Zoe Pierrat <zoe.a.pierrat@jpl.nasa.gov>
 Project-URL: Homepage, https://github.com/gregory-halverson/ECOv002-calval-tables
@@ -21,10 +21,12 @@ Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
 
-# ECOSTRESS Collection 2 Calibration/Validation Data Tables (Python Package)
+# ECOSTRESS Collection 2 Calibration/Validation Data Tables
 
 This Python package provides calibration and validation data tables used in the evaluation of the ECOSTRESS Collection 2 Evapotranspiration (ET) data products. The included datasets and loader functions support reproducible research and validation workflows for ET modeling and remote sensing studies.
 
+The CSV files used in this repository were sourced from the [@zoepierrat/ECOSTRESS_C2_L3_ET_Validation](https://github.com/zoepierrat/ECOSTRESS_C2_L3_ET_Validation) repository.
+
 ## Authors
 
 Zoe Pierrat (she/her)  

ecov002_calval_tables-1.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+ECOv002_calval_tables/ECOv002_calval_tables.py,sha256=h-F6g5wdgtMrWAR7aMo4apVai-kkgih_m0HcqYL5D3E,2572
+ECOv002_calval_tables/__init__.py,sha256=oO0pVascuJs247UwpXq2o23wQPThM1bWEwUhSYiNzMY,60
+ECOv002_calval_tables/combined_eco_flux_EC_filtered.csv,sha256=uSRv1CBMJKUWBgtMlRHB1359kiUFUL1ez2c4m7C4DxU,745225
+ECOv002_calval_tables/metadata_ebc_filt.csv,sha256=74AeCH5DG2Zu8ZFBXUZAW95hlsCjK9K3t6BWRRReR3s,13975
+ECOv002_calval_tables/version.py,sha256=DOnf2BIAf7HAp9SIUIetrDgRoZDL0o7JuKSiC7_ZT_I,87
+ecov002_calval_tables-1.2.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+ecov002_calval_tables-1.2.0.dist-info/METADATA,sha256=WhXeX4uCPfEbGLXZUfgxD6n4UWW51fMoq5vU_m4HQQE,3171
+ecov002_calval_tables-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ecov002_calval_tables-1.2.0.dist-info/top_level.txt,sha256=ePbA84g_XQHWQUAQEVo6gmyuW0WLUzPg2IfHyoGqUqg,22
+ecov002_calval_tables-1.2.0.dist-info/RECORD,,

ecov002_calval_tables-1.0.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-ECOv002_calval_tables/ECOv002_calval_tables.py,sha256=t06ICMGPlyhuB_9EUkuASu8P_jXYk8CKbTRfTi7JOn8,1094
-ECOv002_calval_tables/__init__.py,sha256=oO0pVascuJs247UwpXq2o23wQPThM1bWEwUhSYiNzMY,60
-ECOv002_calval_tables/combined_eco_flux_EC_filtered.csv,sha256=uSRv1CBMJKUWBgtMlRHB1359kiUFUL1ez2c4m7C4DxU,745225
-ECOv002_calval_tables/metadata_ebc_filt.csv,sha256=74AeCH5DG2Zu8ZFBXUZAW95hlsCjK9K3t6BWRRReR3s,13975
-ecov002_calval_tables-1.0.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-ecov002_calval_tables-1.0.1.dist-info/METADATA,sha256=rFDwBUarZI1w2sFpcy_EE8p7fTW2hxNk9JUd20NoXGo,3010
-ecov002_calval_tables-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ecov002_calval_tables-1.0.1.dist-info/top_level.txt,sha256=ePbA84g_XQHWQUAQEVo6gmyuW0WLUzPg2IfHyoGqUqg,22
-ecov002_calval_tables-1.0.1.dist-info/RECORD,,