Science Score: 44.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
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.1%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: LucijaZuzic
  • Language: TeX
  • Default Branch: main
  • Size: 29.5 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme Citation

README.md

A $Dst$-based space weather conditions machine learning classification model for GNSS PNT performance analysis

Ambient conditions classification enables systematic mitigation of adversarial effects on Global Navigation Satellite System (GNSS) Positioning, Navigation, and Timing (PNT) performance. This research contributes to the problem by proposing a classification model of space weather events for sub-equatorial regions. The proposed model uses machine learning-based classification applied to the experimental observations of geomagnetic field components, observed Total Electron Content ($TEC$), and Disturbance Storm-Time ($Dst$-index). A Support Vector Machine (SVM) with a Polynomial Kernel, C5.0 Decision Tree (DT), Naive Bayes (NB), shallow Neural Network (NN), Partial Least Squares (PLS), Flexible Discriminant Analysis (FDA), and shallow NN using Principal Component Analysis (PCA) was applied to develop the candidate model to classify observations of the geomagnetic field in $TEC$, combined with other variables, into one of the scenarios of space weather conditions. Performance is assessed using a confusion matrix and development time to yield the NB as the best performer. The proposed $Dst$-based classification model serves as an indicator of a geomagnetic/ionospheric storm in progress, thus alerting GNSS users of potential degradation in GNSS PNT performance and setting up a framework for the development of a tailored GNSS ionospheric correction model for specific classes of the space weather conditions.

The annual observed $TEC$ data at Darwin, NT is contained in the file $darwin2014.csv$. The $TEC$ data set was derived from RINEX GPS observations using GPS $TEC$ software by Seemala.

The annual estimated $Dst$ and $a{p}$ data in 2014 is contained in the file $Dstap2014.dat$. The $Dst$ and $a{p}$ data were derived from the INTERMAGNET data set, available from the INTERMAGNET website, and reformatted.

Model training can be run using the $ldtr2024\_train.R$ script that automatically sets the working directory to the script's location on disk.

The script $ldtr2024\_vars\_analyze.R$ was used for the statistical analysis of input variable correlation and normal distribution.

The Python script $stat\_test.py$ is used to run McNemar's test on the results.

The Python script $read\_stat\_test\_and\_distr.py$ and $read\_txt\_as\_csv.py$ reformat the results for readability in $.txt$, $.csv$, and $.tex$ format, available in the directory $latex\_table\_total$.

Research results are presented with the following initial set of six predictors (results in the directory entitled $no\_ Dst$): Total Electron Content ($TEC$), dTEC (standard deviation of Total Electron Content), $B{x}$, $B{y}$, $B{z}$, and $a{p}$. Disturbance Storm-Time ($Dst$) should not be a predictor since the initial classification is derived from $Dst$ values. Still, results are evaluated to demonstrate the validity of this conclusion, as presented in the directory entitled $all$. Candidate models have also been developed using: (1.): all predictors except $TEC$, and $dTEC$ ($B{x}$, $B{y}$, $B{z}$, and $a{p}$, results in the directory entitled $no\_ TEC$), (2.): Geomagnetic indices ($B{x}$, $B{y}$, and $B{z}$, results in the directory entitled $coord$), (3.): $B{x}$, $B{y}$, and $a{p}$ (results in the directory entitled $xyap$), (4.): $B{x}$, $B{z}$, and $a{p}$ (results in the directory entitled $xzap$), and (5.): $B{y}$, $B{z}$, and $a{p}$ (results in the directory entitled $yzap$).

Contact: lucija.zuzic@uniri.hr, +385989856334

Hardware requirements: No minimal requirements are set, but the experiment was run on $Windows$ 11 using $R Studio$ version 2024.04.2+764 and $R$ version 4.4.1, the AMD Radeon RX 6600 Graphics Processing Unit (GPU), $16$ GB of Random Access Memory (RAM), and the AMD Ryzen 5 PRO 4650G Central Processing Unit (CPU) with $6$ cores. A stronger configuration will speed up model training.

Program language: $R$ and Python

Software required: The utilized $R$ and Python libraries can be installed from a $cran$ repository using $R Studio$ and using a package manager for Python, such as $conda$.

Program size: The $.zip$ downloaded from GitHub requires approximately $10$ $MB$ of storage space. Extracted files amount to a maximum of $41$ $MB$.

Owner

  • Login: LucijaZuzic
  • Kind: user
  • Location: Rijeka, Croatia

Student of Computer engineering at the University of Rijeka, Faculty of Engineering

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Žužić"
  given-names: "Lucija"
  orcid: "https://orcid.org/0009-0007-6788-7522"
- family-names: "Klen"
  given-names: "Deni"
  orcid: "https://orcid.org/0009-0008-7473-8653"
- family-names: "Iliev"
  given-names: "Teodor B."
  orcid: "https://orcid.org/0000-0003-2214-8092"
- family-names: "Filjar"
  given-names: "Renato"
  orcid: "https://orcid.org/0000-0002-7040-9931"
title: "A Dst-based space weather conditions machine learning classification model for GNSS PNT performance analysis"
version: v1
doi: 10.5281/zenodo.14502657
date-released: 2024-12-16
url: "https://github.com/LucijaZuzic/Dst_classification"

GitHub Events

Total
  • Release event: 3
  • Push event: 10
  • Fork event: 1
  • Create event: 5
Last Year
  • Release event: 3
  • Push event: 10
  • Fork event: 1
  • Create event: 5