LLSDA Documentation

Overview

LLSDA (Lightning Location System Data Analyzer) is an open-source, cross-platform .NET class library for analyzing lightning location system data. It provides core functionality for spatiotemporal statistics and visualization of lightning distribution.

Key Features

Application Screenshot

Installation

NuGet Package Manager:

Install-Package LightningLocationSystemDataAnalyzer-LLDSA

.NET CLI:

dotnet add package LightningLocationSystemDataAnalyzer-LLDSA

PackageReference (add to .csproj):

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

Quick Start

The core class for reading Chinese LLS data files is ADTDFileProcessor, which converts text-format lightning records into strongly-typed objects.

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

// 1. Point to a lightning data file (ADTD format)
string dataFilePath = @"data\2008_07_09.txt";

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

// 2. Parse all records into strongly-typed objects
List<BaseStrikeChina> strikes = processor.ReturnStrikesChinaByProcess().ToList();
Console.WriteLine($"Parsed {strikes.Count} lightning strike records.");

// 3. Each record contains:
foreach (var strike in strikes.Take(3))
{{
    Console.WriteLine($"Time: {{strike.DateAndTime}}, " +
        $"Lat: {{strike.Latitude}}, Lon: {{strike.Longitude}}, " +
        $"Intensity: {{strike.Intensity}} A");
}}

Supported File Formats

Format	Processor Class	Namespace
ADTD (China LLS)	ADTDFileProcessor	LLDSA.Entities.FileOperator.LLSFileProcessor.ADTD
GLD360 (Global)	GLD360FileProcessor	LLDSA.Entities.FileOperator.LLSFileProcessor.GLD360
WWLLN (Global)	WWLLNFileProcessor	LLDSA.Entities.FileOperator.LLSFileProcessor.WWLLN

Architecture & Design

Object-Oriented Design

Architecture Diagram

Source Code Structure

Academic Publications

This project is supported by multiple academic papers. The following abstracts provide a technical overview of the research behind LLSDA.

Paper 1 — Ground Lightning Flash Density Calculation and Software Implementation

📄 View Full Paper (PDF)

Paper 2 — Design and Implementation of Lightning Analysis Software

📄 View Full Paper (PDF)

Paper 3 — TechRxiv Preprint (DOI)

📄 View on TechRxiv (DOI: 10.36227/techrxiv.23615019.v1)

Citation (BibTeX)

Use the following BibTeX entry to cite this project in your publications:

@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}
}

About the Author