HELP
An object that displays a graphical plot in
polar coordinates.

USE
Use Polar Plot to display a value on a polar
scale when separate polar information is
available for radius and angle data.

When more than one trace is to be plotted,
each execution of the Polar Plot object uses
the single angle input data with each trace's
Radius input data, therefore, all traces
share the single angle input.

LOCATION
Display ==> Polar Plot

OPEN VIEW PARAMETERS

* Auto Scale - Automatically scales the
display to show the entire trace.  Auto Scale
resets the polar reference location to
Center.

* R name - The name of the radius scale.

* RData1 - The name of the first trace.

* Polar Reference Location - Specifies the
part of the polar plot displayed.  This is
quicker than scrolling to the area.  Changing
the reference point in the entry field
scrolls the point of the display specified
(such as Center) to the coordinate specified
(such as (0, @0)).

* Span:  - The vertical dimension of the
display.  When the origin is centered on the
display, the Span is twice the radius.  This
parameter controls the scaling of the
display.  Default is 2.

* Ref Radius:  - The radius value of the bold
graticule circle.

OBJECT MENU

* Auto Scale ==> - Automatically scales the
display to show the entire trace.

  * Auto Scale - Automatically scales both
axes and resets the polar reference location
to "Center:  (0,@0)".
This parameter may be added as a control
input.

* Clear Control ==> - Parameters that specify
when to clear the display.

  * Clear - Clears the displayed trace(s).
This parameter may be added as a control
input.

  * Clear At PreRun - Clears the displayed
trace(s) when the model or thread is PreRun.

  * Clear At Activate - Clears the displayed
trace(s) when the User Object is activated.

  * Next Curve - Resets the pen to display
the next curve in a family of curves (data
from the next time the display operates)
without clearing the previous curve.  Next
Curve must be selected (or activated) before
each new curve in the family.  This parameter
may be added as a control input.

* Zoom ==> - Scales the display.

  * In - Magnifies the display to contain
only the rectangular region that you selected
with the pointer.  You select the region
after selecting this feature by dragging on
the graph area.  This action outlines the
information with a "rubber band" box.

  * Out 2|5|10|20|50|100 x - Expands the
scales of the display by a factor in both the
X and Y directions about the center.

* Markers ==> - Allows you to find the exact
value of a data point on the displayed curve.
If the data is plotted on a log scale, the
values shown on the marker are the linear
data points.

To move markers to a different trace,
click on the button to the left of the marker
values near the bottom of the display.  The
button cycles through the different line
types and colors of the different traces.

  * Off - No markers are shown.

  * One On - One marker is available.

  * Two On - Two markers are available.

  * Delta On - Two markers are available and
the x and y differences between them are
displayed.

  * Interpolate - When checked, you can place
markers in between the displayed data points.
The marker values displayed are calculated by
linear interpolation.  Default is off.

  * Center - If markers are available, brings
them to the center of the visible part of the
trace.  This is useful if you've scrolled the
display and markers are not visible.

* Grid Type ==> - Sets the type of grid
marks.  The value of the major x division is
shown below the maximum x value (to the right
of the x scale name).  The value of the major
y division is shown below the y scale name.

  * No Grid - No grid lines are shown.

  * Tic Marks - Shows tic marks at the major
and minor divisions on all four sides of the
graph.

  * Axis - Shows tic marks at the major and
minor divisions on the X and Y axes of the
graph.  If the actual axes are scrolled off
the graph area, axis lines are drawn on the
edge closest to the axes.

  * Lines - Shows circles at the major
divisions and tic marks at the minor
divisions.  The bold (thick) circle is the
"Reference Radius"; its radius is shown in
the lower right corner of the display.

  * Smith Chart - Displays data in a Smith
Chart (also called an "impedance chart").
Marker values are given as real and imaginary
impedances.  The bold circle is the
"reference radius" and its linear radius
value is shown in the lower right corner of
the display.  The Smith Chart grid and
markers only represent properly scaled values
if the input data has been normalized.  To
normalize the data, divide all magnitudes by
the characteristic impedance.

  * Inv Smith Chart - Displays data in an
Inverse Smith Chart (also called an
"admittance chart").  An Inverse Smith Chart
is used in the same way as a Smith Chart
except grid and marker values are admittance
values rather than impedance values.

* Panel Layout ==> - Sets the appearance of
the open view.

  * Graph Only - The open view shows only the
graph area and the marker information (if it
exists).  No buttons, scales, scale names, or
traces names are shown.  This layout redraws
quickest and provides the largest display
area.

  * Scales - The open view shows the graph
area, the scales, the scale names, and trace
names.  These fields are not recessed and may
not be edited.  This layout is useful when
recessed fields might be distracting, such as
printing graphs, or when the fields should be
protected from editing on a User Panel.

  * Scales & Sliders - The open view shows
all information about the graph.  It includes
the most information and allows you to modify
the most elements interactively.  It is the
default.

* Traces & Scales - A control panel that
allows you to specify values such as the
names, colors, line and point
characteristics, minimum values, and maximum
values for the traces and/or scales.

Traces:

  * Name:  - The name of the trace that is
displayed to the left of the graph area and
the name of the corresponding input terminal.

  * Scale:  - If you have multiple Y scales,
selects which Y scale is to be used for this
trace.

  * Color:  - The color of the trace.  Each
added trace has a different color than the
existing traces.  Default is Pen 4 (yellow).

  * Lines:  - The format of the line
connecting data points.  Default is a
continuous line.

  * Points:  - The symbol that marks each
data point.  To show unconnected data points,
select the single dot Lines format and the
desired Points symbol.  Default is a dot.

You can add a Traces control input pin.
The control input data must be a record with
the following fields:  1) A TraceNum field
with an Integer value (1 is the top trace),
and 2) one or more of the following fields:
Name, Pen, LineType, PointType.  (The Pen,
LineType, and PointType values are integers
from 0 to n, where 0 draws nothing.)  Refer
to "Records and DataSets" in Using HP VEE|
for further information.

Scales:

  * Show Scale:  - If you have multiple
Radius scales, a selection (using a check
box) to specify if the span and an axis of
each additional right scale will be displayed
to the right of the graph area.

  * Scale Name:  - The names of the scales.
They may be set here or on the Scales &
Sliders layout.

  * Vert Span - The vertical dimension of the
display area for each scale.  This parameter
may be set here or on the Scales & Sliders
layout.

  * Scale Colors - The color of any
background grid or tic marks.  Default is
Gray.
  * Polar Reference Location The location of
the given reference point for the R MAIN
scale.  This parameter may be set here or on
the Scales or Scales & Sliders layout.

You can add a Scales control input pin.
The control input data must be a record with
one or more of the following fields:  Name,
Span (or Name1, Span1), Name2, Span2, Name3,
Span3, and RefPt (the value of RefPt must be
PComplex).  Refer to "Records and DataSets"
in Using HP VEE| for further information.

* Add Right Scale - Adds up to two additional
scales to permit traces to have different
scale ranges.  After adding a right scale,
use Traces & Scales to assign a trace to the
scale.

* Plot - Presents the Plotter Configuration
control panel.  When OK is pressed, a copy of
the device's entire display is plotted on the
selected plotter.  This parameter may be
added as a control input.  If the current
Plotter Configuration is in Plot to File
mode, you may specify the destination file or
directory name as string data on the Plot
control input.  If no control input value is
given, the file or directory name specified
in Plotter Configuration will be used.  See
Plotter Config for more information.

NOTES
Inputs must be Scalar or Array 1Ds that can
be converted to the type Real.

You can add traces as data inputs.  Up to
twelve traces are allowed.  Angle units are
in the current Trig Mode.

All inputs must be the same size and
shape.  Mapping information on the inputs
data is ignored.

A Title control input may be added, which
sets the title bar name to the specified text
value.  This allows programmatic control over
the title shown when the display is printed
or plotted.

SEE ALSO
Complex Plane, Magnitude Spectrum, Polar
Plot, Strip Chart, Trig Mode, Waveform
(Time), and Plotter Config.
