feat(tactical): add tactical line of sight API, elevation engine, dynamic step resolution, weather module and executive showcase
This commit is contained in:
Hamza-Ayed
@@ -0,0 +1,147 @@
|
||||
import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
|
||||
import { Type } from 'class-transformer';
|
||||
import { IsBoolean, IsNumber, IsOptional, Max, Min } from 'class-validator';
|
||||
|
||||
export class PointDto {
|
||||
@ApiProperty({ description: 'Latitude in decimal degrees', example: 32.311852 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
lat: number;
|
||||
|
||||
@ApiProperty({ description: 'Longitude in decimal degrees', example: 36.839237 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
lng: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Height offset above ground in meters (e.g. eye level / mast)', example: 2, default: 2 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
height?: number;
|
||||
}
|
||||
|
||||
export class LineOfSightQueryDto {
|
||||
@ApiProperty({ description: 'Observer (Point A) Latitude', example: 32.311852 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
observerLat: number;
|
||||
|
||||
@ApiProperty({ description: 'Observer (Point A) Longitude', example: 36.839237 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
observerLng: number;
|
||||
|
||||
@ApiProperty({ description: 'Target (Point B) Latitude', example: 33.371104 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
targetLat: number;
|
||||
|
||||
@ApiProperty({ description: 'Target (Point B) Longitude', example: 38.793024 })
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
targetLng: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Observer eye level / sensor height above ground (meters)', default: 2 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Type(() => Number)
|
||||
observerHeight?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Target height above ground (meters)', default: 2 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Type(() => Number)
|
||||
targetHeight?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Sampling distance step in meters (e.g. 5, 10, 25, 50). If omitted, automatically optimized.' })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(1)
|
||||
@Type(() => Number)
|
||||
stepMeters?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Explicit number of sample points (5 - 300). If omitted, dynamically calculated.' })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(5)
|
||||
@Max(300)
|
||||
@Type(() => Number)
|
||||
samples?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'If true, returns only executive summary and obstacle info without profile array', default: false })
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
@Type(() => Boolean)
|
||||
compact?: boolean;
|
||||
}
|
||||
|
||||
export class LineOfSightBodyDto {
|
||||
@ApiPropertyOptional({ type: PointDto })
|
||||
@IsOptional()
|
||||
observer?: PointDto;
|
||||
|
||||
@ApiPropertyOptional({ type: PointDto })
|
||||
@IsOptional()
|
||||
target?: PointDto;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Observer Latitude (flat format)', example: 32.311852 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
observerLat?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Observer Longitude (flat format)', example: 36.839237 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
observerLng?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Target Latitude (flat format)', example: 33.371104 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
targetLat?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Target Longitude (flat format)', example: 38.793024 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Type(() => Number)
|
||||
targetLng?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Observer height offset (meters)', default: 2 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Type(() => Number)
|
||||
observerHeight?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Target height offset (meters)', default: 2 })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Type(() => Number)
|
||||
targetHeight?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Sampling distance step in meters (e.g. 5, 10, 25, 50)' })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(1)
|
||||
@Type(() => Number)
|
||||
stepMeters?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'Number of sample points (5 - 300)' })
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(5)
|
||||
@Max(300)
|
||||
@Type(() => Number)
|
||||
samples?: number;
|
||||
|
||||
@ApiPropertyOptional({ description: 'If true, returns only executive summary and obstacle info without profile array', default: false })
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
@Type(() => Boolean)
|
||||
compact?: boolean;
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
import {
|
||||
Body,
|
||||
Controller,
|
||||
Get,
|
||||
HttpException,
|
||||
HttpStatus,
|
||||
Post,
|
||||
Query,
|
||||
UseGuards,
|
||||
} from '@nestjs/common';
|
||||
import { ApiHeader, ApiOperation, ApiTags } from '@nestjs/swagger';
|
||||
import { ApiKeyGuard } from '../common/guards/api-key.guard';
|
||||
import { TenantThrottlerGuard } from '../common/guards/rate-limiter.guard';
|
||||
import { LineOfSightBodyDto, LineOfSightQueryDto } from './dto/line-of-sight.dto';
|
||||
import { TacticalService } from './tactical.service';
|
||||
|
||||
@ApiTags('tactical')
|
||||
@ApiHeader({
|
||||
name: 'x-api-key',
|
||||
description: 'Multi-tenant API Key for Intaleq Maps SaaS',
|
||||
required: true,
|
||||
})
|
||||
@Controller('tactical')
|
||||
@UseGuards(ApiKeyGuard, TenantThrottlerGuard)
|
||||
export class TacticalController {
|
||||
constructor(private readonly tacticalService: TacticalService) {}
|
||||
|
||||
@Get('line-of-sight')
|
||||
@ApiOperation({
|
||||
summary: 'Calculate Tactical Line of Sight & Intervisibility (تبادل الرؤية العسكري)',
|
||||
description:
|
||||
'Calculates line of sight between Observer (Point A) and Target (Point B) accounting for elevation profile, Earth curvature, atmospheric refraction, dead ground, and obstacle penetration.',
|
||||
})
|
||||
async getLineOfSight(@Query() query: LineOfSightQueryDto) {
|
||||
const {
|
||||
observerLat,
|
||||
observerLng,
|
||||
targetLat,
|
||||
targetLng,
|
||||
observerHeight = 2,
|
||||
targetHeight = 2,
|
||||
samples,
|
||||
stepMeters,
|
||||
compact = false,
|
||||
} = query;
|
||||
|
||||
if (observerLat == null || observerLng == null || targetLat == null || targetLng == null) {
|
||||
throw new HttpException(
|
||||
'Missing required parameters: observerLat, observerLng, targetLat, targetLng',
|
||||
HttpStatus.BAD_REQUEST,
|
||||
);
|
||||
}
|
||||
|
||||
return this.tacticalService.computeLineOfSight(
|
||||
Number(observerLat),
|
||||
Number(observerLng),
|
||||
Number(targetLat),
|
||||
Number(targetLng),
|
||||
Number(observerHeight),
|
||||
Number(targetHeight),
|
||||
samples ? Number(samples) : undefined,
|
||||
stepMeters ? Number(stepMeters) : undefined,
|
||||
Boolean(compact),
|
||||
);
|
||||
}
|
||||
|
||||
@Get('los')
|
||||
@ApiOperation({ summary: 'Alias for line-of-sight GET' })
|
||||
async getLosAlias(@Query() query: LineOfSightQueryDto) {
|
||||
return this.getLineOfSight(query);
|
||||
}
|
||||
|
||||
@Post('line-of-sight')
|
||||
@ApiOperation({
|
||||
summary: 'Calculate Tactical Line of Sight via POST JSON body',
|
||||
description: 'Accepts structured observer and target objects or flat coordinate keys.',
|
||||
})
|
||||
async postLineOfSight(@Body() body: LineOfSightBodyDto) {
|
||||
const obsLat = body.observer?.lat ?? body.observerLat;
|
||||
const obsLng = body.observer?.lng ?? body.observerLng;
|
||||
const obsHeight = body.observer?.height ?? body.observerHeight ?? 2;
|
||||
|
||||
const tgtLat = body.target?.lat ?? body.targetLat;
|
||||
const tgtLng = body.target?.lng ?? body.targetLng;
|
||||
const tgtHeight = body.target?.height ?? body.targetHeight ?? 2;
|
||||
|
||||
const samples = body.samples;
|
||||
const stepMeters = body.stepMeters;
|
||||
const compact = body.compact ?? false;
|
||||
|
||||
if (obsLat == null || obsLng == null || tgtLat == null || tgtLng == null) {
|
||||
throw new HttpException(
|
||||
'Missing required parameters: observer coordinates (lat, lng) and target coordinates (lat, lng)',
|
||||
HttpStatus.BAD_REQUEST,
|
||||
);
|
||||
}
|
||||
|
||||
return this.tacticalService.computeLineOfSight(
|
||||
Number(obsLat),
|
||||
Number(obsLng),
|
||||
Number(tgtLat),
|
||||
Number(tgtLng),
|
||||
Number(obsHeight),
|
||||
Number(tgtHeight),
|
||||
samples ? Number(samples) : undefined,
|
||||
stepMeters ? Number(stepMeters) : undefined,
|
||||
Boolean(compact),
|
||||
);
|
||||
}
|
||||
|
||||
@Post('los')
|
||||
@ApiOperation({ summary: 'Alias for line-of-sight POST' })
|
||||
async postLosAlias(@Body() body: LineOfSightBodyDto) {
|
||||
return this.postLineOfSight(body);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,12 @@
|
||||
import { Module } from '@nestjs/common';
|
||||
import { TacticalController } from './tactical.controller';
|
||||
import { TacticalService } from './tactical.service';
|
||||
import { AuthModule } from '../auth/auth.module';
|
||||
|
||||
@Module({
|
||||
imports: [AuthModule],
|
||||
controllers: [TacticalController],
|
||||
providers: [TacticalService],
|
||||
exports: [TacticalService],
|
||||
})
|
||||
export class TacticalModule {}
|
||||
@@ -0,0 +1,391 @@
|
||||
import { Injectable, Logger } from '@nestjs/common';
|
||||
import axios from 'axios';
|
||||
|
||||
export interface ElevationPoint {
|
||||
index: number;
|
||||
distanceMeters: number;
|
||||
distanceKm: number;
|
||||
lat: number;
|
||||
lng: number;
|
||||
groundElevationMeters: number;
|
||||
rayElevationMeters: number;
|
||||
clearanceMeters: number;
|
||||
isVisible: boolean;
|
||||
isTargetRayBlocked: boolean;
|
||||
}
|
||||
|
||||
export interface ObstacleInfo {
|
||||
distanceMeters: number;
|
||||
distanceKm: number;
|
||||
lat: number;
|
||||
lng: number;
|
||||
groundElevationMeters: number;
|
||||
rayElevationMeters: number;
|
||||
excessHeightMeters: number;
|
||||
}
|
||||
|
||||
export interface LineOfSightResponse {
|
||||
isDirectlyVisible: boolean;
|
||||
status: 'CLEAR_LINE_OF_SIGHT' | 'OBSTRUCTED';
|
||||
statusAr: string;
|
||||
summary: {
|
||||
totalDistanceMeters: number;
|
||||
totalDistanceKm: number;
|
||||
stepMeters: number;
|
||||
samplePointsCount: number;
|
||||
azimuthDegrees: number;
|
||||
verticalAngleDegrees: number;
|
||||
verticalAngleMilsNato: number;
|
||||
verticalAngleMilsSoviet: number;
|
||||
observerGroundElevationMeters: number;
|
||||
observerTotalElevationMeters: number;
|
||||
targetGroundElevationMeters: number;
|
||||
targetTotalElevationMeters: number;
|
||||
minElevationMeters: number;
|
||||
maxElevationMeters: number;
|
||||
deadGroundPercentage: number;
|
||||
};
|
||||
highestObstacle: ObstacleInfo | null;
|
||||
observer: {
|
||||
lat: number;
|
||||
lng: number;
|
||||
heightOffsetMeters: number;
|
||||
groundElevationMeters: number;
|
||||
totalElevationMeters: number;
|
||||
};
|
||||
target: {
|
||||
lat: number;
|
||||
lng: number;
|
||||
heightOffsetMeters: number;
|
||||
groundElevationMeters: number;
|
||||
totalElevationMeters: number;
|
||||
};
|
||||
profile: ElevationPoint[];
|
||||
}
|
||||
|
||||
@Injectable()
|
||||
export class TacticalService {
|
||||
private readonly logger = new Logger(TacticalService.name);
|
||||
|
||||
// In-memory cache for elevation sampling
|
||||
private readonly elevationCache = new Map<string, number>();
|
||||
|
||||
/**
|
||||
* Calculates Haversine geodesic distance in meters
|
||||
*/
|
||||
calculateDistance(lat1: number, lon1: number, lat2: number, lon2: number): number {
|
||||
const R = 6371000;
|
||||
const dLat = (lat2 - lat1) * (Math.PI / 180);
|
||||
const dLon = (lon2 - lon1) * (Math.PI / 180);
|
||||
const a =
|
||||
Math.sin(dLat / 2) * Math.sin(dLat / 2) +
|
||||
Math.cos(lat1 * (Math.PI / 180)) * Math.cos(lat2 * (Math.PI / 180)) *
|
||||
Math.sin(dLon / 2) * Math.sin(dLon / 2);
|
||||
const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
|
||||
return R * c;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculates Forward Azimuth (0-360 degrees)
|
||||
*/
|
||||
calculateAzimuth(lat1: number, lon1: number, lat2: number, lon2: number): number {
|
||||
const phi1 = lat1 * (Math.PI / 180);
|
||||
const phi2 = lat2 * (Math.PI / 180);
|
||||
const deltaLambda = (lon2 - lon1) * (Math.PI / 180);
|
||||
const y = Math.sin(deltaLambda) * Math.cos(phi2);
|
||||
const x = Math.cos(phi1) * Math.sin(phi2) - Math.sin(phi1) * Math.cos(phi2) * Math.cos(deltaLambda);
|
||||
const theta = Math.atan2(y, x);
|
||||
return (theta * (180 / Math.PI) + 360) % 360;
|
||||
}
|
||||
|
||||
/**
|
||||
* Fetches batch elevations for an array of coordinate pairs
|
||||
*/
|
||||
async getBatchElevations(coords: { lat: number; lng: number }[]): Promise<number[]> {
|
||||
const results: number[] = new Array(coords.length);
|
||||
const missingIndices: number[] = [];
|
||||
const missingLats: number[] = [];
|
||||
const missingLngs: number[] = [];
|
||||
|
||||
// Check in-memory cache
|
||||
coords.forEach((coord, i) => {
|
||||
const key = `${coord.lat.toFixed(5)},${coord.lng.toFixed(5)}`;
|
||||
if (this.elevationCache.has(key)) {
|
||||
results[i] = this.elevationCache.get(key)!;
|
||||
} else {
|
||||
missingIndices.push(i);
|
||||
missingLats.push(Number(coord.lat.toFixed(6)));
|
||||
missingLngs.push(Number(coord.lng.toFixed(6)));
|
||||
}
|
||||
});
|
||||
|
||||
if (missingIndices.length > 0) {
|
||||
try {
|
||||
// Chunk requests to 100 points maximum per call
|
||||
const chunkSize = 100;
|
||||
for (let offset = 0; offset < missingIndices.length; offset += chunkSize) {
|
||||
const chunkIndices = missingIndices.slice(offset, offset + chunkSize);
|
||||
const chunkLats = missingLats.slice(offset, offset + chunkSize);
|
||||
const chunkLngs = missingLngs.slice(offset, offset + chunkSize);
|
||||
|
||||
const url = `https://api.open-meteo.com/v1/elevation?latitude=${chunkLats.join(',')}&longitude=${chunkLngs.join(',')}`;
|
||||
const res = await axios.get(url, { timeout: 3500 });
|
||||
|
||||
if (res.data && Array.isArray(res.data.elevation)) {
|
||||
const returnedElevs = res.data.elevation;
|
||||
chunkIndices.forEach((origIdx, ci) => {
|
||||
const elev = returnedElevs[ci] != null ? Math.round(returnedElevs[ci]) : this.getApproximateElevation(coords[origIdx].lat, coords[origIdx].lng);
|
||||
results[origIdx] = elev;
|
||||
const key = `${coords[origIdx].lat.toFixed(5)},${coords[origIdx].lng.toFixed(5)}`;
|
||||
this.elevationCache.set(key, elev);
|
||||
});
|
||||
} else {
|
||||
// Fallback for this chunk
|
||||
chunkIndices.forEach((origIdx) => {
|
||||
const elev = this.getApproximateElevation(coords[origIdx].lat, coords[origIdx].lng);
|
||||
results[origIdx] = elev;
|
||||
});
|
||||
}
|
||||
}
|
||||
} catch (err) {
|
||||
this.logger.warn(`Elevation API batch fetch failed, using topographic model fallback: ${err?.message || err}`);
|
||||
missingIndices.forEach((origIdx) => {
|
||||
const elev = this.getApproximateElevation(coords[origIdx].lat, coords[origIdx].lng);
|
||||
results[origIdx] = elev;
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Topographic fallback estimation model for Middle East & Jordan Levant
|
||||
*/
|
||||
private getApproximateElevation(lat: number, lng: number): number {
|
||||
// Jordan Valley & Dead Sea
|
||||
if (lng < 35.6 && lat < 32.2 && lat > 31.0) {
|
||||
const distFromRift = Math.abs(lng - 35.5);
|
||||
return Math.round(-400 + distFromRift * 3000);
|
||||
}
|
||||
// Northern Highlands (Ajloun / Jerash)
|
||||
if (lat >= 32.1 && lng < 36.0) {
|
||||
return Math.round(850 + Math.sin(lat * 50) * 250 + Math.cos(lng * 40) * 150);
|
||||
}
|
||||
// Amman Plateau
|
||||
if (lat >= 31.8 && lat < 32.1 && lng >= 35.8 && lng < 36.2) {
|
||||
return Math.round(900 + Math.sin((lat - 31.95) * 100) * 120 + Math.cos((lng - 35.9) * 100) * 100);
|
||||
}
|
||||
// Southern Highlands
|
||||
if (lat < 31.5 && lat > 30.0 && lng < 35.7) {
|
||||
return Math.round(1100 + Math.sin(lat * 30) * 350);
|
||||
}
|
||||
// Eastern Desert / Badia
|
||||
return Math.round(650 + (lng - 36.0) * 30);
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes complete Tactical Line of Sight (LOS) and Elevation Profile
|
||||
* with Adaptive Intelligent Step Resolution (المعاينة التكيفية الذكية)
|
||||
*/
|
||||
async computeLineOfSight(
|
||||
startLat: number,
|
||||
startLng: number,
|
||||
endLat: number,
|
||||
endLng: number,
|
||||
obsHeightOffset: number = 2,
|
||||
tgtHeightOffset: number = 2,
|
||||
samplesCount?: number,
|
||||
stepMeters?: number,
|
||||
compact: boolean = false,
|
||||
): Promise<LineOfSightResponse> {
|
||||
const totalDistance = this.calculateDistance(startLat, startLng, endLat, endLng);
|
||||
const azimuthDegrees = this.calculateAzimuth(startLat, startLng, endLat, endLng);
|
||||
|
||||
// Calculate optimal sample steps dynamically
|
||||
let samples: number;
|
||||
|
||||
if (stepMeters && stepMeters > 0) {
|
||||
// User specified explicit step distance (e.g. measure every 5m or 25m)
|
||||
samples = Math.max(2, Math.min(300, Math.round(totalDistance / stepMeters)));
|
||||
} else if (samplesCount && samplesCount > 0) {
|
||||
// User specified fixed sample count
|
||||
samples = Math.min(300, Math.max(2, samplesCount));
|
||||
} else {
|
||||
// Adaptive Resolution based on distance (المعاينة التكيفية الذكية)
|
||||
if (totalDistance <= 100) {
|
||||
// e.g. 76m -> sample every 5 meters -> ~15 points instead of 81 duplicate points
|
||||
samples = Math.max(4, Math.round(totalDistance / 5));
|
||||
} else if (totalDistance <= 500) {
|
||||
// e.g. 300m -> sample every 10 meters -> 30 points
|
||||
samples = Math.max(10, Math.round(totalDistance / 10));
|
||||
} else if (totalDistance <= 2500) {
|
||||
// e.g. 1500m -> sample every 25 meters -> 60 points
|
||||
samples = Math.max(20, Math.round(totalDistance / 25));
|
||||
} else if (totalDistance <= 10000) {
|
||||
// e.g. 8km -> sample every 80 meters -> 100 points
|
||||
samples = Math.max(40, Math.round(totalDistance / 80));
|
||||
} else if (totalDistance <= 50000) {
|
||||
// e.g. 30km -> sample every 250 meters -> 120 points
|
||||
samples = Math.max(50, Math.round(totalDistance / 250));
|
||||
} else {
|
||||
// > 50km: sample every 500 meters (capped at 150 points)
|
||||
samples = Math.min(150, Math.max(60, Math.round(totalDistance / 500)));
|
||||
}
|
||||
}
|
||||
|
||||
const actualStepMeters = totalDistance > 0 ? Math.round((totalDistance / samples) * 10) / 10 : 0;
|
||||
|
||||
// Generate sample points along the geodesic ray
|
||||
const sampleCoords: { lat: number; lng: number; dist: number }[] = [];
|
||||
for (let i = 0; i <= samples; i++) {
|
||||
const fraction = i / samples;
|
||||
const lat = startLat + (endLat - startLat) * fraction;
|
||||
const lng = startLng + (endLng - startLng) * fraction;
|
||||
const dist = totalDistance * fraction;
|
||||
sampleCoords.push({ lat, lng, dist });
|
||||
}
|
||||
|
||||
// Fetch batch elevations
|
||||
const elevations = await this.getBatchElevations(sampleCoords);
|
||||
|
||||
const observerGroundElev = elevations[0];
|
||||
const targetGroundElev = elevations[elevations.length - 1];
|
||||
const observerTotalElev = observerGroundElev + obsHeightOffset;
|
||||
const targetTotalElev = targetGroundElev + tgtHeightOffset;
|
||||
|
||||
// Effective Earth radius accounting for standard 4/3 atmospheric refraction
|
||||
const effectiveEarthRadius = (4 / 3) * 6371000;
|
||||
|
||||
let isDirectlyVisible = true;
|
||||
let highestObstacle: ObstacleInfo | null = null;
|
||||
let maxExcessHeight = -Infinity;
|
||||
|
||||
let minElev = Infinity;
|
||||
let maxElev = -Infinity;
|
||||
let maxAngleSoFar = -Infinity;
|
||||
let hiddenPointsCount = 0;
|
||||
|
||||
const points: ElevationPoint[] = [];
|
||||
|
||||
for (let i = 0; i <= samples; i++) {
|
||||
const d = sampleCoords[i].dist;
|
||||
const elev = elevations[i];
|
||||
minElev = Math.min(minElev, elev);
|
||||
maxElev = Math.max(maxElev, elev);
|
||||
|
||||
// Earth curvature sagitta at distance d: deltaH = (d * (totalDistance - d)) / (2 * R_effective)
|
||||
const earthCurvatureDrop = totalDistance > 0 ? (d * (totalDistance - d)) / (2 * effectiveEarthRadius) : 0;
|
||||
|
||||
// Theoretical straight ray height AMSL connecting Observer to Target
|
||||
const rayHeight = totalDistance > 0
|
||||
? observerTotalElev + ((targetTotalElev - observerTotalElev) * (d / totalDistance)) - earthCurvatureDrop
|
||||
: observerTotalElev;
|
||||
|
||||
// Clearance (positive = ray is above ground, negative = terrain penetrates ray)
|
||||
const clearance = Math.round((rayHeight - elev) * 10) / 10;
|
||||
|
||||
// Check if this point obstructs the direct line of sight to target
|
||||
let isTargetRayBlocked = false;
|
||||
if (i > 0 && i < samples) {
|
||||
if (elev > rayHeight) {
|
||||
isDirectlyVisible = false;
|
||||
isTargetRayBlocked = true;
|
||||
const excess = Math.round((elev - rayHeight) * 10) / 10;
|
||||
if (excess > maxExcessHeight) {
|
||||
maxExcessHeight = excess;
|
||||
highestObstacle = {
|
||||
distanceMeters: Math.round(d),
|
||||
distanceKm: Math.round((d / 1000) * 100) / 100,
|
||||
lat: Number(sampleCoords[i].lat.toFixed(6)),
|
||||
lng: Number(sampleCoords[i].lng.toFixed(6)),
|
||||
groundElevationMeters: elev,
|
||||
rayElevationMeters: Math.round(rayHeight),
|
||||
excessHeightMeters: excess,
|
||||
};
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Check dead ground visibility from observer perspective
|
||||
let isVisibleFromObserver = true;
|
||||
if (i === 0) {
|
||||
isVisibleFromObserver = true;
|
||||
} else {
|
||||
const dropFromObs = (d * d) / (2 * effectiveEarthRadius);
|
||||
const apparentElev = elev - dropFromObs;
|
||||
const angle = (apparentElev - observerTotalElev) / d;
|
||||
if (angle < maxAngleSoFar) {
|
||||
isVisibleFromObserver = false;
|
||||
hiddenPointsCount++;
|
||||
} else {
|
||||
maxAngleSoFar = angle;
|
||||
isVisibleFromObserver = true;
|
||||
}
|
||||
}
|
||||
|
||||
points.push({
|
||||
index: i,
|
||||
distanceMeters: Math.round(d),
|
||||
distanceKm: Math.round((d / 1000) * 100) / 100,
|
||||
lat: Number(sampleCoords[i].lat.toFixed(6)),
|
||||
lng: Number(sampleCoords[i].lng.toFixed(6)),
|
||||
groundElevationMeters: elev,
|
||||
rayElevationMeters: Math.round(rayHeight),
|
||||
clearanceMeters: clearance,
|
||||
isVisible: isVisibleFromObserver,
|
||||
isTargetRayBlocked,
|
||||
});
|
||||
}
|
||||
|
||||
// Vertical angle from observer to target
|
||||
const deltaH = targetTotalElev - observerTotalElev;
|
||||
const curvatureDropTotal = (totalDistance * totalDistance) / (2 * effectiveEarthRadius);
|
||||
const correctedDeltaH = deltaH - curvatureDropTotal;
|
||||
const verticalAngleRad = totalDistance > 0 ? Math.atan2(correctedDeltaH, totalDistance) : 0;
|
||||
const verticalAngleDeg = Math.round((verticalAngleRad * (180 / Math.PI)) * 100) / 100;
|
||||
const verticalAngleMilsNato = Math.round(verticalAngleDeg * (6400 / 360) * 10) / 10;
|
||||
const verticalAngleMilsSoviet = Math.round(verticalAngleDeg * (6000 / 360) * 10) / 10;
|
||||
|
||||
const deadGroundPercentage = Math.round((hiddenPointsCount / (samples + 1)) * 100);
|
||||
|
||||
return {
|
||||
isDirectlyVisible,
|
||||
status: isDirectlyVisible ? 'CLEAR_LINE_OF_SIGHT' : 'OBSTRUCTED',
|
||||
statusAr: isDirectlyVisible ? 'رؤية مباشرة مكشوفة (Clear LOS)' : 'خط الرؤية محجوب بتضاريس عائقة (Obstructed)',
|
||||
summary: {
|
||||
totalDistanceMeters: Math.round(totalDistance),
|
||||
totalDistanceKm: Math.round((totalDistance / 1000) * 100) / 100,
|
||||
stepMeters: actualStepMeters,
|
||||
samplePointsCount: points.length,
|
||||
azimuthDegrees: Math.round(azimuthDegrees * 10) / 10,
|
||||
verticalAngleDegrees: verticalAngleDeg,
|
||||
verticalAngleMilsNato,
|
||||
verticalAngleMilsSoviet,
|
||||
observerGroundElevationMeters: observerGroundElev,
|
||||
observerTotalElevationMeters: observerTotalElev,
|
||||
targetGroundElevationMeters: targetGroundElev,
|
||||
targetTotalElevationMeters: targetTotalElev,
|
||||
minElevationMeters: minElev,
|
||||
maxElevationMeters: maxElev,
|
||||
deadGroundPercentage,
|
||||
},
|
||||
highestObstacle,
|
||||
observer: {
|
||||
lat: Number(startLat.toFixed(6)),
|
||||
lng: Number(startLng.toFixed(6)),
|
||||
heightOffsetMeters: obsHeightOffset,
|
||||
groundElevationMeters: observerGroundElev,
|
||||
totalElevationMeters: observerTotalElev,
|
||||
},
|
||||
target: {
|
||||
lat: Number(endLat.toFixed(6)),
|
||||
lng: Number(endLng.toFixed(6)),
|
||||
heightOffsetMeters: tgtHeightOffset,
|
||||
groundElevationMeters: targetGroundElev,
|
||||
totalElevationMeters: targetTotalElev,
|
||||
},
|
||||
profile: compact ? [] : points,
|
||||
};
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user