mata_describe.hlp

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

{smcl}
{* 31mar2005}{...}
{cmd:help mata describe}
{hline}
{* index mata tt}{...}
{* index describe tt}{...}
{* index .mlib library files}{...}

{title:Title}

{p 4 4 2}
{bf:[M-3] mata describe -- Describe contents of Mata's memory}


{title:Syntax}

{p 8 16 2}
: {cmd:mata} {cmdab:d:escribe} 
[{it:namelist}] 
[{cmd:,} 
{cmd:all} 
]

{p 8 16 2}
: {cmd:mata} {cmdab:d:escribe} 
{cmd:using} {it:libname}


{p 4 4 2}
where {it:namelist} is as defined in 
{bf:{help m3_namelists:[M-3] namelists}}.
If {it:namelist} is not specified, "{cmd:*} {cmd:*()}" is assumed.

{p 4 4 2}
This command is for use in Mata mode following Mata's colon prompt.
To use this command from Stata's dot prompt, type

		. {cmd:mata: mata describe} ...


{title:Description}

{p 4 4 2}
{cmd:mata} {cmd:describe} 
lists the names of the matrices and functions in memory, including 
the amount of memory consumed by each.

{p 4 4 2}
{cmd:mata} {cmd:describe} {cmd:using} {it:libname}
describes the contents of the specified .mlib library; 
see {bf:{help mata_mlib:[M-3] mata mlib}}.


{title:Option}

{p 4 8 2}
{cmd:all} specifies that automatically loaded library functions that 
happen to be in memory are to be included in the output.


{title:Remarks}

{p 4 4 2}
{cmd:mata describe} is often issued without arguments, and in that case, 
everything in memory is described:

	: {cmd:mata describe}

	      {txt}# bytes   type                        name and extent
	{hline 69}
	{res}           50   {txt}real matrix                 {res}foo{txt}()
	{res}        1,600   {txt}real matrix                 {res}X{txt}[10,20]
	{res}            8   {txt}real scalar                 {res}x
	{txt}{hline 69}

{p 4 4 2}
{cmd:mata describe using} {it:libname} lists the functions stored in an 
.mlib library:

	: {cmd:mata describe using lmatabase}

	      {txt}# bytes   type                        name and extent
	{hline 69}
	{res}          496   {txt}auto numeric vector         {res}Corr{txt}()
	{res}          170   {txt}auto real matrix            {res}Hilbert{txt}()
	{it:(output omitted)}
	{res}          170   {txt}auto transmorphic colvector {res}vech{txt}()
	
	{txt}{hline 69}


{title:Diagnostics}

{p 4 4 2}
The reported memory usage does not include overhead, which usually amounts 
to 64 bytes, but can be less (as small as zero in the case of recently 
used scalars).

{p 4 4 2}
The reported memory usage in the case of pointer matrices reflects the 
memory used to store the matrix itself and does not include memory 
consumed by siblings.


{title:Also see}

{p 4 13 2}
Manual:  {hi:[M-3] mata describe}

{p 4 13 2}
Online:  help for 
{bf:{help mf_sizeof:[M-5] sizeof()}};
{bf:{help m3_intro:[M-3] intro}}
{p_end}