The African GNSS TEC (AfriTEC) Model, version 2.3

-------------------
INTRODUCTION
-------------------
The AfriTEC model is a model of the ionospheric GNSS TEC over the entire African region (Longitudes 25 degree West to 60 degree East, Latitudes 40 degree South to 40 degree North).

The model can be used to obtain the ionospheric GNSS TEC at all locations over the African continent.
For this version of the model (version 2.3), usage is encouraged to be restricted between years 2000-2022. The model is updated biennially. The year span of encouraged usage will be expanded in subsequent versions of the model.

The model is developed by the method of artificial neural networks as detailed in the paper: https://doi.org/10.1029/2019JA027065, which is included in the model folder.

-------------------
USAGE
-------------------

• The program comes in a folder which contains all associating files
• The main program to run is named AfriTEC.m
• It generates a graphical user interface which is simple and easy to use
• Users can either produce diurnal profiles or spatial maps
• Users can also generate the diurnal profiles for all the days in a year by ticking the checkbox on the user interface
• When the program runs, it creates the figure for the user specified details, and stores the corresponding data in a folder named Output (which is created within the same folder where the AfriTEC program is located)

-------------------
ABOUT F10.7 VALUES USED BY THE MODEL
-------------------
The deployed model contains text file named “Kp_Dst_F10p7.txt”. This is the primary file containing F10.7 values used by the model. At the time of writing this document, the file contains values of the F10.7 for the period starting from the end of year 1999 to 20 July 2020. Default data contained in the file is obtained from NASA’s OMNIWeb (https://omniweb.gsfc.nasa.gov/form/dx1.html). Data in the file is arranged in 6 columns. The first column is Year. The second column is Day of year. The third column is Hour (in UT). The fourth column is Kp index (multiplied by 10). The fifth column is Dst index (in nT). The sixth column is the F10.7 index.

Users can follow the above description to update the file, depending on their preferences, and according to the period of TEC data they desire from the model. This is the primary source of solar and geomagnetic storm indices for the model; the model looks elsewhere only if there is no data from this text file for the period in which TEC data is requested.

The internet is a secondary source of F10.7 data for the model; the model looks here only if it does not find values on the text file named “Kp_Dst_F10p7.txt”. The following are sources of web-based F10.7 data used by the model:

NOAA SWPC archive of solar and geomagnetic data
(ftp://ftp.swpc.noaa.gov/pub/indices/old_indices/)
At the time of writing this document, the site contains F10.7 data from year 1994 to present. It is updated in near real time. The model looks here to fetch F10.7 data if data for the periods desired are not found within the text file named “Kp_Dst_F10p7.txt”.

NOAA SWPC 45-day forecasts of F10.7
(ftp://ftp.swpc.noaa.gov/pub/latest/45DF.txt)
The site is continually updated such that it contains a 45-day forecast of the F10.7 values. This is the third and last place the model looks to fetch F10.7 values from. This resource helps to make 45-day forecasts of TEC possible. It is recommended that the user understands this part, and so it may not be possible to forecast beyond the forecasted indices. Also the accuracies of the forecasted TEC values will be dependent on the accuracies of the forecasted indices.

If users update the text file named “Kp_Dst_F10p7.txt” with their values of F10.7, then there will be no need of internet to run the AfriTEC model. Users are encouraged to update the text file named “Kp_Dst_F10p7.txt” with observed values of F10.7 so as to increase speed and accuracy of the AfriTEC model.

-------------------
NEW IN THIS VERSION
-------------------
The model is updated and implemented to produce TEC in real-time and future times using F10.7 data obtained from NOAA SWPC

-------------------
ALLOWED USAGE
-------------------
This program is only open for applications in research and education. Other users should contact Dr Daniel Okoh (okodan2003@gmail.com)

-------------------
ACKNOWLEDGEMENT
-------------------
Users must acknowledge the development of this program appropriately as stated below:
I (or We) acknowledge the developers of the AfriTEC model, the Centre for Atmospheric Research - National Space Research and Development Agency, the CV Raman International Fellowship Scheme, the Indian Institute of Geomagnetism, and the South African National Space Agency for making the AfriTEC model available.

-------------------
CORRESPONDENCE
-------------------
Dr Daniel Okoh
Space Environment Research Laboratory
Centre for Atmospheric Research
National Space Research and Development Agency
Airport Road, Abuja, Nigeria
Email: okodan2003@gmail.com

--------------------
Required:
--------------------
MATLAB
Aerospace Toolbox
Neural Network Toolbox
Statistics Toolbox

---

Download AfriTEC 2.3