This page was created by the IDL library routine
mk_html_help2.
Last modified: Sun Apr 13 03:17:35 2025.
NAME:
atec_global_2dmap
PURPOSE:
Create a two-dimensional world map of the GPS-TEC data at a specified time.
SYNTAX:
atec_global_2dmap, vname1, st_time = st_time,
contour_min = contour_min, contour_max = contour_max
INPUT:
vname1 = tplot variable name
KEYWOARDS:
P0lat = center latitude of a world map
The default is 0.
P0lon = center longitude of a world map
The default is 160.
plot_min_lat = minimum value of plot latitude range
The default is -90.0.
plot_max_lat = maximum value of plot latitude range
The default is 90.0.
plot_min_lon = minimum value of plot longitude range
The default is -180.0.
plot_max_lon = maximum value of plot longitude range
The default is 180.0.
st_time = start time to create a world map of GPS-TEC data
contour_min = plot the minimum range of GPS-TEC value.
The default is the minimum range corresponding to the minimum GPS-TEC value.
contour_max = plot the maximum range of each GPS-TEC value.
The default is the maximum range corresponding to the maximum GPS-TEC value.
/local_noon: plot the local noon line in the two-dimensional map.
CODE:
A. Shinbori, 06/10/2021.
MODIFICATIONS:
ACKNOWLEDGEMENT:
$LastChangedBy: $
$LastChangedDate: $
$LastChangedRevision: $
$URL $
(See projects/iugonet/plot/atec_global_2dmap.pro)
NAME:
atec_keogram_glat_glong
PURPOSE:
Create a keogram of the subtracted TEC (Total Electron Content) data
provided by the DRAWING/PWING projects and and loads data into tplot format.
SYNTAX:
atec_keogram_glat_glong, glong = glong
KEYWOARDS:
glong = specify the geographic longitude of a TEC keogram.
The default is 0.
CODE:
A. Shinbori, 06/10/2021.
MODIFICATIONS:
ACKNOWLEDGEMENT:
$LastChangedBy: $
$LastChangedDate: $
$LastChangedRevision: $
$URL $
(See projects/iugonet/plot/atec_keogram_glat_glong.pro)
PROCEDURE get_data_asi_nipr
:DESCRIPTION:
Extract the ASI data at the designated time from the tplot variable
and make the structure.
:PARAMS:
asi_vn: tplot variable name (as string)
:KEYWORDS:
set_time: set the time (UNIX time) to get 2D data (can be an array)
altitude: set the altitude on which the image data will be mapped.
The default value is 110 (km).
aacgm: set to obtain the position data in the AACGM coordinates
data: output data as the structure which have the tags as follows;
name: tplot variable name
set_time: the designated time (array)
dat_time: the actual time (array)
data: image data
alti: altitude (scalar)
azim: azimuth angle for each pixel of the images
elev: elevation angle for each pixel of the images
center_glat: geographic latitude for the center of each pixel
center_glon: geographic longitude
corner_glat: geographic latitude for the corner of each pixel
corner_glon: geographic longitude
center_mlat: aacgm latitude for the center of each pixel
center_mlon: aacgm longitude
center_mlt: magnetic local time
corner_mlat: aacgm latitude for the corner of each pixel
corner_mlon: aacgm longitude
corner_mlt: magnetic local time
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/07/08: Created
(See projects/iugonet/plot/get_data_asi_nipr.pro)
PROCEDURE get_data_thmasi
:DESCRIPTION:
Extract the ASI data at the designated time from the tplot variable
and make the structure.
:PARAMS:
asi_vn: tplot variable name (as string)
:KEYWORDS:
set_time: set the time (UNIX time) to get 2D data (can be an array)
altitude: set the altitude on which the image data will be mapped.
The default value is 110 (km).
aacgm: set to obtain the position data in the AACGM coordinates
data: output data as the structure which have the tags as follows;
name: tplot variable name
set_time: the designated time (array)
dat_time: the actual time (array)
data: image data
alti: altitude (scalar)
azim: azimuth angle for each pixel of the images
elev: elevation angle for each pixel of the images
center_glat: geographic latitude for the center of each pixel
center_glon: geographic longitude
corner_glat: geographic latitude for the corner of each pixel
corner_glon: geographic longitude
center_mlat: aacgm latitude for the center of each pixel
center_mlon: aacgm longitude
center_mlt: magnetic local time
corner_mlat: aacgm latitude for the corner of each pixel
corner_mlon: aacgm longitude
corner_mlt: magnetic local time
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/07/08: Created
(See projects/iugonet/plot/get_data_thmasi.pro)
:PROCEDURE:
iug_movie_smart
:PURPOSE:
Show movie of the solar images obtained by the SMART telescope
at the Hida Observatory, Kyoto Univ.
:KEYWOARDS:
valuename : tplot variables for image data
:EXAMPLES:
iug_movie_smart, 'smart_t1_p00'
:Author:
Satoru UeNo (E-mail: ueno@kwasan.kyoto-u.ac.jp)
(See projects/iugonet/plot/iug_movie_smart.pro)
NAME:
iug_plot2d_ear_fai
PURPOSE:
Generate several 2-D plots from the FAI f-region observation data taken by the EAR.
SYNTAX:
iug_plot2d_ear_fai, valuename=valuename
KEYWOARDS:
VALUENAME = tplot variable names of ionosonde observation data.
For example, iug_plot2d_ear_fai,valuename = 'faifb8p16m1'.
The default is 'faifb8p16m1'.
STIME = Start time of 2-D plot of the EAR-FAI observations.
For example, iug_plot2d_ear_fai, stime = '2012-03-23/15:00:00'.
The default is '2012-03-23/15:00:00'.
MINIMUM = Minimum value of color plot. For example, iug_plot2d_ear_fai, min = 0.
The default is 0.
MAXIMUM = Maximum value of color plot. For example, iug_plot2d_ear_fai, max = 60.
The default is 60.
ZTICKS = Number of zticks to divide the bar into. There will be (zticks + 1) annotations.
The default is 6.
CHARSIZE = Select of character size. For example, iug_plot2d_ear_fai, charsize = 1.5.
The default is 1.5.
NOTES:
Before you examine this procedure, the EAR-FAI data are necceary to load.
CODE:
A. Shinbori, 08/07/2013.
MODIFICATIONS:
A. Shinbori, 09/01/2014.
ACKNOWLEDGEMENT:
$LastChangedBy: nikos $
$LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
$LastChangedRevision: 25538 $
$URL $
(See projects/iugonet/plot/iug_plot2d_ear_fai.pro)
NAME:
iug_plot2d_gps_ro
PURPOSE:
Generate several height-latitude profile from the GPS radio occultation data
taken by the CHAMP and COSMIC satellites.
SYNTAX:
iug_plot2d_gps_ro, valuename1 = valuename1, valuename2 = valuename2
KEYWOARDS:
SITE = LEO satellite name. CHAMP and COSMIC are available as an input satellite name.
The default is 'cosmic'.
CODE:
A. Shinbori, 14/05/2016.
MODIFICATIONS:
ACKNOWLEDGEMENT:
$LastChangedBy: nikos $
$LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
$LastChangedRevision: 25538 $
$URL $
(See projects/iugonet/plot/iug_plot2d_gps_ro.pro)
NAME:
iug_plot2d_ionogram
PURPOSE:
Generate several ionogram plots from the ionogram data taken by the ionosonde.
SYNTAX:
iug_plot2d_ionogram, valuename=valuename
KEYWOARDS:
VALUENAME = tplot variable names of ionosonde observation data.
For example, iug_plot2d_ionogram,valuename = 'iug_ionosonde_sgk_ionogram'.
The default is 'iug_ionosonde_sgk_ionogram'.
CODE:
A. Shinbori, 11/01/2013.
MODIFICATIONS:
A. Shinbori, 09/01/2014.
ACKNOWLEDGEMENT:
$LastChangedBy: nikos $
$LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
$LastChangedRevision: 25538 $
$URL $
(See projects/iugonet/plot/iug_plot2d_ionogram.pro)
:PROCEDURE:
iug_plot2d_irio, vn, col, row, start_time=start_time, $
step=step, valrng=valrng, flipns=flipns, flipew=flipew, $
oblique_cor=oblique_cor
:PURPOSE:
Plot 2D image of the imaging riometer data obtained by NIPR.
The data are mapped to 90km altitude in the magnetic coordinate.
:KEYWOARDS:
vn : tplot variables for image data
col : number of column
row : number of row
start_time : start time of the images
step: time step
valrng: minimal and maximal values for display (default: [0, 4])
flipns: set to flip in the North-South direction (default: top is north)
flipew: set to flip in the East-West direction (default: right is east)
oblique_cor: if set, CNA for the oblique beams is corrected by CNA*cos(ze).
:EXAMPLES:
iug_plot2d_irio, 'nipr_irio_syo_cna', 3, 3, $
start_time='2003-02-09/01:30', step=60
:Author:
Y.-M. Tanaka (ytanaka at nipr.ac.jp)
(See projects/iugonet/plot/iug_plot2d_irio.pro)
NAME:
iug_plot2d_mu_fai
PURPOSE:
Generate several 2-D plots from the FAI f-region observation data taken by the MU radar.
SYNTAX:
iug_plot2d_mu_fai, valuename=valuename
KEYWOARDS:
VALUENAME = tplot variable names of ionosonde observation data.
For example, iug_plot2d_mu_fai,valuename = 'ifco16'.
The default is 'ifco16'.
STIME = Start time of 2-D plot of the EAR-FAI observations.
For example, iug_plot2d_mu_fai, stime = '2007-01-09/15:00:00'.
The default is '2007-01-09/15:00:00'.
MINIMUM = Minimum value of color plot. For example, iug_plot2d_mu_fai, min = 0.
The default is 0.
MAXIMUM = Maximum value of color plot. For example, iug_plot2d_mu_fai, max = 50.
The default is 50.
ZTICKS = Number of zticks to divide the bar into. There will be (zticks + 1) annotations.
The default is 5.
CHARSIZE = Select of character size. For example, iug_plot2d_ear_fai, charsize = 1.5.
The default is 1.5.
NOTES:
Before you examine this procedure, the EAR-FAI data are necceary to load.
CODE:
A. Shinbori, 08/07/2013.
MODIFICATIONS:
A. Shinbori, 09/01/2014.
ACKNOWLEDGEMENT:
$LastChangedBy: nikos $
$LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
$LastChangedRevision: 25538 $
$URL $
(See projects/iugonet/plot/iug_plot2d_mu_fai.pro)
NAME:
iug_plot2d_radiosonde
PURPOSE:
Generate several height profiles from the radiosonde data.
SYNTAX:
iug_plot2d_radiosonde, site=site
KEYWOARDS:
SITE = Radiosonde observation sites.
For example, iug_plot2d_radiosonde,site = 'sgk'.
The default is 'sgk'.
CODE:
A. Shinbori, 30/05/2013.
MODIFICATIONS:
A. Shinbori, 09/01/2014.
ACKNOWLEDGEMENT:
$LastChangedBy: nikos $
$LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
$LastChangedRevision: 25538 $
$URL $
(See projects/iugonet/plot/iug_plot2d_radiosonde.pro)
:PROCEDURE:
iug_plot2d_smart
:PURPOSE:
Plot the solar image data obtained by the SMART telescope at the Hida Observatory,
Kyoto Univ.
:KEYWOARDS:
vn : tplot variables for image data
col : number of column
row : number of row
start_time : start time of the images
:EXAMPLES:
iug_plot2d_smart, 'smart_t1_p00', 3, 3, start_time='2005-08-03/05:00:00'
:Author:
Tomo Hori (E-mail: horit@stelab.nagoya-u.ac.jp)
Satoru UeNo (E-mail: ueno@kwasan.kyoto-u.ac.jp)
(See projects/iugonet/plot/iug_plot2d_smart.pro)
PROCEDURE overlay_map_asi_nipr
:DESCRIPTION:
Plot 2D images from all-sky imagers on the plot window set up by map_set.
:PARAMS:
asi_vn: tplot variable names (as strings) to be plotted
:KEYWORDS:
set_time: time to plot all-sky imager data
(ex., '2012-01-12/21:30:00' or Unix time)
altitude: altitude on which the image data will be mapped.
The default value is 110 (km). Available values are 90, 110, 150, 250.
position: position of the plot frame in the plot window
colorrange: range of values of colorscale (this can be an array)
notimelabel: set to surpress drawing the time label
timelabelpos: position of the color scale in the noraml coordinates
tlcharsize: size of the characters used for the time label
nocolorscale: set to surpress drawing the color scale
colorscalepos: position of the color scale in the noraml coordinates.
Default: [0.85, 0.1, 0.87, 0.45]
cscharsize: size of the characters used for the colorscale
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/07/08: Created
(See projects/iugonet/plot/overlay_map_asi_nipr.pro)
PROCEDURE overlay_map_thmasi
:DESCRIPTION:
Plot 2D images from all-sky imagers on the plot window set up by map_set.
:PARAMS:
asi_vn: tplot variable names (as strings) to be plotted
:KEYWORDS:
set_time: time to plot all-sky imager data
(ex., '2011-01-01/00:00:00 or Unix time)
altitude: altitude on which the image data will be mapped.
The default value is 110 (km). Available values are 90, 110, 150, 250.
position: Position of the plot frame in the plot window
colorrange: range of values of colorscale (this can be an array)
notimelabel: set to surpress drawing the time label
timelabelpos: position of the color scale in the noraml coordinates
tlcharsize: the size of the characters used for the time label
nocolorscale: set to surpress drawing the color scale
colorscalepos: set the position of the color scale in the noraml coordinates.
Default: [0.85, 0.1, 0.87, 0.45]
cscharsize: size of the characters used for the colorscale.
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/07/08: Created
(See projects/iugonet/plot/overlay_map_thmasi.pro)
PROCEDURE plot_map_asi_nipr
:PURPOSE:
Draw NIPR all-sky imager data on the world map
:Params:
asi_vns: tplot variable to be plotted
:Keywords:
set_time: time to plot all-sky imager data
(ex., '2012-01-12/21:30:00' or Unix time)
coord: the name of the coordinate system.
'geo' or 0 for geographic coordinate
'aacgm' or 1 for AACGM coordinate
glatc: geographical latitude at which a plot region is centered
glonc: geographical longitude at which a plot region is centered
scale: same as the keyword "scale" of map_set
altitude: altitude on which the image data will be mapped.
The default value is 110 (km). Available values are 90, 110, 150, 250.
colorrange: range of values of colorscale (this can be an array)
erase: set to erase pre-existing graphics on the plot window.
position: position of the plot frame in the plot window
label: set to label the latitudes and longitudes.
stereo: use the stereographic mapping, instead of satellite mapping (default)
coast: set to draw coast
mapcharsize: size of the characters used for the labels.
mltlabel: set to draw the MLT labels every 2 hour
lonlab: a latitude from which (toward the poles) the MLT labels are drawn
nogrid: set to suppress drawing the lat-lon mesh
notimelabel: set to surpress drawing the time label
timelabelpos: position of the color scale in the noraml coordinates
tlcharsize: size of the characters used for the time label
nocolorscale: set to surpress drawing the color scale
colorscalepos: position of the color scale in the noraml coordinates.
Default: [0.85, 0.1, 0.87, 0.45]
cscharsize: size of the characters used for the colorscale
:EXAMPLES:
plot_map_asi_nipr, 'nipr_asi_hus_0000'
plot_map_asi_nipr, 'nipr_asi_hus_0000', glatc=65., glonc=-15.
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/08/03: Created
(See projects/iugonet/plot/plot_map_asi_nipr.pro)
PROCEDURE scale_image_values
:DESCRIPTION:
Scale values of image into the designated range.
:PARAMS:
image:
range:
image_out:
:AUTHOR:
Yoshimasa Tanaka (E-mail: ytanaka@nipr.ac.jp)
:HISTORY:
2014/07/08: Created
(See projects/iugonet/plot/scale_image_values.pro)