LLSDA - 闪电定位系统数据分析器文档

概述

LLSDA（闪电定位系统数据分析器）是一个开源、跨平台的 .NET 类库，用于分析闪电定位系统数据。它提供了闪电时空分布统计分析和可视化的核心功能。

主要特性

跨平台

.NET Framework 4.8 + .NET Standard 2.0 — Windows/Linux/macOS。

多格式解析

支持 ADTD（中国 LLS）、GLD360、WWLLN 等多种闪电数据格式。

时间分布分析

年/月/小时时间分布分析与图表生成。

空间统计分析

基于方格网/同心圆的雷击密度计算。

点分析

基于经纬度的点查询分析和自定义区域分析。

玫瑰图与概率图

雷电玫瑰图和雷电流强度概率分布图。

GIS 支持

Shapefile 叠加与 MeteoInfo GIS 集成。

程序截图

主程序窗口

安装方法

NuGet 包管理器：

Install-Package LightningLocationSystemDataAnalyzer-LLDSA

.NET CLI：

dotnet add package LightningLocationSystemDataAnalyzer-LLDSA

PackageReference（添加到 .csproj）：

<PackageReference Include="LightningLocationSystemDataAnalyzer-LLDSA" Version="1.4.1" />

NuGet Gallery GitHub 仓库

快速开始

读取中国 LLS 数据文件的核心类是 ADTDFileProcessor，它将文本格式的雷电记录转换为强类型对象。

using LLDSA;
using LLDSA.Entities.FileOperator.LLSFileProcessor.ADTD;
using System.Collections.Generic;
using System.IO;
using System.Text;

// 1. 创建文件处理器并指向数据文件
string dataFilePath = @"data\2008_07_09.txt";

var processor = new ADTDFileProcessor();
processor.SourceLlsFilePathName = dataFilePath;
processor.Province = "";
processor.Encode = Encoding.UTF8;

// 2. 解析所有记录并返回强类型对象列表
List<BaseStrikeChina> strikes = processor.ReturnStrikesChinaByProcess().ToList();
Console.WriteLine($"成功解析 {strikes.Count} 条雷击记录。");

// 3. 每条记录包含以下信息：
foreach (var strike in strikes.Take(3))
{{
    Console.WriteLine($"时间: {{strike.DateAndTime}}, " +
        $"纬度: {{strike.Latitude}}, 经度: {{strike.Longitude}}, " +
        $"电流强度: {{strike.Intensity}} A");
}}

支持的文件格式

格式	处理类	命名空间
ADTD (中国 LLS)	`ADTDFileProcessor`	`LLDSA.Entities.FileOperator.LLSFileProcessor.ADTD`
GLD360 (全球)	`GLD360FileProcessor`	`LLDSA.Entities.FileOperator.LLSFileProcessor.GLD360`
WWLLN (全球)	`WWLLNFileProcessor`	`LLDSA.Entities.FileOperator.LLSFileProcessor.WWLLN`

架构与设计

面向对象设计图

OOP 设计

架构设计图

架构图

源代码结构

学术论文

本项目有多篇学术论文作为支撑，以下为论文摘要：

引用格式 (BibTeX)

在您的出版物中引用本项目，请使用以下 BibTeX 条目：

@misc{fan2023llsda,
  author = {Rong Fan and JingXiao Li and MingYuan Liu},
  title = {{LLSDA}: Design and Implementation of Lightning Location Data Analysis and Visualization},
  year = {2023},
  doi = {10.36227/techrxiv.23615019.v1},
  publisher = {TechRxiv}
}

LLSDA 文档

概述