ShapeView is a visualisation tool for ASDEX Upgrade's plasma separatrix shape. The main features are :
/afs/ipp/home/w/wot/matlab_exe/bin/ShapeView .
To start the program either
ShapeView command (see Starting ShapeView) with
this path or
setenv PATH ${PATH}:/afs/ipp/home/w/wot/matlab_exe/bin/ShapeView .
If you are using ShapeView frequently you should add the setenv command to your
cshrc.usr file.
ShapeView shot_number
This loads equilibrium variables from FPG (and FPC) and then opens a window displaying the matching AUG vessel cross-section of and the separatrix shape at the first time point available.
ShapeView shot_number diagnostic from to edition
experiment
This allows to specify additional load parameters. from and to can be used to specify a time window. The additional parameters are optional. Default values are assumed if you shorten the command.
ShapeView
The command with no parameters opens only a window with the current
AUG vessel cross-section. After that you can load a
shot with the shots menu.
To load a shot
shots menu.ok loads the requested shot.A navigation bar on top of the ShapeView drawing area appears as soon as there are more than one time points available.
The navigation bar offers several methods to select a time point :
This is the first field in the navigation bar. It displays the currently selected time in seconds. To go to another time point just type in the new time value. The time point nearest to the requested one will be chosen and the display will be updated.
You can use the time slider in several ways:
The minimup step size for an arrow click is specified in the
control field step.
With the animation buttons <<, |<, >|, >> you start the movie mode. The display shows the separatrix evolving in time. Step size and speed can be adjusted with the appropriate control elements of the navigation bar. To stop the movie at any time point press the || button.
Alternatively you can navigate using the marker of the signal timetraces :
options, submenu signal timetraces .left click with the mouse selects one single
signalshift left click selects a range of signals,ctrl left click adds or remove the current signal to
the selection .Finally press the ok button of the dialog to accept the
selection.
ShapeView time traces window will open. The requested
time traces are drawn in separate plot boxes with a common time axes. A
vertical line, the marker shows the currently selected time point in the
ShapeView main window.Left click on the marker line, drag it to a new position
and release it in order to select a new time point.With the profile menu you can add a contour plot of a
poloidally distributed profile parameter such as poloidal flux, safety factor
q, magnetic field components or plasma current densities. Only one profile
parameter is displayed at a time.
To obtain the level of a contour line right click on the
line. The level will be displayed in the heading of the context menu which
pops up.
Profile data are loaded on request. If you request a profile for the first time a dialog opens where you can specify the diagnostic and experiment names which may be different from the ones used to load the separatrix data. However, all flux-surface related profiles (pol. flux, tor. flux, q, magnetic field components and jp) all share the same source and you will be asked only once.
To hide a contour plot select none in the
profile menu.
Other parameters can be displayed selecting items in the
options menu. All selections are cumulative. However, too many
active options may clutter the screen thus hiding more information than they
contribute.
You can display
SOL
points (SOL:ScrapeOffLayer)
FPG delivers the coordinates of these points in terms of ray vectors originating from the geometric plasma center. Based on these points ShapeView calculates a spline to draw an interpolated separatrix contour.
characteristic
points
Various plasma center points (geometric, magnetic and current center) and strike points are marked.
To identify the points right click on them and the
description will appear in the top line of the context menu which pops
up. This option is active by default.
coils
PF coil locations are shown and colored according to the current they carry. The coil current value is also printed aside
Since most of the coils are relatively distant to the vessel you
should select all in the view menu to display a
larger area.
ICRH distance
The separatrix point closest to the ICRH antenna is marked and the distance is printed.
Distances are measured perpendicular to the antenna contour. A slight
restriction is that distances only are measured originating from the
antenna contour points defined by the YGC coordinate data. To inspect
these contour points right click on the antenna contour. A
context menu appears where you select . in the
Marker submenu. Choosing Marker >>
none hides these points again.
triangularity
The edge coordinate based definition of triangularity is visualised with a geometric contstruction and the values of upper, lower and medium triangularity are printed out. These values differ from the FPG parameters delRoben and delRunt because the latter are area averaged moments.
signal
values
A selection of scalar signal values is printed below the plot area.
When you select the signal values submenu a selection
dialog will open
left click with the mouse selects one single
signalshift left click selects a range of signalctrl left click adds or remove the current signal to
the selectionFinally press the ok button of the dialog to accept the
selection.
To hide all singal values printouts choose cancel.
signal
timetraces
Timetraces of scalar signals are displayed in a separate
ShapeView time traces window. In addition to the snapshot of
plasma shape at the current time point you can view the evolution of a
discharge in the time dimension. The timetrace view therefore is also an
ideal tool for navigation through the discharge.
Selection of the signals works in the same way as described for the
signal values submenu. However, deselecting a signal whose
time trace is already being displayed does not delete this timetrace.
The requested time traces are drawn in separate plot boxes with a
common time axes.
A vertical line, the marker shows thecurrently selected time point in
the ShapeView main window.
For navigation left click on the marker line, drag it to a new
position and release it in order to select a new time point.
You can rearrange the plotboxes if you left click into an
empty area inside a box and drag the box to a new vertical position.
Layers are a powerful feature of ShapeView. With layers you can overlay plasma shapes from several discharges or from different time points of the same discharge.
Each layer is identified by a unique name and is assigned a color to
distinguish it from other layers. You find the layer name, a layer comment
(usually #shot_number(diagnostic_name) )
and the current layer time point in a legend line below the drawing area.
Layer names starting with an asterisk (*) are hidden in the
printout. If you choose to display signal values, these values are printed
also in this line. By default you work in layer *, i.e. this
layer name is not printed out in the legend.
Navigation commands, settings in the profile and
options menus and loading a discharge with the shot
menu always refer to the current layer. The layer menu will
indicate the current layer in its title:
layer:layer_nameand it is colored
accordingly.
Two methods are available to create new layers
Copying is the preferred method if you want to overlay different time points of the same discharge. Copying a layer copies all signal data and all display settings but assigns a new layer name and color.
To copy a layer
layer_name submenu of the
layer menu and choose the copy item.You create empty layers from scratch for comparison of different discharges. Initially no signal data are available and all settings are set to their default values. After layer creation you then would load a new shot as described in Getting Started.
In many cases, however, you will want to load a new shot but keep your display options. Then it is more appropriate to make a copy of the sample layer and then overwrite the signal data loading a new shot.
To create a new empty layer proceed as follows:
layer:layer_name menu select the
new item.When you create a layer this new layer will automatically become the active layer.
If you want to change to an already existing layer you open the
layer_name submenu of the layer menu and
choose the select item.
In the layer_name submenu of the
layer menu you can also
by choosing the respective item.
All timetraces of a signal which is selected in different layers are drawn in the same plot box but in the colors of their layer. In addition a label helps to identify the layer to which a timetrace belongs to.
If you select a new signal, a new plotbox for this signal is appended to the existing ones.
The timetrace window offers a very comfortable navigation method if you use multiple layers. You can navigate immediately in any layer without making it the current layer before and without changing the current layer.
For each layer in which timetraces display is enabled a marker line is provided in the layer color. You can move any marker line to navigate to another time point in the associated layer.
Additional helpful options are available via the vessel,
view and draw opts menus.
vessel menu you
can select another vessel geometry which is displayed in addition to the
current vessel. By default the appropriate vessel geometry is
automatically selected depending on the shot number.view menu offers predefined zoom areas of the machine
cross-section. The default view is vessel.draw opts menu is only for specialists. There is just
one command wich might be of general interest:
If you want to see the hull of separatrices in a time sequence you
draw opts >> erasemode
>> none andNow the separatrices of the old time points are not deleted from the display unless you select another erasemode.
Note, however, that this applies also to other graphical elements selected by the profile and options settings.
A printout of this display is not possible. Only the current time point information will be printed.
The print menu offers a simple interface for color and black&white printing. Select the desired submenu and enter the appropriate printer name in the dialog which opens.
This printer name will be remembered for the next printout.
After you have confirmed the settings pressing the ok button the printout is started.
Note: In the File menu there is another Print item. In the standalone version (without running MATLAB) this starts a black&white printout on your standard printer lp.
In the info< menu you can lookup the current version information and find a link to the online documentation you are reading just now.
If you right click anywhere in the display a context sensitive menu will pop up offering graphical manipulation tools for the object beneath.
The header of this menu denotes name and type of the object as well as the the mouse pointer coordinates.
Depending on the type of the object you can e.g.
Last edited on November, 28th 2001, by Wolfgang Treutterer