@caoguo/maplibre-pipeline 0.0.1

package/dist/health/index.d.ts

@@ -0,0 +1,210 @@
+import { PipeMaterial, PipeStatus, PipelineTopologyDataset } from '../types/index.js';
+import { Map } from '@caoguo/maplibre';
+
+/**
+ * 管线健康度评分（healthScorer）
+ *
+ * 6 维加权评分（PRD §4.4.2）：
+ *   health_score = age (0.25) + material (0.20) + soil (0.15) +
+ *                  history (0.20) + pressure (0.10) + protection (0.10)
+ *
+ * 每维 0-100，最终加权求和。
+ * 评分模型可解释：每个维度的评分依据清晰可见。
+ */
+
+interface PipeHealthInput {
+    /** 安装日期 ISO */
+    installDate?: string;
+    /** 材质 */
+    material?: PipeMaterial;
+    /** 当前故障次数 */
+    failureCount?: number;
+    /** 当前压力（MPa） */
+    pressure?: number;
+    /** 最高允许压力（MPa） */
+    ratedPressure?: number;
+    /** 是否阴极保护 */
+    hasCathodicProtection?: boolean;
+    /** 土壤腐蚀指数 0-1（无数据时 0.5） */
+    soilCorrosion?: number;
+    /** 状态（damaged / under_repair 直接影响评分） */
+    status?: PipeStatus;
+}
+interface PipeHealthScore {
+    /** 总分 0-100 */
+    score: number;
+    /** 等级 */
+    level: 'excellent' | 'good' | 'fair' | 'poor' | 'critical';
+    /** 6 维细分 */
+    dimensions: {
+        age: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+        material: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+        soil: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+        history: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+        pressure: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+        protection: {
+            score: number;
+            weight: number;
+            reason: string;
+        };
+    };
+}
+/** 默认权重 */
+declare const DEFAULT_WEIGHTS: {
+    age: number;
+    material: number;
+    soil: number;
+    history: number;
+    pressure: number;
+    protection: number;
+};
+/**
+ * 计算单根管线的健康度
+ */
+declare function scorePipeHealth(input: PipeHealthInput, weights?: {
+    age: number;
+    material: number;
+    soil: number;
+    history: number;
+    pressure: number;
+    protection: number;
+}): PipeHealthScore;
+/**
+ * 批量评分（按需遍历）
+ */
+declare function scorePipes(inputs: PipeHealthInput[], weights?: {
+    age: number;
+    material: number;
+    soil: number;
+    history: number;
+    pressure: number;
+    protection: number;
+}): PipeHealthScore[];
+
+/**
+ * 风险热力图（riskHeatmap）
+ *
+ * 把 scorePipeHealth 输出按地理网格聚合，输出每个网格的平均分/最高风险，
+ * 用于地图热力图（heat-map layer）。
+ *
+ * 输入：管线数组 [{ lng, lat, healthScore }]
+ * 输出：GeoJSON FeatureCollection<Point>（含 healthScore 属性）
+ */
+interface HeatmapCell {
+    lng: number;
+    lat: number;
+    healthScore: number;
+    /** 网格内管段数 */
+    pipeCount: number;
+}
+interface PipeHealthPoint {
+    lng: number;
+    lat: number;
+    healthScore: number;
+}
+interface RiskHeatmapOptions {
+    /** 网格尺寸（m），默认 500 */
+    cellSize?: number;
+    /** 聚合方式 */
+    aggregation?: 'average' | 'min' | 'max';
+}
+declare function aggregateHeatmap(points: PipeHealthPoint[], options?: RiskHeatmapOptions): HeatmapCell[];
+declare function heatmapToGeoJSON(cells: HeatmapCell[]): GeoJSON.FeatureCollection<GeoJSON.Point>;
+/** 优先维护建议列表（风险最高的 Top N 管线） */
+declare function prioritizeMaintenance(pipes: Array<{
+    id: string;
+    healthScore: number;
+    lng: number;
+    lat: number;
+    label?: string;
+}>, topN?: number): {
+    id: string;
+    healthScore: number;
+    lng: number;
+    lat: number;
+    label?: string;
+}[];
+
+/**
+ * PipelineHealth 组件类（地图集成层）
+ */
+
+interface PipelineHealthOptions {
+    map: Map;
+    dataset: PipelineTopologyDataset;
+    cellSize?: number;
+    layerPrefix?: string;
+}
+interface HealthResult {
+    /** 全部管段评分 */
+    scores: Array<{
+        pipeId: string;
+        score: PipeHealthScore;
+    }>;
+    /** 热力图聚合格 */
+    heatmap: HeatmapCell[];
+    /** 优先维护建议 */
+    maintenance: Array<{
+        id: string;
+        healthScore: number;
+        lng: number;
+        lat: number;
+        label?: string;
+    }>;
+    /** 计算耗时 */
+    durationMs: number;
+}
+type Listener = (r: HealthResult) => void;
+/**
+ * 管线健康评估组件
+ */
+declare class PipelineHealth {
+    private map;
+    private dataset;
+    private cellSize;
+    private layerPrefix;
+    private listeners;
+    private lastResult;
+    private layerIds;
+    constructor(options: PipelineHealthOptions);
+    /** 评估全网管线健康度 */
+    evaluate(weights?: {
+        age: number;
+        material: number;
+        soil: number;
+        history: number;
+        pressure: number;
+        protection: number;
+    }): HealthResult;
+    /** 清空图层 */
+    clear(): void;
+    /** 销毁 */
+    destroy(): void;
+    /** 订阅结果 */
+    onResult(fn: Listener): () => void;
+    /** 取最后一次结果 */
+    getLastResult(): HealthResult | null;
+    private renderHeatmap;
+}
+
+export { DEFAULT_WEIGHTS, type HealthResult, type HeatmapCell, type PipeHealthInput, type PipeHealthPoint, type PipeHealthScore, PipelineHealth, type PipelineHealthOptions, type RiskHeatmapOptions, aggregateHeatmap, heatmapToGeoJSON, prioritizeMaintenance, scorePipeHealth, scorePipes };

package/dist/health/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_WEIGHTS, PipelineHealth, aggregateHeatmap, heatmapToGeoJSON, prioritizeMaintenance, scorePipeHealth, scorePipes } from '../chunk-VA2TQWL3.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}