marker_options.hlp

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

{smcl}
{* 02mar2005}{...}
{cmd:help marker_options}
{hline}
{* index markers}{...}
{* index symbols, see markers}{...}
{* index mstyle() tt option}{...}
{* index msymbol() tt option}{...}
{* index mcolor() tt option}{...}
{* index msize() tt option}{...}
{* index mfcolor() tt option}{...}
{* index mlstyle() tt option}{...}
{* index mlwidth() tt option}{...}
{* index mlcolor() tt option}{...}

{title:Title}

{p2colset 5 27 29 2}{...}
{p2col :{hi:[G] {it:marker_options}} {hline 2}}Options for specifying markers{p_end}
{p2colreset}{...}


{title:Syntax}

	{it:marker_options}{col 38}description
	{hline 70}
	{cmdab:m:symbol:(}{it:{help symbolstyle}}{cmd:)}{...}
{col 34}shape of marker
	{cmdab:mc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 34}color of marker, inside and out
	{cmdab:msiz:e:(}{it:{help markersizestyle}}{cmd:)}{...}
{col 34}size of marker

	{cmdab:mfc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 34}inside or "fill" color

	{cmdab:mlc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 34}outline color
	{cmdab:mlw:idth:(}{it:{help linewidthstyle}}{cmd:)}{...}
{col 34}outline thickness
	{cmdab:mlsty:le:(}{it:{help linestyle}}{cmd:)}{...}
{col 34}thickness and color, overall style of outline

	{cmdab:msty:le:(}{it:{help markerstyle}}{cmd:)}{...}
{col 34}overall style of marker; all settings above
	{cmdab:psty:le:(}{it:{help pstyle}}{cmd:)}{...}
{col 34}overall plot style, including markerstyle

	{help advanced_options:{bf:recast(}{it:newplottype}{bf:)}}{...}
{col 34}advanced; treat plot as {it:newplottype}
	{hline 70}
{pin}
All options are {it:rightmost}; see {help repeated options}.

{pstd}
One example of each of the above is{cmd}

	    msymbol(O)       mfcolor(red)    mlcolor(olive)       mstyle(p1)
	    mcolor(green)                    mlwidth(thick)       mlstyle(p1)
	    msize(medium)                                    {txt}

{pstd}
Sometimes you may specify a list of elements, with the first element
applying to the first variable, the second to the second, and
so on.  See, for instance, {helpb scatter}.  One example would be

	    {cmd:msymbol(O o p)}
	    {cmd:mcolor(green blue black)}
	    {cmd:msize(medium medium small)}

	    {cmd:mfcolor(red red none)}

	    {cmd:mlcolor(olive olive green)}
	    {cmd:mlwidth(thick thin thick)}

	    {cmd:mstyle(p1 p2 p3)}
	    {cmd:mlstyle(p1 p2 p3)}

{pstd}
For information about specifying lists, see {it:{help stylelists}}.


{title:Description}

{pstd}
Markers are the ink used to mark where points are on a plot.
The important options are

	{cmd:msymbol(}{it:{help symbolstyle}}{cmd:)}                (choice of symbol)
	{cmd:mcolor(}{it:{help colorstyle}}{cmd:)}                  (choice of color)
	{cmd:msize(}{it:{help markersizestyle}}{cmd:)}              (choice of size)


{title:Options}

{phang}
{cmd:msymbol(}{it:symbolstyle}{cmd:)} specifies the shape of the marker
    and is one of the more commonly specified options.
    See {it:{help symbolstyle}} for more information on this important
    option.

{phang}
{cmd:mcolor(}{it:colorstyle}{cmd:)} specifies the color of the marker.
    This option sets both the color of the line used to outline the
    markers shape and the color of the inside of the marker.  Also
    see options {cmd:mfcolor()} and {cmd:mlcolor()} below.
    See {it:{help colorstyle}} for a list of color choices.

{phang}
{cmd:msize(}{it:markersizestyle}{cmd:)} specifies the size of the
    marker.
    See {it:{help markersizestyle}} for a list of size choices.

{phang}
{cmd:mfcolor(}{it:colorstyle}{cmd:)}
    specifies the color of the inside of the marker.
    See {it:{help colorstyle}} for a list of color choices.

{phang}
{cmd:mlcolor(}{it:colorstyle}{cmd:)},
{cmd:mlwidth(}{it:linewidthstyle}{cmd:)}, and
{cmd:mlstyle(}{it:linestyle}{cmd:)}
    specify the look of the line used to outline the shape of the
    marker.  See {help lines}, but note that you cannot change the line
    pattern of a marker.

{phang}
{cmd:mstyle(}{it:markerstyle}{cmd:)}
    specifies the overall look of markers, including as their shape, 
    their color, etc.  The other options allow you to change each attribute of
    the marker, but {cmd:mstyle()} is the point from which they start.

{pmore}
    You need not specify {cmd:mstyle()} just because there is something
    you want to change about the look of the marker and, in fact,
    most people seldom specify the {cmd:mstyle()} option.  You specify
    {cmd:mstyle()} when another style exists that is exactly what you
    desire or when another style would allow you to specify
    fewer changes to obtain what you want.

{pmore}
    See {it:{help markerstyle}} for a list of available marker styles.

{phang}
{cmd:pstyle(}{it:pstyle}{cmd:)}
    specifies the overall style of the plot, including not only the
    markerstyle, but the {it:{help markerlabelstyle}} and all other settings
    for the look of the plot.  Only the {it:{help markerstyle}} and 
    {it:{help markerlabelstyle}} affect the look of markers.
    See {it:{help pstyle}} for a list of available plot styles.

{phang}
{cmd:recast(}{it:newplottype}{cmd:)}
        is an advanced option allowing the plot to be recast from one type to
        another, for example, from a {help twoway scatter:scatter plot} to
        a {help twoway line:line plot}; see help 
        {it:{help advanced options}}.  Most, but not all, plots allow
        {cmd:recast()}.


{title:Remarks}

{pstd}
You will never need to specify all nine marker options, and seldom will you
even need to specify more than one or two of them.  Many people think
that there is just one important marker option,

	{cmd:msymbol(}{it:symbolstyle}{cmd:)}

{pstd}
{cmd:msymbol()} specifies the shape of the symbol; see
{it:{help symbolstyle}} for choice of symbol.
A few people would add to the important list a second option,

	{cmd:mcolor(}{it:colorstyle}{cmd:)}

{pstd}
{cmd:mcolor()} specifies the marker's color;
see {help colorstyle} for choice of color.
Finally, a very few would add

	{cmd:msize(}{it:markersizestyle}{cmd:)}

{pstd}
{cmd:msize()} specifies the marker's size; see {help markersizestyle}
for choice of sizes.

{pstd}
After that, we are really into the details.  One of the remaining options,
however, is of interest:

	{cmd:mstyle(}{it:markerstyle}{cmd:)}

{pstd}
A marker has a set of characteristics,

	{c -(}shape, color, size, inside details, outside details{c )-}

{pstd}
Each of the options other than {cmd:mstyle()} modifies something in that set.
{cmd:mstyle()} sets the values of the entire set.  It is from there that the
changes you specify are made.  See help {it:{help markerstyle}}.


{title:Also see}

{psee}
Manual:  {bf:[G] {it:marker_options}}

{psee}
Online:  
{it:{help symbolstyle}},
{it:{help colorstyle}},
{it:{help markersizestyle}},
{it:{help linewidthstyle}},
{it:{help linestyle}};
{it:{help markerstyle}}
{p_end}