@smartnet360/svelte-components 0.0.102 → 0.0.104

package/dist/core/CoverageMap/data/SiteStore.js

@@ -0,0 +1,355 @@
+/**
+ * Site Store
+ *
+ * This module manages site and cell/sector data for the coverage calculator.
+ * It provides integration with existing map cell data and converts it
+ * to the format needed for coverage calculations.
+ *
+ * Integration points:
+ * - map-v2 and map-v3 cell data
+ * - Antenna store (for loading antenna patterns)
+ * - Coverage calculator (for creating configurations)
+ */
+import { antennaStore } from './AntennaStore';
+// ============================================================================
+// SITE STORE CLASS
+// ============================================================================
+/**
+ * Site Store - Manages site and sector data
+ *
+ * Converts cell data from map components into site configurations
+ * suitable for coverage calculations.
+ */
+export class SiteStore {
+    /**
+     * Create site configuration from cell data
+     *
+     * Takes an array of cells (sectors) that belong to the same site
+     * and creates a complete site configuration for coverage calculation.
+     *
+     * Process:
+     * 1. Group cells by site (use siteName or siteId)
+     * 2. For each cell, create sector configuration
+     * 3. Load antenna patterns
+     * 4. Set RF parameters (power, frequency, tilts)
+     * 5. Assign colors for visualization
+     *
+     * @param cells - Array of cells from map component
+     * @param siteId - Optional site ID to filter (if cells from multiple sites)
+     * @returns Site configuration ready for coverage calculation
+     *
+     * @example
+     * const cells = getCellsForSite("SITE_001");
+     * const siteConfig = await siteStore.createSiteConfiguration(cells);
+     *
+     * // Use for coverage calculation
+     * const calculator = new CoverageCalculator();
+     * const result = await calculator.calculate({ site: siteConfig, ... });
+     */
+    async createSiteConfiguration(cells, siteId) {
+        if (!cells || cells.length === 0) {
+            console.error('No cells provided for site configuration');
+            return null;
+        }
+        // Filter to specific site if provided
+        const siteCells = siteId
+            ? cells.filter((c) => c.siteId === siteId || c.cellName.startsWith(siteId))
+            : cells;
+        if (siteCells.length === 0) {
+            console.error(`No cells found for site: ${siteId}`);
+            return null;
+        }
+        // Use first cell to get site information
+        const firstCell = siteCells[0];
+        const siteName = firstCell.siteId || firstCell.cellName.split('_')[0] || 'Unknown Site';
+        const sitePosition = {
+            lat: firstCell.siteLatitude || firstCell.latitude,
+            lng: firstCell.siteLongitude || firstCell.longitude
+        };
+        // Create sector configurations
+        const sectors = [];
+        for (let i = 0; i < siteCells.length; i++) {
+            const cell = siteCells[i];
+            try {
+                const sectorConfig = await this.createSectorConfig(cell, i);
+                if (sectorConfig) {
+                    sectors.push(sectorConfig);
+                }
+            }
+            catch (error) {
+                console.error(`Failed to create sector config for cell ${cell.cellName}:`, error);
+            }
+        }
+        if (sectors.length === 0) {
+            console.error('Failed to create any sector configurations');
+            return null;
+        }
+        return {
+            siteId: siteId || siteName,
+            siteName,
+            position: sitePosition,
+            sectors
+        };
+    }
+    /**
+     * Create sector configuration from a single cell
+     *
+     * @param cell - Cell data from map
+     * @param index - Sector index (for color assignment)
+     * @returns Sector configuration
+     */
+    async createSectorConfig(cell, index) {
+        // Load antenna pattern
+        let antennaPattern = await antennaStore.getAntenna(cell.antenna, String(cell.electricalTilt || '0'));
+        if (!antennaPattern) {
+            console.warn(`Failed to load antenna pattern for ${cell.cellName}: ${cell.antenna}`);
+            // Create a default omnidirectional pattern
+            const defaultPattern = new Array(360).fill(0);
+            antennaPattern = {
+                name: cell.antenna || 'Unknown',
+                model: cell.antenna || 'Unknown',
+                frequency: this.parseFrequency(cell.fband),
+                gain_dBd: 0, // Assume 0 dBd if unknown
+                gain_dBi: 2.15, // 0 dBd = 2.15 dBi
+                pattern: defaultPattern,
+                vertical_pattern: defaultPattern,
+                availableTilts: ['0']
+            };
+        }
+        // Determine TX power (priority: atollPW > nwtP1 > default)
+        const txPower = cell.atollPW || cell.nwtP1 || 43; // Default to 43 dBm (20W)
+        // Determine frequency from band
+        const frequency = antennaPattern.frequency || this.parseFrequency(cell.fband);
+        // Get mechanical tilt (might need to parse from string)
+        // Note: Cell has electricalTilt string, mechanical tilt may need to be derived or defaulted
+        const mechanicalTilt = 0; // TODO: Extract from cell data if available
+        // Get electrical tilt
+        const electricalTilt = parseFloat(String(cell.electricalTilt || '0'));
+        // Assign sector color (rotate through standard colors)
+        const color = this.getSectorColor(index);
+        // Create sector name (extract from cell name or use index)
+        const sectorName = this.extractSectorName(cell.cellName, index);
+        return {
+            sectorId: cell.cellName,
+            sectorName,
+            position: {
+                lat: cell.latitude,
+                lng: cell.longitude,
+                height: cell.height
+            },
+            azimuth: cell.azimuth,
+            mechanicalTilt,
+            electricalTilt,
+            txPower,
+            frequency,
+            antennaPattern,
+            enabled: true, // Enable by default
+            color
+        };
+    } /**
+         * Group cells by site
+         *
+         * Takes an array of cells and groups them by site for batch processing.
+         *
+         * @param cells - Array of all cells
+         * @returns Map of siteId → cells
+         */
+    groupCellsBySite(cells) {
+        const siteMap = new Map();
+        for (const cell of cells) {
+            const siteId = cell.siteId || cell.cellName.split('_')[0] || 'Unknown';
+            if (!siteMap.has(siteId)) {
+                siteMap.set(siteId, []);
+            }
+            siteMap.get(siteId).push(cell);
+        }
+        return siteMap;
+    }
+    /**
+     * Create site configurations for multiple sites
+     *
+     * @param cells - Array of all cells
+     * @returns Array of site configurations
+     */
+    async createMultipleSiteConfigurations(cells) {
+        const siteMap = this.groupCellsBySite(cells);
+        const configurations = [];
+        for (const [siteId, siteCells] of siteMap.entries()) {
+            try {
+                const config = await this.createSiteConfiguration(siteCells, siteId);
+                if (config) {
+                    configurations.push(config);
+                }
+            }
+            catch (error) {
+                console.error(`Failed to create configuration for site ${siteId}:`, error);
+            }
+        }
+        return configurations;
+    }
+    // ========================================================================
+    // PRIVATE HELPER METHODS
+    // ========================================================================
+    /**
+     * Parse frequency from band string
+     *
+     * Examples:
+     *   "700" → 700 MHz
+     *   "1800" → 1800 MHz
+     *   "L700" → 700 MHz
+     *   "B3" → 1800 MHz (LTE Band 3)
+     *
+     * @param band - Band identifier
+     * @returns Frequency in MHz
+     */
+    parseFrequency(band) {
+        if (!band)
+            return 1800; // Default to 1800 MHz
+        // Remove non-numeric characters
+        const numericBand = band.replace(/[^0-9]/g, '');
+        if (numericBand) {
+            const freq = parseInt(numericBand, 10);
+            // Handle LTE band numbers (need conversion)
+            if (freq < 100) {
+                // Assume it's a band number, not frequency
+                return this.bandNumberToFrequency(freq);
+            }
+            return freq;
+        }
+        return 1800; // Default
+    }
+    /**
+     * Convert LTE band number to center frequency
+     *
+     * @param bandNumber - LTE band number
+     * @returns Center frequency in MHz
+     */
+    bandNumberToFrequency(bandNumber) {
+        const bandMap = {
+            1: 2100, // Band 1 (2100 MHz)
+            2: 1900, // Band 2 (PCS 1900)
+            3: 1800, // Band 3 (DCS 1800)
+            4: 1700, // Band 4 (AWS)
+            5: 850, // Band 5 (850 MHz)
+            7: 2600, // Band 7 (2600 MHz)
+            8: 900, // Band 8 (900 MHz)
+            12: 700, // Band 12 (700 MHz)
+            13: 700, // Band 13 (700 MHz)
+            20: 800, // Band 20 (800 MHz DD)
+            28: 700, // Band 28 (APT 700)
+            66: 1700 // Band 66 (AWS extension)
+        };
+        return bandMap[bandNumber] || 1800;
+    }
+    /**
+     * Parse mechanical tilt value
+     *
+     * Handles various formats:
+     *   - Number: 3 → 3
+     *   - String: "3" → 3
+     *   - String with units: "3°" → 3
+     *
+     * @param tilt - Tilt value (various formats)
+     * @returns Tilt as number
+     */
+    parseTilt(tilt) {
+        if (typeof tilt === 'number') {
+            return tilt;
+        }
+        if (typeof tilt === 'string') {
+            const numeric = parseFloat(tilt.replace(/[^0-9.-]/g, ''));
+            return isNaN(numeric) ? 0 : numeric;
+        }
+        return 0;
+    }
+    /**
+     * Get color for sector visualization
+     *
+     * Standard sector colors (3-sector site):
+     *   - Sector 0 (Alpha): Blue
+     *   - Sector 1 (Beta): Green
+     *   - Sector 2 (Gamma): Red
+     *
+     * @param index - Sector index
+     * @returns Hex color
+     */
+    getSectorColor(index) {
+        const colors = [
+            '#0066CC', // Blue
+            '#00CC66', // Green
+            '#CC0066', // Red/Magenta
+            '#CC6600', // Orange
+            '#6600CC', // Purple
+            '#CCCC00' // Yellow
+        ];
+        return colors[index % colors.length];
+    }
+    /**
+     * Extract sector name from cell name
+     *
+     * Examples:
+     *   "SITE001_Alpha" → "Alpha"
+     *   "SITE001_A" → "A"
+     *   "SITE001_1" → "Sector 1"
+     *
+     * @param cellName - Full cell name
+     * @param index - Fallback index
+     * @returns Sector name
+     */
+    extractSectorName(cellName, index) {
+        // Try to extract sector name after underscore
+        const parts = cellName.split('_');
+        if (parts.length > 1) {
+            const lastPart = parts[parts.length - 1];
+            // Check if it's a common sector name
+            if (/^(Alpha|Beta|Gamma|A|B|C|[123])$/i.test(lastPart)) {
+                return lastPart;
+            }
+        }
+        // Fallback to index-based naming
+        const sectorNames = ['Alpha', 'Beta', 'Gamma', 'Delta', 'Epsilon', 'Zeta'];
+        return sectorNames[index] || `Sector ${index + 1}`;
+    }
+}
+// ============================================================================
+// SINGLETON INSTANCE
+// ============================================================================
+/**
+ * Global site store instance
+ *
+ * @example
+ * import { siteStore } from './SiteStore';
+ *
+ * const siteConfig = await siteStore.createSiteConfiguration(cells);
+ */
+export const siteStore = new SiteStore();
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Quick site configuration creation
+ *
+ * Convenience function for creating a single site configuration.
+ *
+ * @param cells - Cells for the site
+ * @returns Site configuration or null
+ */
+export async function createQuickSiteConfig(cells) {
+    return siteStore.createSiteConfiguration(cells);
+}
+/**
+ * Get sites from cell array
+ *
+ * Returns unique site identifiers from an array of cells.
+ *
+ * @param cells - Array of cells
+ * @returns Array of site IDs
+ */
+export function getSiteIds(cells) {
+    const siteIds = new Set();
+    for (const cell of cells) {
+        const siteId = cell.siteId || cell.cellName.split('_')[0] || 'Unknown';
+        siteIds.add(siteId);
+    }
+    return Array.from(siteIds).sort();
+}

package/dist/core/CoverageMap/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Coverage Map System - Main Export
+ *
+ * This is the main entry point for the coverage map system.
+ * Import from here to access all functionality.
+ *
+ * @example
+ * import {
+ *   CoverageCalculator,
+ *   antennaStore,
+ *   siteStore,
+ *   COLOR_SCHEMES
+ * } from './';
+ */
+export type { Position2D, Position3D, GeoBounds, AntennaPattern, RFParameters, SectorConfig, SiteConfiguration, PathLossModel, GridSettings, SignalThresholds, CoverageConfig, GridCell, CoverageGrid, CoverageStats, CoverageResult, SignalQuality, CalculationProgress, ProgressCallback, AIAnalysisRequest, AIAnalysisResponse, AIRecommendation, AIToolFunction, VisualizationOptions, MapIntegration } from './types';
+export { CoverageCalculator, quickCalculate, calculateForAI } from './core/CoverageCalculator';
+export { calculateSingleSectorCoverage, calculateMultiSectorCoverage, extractMetrics } from './core/GridCalculator';
+export { calculatePathLoss, calculateFSPL, calculateHata, calculateCOST231, getRecommendedModel } from './core/PathLossModels';
+export { calculateSignalStrength, calculateMultiSectorSignal, calculateCombinedGain } from './core/SignalProcessor';
+export { AntennaStore, antennaStore, loadAntennaForSector } from './data/AntennaStore';
+export { SiteStore, siteStore, createQuickSiteConfig, getSiteIds } from './data/SiteStore';
+export { calculateDistance, calculate3DDistance, calculateBearing, calculateDestinationPoint, calculateElevationAngle, calculateBounds, calculateBoundsArea, normalizeAngle, angleDifference, isPointInBounds } from './utils/geoUtils';
+export { dBmToWatts, wattsTodBm, dBdTodBi, dBiTodBd, addPowersdB, subtractPowersdB, calculateEIRP, calculateEffectiveEIRP, calculateReceivedPower, calculateMaxRange, attenuationToGain, interpolatePattern, classifySignalQuality, calculateSNR, calculateNoiseFloor } from './utils/rfUtils';
+export { HEATMAP_RED_BLUE, HEATMAP_GREEN_RED, VIRIDIS, PLASMA, CATEGORICAL, interpolateColor, getCategoricalColor, getColorForSignal, addOpacity, createLegend, type ColorStop, type ColorScheme } from './visualization/ColorSchemes';
+export { analyzeCoverageQuality, generateOptimizationSuggestions, compareCoverageScenarios, extractAIMetrics, AI_TOOLS, getAITool, executeAITool } from './ai/AITools';
+/**
+ * Default grid settings for quick calculations
+ */
+export declare const DEFAULT_GRID_SETTINGS: {
+    cellSizeMeters: number;
+    maxRadiusKm: number;
+    pathLossModel: "free-space";
+};
+/**
+ * Default signal thresholds (dBm)
+ */
+export declare const DEFAULT_SIGNAL_THRESHOLDS: {
+    excellent: number;
+    good: number;
+    fair: number;
+    edge: number;
+};
+/**
+ * Typical antenna heights by site type (meters)
+ */
+export declare const TYPICAL_ANTENNA_HEIGHTS: {
+    macroCell: number;
+    microCell: number;
+    picoCell: number;
+    femtoCell: number;
+};
+/**
+ * Typical TX power by technology (dBm)
+ */
+export declare const TYPICAL_TX_POWERS: {
+    lte: number;
+    umts: number;
+    gsm: number;
+    fiveG: number;
+    wifi: number;
+};
+/**
+ * Common frequency bands (MHz)
+ */
+export declare const COMMON_FREQUENCIES: {
+    band_700: number;
+    band_850: number;
+    band_900: number;
+    band_1800: number;
+    band_1900: number;
+    band_2100: number;
+    band_2600: number;
+    band_3500: number;
+};

package/dist/core/CoverageMap/index.js

@@ -0,0 +1,103 @@
+/**
+ * Coverage Map System - Main Export
+ *
+ * This is the main entry point for the coverage map system.
+ * Import from here to access all functionality.
+ *
+ * @example
+ * import {
+ *   CoverageCalculator,
+ *   antennaStore,
+ *   siteStore,
+ *   COLOR_SCHEMES
+ * } from './';
+ */
+// ============================================================================
+// CORE CALCULATION
+// ============================================================================
+export { CoverageCalculator, quickCalculate, calculateForAI } from './core/CoverageCalculator';
+export { calculateSingleSectorCoverage, calculateMultiSectorCoverage, extractMetrics } from './core/GridCalculator';
+export { calculatePathLoss, calculateFSPL, calculateHata, calculateCOST231, getRecommendedModel } from './core/PathLossModels';
+export { calculateSignalStrength, calculateMultiSectorSignal, calculateCombinedGain } from './core/SignalProcessor';
+// ============================================================================
+// DATA STORES
+// ============================================================================
+export { AntennaStore, antennaStore, loadAntennaForSector } from './data/AntennaStore';
+export { SiteStore, siteStore, createQuickSiteConfig, getSiteIds } from './data/SiteStore';
+// ============================================================================
+// UTILITIES
+// ============================================================================
+export { 
+// Geographic
+calculateDistance, calculate3DDistance, calculateBearing, calculateDestinationPoint, calculateElevationAngle, calculateBounds, calculateBoundsArea, normalizeAngle, angleDifference, isPointInBounds } from './utils/geoUtils';
+export { 
+// RF calculations
+dBmToWatts, wattsTodBm, dBdTodBi, dBiTodBd, addPowersdB, subtractPowersdB, calculateEIRP, calculateEffectiveEIRP, calculateReceivedPower, calculateMaxRange, attenuationToGain, interpolatePattern, classifySignalQuality, calculateSNR, calculateNoiseFloor } from './utils/rfUtils';
+// ============================================================================
+// VISUALIZATION
+// ============================================================================
+export { 
+// Color schemes
+HEATMAP_RED_BLUE, HEATMAP_GREEN_RED, VIRIDIS, PLASMA, CATEGORICAL, 
+// Functions
+interpolateColor, getCategoricalColor, getColorForSignal, addOpacity, createLegend } from './visualization/ColorSchemes';
+// ============================================================================
+// AI INTEGRATION
+// ============================================================================
+export { 
+// Tool functions
+analyzeCoverageQuality, generateOptimizationSuggestions, compareCoverageScenarios, extractAIMetrics, 
+// Tool registry
+AI_TOOLS, getAITool, executeAITool } from './ai/AITools';
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/**
+ * Default grid settings for quick calculations
+ */
+export const DEFAULT_GRID_SETTINGS = {
+    cellSizeMeters: 50,
+    maxRadiusKm: 10,
+    pathLossModel: 'free-space'
+};
+/**
+ * Default signal thresholds (dBm)
+ */
+export const DEFAULT_SIGNAL_THRESHOLDS = {
+    excellent: -70,
+    good: -85,
+    fair: -95,
+    edge: -105
+};
+/**
+ * Typical antenna heights by site type (meters)
+ */
+export const TYPICAL_ANTENNA_HEIGHTS = {
+    macroCell: 30, // Typical rooftop/tower
+    microCell: 10, // Street lamp/small pole
+    picoCell: 3, // Indoor/wall-mount
+    femtoCell: 2 // Desktop/home
+};
+/**
+ * Typical TX power by technology (dBm)
+ */
+export const TYPICAL_TX_POWERS = {
+    lte: 43, // 20W
+    umts: 43, // 20W
+    gsm: 43, // 20W
+    fiveG: 46, // 40W (higher for mmWave)
+    wifi: 20 // 100mW
+};
+/**
+ * Common frequency bands (MHz)
+ */
+export const COMMON_FREQUENCIES = {
+    band_700: 700,
+    band_850: 850,
+    band_900: 900,
+    band_1800: 1800,
+    band_1900: 1900,
+    band_2100: 2100,
+    band_2600: 2600,
+    band_3500: 3500 // 5G
+};