fields/currentHelp/pushpin.html at master · NCAR/fields · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Adds a &quot;push pin&quot; to an existing 3-d plot</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="R.css" />
</head><body>

<table width="100%" summary="page for pushpin {fields}"><tr><td>pushpin {fields}</td><td style="text-align: right;">R Documentation</td></tr></table>

<h2> Adds a &quot;push pin&quot; to an existing  3-d plot</h2>

<h3>Description</h3>

<p>Adds  to an existing 3-d perspective plot
a push pin to locate a  specific point.</p>


<h3>Usage</h3>

<pre>
pushpin( x,y,z,p.out, height=.05,col="black",text=NULL,adj=-.1,cex=1.0,...)
</pre>


<h3>Arguments</h3>

<table summary="R argblock">
<tr valign="top"><td><code>x</code></td>
<td>
<p>x location</p>
</td></tr>
<tr valign="top"><td><code>y</code></td>
<td>
<p>y location</p>
</td></tr>
<tr valign="top"><td><code>z</code></td>
<td>
<p>z location</p>
</td></tr>
<tr valign="top"><td><code>p.out</code></td>
<td>
<p>Projection information returned by persp</p>
</td></tr>
<tr valign="top"><td><code>height</code></td>
<td>
<p>Height of pin in device coordinates (default is about
5% of the vertical distance ). </p>
</td></tr>
<tr valign="top"><td><code>col</code></td>
<td>
<p>Color of pin head.</p>
</td></tr>
<tr valign="top"><td><code>text</code></td>
<td>
<p>Optional text to go next to pin head.</p>
</td></tr>
<tr valign="top"><td><code>adj</code></td>
<td>
<p>Position of text relative to pin head.</p>
</td></tr>
<tr valign="top"><td><code>cex</code></td>
<td>
<p>Character size for pin head and/or text</p>
</td></tr>
<tr valign="top"><td><code>...</code></td>
<td>
<p>Additional graphics arguments that are passed to the text
function.</p>
</td></tr>
</table>


<h3>Details</h3>

<p>See the help(text) for the conventions on
the <code>adj</code> argument and other options for placing text.
</p>


<h3>Author(s)</h3>

<p>Doug Nychka</p>


<h3>See Also</h3>

<p>drape.plot,persp</p>


<h3>Examples</h3>

<pre>
# Dr. R's favorite New  Zealand Volcano!
     data( volcano)
     M&lt;- nrow( volcano)
     N&lt;- ncol( volcano)
     x&lt;- seq( 0,1,,M)
     y&lt;- seq( 0,1,,N)

     drape.plot( x,y,volcano, col=terrain.colors(128))-&gt; pm

     max( volcano)-&gt; zsummit
     xsummit&lt;- x[ row( volcano)[volcano==zsummit]]
     ysummit&lt;- y[ col( volcano)[volcano==zsummit]]

pushpin( xsummit,ysummit,zsummit,pm, text="Summit")

</pre>

<hr /><div style="text-align: center;">[Package <em>fields</em> version 9.9 <a href="00Index.html">Index</a>]</div>
</body></html>