procrustes_postestimation.hlp

是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到

{smcl}
{* 06apr2005}{...}
{cmd:help procrustes postestimation} {...}
{right:dialogs:  {bf:{dialog procrustes_p:predict}  {dialog procrustes_estat:estat}}}
{right:{bf:{dialog procoverlay}}   }
{right:also see:  {bf:{help procrustes}}    }
{hline}

{title:Title}

{p 4 40 2}
{hi:[MV] procrustes postestimation} {hline 2} Postestimation tools for
{cmd:procrustes}


{title:Description}

{pstd}
The following postestimation commands are of special interest after
{cmd:procrustes}:

{synoptset 19 tabbed}{...}
{p2coldent:command}description{p_end}
{synoptline}
{synopt:{helpb procrustes postestimation##estat:estat compare}}fit statistics
	for orthogonal, oblique, and unrestricted transformations{p_end}
{synopt:{helpb procrustes postestimation##estat:estat mvreg}}display
	multivariate regression resembling unrestricted transformation{p_end}
{synopt:{helpb procrustes postestimation##estat:estat summarize}}display
	summary statistics over the estimation sample{p_end}
{synopt:{helpb procrustes postestimation##procoverlay:procoverlay}}produce a
	Procrustes overlay graph{p_end}
{synoptline}
{p2colreset}{...}

{pstd}
In addition, the following postestimation commands are available:

{synoptset 19 tabbed}{...}
{p2coldent:command}description{p_end}
{synoptline}
{p2coldent:* {helpb estimates}}catalog estimation results{p_end}
{synopt:{helpb procrustes postestimation##predict:predict}}compute fitted values
	and residuals{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}
* All {helpb estimates} subcommands except {cmd:table} and {cmd:stats} are
available.
{p_end}


{title:Special-interest postestimation commands}

{pstd}
{cmd:estat} {cmd:compare}
displays a table with fit statistics of the three transformations provided
by {cmd:procrustes}: {cmd:orthogonal}, {cmd:oblique}, and {cmd:unrestricted}.
The two additional procrustes analyses are performed on the same sample as
the original procrustes analysis, and with the same options (as far as
relevant).  F-tests comparing the models are provided.

{pstd}
{cmd:estat} {cmd:mvreg}
produces the {helpb mvreg} output related to the unrestricted
Procrustes analysis (the {cmd:transform(unrestricted)} option of
{cmd:procrustes}).

{pstd}
{cmd:estat} {cmd:summarize}
displays summary statistics over the estimation sample of the target and
source variables ({it:varlist_y} and {it:varlist_x}).

{pstd}
{cmd:procoverlay}
displays a plot of the target variables overlaid with the fitted values
derived from the source variables.  If there are more than two target
variables, multiple plots are layed out in one graph.


{marker predict}{...}
{title:Syntax for predict}

{p 8 16 2}
{cmd:predict} {dtype} {newvar:list} {ifin} [{cmd:,} {it:statistic} ]

{synoptset 13 tabbed}{...}
{synopthdr:statistic}
{synoptline}
{syntab:Main}
{synopt:{opt fit:ted}}(specify #y vars) fitted  values
	{bf:1} {bf:c}' + rho {bf:X} {bf:A}}; the default{p_end}
{synopt:{opt res:iduals}}(specify #y vars) unstandardized residuals{p_end}
{synopt:{opt q}}(specify one var) residual sum of squares over the target
	variables{p_end}
{synoptline}
INCLUDE help esample


{title:Options for predict}

{dlgtab:Main}

{phang}{opt fitted}, the default,
computes fitted values, i.e., the least squares approximations of the target
({it:varlist_y}) variables.  You have to specify the same number of new
variables as there are target variables.

{phang}{opt residuals}
computes the raw (unstandardized) residuals for each of the target
({it:varlist_y}) variables.  You have to specify the same number of new
variables as there are target variables.

{phang}{opt q}
computes the residual sum of squares over all variables, i.e., the squared
Euclidean distance between the target and transformed source points.  Specify
one new variable.


{marker estat}{...}
{title:Syntax for estat}

{pstd}
Table of fit statistics

{p 8 14 2}
{cmd:estat} {cmdab:co:mpare} [{cmd:,} {opt det:ail} ]

{pstd}
Comparison of {cmd:mvreg} and {cmd:procrustes} output

{p 8 14 2}
{cmd:estat} {cmdab:mv:reg} [{cmd:,} {it: mvreg_options} ]

{pstd}
Display summary statistics

{p 8 14 2}
{cmd:estat} {cmdab:su:mmarize}
	[{cmd:,}
		{opt lab:el}
		{opt nohea:der}
		{opt nowei:ghts}
	]


{title:Options for estat}

{phang}
{opt detail}, an option with {cmd:estat compare}, displays the standard
{cmd:procrustes} output for the two additional transformations.

{phang}
{it:mvreg_options}, allowed with {cmd:estat mvreg}, are any of the options
allowed by {helpb mvreg}.  Note that the constant is already suppressed if the
procrustes analysis suppressed it.

{phang}
{opt label}, {opt noheader}, and {opt noweights} are the same as for the
generic {cmd:estat} {cmd:summarize} command; see {helpb estat}.


{marker procoverlay}{...}
{title:Syntax for procoverlay}

{p 8 20 2}
{cmd:procoverlay} {ifin} [{cmd:,} {it:procoverlay_options} ]

{synoptset 27 tabbed}{...}
{synopthdr:procoverlay_options}
{synoptline}
{syntab:Main}
{synopt:{opt auto:aspect}}adjust aspect ratio based on the data; default
	aspect ratio is 1{p_end}
{synopt:{opth target:opts(procrustes_postestimation##targetopts:target_opts)}}affect the rendition of the target{p_end}
{synopt:{opth source:opts(procrustes_postestimation##sourceopts:source_opts)}}affect the rendition of the source{p_end}

{syntab:Y-Axis, X-Axis, Title, Caption, Legend, Overall}
{synopt:{it:{help twoway_options}}}any options other than {opt by()} documented
	in {bind:{bf:[G] {it:twoway_options}}}{p_end}

{syntab:By}
{synopt:{opth byo:pts(by_option)}}affect the
	rendition of combined graphs{p_end}
{synoptline}

{marker targetopts}{...}
{synopthdr:target_opts}
{synoptline}
{syntab:Main}
{synopt:{opt nolab:el}}removes the default observation label from the
	target{p_end}
{synopt:{it:{help marker_options}}}change look of markers 
	(color, size, etc.){p_end}
{synopt:{it:{help marker_label_options}}}change 
	look or position of marker labels{p_end}
{synoptline}

{marker sourceopts}{...}
{synopthdr:source_opts}
{synoptline}
{syntab:Main}
{synopt:{opt nolab:el}}removes the default observation label from the
	source{p_end}
{synopt:{it:{help marker_options}}}change look of markers 
	(color, size, etc.){p_end}
{synopt:{it:{help marker_label_options}}}change 
	look or position of marker labels{p_end}
{synoptline}
{p2colreset}{...}


{title:Options for procoverlay}

{dlgtab:Main}

{phang}{opt autoaspect}
specifies that the aspect ratio is to be automatically adjusted based on the
range of the data to be plotted.  This option can make some {cmd:procoverlay}
plots more readable.  By default, {cmd:procoverlay} uses an aspect ratio of
one, producing a square plot.

{pmore}
As an alternative to {opt autoaspect}, the {it:twoway_option}
{help aspect_option:aspectratio()} can be used to override the default
aspect ratio.  {cmd:procoverlay}
accepts the {cmd:aspectratio()} option as a suggestion only, and will override
it when necessary to produce plots with balanced axes, i.e., distance on the
{it:x}-axis equals distance on the {it:y}-axis.

{pmore}
{it:{help twoway_options}} such as {cmd:xlabel()},
{cmd:xscale()}, {cmd:ylabel()}, and {cmd:yscale()} should be used with
caution.  These options are accepted, but may have unintended side effects on
the aspect ratio.

{phang}{opt targetopts(target_options)}
affect the rendition of the target plot.  The following {it:target_options}
are allowed:

{phang2}
{opt nolabel}
removes the default target observation label from the graph.

{phang2}
{it:marker_options}
affect the rendition of markers drawn at the plotted points, including
their shape, size, color, and outline; see {it:{help marker_options}}.

{phang2}
{it:marker_label_options}
specify if and how the markers are to be labeled; see
{it:{help marker_label_options}}.

{phang}{opt sourceopts(source_options)}
affect the rendition of the source plot.  The following {it:source_options}
are allowed:

{phang2}
{opt nolabel}
removes the default source observation label from the graph.

{phang2}
{it:marker_options}
affect the rendition of markers drawn at the plotted points, including
their shape, size, color, and outline; see {it:{help marker_options}}.

{phang2}
{it:marker_label_options}
specify if and how the markers are to be labeled; see
{it:{help marker_label_options}}.

{dlgtab:Y-Axis, X-Axis, Title, Caption, Legend, Overall}

{phang}
{it:twoway_options} are any of the options documented in 
{it:{help twoway_options}}, excluding {cmd:by()}.  These include options for
titling the graph (see {it:{help title_options}}) and options for saving the
graph to disk (see {it:{help saving_option}}).

{pmore}
See {opt autoaspect} above for a warning against using options
such as {cmd:xlabel()}, {cmd:xscale()}, {cmd:ylabel()}, and {cmd:yscale()}.

{dlgtab:By}

{phang}
{marker byopts}
{opt byopts(by_option)}
is documented in {it:{help by_option}}.  This option affects the appearance
of the combined graph and is ignored unless there are more than two target
variables specified in {cmd:procrustes}.


{title:Examples}

    {cmd:. procrustes (y1 y2 y3) (x1 x2 x3), transform(ortho)}

    {cmd:. procoverlay}

    {cmd:. estat compare}
    {cmd:. estat summ}

    {cmd:. predict yh1 yh2 yh3, fitted}
    {cmd:. predict res1 res2 res3, residual}
    {cmd:. predict qpro, q}


{title:See also}

{psee}
Manual:  {bf:[MV] procrustes postestimation}
{p_end}

{psee}
Online:  {helpb procrustes};{break}
{help mvreg}
{p_end}