LightningLocationSystemDataAnalyzer-LLDSA 1.4.1

dotnet add package LightningLocationSystemDataAnalyzer-LLDSA --version 1.4.1
                    
NuGet\Install-Package LightningLocationSystemDataAnalyzer-LLDSA -Version 1.4.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="LightningLocationSystemDataAnalyzer-LLDSA" Version="1.4.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="LightningLocationSystemDataAnalyzer-LLDSA" Version="1.4.1" />
                    
Directory.Packages.props
<PackageReference Include="LightningLocationSystemDataAnalyzer-LLDSA" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add LightningLocationSystemDataAnalyzer-LLDSA --version 1.4.1
                    
#r "nuget: LightningLocationSystemDataAnalyzer-LLDSA, 1.4.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package LightningLocationSystemDataAnalyzer-LLDSA@1.4.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=LightningLocationSystemDataAnalyzer-LLDSA&version=1.4.1
                    
Install as a Cake Addin
#tool nuget:?package=LightningLocationSystemDataAnalyzer-LLDSA&version=1.4.1
                    
Install as a Cake Tool

<a href="https://github.com/memoryfraction/LLSDA-Lightning-Location-System-Data-Analyzer"> <img src="https://github.com/memoryfraction/LLSDA-Lightning-Location-System-Data-Analyzer/raw/main/Images/LLSDA-Icon.png" align="right" width="96" height="96" alt="LLSDA Logo"> </a>

LLSDA - Lightning Location System Data Analyzer

License: GPL v3 NuGet .NET

An open-source, cross-platform class library for analyzing lightning location system data providing statistical analysis and visualization of lightning time/space distribution.

| English | 中文 |

Demo Screenshots

Lightning Distribution on Map

Brief Introduction

LLSDA (Lightning Location System Data Analyzer) is an open-source, cross-platform class library for analyzing lightning location system data. It provides essential statistical analysis and visualization capabilities for lightning time and spatial distribution studies.

  • Prevents duplication of effort across research groups
  • Improves development efficiency for lightning protection engineers and meteorologists
  • Contributes to the open-source community and the lightning protection industry

Table of Contents

Features

Feature Status
Cross-platform (.NET Framework 4.8 / .NET Standard 2.0)
Lightning file parsing (multiple formats)
Time distribution analysis (year/month/hour)
Spatial distribution statistics
Point analysis (lat/lng based queries)
User-defined analysis regions
Rose diagram chart
Intensity probability chart
GIS / Shapefile overlay support

Installation

Via NuGet Package Manager Console:

Install-Package LightningLocationSystemDataAnalyzer-LLDSA

Via .NET CLI:

dotnet add package LightningLocationSystemDataAnalyzer-LLDSA

Quick Start

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

var strikes = new List<BaseStrikeChina>();
var srcFile1 = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"data\2008_07_09.txt");

if (File.Exists(srcFile1))
{
    var fileProcessor = new LlsFileProcessor(srcFile1, Encoding.UTF8);
    strikes.AddRange(fileProcessor.ReturnStrikesChinaByProcess());
}

For more examples, refer to LLSDA.Client.

Design & Architecture

Object-Oriented Design

OOP Design

Software Architecture

Architecture

Academic Publications

Paper Abstracts

Abstract 1

Abstract 2

TechRxiv

Citation (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}
}

Author

Rong Fan / 樊荣
<img src="https://github.com/memoryfraction/LLSDA-Lightning-Location-System-Data-Analyzer/raw/main/Images/avatar-rong-fan.jpg" width="128" height="150" alt="Rong Fan">
Email: 1470269034@qq.com
百度学术 - 樊荣
Google Scholar - Rong Fan

Changelog

Version Date Changes
v1.0.0 2019-06-04 Initial release — Lightning strike related classes
v1.0.1 2019-06-05 Added StrikesDistributionStatistic class with time/spatial statistics
v1.0.3 2019-06-10 Added file operator classes for LLS database parsing
v1.0.4 2019-06-11 Added angle, shape, and shapeType classes
v1.0.5 2019-06-13 Added point analysis module
v1.0.6 2019-06-16 Added user-defined analysis module
v1.0.7 2019-06-23 Refactored to follow SOLID principle (interface-based)
v1.1.0 2019-06-24 New OOP design and architecture diagrams
v1.2.0 2019-07-18 Hour and month distribution charts
v1.2.1 2019-07-23 Year distribution feature
v1.2.1 2020-05-22 Academic paper added
v1.2.2 2020-12-06 Upgraded to .NET Standard 2.1 / .NET 5.0; unit tests added
v1.2.3 2021-01-06 Intensity probability chart; rose diagram chart
v1.3.0 2021-09-05 Multi-target: .NET 4.8 + .NET Standard 2.0; Winform app with GIS support
v1.4.0 2023-07-25 Academic paper on TechRxiv (DOI: 10.36227/techrxiv.23615019.v1)
v1.4.1 2026-08-12 README overhaul; System.Drawing.Common upgraded to stable; GitHub Pages deployed

License

Acknowledgements


<a name="chinese-section"></a>

闪电定位系统数据分析器 (LLSDA) — 中文版

部分效果图

闪电时间分布图

简介

LLSDA (Lightning Location System Data Analyzer) 是一个开源、跨平台的类库,用于分析闪电定位系统数据。 它提供了闪电时空分布统计分析和可视化的核心功能。

  • 避免重复劳动:为不同研究团队提供统一的基础分析库
  • 提高开发效率:防雷工程师和气象学者可快速集成
  • 开源贡献:回馈开源社区和防雷行业

特性

特性 状态
跨平台 (.NET Framework 4.8 / .NET Standard 2.0)
多格式闪电文件解析
时间分布分析(年/月/时)
空间分布统计
基于经纬度的点分析
自定义区域分析
雷电玫瑰图
电流强度概率图
GIS / Shapefile 叠加支持

安装方法

NuGet Package Manager Console:

Install-Package LightningLocationSystemDataAnalyzer-LLDSA

.NET CLI:

dotnet add package LightningLocationSystemDataAnalyzer-LLDSA

快速开始

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

var strikes = new List<BaseStrikeChina>();
var srcFile1 = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"data\2008_07_09.txt");

if (File.Exists(srcFile1))
{
    var fileProcessor = new LlsFileProcessor(srcFile1, Encoding.UTF8);
    strikes.AddRange(fileProcessor.ReturnStrikesChinaByProcess());
}

更多示例请参考 LLSDA.Client

面向对象设计与架构

OOP 设计图

OOP 设计

架构设计图

架构

学术支撑

论文摘要

摘要1

摘要2

TechRxiv

引用格式 (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}
}

作者

樊荣 Rong Fan
<img src="https://github.com/memoryfraction/LLSDA-Lightning-Location-System-Data-Analyzer/raw/main/Images/avatar-rong-fan.jpg" width="128" height="150" alt="Rong Fan">
Email: 1470269034@qq.com
百度学术 / Google Scholar

版本记录

版本 日期 更新内容
v1.0.0 2019-06-04 初始发布 — 雷电击相关类
v1.0.1 2019-06-05 新增 StrikesDistributionStatistic 类,含多种时空统计方法
v1.0.3 2019-06-10 新增文件操作类,用于识别 LLS 数据库文件
v1.0.4 2019-06-11 添加角度、形状相关类
v1.0.5 2019-06-13 新增点分析模块
v1.0.6 2019-06-16 新增自定义分析模块
v1.0.7 2019-06-23 遵循 SOLID 原则,重构为接口驱动
v1.1.0 2019-06-24 新增面向对象设计图和架构设计图
v1.2.0 2019-07-18 实现小时分布和月分布图
v1.2.1 2019-07-23 新增年分布功能
v1.2.1 2020-05-22 新增学术论文
v1.2.2 2020-12-06 升级到 .NET Standard 2.1 / .NET 5.0;添加单元测试
v1.2.3 2021-01-06 新增雷电流累计概率分布图、雷电玫瑰分布图
v1.3.0 2021-09-05 多框架支持 (.NET 4.8 + .NET Standard 2.0);Winform 客户端集成 MeteoInfo GIS
v1.4.0 2023-07-25 TechRxiv 学术论文发表 (DOI: 10.36227/techrxiv.23615019.v1)
v1.4.1 2026-08-12 README 大修;System.Drawing.Common 升级至稳定版;部署 GitHub Pages

知识产权

声明

由于知识有限、精力有限,不对开源版本提供任何使用质量保障和服务。 欢迎在 Issue 区提出。

合作伙伴

如您对雷电有兴趣,正在攻读相关学位,从事相关研究,或有意向成为项目的贡献者,欢迎联系我:1470269034@qq.com

鸣谢

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.4.1 43 8/12/2026
1.3.0 357 9/6/2021
1.2.2 591 12/8/2020