graph_drop.hlp

来自「是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到」· HLP 代码 · 共 136 行

{smcl}
{* 05mar2005}{...}
{cmd:help graph drop} {right:dialog:  {bf:{dialog graph_drop:graph drop}}}
{hline}
{* index graph drop tt}{...}
{* index graph combine tt}{...}
{* index dropping graphs}{...}
{* index erasing graph files}{...}
{* index discard tt, relationship to graph drop}{...}

{title:Title}

{p2colset 5 23 25 2}{...}
{p2col :{hi:[G] graph drop} {hline 2}}Drop graphs from memory{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 23 2}
{cmdab:gr:aph}
{cmd:drop}
{it:name}
[{it:name} ...]

{p 8 23 2}
{cmdab:gr:aph}
{cmd:drop}
{cmd:_all}


{title:Description}

{pstd}
{cmd:graph drop} {it:name} drops (discards) the specified
graphs from memory and closes any associated graph windows.

{pstd}
{cmd:graph} {cmd:drop} {cmd:_all} drops all graphs from memory and closes all
associated graph windows.


{title:Remarks}

{pstd}
See {help graph manipulation} for an introduction to the graph
manipulation commands.

{pstd}
Remarks are presented under the headings

	{help graph drop##remarks1:Typical use}
	{help graph drop##remarks2:Relationship between graph drop _all and discard}
	{help graph drop##remarks3:Erasing graphs on disk}


{marker remarks1}{...}
{title:Typical use}

{pstd}
Graphs contain the data they display, so, when datasets are large, graphs have
the potential to consume considerable amounts of memory.  {cmd:graph}
{cmd:drop} frees that memory.  Remember that {cmd:Graph} is the name of a
graph when you do not specify otherwise.

{phang2}
	{cmd:. graph twoway scatter faminc educ, ms(p)}

	{cmd:.} ...

	{cmd:. graph drop Graph}

{pstd}
We often use graphs in memory to prepare the pieces for {cmd:graph}
{cmd:combine}:

	{cmd:. graph} ... {cmd:,} ... {cmd:name(p1)}

	{cmd:. graph} ... {cmd:,} ... {cmd:name(p2)}

	{cmd:. graph} ... {cmd:,} ... {cmd:name(p3)}

{phang2}
	{cmd:. graph combine p1 p2 p3,} ... {cmd:saving(result, replace)}

	{cmd:. graph drop _all}


{marker remarks2}{...}
{title:Relationship between graph drop _all and discard}

{pstd}
The {cmd:discard} command performs {cmd:graph} {cmd:drop} {cmd:_all} and
more:

{phang2}
    1.  {cmd:discard} eliminates prior estimation results and
	automatically loaded programs, and thereby frees even more memory.

{phang2}
    2.  {cmd:discard} closes any open dialog boxes and thereby frees
	even more memory.

{pstd}
We nearly always type {cmd:discard} in preference to {cmd:graph}
{cmd:drop} {cmd:_all} if only because {cmd:discard} has fewer characters.
The exception to that is when we have fitted a model and still
plan on redisplaying prior results, performing tests on that model,
or referring to {cmd:_b[]}, {cmd:_se[]}, etc.

{pstd}
See {helpb discard} for a description of the {cmd:discard} command.


{marker remarks3}{...}
{title:Erasing graphs on disk}

{pstd}
{cmd:graph} {cmd:drop} is not used to erase {cmd:.gph} files; instead, use
Stata's standard {cmd:erase} command:

	{cmd:. erase matfile.gph}


{title:Also see}

{psee}
Manual:  {bf:[G] graph drop}

{psee}
Online:  
{help graph manipulation};
{helpb discard},
{helpb erase}
{p_end}