*! version 1.2.1 07mar2013

Title

tesensitivity cpiplot -- plot results of conditional partial independence analysis

Syntax

tesensitivity cpiplot [estimates]
[,
display_options formatting_options]

estimates is a list of stored results from calls to tesensitivity cpi
if this is not specified, the estimation results in memory are used.

display_options

nobreakdown suppress horizontal line for the breakdown point

creflines display a vertical line for maximum propensity score deviation associated with each covariate (see details)

display_options control the elements of the graph to be included.

formatting_options

boundpatterns(pattern_list) specify line patterns for bound lines

boundcolors(color_list) specify line colors for bound lines

boundoptions(connect_options) additional options for bound lines

breakdownoptions(added_line_options) additional options for breakdown analysis conclusion line

legoptions(legend_options) formatting options for legend

nolegend suppress legend

twoway_options formatting options for overall plot

formatting_options control the style of the graph.

Desciption

tesensitivity cpiplot is a post estimation command that plots results
from a call to tesensitivity cpi. By default
a plot is produced showing the upper and lower bounds of the statistic given
in the last call against values of c-dependence ranging from 0 to 1.
Points in the grid of c-dependence values specified in the call to
tesensitivity cpi are plotted with a linear
interpolation between them. If multiple estimates are included, then bounds
for all estimates are plotted on the same graph. The graph is produced using
Stata's graph twoway command, and formatting can be controlled by passing
options to that command through the interface provided by this command.

Options

Display options

nobreakdown if this option is not chosen, a horizontal line is drawn at the
value of the breakdown analysis conclusion (e.g., ATE > 0). Note: currently, if
multiple estimates are plotted, only the breakdown point conclusion
for the last estimate is plotted. Therefore, it is recommended to only include the breakdown
line with multiple estimates when the same breakdown analysis conclusion is used for each
estimate.

creflines include vertical line for the maximum propensity score deviation
associated with each covariate. These are the calculated by
tesensitivity cscale, cmax. See the help file
for that command for details on the interpretation of these lines. Note: in order
to use this option, tesensitivity cpi must have been called with the option
creference.

Formatting options

boundpatterns(pattern_list) bounds for each of the estimates are
plotted using these patterns. pattern_list is a list of up to 8 linepatternstyles
separated by spaces. If only one pattern is specified it is used for all
estimates.

boundcolors(color_list) bounds for each of the estimates are
plotted using these colors. color_list is a list of up to 8 colorstyles
separated by spaces. If only one pattern is specified it is used for all
estimates.

boundoptions(connect_options) bound lines for all estimates
are plotted with these options. Any options in connect_options
may be included except for lpattern and lcolor.

breakdownoptions(added_line_options) a horizontal line at the
breakdown analysis conclusion is plotted with these display options. Any suboptions to
added_line_options may be included.

legoptions(legend_options) by default, a legend is added to the
plot if multiple estimates are included or if the creflines is specified.
This option can be used to control the formatting of the legend in either case.
Any legend_options can be included except order or label.

nolegend suppresses the legend.

twoway_options any additional twoway_options to
Stata's twoway command may be included except for legend_options

Remarks

See here for links to the articles
this package is based on, more detailed documentation on the implementation in
this package, and examples of its use.

Examples

. sysuse lalonde1986, clear

Loads LaLonde (1986) dataset included with tesensitivity package.

. qui tesensitivity cpi (re78 age education) (treat age education) if sample1, ate

. qui estimates store ate_sample1

. qui tesensitivity cpi (re78 age education) (treat age education) if sample3, ate

. qui estimates store ate_sample3

Calculates bounds of the ATE for two samples and stores them.

. tesensitivity cpiplot ate_sample1 ate_sample3

Produces a graph comparing the how the bounds on the ATE for the
two samples vary with the level of c-dependence.

For more examples see this vignette.