remotesensing-14-03760
⛈️ Code for the paper "End-to-End Prediction of Lightning Events from Geostationary Satellite Images"
Science Score: 41.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
○codemeta.json file
-
○.zenodo.json file
-
✓DOI references
Found 9 DOI reference(s) in README -
○Academic publication links
-
✓Committers with academic emails
1 of 2 committers (50.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.0%) to scientific vocabulary
Keywords
Repository
⛈️ Code for the paper "End-to-End Prediction of Lightning Events from Geostationary Satellite Images"
Basic Info
Statistics
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
End-to-End Prediction of Lightning Events from Geostationary Satellite Images
This is the official repo for the paper "End-to-End Prediction of Lightning Events from Geostationary Satellite Images".
Abstract
While thunderstorms can pose severe risks to property and life, forecasting remains challenging, even at short lead times, as these often arise in meta-stable atmospheric conditions. In this paper, we examine the question of how well we could perform short-term (up to 180 min) forecasts using exclusively multi-spectral satellite images and past lighting events as data. We employ representation learning based on deep convolutional neural networks in an "end-to-end" fashion. Here, a crucial problem is handling the imbalance of the positive and negative classes appropriately in order to be able to obtain predictive results (which is not addressed by many previous machine-learning-based approaches). The resulting network outperforms previous methods based on physically based features and optical flow methods (similar to operational prediction models) and generalizes across different years. A closer examination of the classifier performance over time and under masking of input data indicates that the learned model actually draws most information from structures in the visible spectrum, with infrared imaging sustaining some classification performance during the night.
from "End-to-End Prediction of Lightning Events from Geostationary Satellite Images".
Getting Started
Prerequisites
DFCC is based on the following libraries and their versions:
Additionally, the Python packages as listed in the requirements.txt file must be installed.
We recommend to use a virtual environment.
Usage
Package Structure
The src directory contains all the code to run the experiments.
Here, everything is split up into different modules:
- data includes everything related to data, from different data sources to actual data loading
- events includes the learning range rate test (LRRT) and code to run experiments
- experiments includes different experiments
- log includes logging
- model includes model code
- optimizer includes everything related to optimizer, lr scheduling, loss and loss weighting
- skill includes skill scores, such as CSI, FAR and POD
- system includes system settings
- utils includes utilities used by other modules
The scripts directory contains scripts to create figures displayed in our publication.
Experiments
Settings
| Lead Time | Bottleneck Channels | Weight Decay | Regularization Factor | |----------:|--------------------:|-------------:|----------------------:| | 0 min | 16 | 5 x 10^-6 | 0.1 | | 30 min | 81 | 7 x 10^-6 | 0.15 | | 60 min | 97 | 7 x 10^-6 | 0.2 | | 90 min | 106 | 7 x 10^-6 | 0.2 | | 120 min | 114 | 1 x 10^-5 | 0.3 | | 180 min | 124 | 1 x 10^-5 | 0.3 |
Figure 4
Run the following code with the settings above to get a trained model for the given lead time:
python
python run.py experiment
--SEVIRI.roots.train "${train-data}"
--SEVIRI.roots.test "${test-data}"
--SEVIRI.roots.val "${validation-data}"
--LINET.db_path "${linet.db}"
--LINET.lead_time "${lead-time}"
--regularizer_factor "${reg-factor}"
--sgdw.weight_decay "${weight-decay}"
--channel_hierarchy_depth "${bottleneck-channels}"
The testing step will dump detailed model statistics which can be used with figure_4.py.
Figure 6
For Figure 6 train models with varying input channels, e.g. VIS+PER, WV+PER and IR+PER, and pass the testing details to figure_6.py.
For the sake of simplicity, we use the option --zero_out to replace inputs of the given channel with zeros during training.
python
python scripts/figure_6.py
-lt 120
--vis-per vis+per-testing_model_details.json
--wv-per wv+per-testing_model_details.json
--ir-per ir+per-testing_model_details.json
--json complete-testing_model_details.json
--persistence testing_persistence_details.json
Citation
If you find the code useful for your research, please cite (see CITATION for details):
- Brodehl, S.; Müller, R.; Schömer, E.; Spichtinger, P.; Wand, M. End-to-End Prediction of Lightning Events from Geostationary Satellite Images. Remote Sens. 2022, 14, 3760. https://doi.org/10.3390/rs14153760
Versioning
We use SemVer for versioning. For the versions available, see the releases and tags on this repository.
Authors
- Sebastian Brodehl / @sbrodehl
License
With the exceptions noted below, this project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
- lr_finder.py taken from github.com/davidtvs/pytorch-lr-finder (MIT license) and adapted to be used in this project.
- modelsummary taken from github.com/sksq96/pytorch-summary (MIT license) and adapted to be used in this project.
Owner
- Name: Sebastian Brodehl
- Login: sbrodehl
- Kind: user
- Twitter: sbr0d3hl
- Repositories: 8
- Profile: https://github.com/sbrodehl
Citation (CITATION)
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Sebastian"
given-names: "Brodehl"
orcid: "https://orcid.org/0000-0001-8970-9523"
title: "End-to-End Prediction of Lightning Events from Geostationary Satellite Images"
version: 1.0.1
date-released: 2022-06-28
url: "https://github.com/sbrodehl/remotesensing-14-03760"
preferred-citation:
type: article
authors:
- family-names: "Brodehl"
given-names: "Sebastian"
orcid: "https://orcid.org/0000-0001-8970-9523"
- family-names: "Müller"
given-names: "Richard"
orcid: "https://orcid.org/0000-0002-0376-0393"
- family-names: "Schömer"
given-names: "Elmar"
- family-names: "Spichtinger"
given-names: "Peter"
- family-names: "Wand"
given-names: "Michael"
doi: "10.3390/rs14153760"
journal: "Remote Sensing"
title: "End-to-End Prediction of Lightning Events from Geostationary Satellite Images"
year: 2022
GitHub Events
Total
- Watch event: 2
Last Year
- Watch event: 2
Committers
Last synced: about 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Sebastian Brodehl | f****s@s****e | 4 |
| Sebastian Brodehl | b****l@u****e | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: about 2 years ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
- dependabot[bot] (1)