openskidata-format 5.0.0 → 5.2.0

package/dist/Run.d.ts

@@ -2,6 +2,7 @@ import * as GeoJSON from 'geojson';
 import { ElevationData, ElevationProfile } from './ElevationProfile';
 import { FeatureType } from './FeatureType';
 import { SkiAreaSummaryFeature } from './SkiArea';
+import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
 export type RunGeometry = GeoJSON.LineString | GeoJSON.Polygon;
@@ -45,6 +46,7 @@ export type RunFeature = GeoJSON.Feature<RunGeometry, RunProperties>;
  * @property {Source[]} sources - Data sources for this run's information
  * @property {string[]} websites - Websites associated with this run, derived from the OpenStreetMap website tag
  * @property {string | null} wikidata_id - Wikidata identifier, if available, derived from the OpenStreetMap wikidata tag
+ * @property {SnowCoverHistory} [snowCoverHistory] - Historical snow cover data for this run, if available
  */
 export type RunProperties = {
     type: FeatureType.Run;
@@ -66,6 +68,7 @@ export type RunProperties = {
     sources: Source[];
     websites: string[];
     wikidata_id: string | null;
+    snowCoverHistory?: SnowCoverHistory;
 };
 export declare enum RunUse {
     Downhill = "downhill",

package/dist/Run.js.map

@@ -1 +1 @@
-{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":";;;AAoKA,kDAUC;AAED,kCAKC;AAED,kDAiBC;AAED,0CAyDC;AAlQD,yDAK2B;AAK3B,4EAAwE;AAoExE,IAAY,MAYX;AAZD,WAAY,MAAM;IAChB,+BAAqB,CAAA;IACrB,2BAAiB,CAAA;IACjB,6BAAmB,CAAA;IACnB,uBAAa,CAAA;IACb,uBAAa,CAAA;IACb,2BAAiB,CAAA;IACjB,gCAAsB,CAAA;IACtB,gCAAsB,CAAA;IACtB,mCAAyB,CAAA;IACzB,mCAAyB,CAAA;IACzB,6BAAmB,CAAA;AACrB,CAAC,EAZW,MAAM,sBAAN,MAAM,QAYjB;AAED,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,oDAAqC,CAAA;IACrC,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,0CAA2B,CAAA;AAC7B,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB;AAED,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;AACrB,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB;AAED,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,+BAAe,CAAA;IACf,iCAAiB,CAAA;IACjB,6BAAa,CAAA;AACf,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAED,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,6CAA4B,CAAA;IAC5B,2CAA0B,CAAA;IAC1B,yCAAwB,CAAA;IACxB,8CAA6B,CAAA;IAC7B,yCAAwB,CAAA;AAC1B,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAED;;;GAGG;AACH,IAAY,uBA4BX;AA5BD,WAAY,uBAAuB;IACjC;;;;;;;OAOG;IACH,4CAAiB,CAAA;IAEjB;;;;;;OAMG;IACH,0CAAe,CAAA;IAEf;;;;;;OAMG;IACH,0DAA+B,CAAA;AACjC,CAAC,EA5BW,uBAAuB,uCAAvB,uBAAuB,QA4BlC;AAED,SAAgB,mBAAmB,CAAC,OAAmB;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAA;IACnD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+EAA+E;IAC/E,MAAM,eAAe,GAAG,IAAA,qCAAkB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC7D,OAAO,IAAA,mCAAgB,EAAC,eAAe,CAAC,CAAA;AAC1C,CAAC;AAED,SAAgB,WAAW,CACzB,UAAmC,EACnC,UAAgC;IAEhC,OAAO,mBAAmB,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAA;AACrE,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAmB;IACrD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,aAAa,CAAC,KAAK,CAAA;QAC5B,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,aAAa,CAAC,IAAI,CAAA;QAC3B,KAAK,YAAY,CAAC,GAAG;YACnB,OAAO,aAAa,CAAC,GAAG,CAAA;QAC1B,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,aAAa,CAAC,KAAK,CAAA;QAC5B,KAAK,YAAY,CAAC,MAAM;YACtB,OAAO,aAAa,CAAC,MAAM,CAAA;QAC7B,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,aAAa,CAAC,IAAI,CAAA;QAC3B;YACE,MAAM,eAAe,CAAA;IACzB,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,UAAmC,EACnC,UAAgC;IAEhC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,uBAAuB,CAAC,MAAM;YACjC,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,aAAa,CAAC,MAAM;oBACvB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,IAAI;oBACrB,OAAO,YAAY,CAAC,IAAI,CAAA;gBAC1B,KAAK,aAAa,CAAC,YAAY;oBAC7B,OAAO,YAAY,CAAC,GAAG,CAAA;gBACzB,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,MAAM;oBACvB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,OAAO;oBACxB,OAAO,YAAY,CAAC,MAAM,CAAA;gBAC5B;oBACE,OAAO,YAAY,CAAC,IAAI,CAAA;YAC5B,CAAC;QACH,KAAK,uBAAuB,CAAC,KAAK;YAChC,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,aAAa,CAAC,MAAM,CAAC;gBAC1B,KAAK,aAAa,CAAC,IAAI;oBACrB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,YAAY;oBAC7B,OAAO,YAAY,CAAC,GAAG,CAAA;gBACzB,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,MAAM;oBACvB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,OAAO;oBACxB,OAAO,YAAY,CAAC,MAAM,CAAA;gBAC5B;oBACE,OAAO,YAAY,CAAC,IAAI,CAAA;YAC5B,CAAC;QACH,KAAK,uBAAuB,CAAC,aAAa;YACxC,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,aAAa,CAAC,MAAM,CAAC;gBAC1B,KAAK,aAAa,CAAC,IAAI;oBACrB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,YAAY;oBAC7B,OAAO,YAAY,CAAC,IAAI,CAAA;gBAC1B,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,MAAM;oBACvB,OAAO,YAAY,CAAC,KAAK,CAAA;gBAC3B,KAAK,aAAa,CAAC,QAAQ,CAAC;gBAC5B,KAAK,aAAa,CAAC,OAAO;oBACxB,OAAO,YAAY,CAAC,MAAM,CAAA;gBAC5B;oBACE,OAAO,YAAY,CAAC,IAAI,CAAA;YAC5B,CAAC;QACH;YACE,OAAO,IAAA,iDAAuB,EAAC,UAAU,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC"}
+{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":"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"}

package/dist/SkiArea.d.ts

@@ -2,6 +2,7 @@ import { FeatureType } from './FeatureType';
 import { LiftType } from './Lift';
 import { Location } from './Location';
 import { RunDifficulty, RunDifficultyConvention } from './Run';
+import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
 /**
@@ -63,6 +64,16 @@ export type SkiAreaStatistics = {
     lifts: LiftStatistics;
     minElevation?: number;
     maxElevation?: number;
+    snowCover?: SkiAreaSnowCoverStatistics;
+};
+/**
+ * Aggregated snow cover data for a ski area's runs.
+ */
+export type SkiAreaSnowCoverStatistics = {
+    overall: SnowCoverHistory;
+    byActivity: {
+        [key in SkiAreaActivity | 'other']?: SnowCoverHistory;
+    };
 };
 export type RunStatistics = {
     minElevation?: number;

package/dist/SkiArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAoEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAqEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/dist/SnowCoverHistory.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Historical snow cover information for a geometry.
+ * Data is organized chronologically, with the oldest year first.
+ *
+ * @property {number} year - The year for this data
+ * @property {Array<[number, number, number]>} days - Daily measurements as tuples of [day of year, NDSI snow cover value, % of valid pixels]
+ */
+export type SnowCoverHistory = {
+    year: number;
+    /**
+     * Array of daily snow cover measurements ordered chronologically by day of year.
+     * Each tuple contains:
+     * - Day of year (1-365/366)
+     * - NDSI snow cover value (0-100) - measures snow presence, not depth
+     * - Percentage of valid pixels (0-100) - pixels with valid data for that day
+     *
+     * Data source: VIIRS/NPP CGF Snow Cover Daily L3 Global 375m product (VNP10A1F)
+     * Resolution: 375m (affects measurement accuracy for small geometries)
+     * Frequency: Weekly under cloud-free conditions, varies in practice
+     *
+     * Valid pixel percentage may be less than 100% due to:
+     * - Cloud cover
+     * - Different cloud gap filling dates for pixels
+     * - Incomplete pipeline data
+     */
+    days: [number, number, number][];
+}[];
+/**
+ * Monthly aggregated snow cover history.
+ * Data is organized chronologically, with the oldest year first.
+ *
+ * @property {number} year - The year for this data
+ * @property {Array<[number, number, number]>} months - Monthly aggregations as tuples of [month, average snow cover, average valid pixels]
+ */
+export type MonthlySnowCoverHistory = {
+    year: number;
+    /**
+     * Array of monthly snow cover aggregations ordered chronologically by month.
+     * Each tuple contains:
+     * - Month (1-12)
+     * - Average NDSI snow cover value (0-100) - weighted by valid pixels
+     * - Average percentage of valid pixels (0-100) - across all days in month
+     */
+    months: [number, number, number][];
+}[];
+/**
+ * Converts daily snow cover measurements to monthly aggregations.
+ *
+ * Snow cover values are weighted by valid pixel percentages when calculating monthly averages.
+ * Input data is assumed to be sorted chronologically.
+ *
+ * @param snowCoverHistory Daily snow cover history to aggregate
+ * @returns Monthly aggregated snow cover history
+ */
+export declare function getMonthlySnowCover(snowCoverHistory: SnowCoverHistory): MonthlySnowCoverHistory;

package/dist/SnowCoverHistory.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMonthlySnowCover = getMonthlySnowCover;
+/**
+ * Converts daily snow cover measurements to monthly aggregations.
+ *
+ * Snow cover values are weighted by valid pixel percentages when calculating monthly averages.
+ * Input data is assumed to be sorted chronologically.
+ *
+ * @param snowCoverHistory Daily snow cover history to aggregate
+ * @returns Monthly aggregated snow cover history
+ */
+function getMonthlySnowCover(snowCoverHistory) {
+    return snowCoverHistory.map(yearData => {
+        const monthlyData = new Map();
+        // Group daily data by month
+        yearData.days.forEach(([dayOfYear, snowCover, validPixelPercent]) => {
+            const date = dayOfYearToDate(yearData.year, dayOfYear);
+            const month = date.getMonth() + 1; // Convert to 1-12
+            if (!monthlyData.has(month)) {
+                monthlyData.set(month, { values: [], validPixels: [], count: 0 });
+            }
+            const monthData = monthlyData.get(month);
+            monthData.values.push(snowCover * validPixelPercent / 100); // Weight by valid pixels
+            monthData.validPixels.push(validPixelPercent);
+            monthData.count++;
+        });
+        // Calculate monthly averages
+        const months = [];
+        monthlyData.forEach((data, month) => {
+            const totalValidPixels = data.validPixels.reduce((sum, val) => sum + val, 0);
+            const weightedSnowCover = data.values.reduce((sum, val) => sum + val, 0);
+            const avgValidPixels = totalValidPixels / data.count;
+            const avgSnowCover = avgValidPixels > 0 ? (weightedSnowCover / totalValidPixels) * 100 : 0;
+            months.push([month, Math.round(avgSnowCover * 100) / 100, Math.round(avgValidPixels * 100) / 100]);
+        });
+        return {
+            year: yearData.year,
+            months
+        };
+    });
+}
+/**
+ * Converts day of year to a Date object.
+ *
+ * @param year The year
+ * @param dayOfYear Day of year (1-365/366)
+ * @returns Date object for the specified day
+ */
+function dayOfYearToDate(year, dayOfYear) {
+    const date = new Date(year, 0, 1);
+    date.setDate(dayOfYear);
+    return date;
+}
+//# sourceMappingURL=SnowCoverHistory.js.map

package/dist/SnowCoverHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnowCoverHistory.js","sourceRoot":"","sources":["../src/SnowCoverHistory.ts"],"names":[],"mappings":";;AAwDA,kDAqCC;AA9CD;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,gBAAkC;IAElC,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;QACrC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsE,CAAA;QAEjG,4BAA4B;QAC5B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,EAAE;YAClE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA,CAAC,kBAAkB;YAEpD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACnE,CAAC;YAED,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAA;YACzC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,iBAAiB,GAAG,GAAG,CAAC,CAAA,CAAC,yBAAyB;YACpF,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAC7C,SAAS,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC,CAAC,CAAA;QAEF,6BAA6B;QAC7B,MAAM,MAAM,GAA+B,EAAE,CAAA;QAC7C,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;YAC5E,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;YACxE,MAAM,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAA;YACpD,MAAM,YAAY,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAE1F,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QACpG,CAAC,CAAC,CAAA;QAEF,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,SAAiB;IACtD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACjC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACvB,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export * from './LiftNameFormatter';
 export * from './Location';
 export * from './Run';
 export * from './SkiArea';
+export * from './SnowCoverHistory';
 export * from './Source';
 export * from './Status';

package/dist/index.js

@@ -8,6 +8,7 @@ tslib_1.__exportStar(require("./LiftNameFormatter"), exports);
 tslib_1.__exportStar(require("./Location"), exports);
 tslib_1.__exportStar(require("./Run"), exports);
 tslib_1.__exportStar(require("./SkiArea"), exports);
+tslib_1.__exportStar(require("./SnowCoverHistory"), exports);
 tslib_1.__exportStar(require("./Source"), exports);
 tslib_1.__exportStar(require("./Status"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,qDAA0B;AAC1B,gDAAqB;AACrB,oDAAyB;AACzB,mDAAwB;AACxB,mDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,qDAA0B;AAC1B,gDAAqB;AACrB,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,mDAAwB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openskidata-format",
-  "version": "5.0.0",
+  "version": "5.2.0",
   "description": "Data format for OpenSkiMap.org",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/Run.ts

@@ -7,6 +7,7 @@ import {
 } from './ElevationProfile'
 import { FeatureType } from './FeatureType'
 import { SkiAreaSummaryFeature } from './SkiArea'
+import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
 import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
@@ -54,6 +55,7 @@ export type RunFeature = GeoJSON.Feature<RunGeometry, RunProperties>
  * @property {Source[]} sources - Data sources for this run's information
  * @property {string[]} websites - Websites associated with this run, derived from the OpenStreetMap website tag
  * @property {string | null} wikidata_id - Wikidata identifier, if available, derived from the OpenStreetMap wikidata tag
+ * @property {SnowCoverHistory} [snowCoverHistory] - Historical snow cover data for this run, if available
  */
 export type RunProperties = {
   type: FeatureType.Run
@@ -75,6 +77,7 @@ export type RunProperties = {
   sources: Source[]
   websites: string[]
   wikidata_id: string | null
+  snowCoverHistory?: SnowCoverHistory
 }
 
 export enum RunUse {

package/src/SkiArea.ts

@@ -2,6 +2,7 @@ import { FeatureType } from './FeatureType'
 import { LiftType } from './Lift'
 import { Location } from './Location'
 import { RunDifficulty, RunDifficultyConvention } from './Run'
+import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
 
@@ -76,6 +77,15 @@ export type SkiAreaStatistics = {
   lifts: LiftStatistics
   minElevation?: number
   maxElevation?: number
+  snowCover?: SkiAreaSnowCoverStatistics
+}
+
+/**
+ * Aggregated snow cover data for a ski area's runs.
+ */
+export type SkiAreaSnowCoverStatistics = {
+  overall: SnowCoverHistory
+  byActivity: { [key in SkiAreaActivity | 'other']?: SnowCoverHistory }
 }
 
 export type RunStatistics = {

package/src/SnowCoverHistory.test.ts

@@ -0,0 +1,103 @@
+import { getMonthlySnowCover, SnowCoverHistory, MonthlySnowCoverHistory } from './SnowCoverHistory'
+
+describe('getMonthlySnowCover', () => {
+  it('should process daily data into monthly averages', () => {
+    const input: SnowCoverHistory = [
+      {
+        year: 2023,
+        days: [
+          [1, 80, 95],   // Jan 1
+          [15, 75, 90],  // Jan 15
+          [32, 60, 85],  // Feb 1
+          [46, 65, 80],  // Feb 15
+          [60, 40, 75],  // Mar 1
+          [74, 35, 70],  // Mar 15
+        ]
+      }
+    ]
+
+    const result = getMonthlySnowCover(input)
+
+    expect(result).toHaveLength(1)
+    expect(result[0].year).toBe(2023)
+    expect(result[0].months).toHaveLength(3)
+
+    // January: (80*95 + 75*90) / (95 + 90) = (7600 + 6750) / 185 = 77.57
+    expect(result[0].months[0][0]).toBe(1) // Month
+    expect(result[0].months[0][1]).toBeCloseTo(77.57, 1) // Snow cover
+    expect(result[0].months[0][2]).toBe(92.5) // Valid pixels average
+
+    // February: (60*85 + 65*80) / (85 + 80) = (5100 + 5200) / 165 = 62.42
+    expect(result[0].months[1][0]).toBe(2)
+    expect(result[0].months[1][1]).toBeCloseTo(62.42, 1)
+    expect(result[0].months[1][2]).toBe(82.5)
+
+    // March: (40*75 + 35*70) / (75 + 70) = (3000 + 2450) / 145 = 37.59
+    expect(result[0].months[2][0]).toBe(3)
+    expect(result[0].months[2][1]).toBeCloseTo(37.59, 1)
+    expect(result[0].months[2][2]).toBe(72.5)
+  })
+
+  it('should handle multiple years', () => {
+    const input: SnowCoverHistory = [
+      {
+        year: 2022,
+        days: [[1, 50, 80]]
+      },
+      {
+        year: 2023,
+        days: [[1, 60, 90]]
+      }
+    ]
+
+    const result = getMonthlySnowCover(input)
+
+    expect(result).toHaveLength(2)
+    expect(result[0].year).toBe(2022)
+    expect(result[1].year).toBe(2023)
+  })
+
+  it('should handle empty data', () => {
+    const input: SnowCoverHistory = []
+    const result = getMonthlySnowCover(input)
+    expect(result).toEqual([])
+  })
+
+  it('should handle zero valid pixels gracefully', () => {
+    const input: SnowCoverHistory = [
+      {
+        year: 2023,
+        days: [
+          [1, 80, 0],   // No valid pixels
+          [15, 75, 100] // Full valid pixels
+        ]
+      }
+    ]
+
+    const result = getMonthlySnowCover(input)
+
+    expect(result[0].months[0][0]).toBe(1)
+    expect(result[0].months[0][1]).toBe(75) // Only the second day contributes
+    expect(result[0].months[0][2]).toBe(50) // Average of 0 and 100
+  })
+
+  it('should handle data across multiple months', () => {
+    const input: SnowCoverHistory = [
+      {
+        year: 2023,
+        days: [
+          [1, 80, 90],   // January
+          [100, 40, 70], // April (day 100)
+          [335, 50, 80]  // December (day 335)
+        ]
+      }
+    ]
+
+    const result = getMonthlySnowCover(input)
+
+    expect(result[0].months).toHaveLength(3)
+    expect(result[0].months[0][0]).toBe(1)  // January
+    expect(result[0].months[1][0]).toBe(4)  // April  
+    expect(result[0].months[2][0]).toBe(12) // December
+  })
+})

package/src/SnowCoverHistory.ts

@@ -0,0 +1,107 @@
+/**
+ * Historical snow cover information for a geometry.
+ * Data is organized chronologically, with the oldest year first.
+ * 
+ * @property {number} year - The year for this data
+ * @property {Array<[number, number, number]>} days - Daily measurements as tuples of [day of year, NDSI snow cover value, % of valid pixels]
+ */
+export type SnowCoverHistory = {
+  year: number
+  /**
+   * Array of daily snow cover measurements ordered chronologically by day of year.
+   * Each tuple contains:
+   * - Day of year (1-365/366)
+   * - NDSI snow cover value (0-100) - measures snow presence, not depth
+   * - Percentage of valid pixels (0-100) - pixels with valid data for that day
+   * 
+   * Data source: VIIRS/NPP CGF Snow Cover Daily L3 Global 375m product (VNP10A1F)
+   * Resolution: 375m (affects measurement accuracy for small geometries)
+   * Frequency: Weekly under cloud-free conditions, varies in practice
+   * 
+   * Valid pixel percentage may be less than 100% due to:
+   * - Cloud cover
+   * - Different cloud gap filling dates for pixels
+   * - Incomplete pipeline data
+   */
+  days: [number, number, number][]
+}[]
+
+/**
+ * Monthly aggregated snow cover history.
+ * Data is organized chronologically, with the oldest year first.
+ * 
+ * @property {number} year - The year for this data
+ * @property {Array<[number, number, number]>} months - Monthly aggregations as tuples of [month, average snow cover, average valid pixels]
+ */
+export type MonthlySnowCoverHistory = {
+  year: number
+  /**
+   * Array of monthly snow cover aggregations ordered chronologically by month.
+   * Each tuple contains:
+   * - Month (1-12)
+   * - Average NDSI snow cover value (0-100) - weighted by valid pixels
+   * - Average percentage of valid pixels (0-100) - across all days in month
+   */
+  months: [number, number, number][]
+}[]
+
+/**
+ * Converts daily snow cover measurements to monthly aggregations.
+ * 
+ * Snow cover values are weighted by valid pixel percentages when calculating monthly averages.
+ * Input data is assumed to be sorted chronologically.
+ * 
+ * @param snowCoverHistory Daily snow cover history to aggregate
+ * @returns Monthly aggregated snow cover history
+ */
+export function getMonthlySnowCover(
+  snowCoverHistory: SnowCoverHistory
+): MonthlySnowCoverHistory {
+  return snowCoverHistory.map(yearData => {
+    const monthlyData = new Map<number, { values: number[], validPixels: number[], count: number }>()
+    
+    // Group daily data by month
+    yearData.days.forEach(([dayOfYear, snowCover, validPixelPercent]) => {
+      const date = dayOfYearToDate(yearData.year, dayOfYear)
+      const month = date.getMonth() + 1 // Convert to 1-12
+      
+      if (!monthlyData.has(month)) {
+        monthlyData.set(month, { values: [], validPixels: [], count: 0 })
+      }
+      
+      const monthData = monthlyData.get(month)!
+      monthData.values.push(snowCover * validPixelPercent / 100) // Weight by valid pixels
+      monthData.validPixels.push(validPixelPercent)
+      monthData.count++
+    })
+    
+    // Calculate monthly averages
+    const months: [number, number, number][] = []
+    monthlyData.forEach((data, month) => {
+      const totalValidPixels = data.validPixels.reduce((sum, val) => sum + val, 0)
+      const weightedSnowCover = data.values.reduce((sum, val) => sum + val, 0)
+      const avgValidPixels = totalValidPixels / data.count
+      const avgSnowCover = avgValidPixels > 0 ? (weightedSnowCover / totalValidPixels) * 100 : 0
+      
+      months.push([month, Math.round(avgSnowCover * 100) / 100, Math.round(avgValidPixels * 100) / 100])
+    })
+    
+    return {
+      year: yearData.year,
+      months
+    }
+  })
+}
+
+/**
+ * Converts day of year to a Date object.
+ * 
+ * @param year The year
+ * @param dayOfYear Day of year (1-365/366)
+ * @returns Date object for the specified day
+ */
+function dayOfYearToDate(year: number, dayOfYear: number): Date {
+  const date = new Date(year, 0, 1)
+  date.setDate(dayOfYear)
+  return date
+}

package/src/index.ts

@@ -5,5 +5,6 @@ export * from './LiftNameFormatter'
 export * from './Location'
 export * from './Run'
 export * from './SkiArea'
+export * from './SnowCoverHistory'
 export * from './Source'
 export * from './Status'