Training session
SPEDAS-GUI & IUGONET Type-A
The 3rd ISEE Symposium
PWING-ERG conference and school on the innermagnetosphereon March 8-12, 2021

Contents of this documents

1. Basic operation of IUGONET data service(IUGONET Type-A)
2. Basic operation of the GUI tool of SPEDASWhat is IUGONET Type-A?

http://search.iugonet.org/• IUGONET data service (called IUGONET Type-A) is capable of cross-searchingobservational data distributed across the IUGONET universities and institutes,
including the PWING data, .
• IUGONET Type-A provides one-stop web services such as
searching data, finding interesting events, interactively plotting the data,
and leading users to more detailed analysis.

What is SPEDAS?
Space Physics Environment Data Analysis Software : SPEDAS
Users can easily load and visualize various kinds of data by a few
commands with SPEDAS.
1. Set a time period
2. Load *** data
3. Plot the loaded data
Data Servers
on the Internet
SSL, Berkeley,THEMIS, GBO
CDAWeb, Arase,
OMNI, ACE, etc.

timespan, ‘yyyy-mm-dd’
xxx_load_***tplot, +++UserPC

Automaticdownloaddata

Directories for the
downloaded data
are createdautomatically.

Data areloaded as
tplot variables
datadata

If you use the GUI tool, only a few simple clicks of your mouse are required tomake the same plot as that created by the SPEDAS commands above.

How to use IUGONET Type-A

Basic Operation of IUGONET Type-A
Access to IUGONET Type-A (http://search.iugonet.org)

Basic Operation of IUGONET Type-A
Search data
Select the LIST or
MAP search.
You can limit thesearch results byselecting theInstrument/Projectfrom the list or
inputting thekeyword that youwant to search.

Input the timespan
you want to search
the data
2021/01/01 (from)2021/01/07 (to)Click “Search”
buttonBasic Operation of IUGONET Type-A
Search result (list display)
You can switch
between the text
and QL-plot display
modes.
If you click “Plot”,
the search results
are shown by QL
plots of eachdataset.
List of the search
results is shownhere.
If you click the titleof each dataset, you
can see the detailed
information of thedata.

Basic Operation of IUGONET Type-A
Search result (QL plot display)
You can select thetime interval from 1or 3 or 7 days.
The default is 7days.

Search results areshown as QL plots
here.
If you click the QL
plot or the title ofthe dataset, you cansee the detailed
information of thedata.

Basic Operation of IUGONET Type-A
Metadata display
The metadata display
page shows the detailed
information of thedataset, such as QL plot,contact person, anddata use policy.

You can select the startdate of the QL plot andtime interval (1, 3, or 7days).

Scroll downBasic Operation of IUGONET Type-A
Metadata display
Data description:
This information isuseful for writingscientific papers.
Data use policy

Contact person:
You can easily contact
PIs of the dataset.
Data location and fileformat:You can access thewebpage of the data
Information ofinstrument
Scroll downBasic Operation of IUGONET Type-A
Metadata display
Information ofobservatory
Basic SPEDAS
commands (for thecommand line interface)
to load and plot the data.
Advanced SPEDAS
commands tocustomize the plot
How to load and plot
with GUI of SPEDAS.

MATLAB command toload and plot the datawith M-UDAS.

Hand on of SPEDAS-GUI

Preparation for SPEDAS GUI
Prepare 64 bit Operating System.
1. Access the following URL
http://themis.ssl.berkeley.edu/software.shtml
2. Download SPEDAS 4.1 zip file for your operating system(Win orMac), and then unzip it to your desktop.

Start of SPEDAS GUI[1] Unzip the zipped SPEDAS file.
[2] Double-click the executable file
named ‘spedas’ in thedirectory‘spedas_v_3/spd_gui’.

Doule-click theexecutable file named‘spedas’

Click the icon
‘spd_gui’.

[3] IDL Virtual Machine window opens
on your PC, so please click the‘spd_gui’ button.

How to Use SPEDAS-GUI
part1・Load data・Plot data
・Save figure, data, and your workBasic Operation of SPEDAS GUI
Load Dst index
1. Click this icon

Or,Select “Load Data from Plug-ins…” from“Data” dropdown menu.

Basic Operation of SPEDAS GUI
1. Click IUGONET Tab

2. Uncheck “Use Single Day”

4. Change Instrument Typegeomagnetic_field_index

3. Set Date and Time
Start Time: 2012-03-04/00:00:00
Stop Time: 2012-03-11/00:00:00

Basic Operation of SPEDAS GUI

2. Click the arrow
1. Choose three parameters- Dst_index- *(all)- *Basic Operation of SPEDAS GUI

Display of Data Use Policy

1. Click“OK”

Basic Operation of SPEDAS GUI

1. Data was loaded successfully!

2. Click“Done”

Basic Operation of SPEDAS GUI
Plot data

1. Click this icon

Or,Select “Plot/Layout Options…” from “Plot”
dropdown menu.

Basic Operation of SPEDAS GUI

2. Click “Line”

1. Select data which you want to plot:
wdc_mag_dst_prov

Basic Operation of SPEDAS GUI

1. Selected variablename is added to thisbox

2. Click OK

Basic Operation of SPEDAS GUIPanelX(Y,Z)
X: panel serial number
Y: row index of the panel
Z: column index of the panel

You can add, remove, andedit panels with thesebuttons.
You can move panels
and change thenumber of panels perpage.

Lock to panel:
Lock panel axes tocurrently selected panel.

Basic Operation of SPEDAS GUI
Load other three data
AE index(in IUGONET tab)
Instrument:magnetometer
MAGDAS magnetometer(in IUGONET tab)
Instrument: magnetometer
Station: HER
MAGDAS magnetometer(in IUGONET tab)
Instrument: magnetometer
Station: ASB

Basic Operation of SPEDAS GUI
1. Select IUGONET tab

2. Select magnetic_field_index
4. Click arrow
3. Select AE_index, *(all), *5. Data is loaded

Basic Operation of SPEDAS GUI

1. Select geomagnetic_field_fluxgate
3. Click arrow
4. Data is loaded
2. Select magdas#, asb & her, *5. Click Done

Basic Operation of SPEDAS GUI
Add plot
wdc_mag_ae_prov_1min

1. Click this icon

Or,
Select “Plot/Layout Options…” from “Plot”
dropdown menu.

Basic Operation of SPEDAS GUI
1. Click Add

3. Click “Line”

4. Data are added
2. Select wdc_mag_ae_prov_1min

5. Click OK

Basic Operation of SPEDAS GUI
1. Click black triangles

Basic Operation of SPEDAS GUIPlot other two data

magdas_mag_her_1sec_hdz
magdas_mag_asb_1sec_hdz

Basic Operation of SPEDAS GUI

2. Click Line

3. Data are added
1. Select magdas_mag_her_1sec_hdz

Basic Operation of SPEDAS GUI

2. Click Line

1. Select magdas_mag_asb_1sec_hdz

4. Click OK

3. Data are added

Basic Operation of SPEDAS GUI

Basic Operation of SPEDAS GUI
Save plot as image file
1. Select
File – Save Page As Image File…

2. Select save folder

2. Input file name and select format (by extension)

3. Click “save”

Basic Operation of SPEDAS GUI

Back to previous

Click “Save”

Basic Operation of SPEDAS GUI

X pixel 856, Y pixel 554(65%)

X pixel 428, Y pixel 554

Basic Operation of SPEDAS GUI
Save data as ASCII
1. Select
Data – Save Data As

Basic Operation of SPEDAS GUI
2. check this box
3. Select time interval
1. Select data which you want to savemagdas_mag_her_1sec_hdz_x
4. check this box

6. Select save folder

7. Input file name (data is saved in csv format)
5. Click Save
8. Click “save”

Basic Operation of SPEDAS GUI
An ASCII data file was
successfully saved!!!

Basic Operation of SPEDAS GUI
Save your workspace
1. Select
File – Save SPEDAS GUI Document

2. Select save folder

3. Input file name

4. Click “save”※ SPEDAS Document is written in XML format

How to Use SPEDAS-GUI
part2
・Restore your work
・Manage axis
・Process and data

Basic Operation of SPEDAS GUI
Restore part1 workspace

1. Exit SPEDAS
2. Run SPEDAS again
3. Select File- Open SPEDAS Document
4. Click “Yes”
5. Select the saved tgd file.

Basic Operation of SPEDAS GUI
Remove plot

1. Select
Plot – Plot/Layout Options

Basic Operation of SPEDAS GUI
2. Click “Remove
1. Select
wdc_mag_ae_prov_1min_time -vs- wdc_mag_ae_prov_1min_4
in the right-hand panel.

3. Remove
wdc_mag_ae_prov_1min_time -vs- wdc_mag_ae_prov_1min_3
wdc_mag_ae_prov_1min_time -vs- wdc_mag_ae_prov_1min_2
wdc_mag_ae_prov_1min_time -vs- wdc_mag_ae_prov_1min_1
in the same way

4. Click OK

Basic Operation of SPEDAS GUIBasic Operation of SPEDAS GUI
Change X range (time scale)(1)
Reduces X range
by major tickmarker
Expands X range
by major tickmarker
Shift left X range
by major tickmarker
Shift right X range
by major tickmarker

Use these icons

Basic Operation of SPEDAS GUI
Change X range (time scale)(2)

1. Select
Plot – X Axis Options

Basic Operation of SPEDAS GUI
1. Select Panel (If panel is locked,
use “Apply to All Panels”.)

2. Select Fixed Range

3. Change values
Min 2012-03-06/00:00:00.000
Max 2012-03-11/00:00:00.000
4. Click "Apply to All Panels”

Basic Operation of SPEDAS GUI
Customize ticks

1. Select Major Ticks
By Number or Interval.
2. Input the number
into # (Number orInterval) of Minor Ticks

Basic Operation of SPEDAS GUI
Change annotations

1. Select your favorite
format in the pull-downmenu of Annotation
Format.
2. If you want tochange the character
font, size, and color,select your favorite
format in the pulldown menu here.

3. Click "Apply to All Panels”

52Basic Operation of SPEDAS GUI
Customize labels(of X axis)

1. Select Panel 4(bottom panel)

3. Type “UniversalTime ” on the Edit/AddLabel

2. Check the“Show Label” box

4. Click "OK“.

Basic Operation of SPEDAS GUI

Basic Operation of SPEDAS GUI
Other options• Page Options…
Customize the text and layout of thepage.
• Panel Options…
Customize the title and color ofeach panel.
• Line Options…

Customize the line and symbol ofeach plot panel.
• Legend Options…
Customize the legend whichappears when you put the mouse
cursor on the plot.
• Variable Options…
Display the values of the selectedparameters under the time label.

Basic Operation of SPEDAS GUI
Reset X range (time scale)

1. Select X Axis Options

Basic Operation of SPEDAS GUI
1. Select (L) Panel 1(1, 1) 2. Select Auto Range

3. Click “OK”

Basic Operation of SPEDAS GUI
Data processing(subtract average)
1. SelectAnalysis – Data Processing

Basic Operation of SPEDAS GUI
4. Click Subtract Average

3. Active Data are added
2. Click right arrow

1. Select data you want to process
magdas_mag_asb_1sec_hdz
magdas_mag_her_1sec_hdz

Basic Operation of SPEDAS GUI

New variables are created.
magdas_mag_asb_1sec_hdz-d
magdas_mag_her_1sec_hdz-d

1. Click Done

Basic Operation of SPEDAS GUI
Open “Plot/Layout Options”

1. Remove Panel 3 and 4
3. Click line
4. Data are added

2. Selectmagdas_mag_her_1sec_hdz-d

5. Then, add the other variable,
magdas_mag_asb_1sec_hdz-d
to panel in the same way.

6. Click OK

Basic Operation of SPEDAS GUI

Subtracted average!

Basic Operation of SPEDAS GUI
Data processing(power spectrum)
magdas_mag_her_1sec_hdz_x
Hint1: Use “Data Processing”
for calculating (if you will get
an option dialog, use defaultvalue)

Hint2: Use “Spec” for plotting

1. SelectAnalysis – Data Processing

Basic Operation of SPEDAS GUI

2. Active Data is removed

1. Click Clear ActiveBasic Operation of SPEDAS GUI

3. Active Data are added

2. Click right arrow

1. Select data
magdas_mag_her_1sec_hdz

5. Click OK

4. Click Power Spectrum

Basic Operation of SPEDAS GUI

1. New variables are created!

2. Click Done

Basic Operation of SPEDAS GUI
Open “Plot/Layout Options”

2. Click Spec
3. Data are added
1. Selectmagdas_mag_her_1sec_hdz_x_dpwrspc

4. Click OK

Basic Operation of SPEDAS GUIThis color bar can becustomized inGraph - Z Axis
Options.

Basic Operation of SPEDAS GUI
Calculate (Equation editor)

1. SelectAnalysis – Calculate…

Basic Operation of SPEDAS GUI
Equation Editor for SPEDAS
Variable=Your loaded data

Built-in function

Built-in Operator

Built-in ConstantBasic Operation of SPEDAS GUI
Make an equation using the loaded variables

Type variable/function/Operator/Constant, and make equation
A = B + C - D…
Note:
Enclose the tplot variable in double quotation marks

Basic Operation of SPEDAS GUI
1. Select magdas_mag_her_1sec_hdz-d_x
3. Variable is added
2. Click arrow

Then, add the offset (+200) tomagdas_mag_her_1sec_hdz-d_x
and plot it on new panel.

Basic Operation of SPEDAS GUI
Note: one line, never return"magdas_mag_her_1sec_hdz-d_x_ofst" = "magdas_mag_her_1sec_hdz-d_x"+ 200

1. Click Run
2. A new variable is created
3. Click doneBasic Operation of SPEDAS GUI
Open “Plot/Layout Options”

1. Select Panel 3 and Remove it

3. Click Line

4. Data are added

2. Selectmagdas_mag_her_1sec_hdz-d_y
magdas_mag_her_1sec_hdz-d_x_ofst

Basic Operation of SPEDAS GUI
Open “Plot/Layout Options”

1. Change the value of Row to 3

2. Panel 6 is changed to (3, 1)

3. Click OK

Basic Operation of SPEDAS GUI

Offset (+200nT)
was added to the Hcomp.

Basic Operation of SPEDAS GUI
Expand X range using the mouse
By left-click anddrag the mouse

A new page opens

How to Use SPEDAS-GUI
part3
Additional data loadingBasic Operation of SPEDAS GUI
Load your ASCII file (1)Sample1: magnetometer data

HEADER(13 lines)

Data(1440lines)

This example reads an ASCII
file fromhttp://data.icswse.Kyushu-u.ac.jp/
gmag/data/ASB/Min/2012/
ASB20120301pmin.min

Data(6 columns)

Basic Operation of SPEDAS GUI

1. Select
Data – Load Single File – Load ASCII…

Basic Operation of SPEDAS GUI
1. Click”Browse”, and select‘testfile_format0.txt’.
2. Format Type: Select 0
3. Time Format: Check Specify, andput ‘YYYY-MM-DD hh:mm:ss.fff’
4. Column No. of loaded data:put ‘1,2,3,4’Note:Column number starts from 0.

5. Options for Header:
Check the box, and put ‘13’ toNumber of lines of skip.

6. Click OK

Basic Operation of SPEDAS GUI

1. Click “OK”

Basic Operation of SPEDAS GUI
Open “Plot/Layout Options”

2. Click Line

1. Click +, and selecttvar1_03. Data are added

4. Repeat the same process
to tvar1_1, tvar_1_2, andtvar1_3
5. Click “OK”

Basic Operation of SPEDAS GUI
Magnetometer data
Click this icon before next lesson
written inASCII(IAGA-2002)
format are plotted.

Basic Operation of SPEDAS GUI
Load your ASCII file (2)Sample2: EISCAT radar data

HEADER(starts from %)Data(11520lines)

Data(19 columns)
http://pc115.seg20.nipr.ac.jp/www/eiscatdata/esr/ascii/42m_ascii/2014/20140108_42m0_ipy0_0060.txt

Basic Operation of SPEDAS GUI
Open File – Load Your Data – Load ASCII

1. Click”Browse”, and select‘testfile_format1.txt’.
2. Format Type: Select 1
3. Time Format: Check Specify, andput ‘YYYY-MM-DD hh:mm:ss.f’
4. Column No. of loaded data:put ‘5,6,7,8’
5. Loaded data name:put ‘Ne, Vi, Ti, Te’
6. Column No. of v_vector:
put ‘1’

5. Click OK

7. Options for Header:
Check the box, and put ‘%’ toComment symbol

Basic Operation of SPEDAS GUI

1. Click “OK”

Basic Operation of SPEDAS GUI
Open “Plot/Layout Options”

2. Click Spec

3. Data are added
1. Select Ne
4. Repeat the sameprocess to Vi, Ti, and Te

5. Click “OK”

Basic Operation of SPEDAS GUI

Click this icon before next lesson

EISCAT radar data written
in ASCII format are plottedin spectrogram.

Acknowledgments
SPEDAS is a grass-roots data analysis software for the Space
Physics community, which was developed by scientists andprogrammers of the UC Berkeley's Space Sciences Laboratory,
UCLA's IGPP and other contributors.

References:
Angelopoulos et al., The Space Physics Environment Data Analysis
System (SPEDAS), Space Sci. Rev., 215:9, doi:10.1007/s11214-0180576-4, 2019.