Selecting Show Vector under the Plot Tools option in the Plot Definition Menu brings up the menu:
This is a generic menu used for a number of Plot Tool definitions. For Show Vector only the first Vector Source option line is ever enabled. The vector can be either input manually or taken from a UDF source. The advantage of the latter is that the vector is tracked in time and aligned with the data as closely as possible before each operation. If there are multiple occurrances of the vector within the accumulation time of a single data measurement then the average of the values is used.
The show vector tool is designed to display the location of the head and tail of a vector in any Plot Definition whose Function Of options have been set to Spin Phase (phi) and Theta (elevation). The algorithm assumes:
The basic algorithm is given below. Inputs to the algorithm are the vector components X, Y, and Z. The algorithm outputs the phase angle of the vector head (Ph), the theta angle of the vector head (Th), the phase angle of the vector tail (Pt), and the theta angle of the vector tail (Tt). The phase angles are returned in the range -180 degrees to 180 degrees and the theta angles are returned in the range -90 degrees to 90 degrees.
Algorithm:
XY = [X2 + Y2]½
Ph = atan2(Y, X)
Th = atan2(Z, XY)
Pt = (Ph > 0) ? Ph - 180 :
180 + Ph
Tt = -Th
This is not an option in the conventional definition but contains the name of the Plot Tool which spawned the menu page. This is given as a reference since many different Plot Tools use this menu page.
CLOSE closes the Plot Tool Menu window.
For Show Vector, only the first set of options in the main menu panel is ever enabled.
The first instance of the Vector Source option line defines the vector to be displayed.
LOCATION defines the source of the Vector to display. The options are:
| Option | Definition |
|---|---|
| USER | The user must enter the vector to display in the X, Y, Z entry boxes on the option line. |
| UDF | The displayed vector is derived from a UDF source. Selecting this option will pop up the Vector Source Menu and will make the next three options on this line inaccessible. |
| UNUSED | This option is a place holder. There are some options that don't use the Vector Source and so UNUSED is there as a reminder. |
X is accessible only if the LOCATION option has been set to USER. The option sets the X component of the Vector to display.
Y is accessible only if the LOCATION option has been set to USER. The option sets the Y component of the Vector to display.
Z is accessible only if the LOCATION option has been set to USER. The option sets the Z component of the Vector to display.
The VEC SYMBOLS options define the symbol, symbol size, and symbol color used to display the vector head and tail in the plot. The Output Fmt option is not used.
SIZE sets the label size. Valid sizes run from 3 to 32767 with character size increasing with value. As a general rule of thumb 12-25 is a good selection. At a size of 1000 a single character will completely fill the plot page. Both the vector head and tail symbols will be displayed at this size.
COLOR sets the symbol color. There are 8 basic colors to select from. Both the vector head and tail symbols will be displayed in this color.
HEAD defines the character(s) to output at the location of the vector head. Multiple characters are allowed as long as there are no spaces. In addition to the alpha/numeric symbols there are a number of non-alpha/numeric symbols which can be defined. These are given in the table below. Note: the apostrophe ' must be included in the symbol name.
| Symbol | Definition |
|---|---|
| 'FSTAR' | Filled Star |
| 'FBOX' | Filled Box |
| 'FUTRI' | Filled Inverted Triangle |
| 'FDTRI' | Filled Triangle |
| 'BLOT' | Filled Circle |
| 'STAR' | Unfilled Circle |
| 'DIA' | Unfilled Diamond |
| 'CIRCLE' | Unfilled Circle |
| 'BOX' | Unfilled Box |
| 'DTRI' | Unfilled Triangle |
TAIL defines the character(s) to output at the location of the vector tail. Multiple characters are allowed as long as there are no spaces. In addition to the alpha/numeric symbols there are a number of non-alpha/numeric symbols which can be defined. These are given in the table below. Note: the apostrophe ' must be included in the symbol name.
| Symbol | Definition |
|---|---|
| 'FSTAR' | Filled Star |
| 'FBOX' | Filled Box |
| 'FUTRI' | Filled Inverted Triangle |
| 'FDTRI' | Filled Triangle |
| 'BLOT' | Filled Circle |
| 'STAR' | Unfilled Circle |
| 'DIA' | Unfilled Diamond |
| 'CIRCLE' | Unfilled Circle |
| 'BOX' | Unfilled Box |
| 'DTRI' | Unfilled Triangle |
DELETE PAGE deletes the current Plot Tool Definition and all menus associated with it.
Adding the magnetic field vector to a phi-theta plot of a particle distribution is accomplished by the following two menu definitions: the Show Vector definition which indicates a UDF source for the solar wind; and the Vector Source Menu which defines where the magnetic field vector data is found.
The resultant plot is shown in the following figure. The applied Plot Tools are listed above the right-hand corner of the plot. The location of the magnetic field vector head and tail are displayed in the plot as a H and T respectively.
| &larr Previous | TOC | HOME | Next &rarr | |
| Flow Removal Menu | Show Globe Menu |