The plotting of 1D arrays option and plot handling is one of the main features of IMASViz tool.
This tutorial subsection presents the basics of plotting a 1D array, stored in the IDS, and handling the created plots.
1.1.1. 3.1 Plotting a single 1D array
The procedure to plot 1D array is as follows:
- Navigate through the magnetics IDS node and search for the node ids.magnetics.flux_loop[0].flux.data
- Right-click on the node ids.magnetics.flux_loop[0].flux.data
From the pop-up menu, select the command Plot ids.magnetics.flux_loop[0].flux.data
The plot should display as shown in the image below.Each plot window has a menu for printing (File menu), saving and exporting data (File menu) or customizing the plot (Options menu).
Any part of the plot can be zoom-in using the mouse (Options menu to zoom out).
1.1.1.1. 3.1.1 Customizing the plot
Each plot can be customized. To do so:
- right-click anywhere on the plot and select Configure option
- Plot configuration window will open, displaying all available customizations
1.1.2. 3.2 Adding a plot to an existing figure
The procedure of adding a plot to an already existing figure is as follow:
- From the previous navigation tree, navigate to the node ids.magnetics.flux_loop[16].flux.data
- Right-click on the node ids.magnetics.flux_loop[16].flux.data
- From the pop-up menu, select the command Add plot to existing figure and Figure0 in the attached submenu
The plot should display as in the image below.
1.1.3. 3.3 Comparing float 1D arrays between 2 shots
IMASViz allows comparing of 1D arrays between 2 different shots. The procedure is very similar to the one presented in the previous section 3.2:
Open the shot 52682.
Tutorial IDS case parameters:User name: g2lfleur
IMAS database name:test
Shot number:52682
Run number:0
Load occurrence 0 of magnetics' IDS
Navigate through the magnetics IDS of shot 52682 and search for the node ids.magnetics.flux_loop[0].flux.data
- Right-click on the node ids.magnetics.flux_loop[0].flux.data
From the pop-up menu, select the command Add plot to existing figure and Figure0 in the attached submenu
The plot should display as in the image below.
1.1.4. 3.4 Selecting 1D arrays, plotting the selection
IMASViz allows the user to preselect arrays to be added to a single plot, thus providing a faster plot option when multiple 1D data arrays are desired to be shown on a single plot and avoiding "one-by-one" selection.
The procedure of 1D arrays selection and plotting is as follows:
- Navigate the tree of shot 52682 and search for the node ids.magnetics.bpol_probe[0].field.data
- Right-click on the node ids.magnetics.bpol_probe[0].field.data
- From the pop-up menu, select the command Select ids.magnetics.bpol_probe[0].field.data
The selected node turns into red. - Navigate the tree of shot 52682 and search for the node ids.magnetics.bpol_probe[9].field.data
- Right-click on the node ids.magnetics.bpol_probe[9].field.data
- From the pop-up menu, select the command Select ids.magnetics.bpol_probe[9].field.data
The selected node turns into red. - Right-click one of the selected nodes
From the pop-up menu, select the command Plot all selected signals to a new figure
Selections list are proper to each shot navigation tree; selections list are not concatenated between different shots.
1.1.5. 3.5 Plotting 1D arrays as a function of coordinate1 along the time axis and vice-versa
Another IMASViz feature is plotting coordinate along the time axis and vice-versa. Examples are shown in the subsections below.
1.1.5.1. 3.5.1 Plotting 1D array as a function of coordinate1 along the time axis
- Load the equilibrium IDS from shot 52682
- Navigate the tree of shot 52682 and search for the node ids.equilibrium.time_slice[0].profiles_1d.f
- Click on the + symbol at the right of node ids.equilibrium.time_slice[0].profiles_1d.f to expand it.
You should get the image below. Note that coordinate1 = ids.equilibrium.time_slice[itime].profiles_1d.psi
for this FLT_1D data array. - Right-click now on the node ids.equilibrium.time_slice[0].profiles_1d.f
- From the pop-up menu, select the command Plot ids.equilibrium.time_slice[0].profiles_1d.f to a new figure
The plot should display as in the image below.
The data are represented as a function of coordinate1 for the first time slice. - Click on the time slider and release the mouse at index value 41
The time slider allows you to move along the time axis. You should obtain the image below.
1.1.5.2. 3.5.2 Plotting 1D arrays as a function of the time along coordinate1
- From the previous shot 52682 tree, right-click now the node ids.equilibrium.time_slice[0].profiles_1d.f
- From the pop-up menu, select the command Plot ids.equilibrium.time_slice[0].profiles_1d.f as a function of time
The plot should display as in the image below.
The data are represented as a function of time for a given coordinate1 value. - Click on the time slider and release the mouse at index value 19.
The slider allows you to move along the coordinate1. You should obtain the image below.
The title of the plot gives the coordinate1 value which is selected by the slider. The label of the
plot is the short name of the quantity which has been selected in the tree (equilibrium.time_slice[itime] has
been removed from the label).
1.1.6. 3.6. Multiple plots configuration
IMASViz enables the creation and later use of custom plot configuration.
1.1.6.1. 3.6.1 Creating a multiple plots configuration
The procedure is as follows:
- Load the magnetics IDS (see above 'Loading 'magnetics' IDS from an IMAS local data source example')
- Navigate through the 'magnetics' IDS of shot 52682 and select the next nodes:
- ids.magnetics.flux_loop[0].flux.data
- ids.magnetics.flux_loop[5].flux.data
- ids.magnetics.flux_loop[15].flux.data
- ids.magnetics.bpol_probe[0].field.data
- ids.magnetics.bpol_probe[40].field.data
ids.magnetics.bpol_probe[80].field.data
At this stage, there are six FLT_1D arrays selected.Currently, up to 6 plots only can be plotted simultaneously. This limitation will be removed in the future.Each plot can be customized individually; right click on a node and select 'Configure Plot'.
- Right-click on one of the selected node
- From the pop-up menu, select the command Plot all selected signals to a multiplot frame
- In the menu, select Options -> Save plots configuration and type Magnetics_flux_loop_bpol_probes as a name for the configuration, click the OK button
The configuration has been saved as a file in your $HOME/.imasviz directory (i.e Magnetics_flux_loop_bpol_probes.cfg file).
1.1.6.2. 3.6.2 Applying a multiple plots configuration to a new shot
The procedure is as follows:
Open the shot 52344 if it is not already opened
Tutorial IDS case parameters:User name: g2lfleur
IMAS database name:test
Shot number:52344
Run number:0
- From the Options menu of the navigation tree of shot 52344, select the command Apply multiple plots configuration
- Click on the Apply configuration
The new multiplot should be displayed as shown in the image below.
all IDSs (from which the data to be plotted are fetched) before to plot the data.
1.1.7. 3.7 SubPlot Manager
1.1.7.1. 3.7.1 SubPlot Manager overview
SubPlot Manager is another IMASViz utility for working with multiple plots. To use it:
- Select multiple FLT_1D arrays (as previously shown in section 3.4)
- Right-click on one of the selected arrays and select Open subplots manager
- SubPlot Manager Input window will be shown. The required number of subplots is automatically inserted. Press OK button to proceed
- Next, SubPlot Manager will open, displaying the selected arrays. The order of subplots can be customized if the user chooses so. Press Open subplots to proceed
Next, the resulting subplots will be shown within the same Subplot Manager display window with all subplots having the same x-axis range.
The x-axis range was defined by taking the minimum and maximum x-axis value between all of the selected FLT_1D arrays.
1.1.7.2. 3.7.2 Applying mouse-selected x-axis range to all subplots
SubPlot Managers enables to select the plot section selection in the first subplot.
The x-axis range of other subplots will update, following the first subplot x-axis range.
To zoom out to default view chose Zoom Out option in the Options menu
1.1.7.3. 3.7.3 SubPlot configuration
As already shown at the end of section 3.1, each plot can be configured. Same goes for the subplots in the SubPlot Manager.
For example, changing the theme of the first subpanel can be done by selection dark color theme in the configuration
This gives us the next SubPlot Manager view:
In order to apply the same theme to all subplots within the SubPlot Manager display window, select Top theme to all option in the Options menu.
This, for the dark plot theme, all other subplots below the first plot will be set to the selected theme.
Note that this feature always takes theme set for the first subplot.
1.1.7.4.
3.7.4 Reopen closed SubPlot Manager display window
When the SubPlot Manager display window is closed, it can be reopened from the Show/Hide subplots selection from the right-click menu.