The R Project SVN R

Rev

Rev 81657 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
89889 hornik 1 
<!DOCTYPE html>
2 
<html lang="en">
80928 hornik 3 
<head>
14947 duncan 4 
<title>Testing the Embeddable R library</title>
89889 hornik 5 
<link rel=stylesheet href="../../doc/html/R.css">
14947 duncan 6 
</head>
7 
 
8 
<body>
9 
<h1>Test the Embeddable R Library</h1>
10 
 
80928 hornik 11 
<p>
14947 duncan 12 
This a collection of tests for verifying that using R as a library
13 
within another application (i.e. embedded R) works for this
14 
installation. This is only relevant if one has configured R with the
15 
<code>--enable-R-shlib </code> argument for the top-level
80928 hornik 16 
<code>configure</code>.
17 
</p>
14947 duncan 18 
 
19 
<p>
20 
More information can be found at the
70260 ripley 21 
<a href="https://developer.r-project.org/embedded.html">R Developers' site</a>
80928 hornik 22 
</p>
14947 duncan 23 
 
24 
<h3>Test Applications</h3>
25 
<dl>
26 
  <dt>
80928 hornik 27 
    <a href="Rtest.c">Rtest</a>
28 
  </dt>
14947 duncan 29 
  <dd>
80928 hornik 30 
    Just prints the vector <code>c(1, 2, ..., 10)</code>
31 
  </dd>
14947 duncan 32 
  <dt>
80928 hornik 33 
    <a href="Rplot.c">Rplot</a>
34 
  </dt>
35 
  <dd>
36 
    Creates a basic plot of  <code>c(1,2,..., 10)</code>
37 
    in the default device and then quits immediately.
38 
  </dd>
14947 duncan 39 
  <dt>
80928 hornik 40 
    <a href="Rpostscript.c">Rpostscript</a>
41 
  </dt>
14947 duncan 42 
  <dd>
80928 hornik 43 
    Produces a plot of <code>1:100</code> using the Postscript
44 
    graphics device. This creates a file named <code>Rplots.ps</code>
45 
  </dd>
14947 duncan 46 
  <dt>
80928 hornik 47 
    <a href="Rerror.c"> Rerror</a>
48 
  </dt>
49 
  <dd>
50 
    Reads a function definition from an external file
51 
    (<a href="code.R"><code>code.R</code></a>) and calls it
52 
    which in turn generates an "error" via <code>stop()</code>.
53 
    The local error handler defined for this application
54 
    catches this error and recovers.
55 
  </dd>
14947 duncan 56 
  <dt>
80928 hornik 57 
    <a href="RNamedCall.c">RNamedCall</a>
58 
  </dt>
59 
  <dd>
60 
    Calls a function with some named arguments.
61 
  </dd>
14947 duncan 62 
  <dt>
80928 hornik 63 
    <a href="RParseEval.c">RParseEval</a>
64 
  </dt>
65 
  <dd>
66 
    Parses a string and evaluates the resulting expression(s).
67 
  </dd>
14947 duncan 68 
  <dt>
80928 hornik 69 
    <a href="Rpackage.c">Rpackage</a>
70 
  </dt>
71 
  <dd>
72 
    Invokes <code>example()</code> for functions in ctest and mva
73 
    to ensure that packages can be loaded into R in an embedded
74 
    context.  These packages must be linked against libR.so.
75 
  </dd>
14947 duncan 76 
  <dt>
80928 hornik 77 
    <a href="embeddedRCall.c">embeddedRCall.c</a>
78 
  </dt>
79 
  <dd>
80 
    Collection of routines used in the different tests.
81 
  </dd>
14947 duncan 82 
  <dt>
80928 hornik 83 
    Other Tests
84 
  </dt>
14947 duncan 85 
  <dd>
80928 hornik 86 
    This has been tested in many  other situations including the some of
81657 ripley 87 
    the former Omegahat packages:
80928 hornik 88 
    <ul>
89 
      <li>
81657 ripley 90 
	As a procedural language within <a href="https://www.postgresql.org">Postsgres</a>.
91 
	See <a href="https://www.omegahat.net/DBMS/Postgres/R/RPostgres.pdf">R
80928 hornik 92 
	in Postgres</a>
93 
      </li>
94 
      <li>
81657 ripley 95 
	<a href="https://www.omegahat.net/RSJava">SJava</a>
80928 hornik 96 
      </li>
97 
      <li>
81657 ripley 98 
	<a href="https://www.omegahat.net/SNetscape">SNetscape</a>
80928 hornik 99 
      </li>
100 
      <li>
81657 ripley 101 
	<a href="https://www.omegahat.net/SXalan">SXalan</a>
80928 hornik 102 
      </li>
103 
      <li>
81657 ripley 104 
	<a href="https://www.omegahat.net/RSPython">RSPython</a>
80928 hornik 105 
      <li>
81657 ripley 106 
	<a href="https://www.omegahat.net/SXalan">SXalan</a>
80928 hornik 107 
      </li>
108 
      <li>
81657 ripley 109 
	<a href="https://www.omegahat.net/RSPerl">RSPerl</a>
80928 hornik 110 
      </li>
111 
    </ul>
112 
    These can be used as example code for embedding R within other
113 
    applications.
114 
  </dd>
14947 duncan 115 
</dl>
116 
 
89889 hornik 117 
<hr>
80928 hornik 118 
 
119 
</body>
120 
</html>