dot | Command || Coef View | Graph Command | Group View | Matrix View | Rowvector View | Series View | Sym View | Vector View |

Display a dot plot graph view.

A dot plot is a symbol only version of the line and symbol graph that uses circles to represent the value of each observation.

Syntax

dot(options) o1 [o2 o3 ... ]

object_name.dot(options) [categorical_spec(arg)]

where o1, o2, ..., are series or group objects.

Following the dot keyword, you may specify general graph characteristics using options. Available options include multiple graph handling, dual scaling, template application, data contraction, adding axis extensions, and rotation.

Options

Scale options

a (default) | Automatic single scale. |

d | Dual scaling with no crossing. The first series or column is scaled on the left and all other series or columns are scaled on the right. |

x | Dual scaling with possible crossing. See the “d” option. |

n | Normalized scale (zero mean and unit standard deviation). May not be used with the “s” option. |

rotate | Rotate the graph so the observation axis is on the left. |

ab=type | Add axis border along data scale, where type may be “hist” or “h” (histogram), “boxplot” or “b”, “kernel” or “k”. (Note: axis borders are not available for panel graphs with “panel=” options that involve summaries: mean, median, etc.) |

Multiple series options (categorical graph settings will override these options)

m | Plot dot plots in multiple graphs (will override the “s” option). |

s | Stacked dot plot. Each dot represents the cumulative total of the series or columns listed. The difference between dots corresponds to the value of a series or column. |

Template and printing options

o=template | Use appearance options from the specified template. template may be a predefined template keyword (“default” - current global defaults, “classic”, “modern”, “reverse”, “midnight”, “spartan”, “monochrome”) or a graph in the workfile. |

t=graph_name | Use appearance options and copy text and shading from the specified graph. |

b / -b | [Apply / Remove] bold modifiers of the base template style specified using the “o=” option above. |

w / -w | [Apply / Remove] wide modifiers of the base template style specified using the “o=” option above. |

reset | Resets all graph options to the global defaults. May be used to remove existing customization of the graph. |

p | Print the graph. |

The options which support the “–” may be preceded by a “+” or “–” indicating whether to turn on or off the option. The “+” is optional.

Graph data options

The following option is available in non-panel or categorical graph settings:

contract=key | Contract the data as specified by key, where key may be: “mean”, “median”, “max”, “min”, “sum”, “var” - variance, “sd” - standard deviation, “sumsq” - sum of the squared values, “skew” - skewness, “kurt” - kurtosis, “nas” - number of missing values, “obs” - number of observations, “unique” - error if the series is not identical for all observations in a given group, “first” - first observation in category using workfile order, “last” - last observation in category using workfile order, “quant(quantile)” - where quantile is a number between 0 and 1. |

Panel options

The following option applies when graphing panel structured data:

panel=arg (default taken from global settings) | Panel data display: “stack” (stack the cross-sections), “individual” or “i” (separate graph for each cross-section), “combine” or “c” (combine cross-section graphs in a single frame), “mean” (plot means across cross-sections), “median” (plot median across cross-sections). (Note: more general versions of these panel graphs may be constructed as categorical graphs.) |

Categorical graph options

These options only apply to categorical graphs (“Categorical Spec”) where the graph has one or more within factors and a contraction method other than raw data (see the “contract” option above).

favorlegend | Favor the use of legends over axis labels to describe categories. |

elemcommon = int | Specifies the number of within factors for which the graph uses common area colors. For example, with multiple within dimensions, if “elemcommon=1”, then only categories defined by the first within factor will have common colors. If “elemcommon=2”, then categories defined by the first two within factors will have common colors. If “elemcommon=0”, all areas will have different colors. The default is one less than the number of within factors. |

Examples

Basic examples

dot(rotate) oldsales newsales

displays rotated dotplots of OLDSALES and NEWSALES.

pop.dot

displays a dotplot graph of the series POP.

group mygrp oldsales newsales

mygrp.dot(m)

displays dotplots of each series in MYGRP, each in its own frame.

mygrp.dot(o=midnight, b)

creates a bar graph of MYGRP, using the settings of the predefined template “midnight”, applying the bold modifier.

mygrp.dot(rotate, contract=median)

displays a rotated dotplot of the medians of OLDSALES and NEWSALES.

Panel examples

ser1.dot(panel=individual)

displays dotplots for each cross-section in a separate frame, while,

ser1.dot(panel=mean)

displays a dotplot of the means for each period computed across cross-sections.

ser1.dot(panel=combine)

shows the dotplots for each cross-section in the same graph frame, with different symbols and colors for each cross-section.

Categorical spec examples

ser1.dot across(firm, dispname)

displays a categorical dotplot graph of SER1 using distinct values of FIRM to define the categories, and displaying the resulting graphs in multiple frames.

ser1.dot across(firm, dispname, iscale)

shows the same graph with individual scaling for each of the frames.

ser1.dot within(firm, inctot, label=value)

displays a graph categorized by firm (with an added category for the total), with all of the graphs in a single frame and the category value used as labels.

ser1.dot across(firm, dispname) within(income, bintype=quant, bincount=4)

constructs a categorical dotplot graph with FIRM defining the across dimension, and INCOME defining the within dimension. Observations will be classified in the within dimension using the quartiles of INCOME.

ser1.dot(contract=mean, elemcommon=1) within(sex) within(union)

creates a dotplot of mean values of within categories based on both SEX and UNION. Categories within the more slowly varying SEX factor will be drawn using the same symbol and color, while the distinct elements of UNION will employ different symbols and colors.

Cross-references

See “Graphing Data” for a detailed discussion of graphs in EViews, and “Templates” for a discussion of graph templates. See Graph::graphfor graph declaration and other graph types.