LLSDA - Lightning Location System Data Analyzer

Readme: English | 中文

Part of the Result | 部分效果图

Brief Introduction

LLSDA is a public benefit project helps lightning protection engineer and lightning scientist to analyze lightning distribution. LLSDA(Lightning Location System Data Analyzer) is an cross platform class library for lightning location system using C# following .NET Standard. It is the necessary part of all lightning time and spatial distribution analysis software.

Introduction

Lightning is a violent and sudden electrostatic discharge where two electrically charged regions in the atmosphere temporarily equalize themselves, usually during a thunderstorm.

Lightning location meter, also known as lightning monitoring location meter, refers to the use of the sound, light, electromagnetic characteristics of the lightning return stroke radiation to telemetry lightning return stroke discharge parameters of an automatic weather detection equipment, it can detect the occurrence of lightning time, location, intensity, polarity, etc..People have been devoted to the research of lightning detection and early detection and prediction techniques and methods of thunderstorm disaster.

Lightning location system data analyzer, is basic data analysis library. The data development based on lightning location system will depend on the basic class library development of lightning location system.In order to prevent duplication of efforts, improve development efficiency, and make personal contributions to the open source community and lightning protection industry. I contribute this library to open source community.

Glad you like it.

Features

• Build passing
• Based on .NET STANDARD 2.1
• Cross platform

Dependencies

• .NET Standard 2.1
• Newtonsoft
• Nuget: System.Drawing.Common

How to use it

• NugetUrl

• Package Manager execute below command to install Nuget package
  Install-Package LightningLocationSystemDataAnalyzer-LLDSA -Version 1.2.2

• Code

  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 statistical and visualization method，refer to codes in LLSDA.ClientWinform

Change Log

• V1.0.0(2019-6-4) Lightning strike related classes

• V1.0.1(2019-6-5) StrikesDistributionStatistic class added, which contains dozens of distribution statistic methods

• V1.0.3(2019-6-10) Add File Operator classes

• V1.0.4(2019-6-11) Add angle classes, shape, shapeType

• V1.0.5(2019-6-13) Add PointAnalysis

• V1.0.6(2019-6-16) Add UserDefinedAnalysis

• V1.0.7(2019-6-23) Follow SOLID Principle to rely on Interfaces instead of Entities

• V1.1.0(2019-6-24) New added OOP Design and Architecture

• V1.2.0(2019-7-18) Implemented Hour and month distribution

• V1.2.1(2019-7-23) New added year distribution feature

• V1.2.1(2020-5-22) New added academic paper

• V1.2.2(2020-12-06) Updated to .net standard 2.1 and .NET 5.0 Added unit test project

• V1.2.3(2021-01-06) Added Intensity Probability Chart Added Rose Diagram Chart

• V1.3.0(2021-09-05) Added multiple target frameworks: .NET 4.8, and .NetStandard 2.0 Added WinformApplication, added MeteoInfo(GIS) reference

• V1.4.0(2023-07-25) LLSDA Academic Paper published in TechRxiv DOI: https://doi.org/10.36227/techrxiv.23615019.v1

OOP Design

Architecture

Reference & Academic support

• Abstract

Citation Fan, Rong; Li, JingXiao; Liu, MingYuan (2023). LLSDA: Design and implementation of lightning location data analysis, and visualization. TechRxiv. Preprint. https://doi.org/10.36227/techrxiv.23615019.v1

License

• For Non-Code parts: Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
• For Code parts: GNU GENERAL PUBLIC LICENSE Version 3

Donation

• Paypal: rong.fan1031@gmail.com
• You are welcome to buy me a coffee.

Google Scholar Citations

https://scholar.google.com/citations?user=Zxn84ckAAAAJ

Thanks to

• HongBing Chen, Xia Li, Yi Gao, Wen'an Xiao(Alphabetical Sorted by family name)
• Nanjing University of Information Science and Technology(NUIST)
• Maharishi University of Management
• LeaderTech Co., Ltd

简介

闪电，在大气科学中指大气中的强放电现象。在夏季的雷雨天气，雷电现象较为常见。它的发生与云层中气流的运动强度有关。有资料显示，冬季下雪时也可能发生雷电现象，即雷雪，但是发生机会相当微小。若有严重的火山爆发时，或是原子弹爆炸产生蘑菇云时，空中可能因短路而发生闪电。

闪电定位仪又称雷电监测定位仪，是指利用闪电回击辐射的声、光、电磁场特性来遥测闪电回击放电参数的一种监测雷电发生的自动化的气象探测设备，它可检测雷电发生的时间、位置、强度、极性等。人们一直在致力于闪电探测设各与雷暴灾害早期检侧、预报技术和方法的研究。

LLSDA(闪电定位系统数据分析器), 一款服务于雷电相关工作者的数据分析的基础类库。 基于闪电定位系统的数据开发的软件将必不可少的依赖于闪电定位系统的基础类库开发。 可以大幅度提高开发效率、避免重复劳动。

特性

• 编译通过
• 基于 .NET STANDARD 2.1
• 跨平台: MAC/LINUX/WINDOWS

依赖项

• .NET Core 2.1版本及以上
• Newtonsoft
• Nuget: System.Drawing.Common

使用方法

• NugetUrl

• Package Manager 中执行以下命令以安装Nuget包
  Install-Package LightningLocationSystemDataAnalyzer-LLDSA -Version 1.2.2

• 代码

  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.ClientWinform中的代码

版本

• V1.0.0(2019-6-4) 新增LightningStrike相关类;

• V1.0.1(2019-6-5) 新增StrikesDistributionStatistic 类, 内含多种时间、空间统计方法;

• V1.0.3(2019-6-10) 新增文件操作类，用于识别LLS数据库文件; 和持久化内存数据到硬盘;

• V1.0.4(2019-6-11) 添加以下类: angle classes, shape 和 shapeType;

• V1.0.5(2019-6-13) 新增点分析相关类。 点分析，用于输入经纬度点后得到相关分析结果;

• V1.0.6(2019-6-16) 新增 UserDefinedAnalysis;

• V1.0.7(2019-6-23) 遵循SOLID原则，依赖于接口，而不是依赖于实体。 有利于解耦和开发、维护

• V1.1.0(2019-6-24) 新增面向对象设计图和架构设计图;

• V1.2.0(2019-7-18) 实现了时分布、月分布图

• V1.2.1(2019-7-23) 新增年分布功能

• V1.2.1(2020-5-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, and .NetStandard 2.0 升级了Window桌面客户端，该客户端添加 MeteoInfo(GIS)的引用，允许闪电与GIS地图(*.shp格式)的叠加，效果图见Readme顶部

• V1.4.0(2023-07-25) LLSDA Academic Paper published in TechRxiv DOI: https://doi.org/10.36227/techrxiv.23615019.v1

学术支撑

• Abstract

[]

引用 Rong; Li, JingXiao; Liu, MingYuan (2023). LLSDA: Design and implementation of lightning location data analysis, and visualization. TechRxiv. Preprint. https://doi.org/10.36227/techrxiv.23615019.v1

百度学术引用

https://xueshu.baidu.com/scholarID/CN-BM75JUJJ

知识产权

• 非代码部分: 署名-非商业性使用 4.0 国际 (CC BY-NC 4.0)

• 解释: 谈谈创作共用许可证（Creative Commons licenses）- 阮一峰

• 代码部分: GNU GENERAL PUBLIC LICENSE Version 3

• 著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

声明

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

捐赠与支持

支付宝二维码 如本项目对您的研究、工作有帮助，请在参考文献中添加本文作为引用。

合作伙伴

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

鸣谢

• 肖稳安、高燚、陈鸿兵
• 南京信息工程大学(NUIST)
• Maharishi University of Management
• 南京雷德尔信息科技有限公司