R.NET使用文档

偏执的太偏执、 2022-07-14 06:55 246阅读 0赞

# R.NET使用文档 #

### 介绍 ###

本页面涉及R.NET1.5.13。 1.5.13版本在功能上等同于1.5.12，但可作为一个包在NuGet.org上获得。

R[.NET][]使.NET框架与R统计语言在同一进程进行互操作。 R[.Net][.NET]需要.NET Framework 4的并有R环境中安装的本地的DLL。您可以使用R.NET用在.NET的任何语言（它已被用于至少C＃，F＃，Vb.NET，IronPython中）。你使用这个文档之前有几个相关的事项都必须被提及。对于F＃，你应该考虑F＃ - \[R提供商。一个动机释放1.5.13对于RProvider更轻松地管理R.NET依赖。

### 入门 ###

这个网页主要介绍R.NET是众所周知的跨平台运行。   
作为1.5.10版本，R.NET二进制文件是平台无关的。您可能需要设置一些[Linux][]发行版的小附加的解决方法（CentOS的是已知的），但你可以使用的。R.NET二进制文件来移动和跨平台。

### Visual Studio中 ###

如果您正在使用从zip文件分发二进制文件，解压缩文件和内容复制到您选择的位置。添加项目引用到RDotNet.dll和RDotNet.Native.dll“通常”的方式。

### NuGet是首选的方式来管理R.NET依赖性。 ###

### 如果您正在使用的NuGet包： ###

首先，您必须安装，如果你有没有准备好，通过工具的的NuGet包管理器 - 扩展和更新：

### Visual Studio中 ###

如果您正在使用从zip文件分发二进制文件，解压缩文件和内容复制到您选择的位置。添加项目引用到RDotNet.dll和RDotNet.Native.dll“通常”的方式。

的NuGet是首选的方式来管理R.NET依赖性。

如果您正在使用的NuGet包：

首先，您必须安装，如果你有没有准备好，通过工具的的NuGet包管理器 - 扩展和更新：

您可以添加R.NET包作为一个依赖于一个或多个项目在您的解决方案。对于一个项目：

请注意，你或许应该卸载软件包的依赖或R.NET1.5.5或更早的版本，如果预先存在的。

R.NET1.5.13使用不同的包装标识：R.NET.Community。请务必使用搜索R.NET上的NuGet最近条目：

该系统的NuGet然后增加了一些依赖。

您可以一气呵成的解决方案级别管理的几个项目：

你可以找到有关的NuGet在文档的NuGet更一般的信息   
[http://docs.nuget.org/][http_docs.nuget.org]

### 入门编码 ###

R.NET1.5.10及以后的版本包括显著明显的变化，以缓解2块绊脚石，处理方式往往是由用户处理：路径与R共享库，并防止发动机多初始化。

下面的“Hello World”示例说明了如何使用新的API为90％的在Windows窗体上使用的情况下更简单：

static void Main(string[] args) { REngine.SetEnvironmentVariables(); // <-- May be omitted; the next line would call it. REngine engine = REngine.GetInstance(); // A somewhat contrived but customary Hello World: CharacterVector charVec = engine.CreateCharacterVector(new[] { "Hello, R world!, .NET speaking" }); engine.SetSymbol("greetings", charVec); engine.Evaluate("str(greetings)"); // print out in the console string[] a = engine.Evaluate("'Hi there .NET, from the R engine'").AsCharacter().ToArray(); Console.WriteLine("R answered: '{0}'", a[0]); Console.WriteLine("Press any key to exit the program"); Console.ReadKey(); engine.Dispose(); } 
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14
       15
       16
       17
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14
       15
       16
       17

您检索单个REngine对象实例，设置必要的环境变量之后。甚至调用SetEnvironmentVariables可以省略，但我们会建议你把它明确。 SetEnvironmentVariables，在Windows上，着眼于建立是R安装程序的注册表设置。如果需要，您可以覆盖行为设置环境变量和发动机初始化用自己的方式，在附录中详细说明。

### 示例代码 ###

你通常与REngine对象交互的方法是Evaluate，GetSymbol和SetSymbol。创建R向量和矩阵，所述REngine对象具有扩展方法如CreateNumericVector，CreateCharacterMatrix等。最后，可以以各种方式调用R里面的函数，使用Evaluate方法执行REngine对象，并且还更直接。   
基本的例子采用t-test统计

它是可从示例代码在：[https://github.com/jmp75/rdotnet-onboarding][https_github.com_jmp75_rdotnet-onboarding]获取。

static void Main(string[] args) { REngine.SetEnvironmentVariables(); REngine engine = REngine.GetInstance(); // REngine requires explicit initialization. // You can set some parameters. engine.Initialize(); // .NET Framework array to R vector. NumericVector group1 = engine.CreateNumericVector(new double[] { 30.02, 29.99, 30.11, 29.97, 30.01, 29.99 }); engine.SetSymbol("group1", group1); // Direct parsing from R script. NumericVector group2 = engine.Evaluate("group2 <- c(29.89, 29.93, 29.72, 29.98, 30.02, 29.98)").AsNumeric(); // Test difference of mean and get the P-value. GenericVector testResult = engine.Evaluate("t.test(group1, group2)").AsList(); double p = testResult["p.value"].AsNumeric().First(); Console.WriteLine("Group1: [{0}]", string.Join(", ", group1)); Console.WriteLine("Group2: [{0}]", string.Join(", ", group2)); Console.WriteLine("P-value = {0:0.000}", p); // you should always dispose of the REngine properly. // After disposing of the engine, you cannot reinitialize nor reuse it engine.Dispose(); } 
     
      
       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
      
     
      
       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

### 数字向量 ###

下面的代码示例说明了最常用的功能。它是从样本代码2萃取在[https://github.com/jmp75/rdotnet-onboarding][https_github.com_jmp75_rdotnet-onboarding]，这个例子说明了数值向量的基本操作。

var e = engine.Evaluate("x <- 3");// You can now access x defined in the R environment NumericVector x = engine.GetSymbol("x").AsNumeric(); engine.Evaluate("y <- 1:10"); NumericVector y = engine.GetSymbol("y").AsNumeric(); 
     
      
       1
       2
       3
       4
       5
       6
       7
      
     
      
       1
       2
       3
       4
       5
       6
       7

### 调用R里面的函数 ###

虽然你可以通过生成字符串并用Evaluate函数调用，并调用Evaluate方法，这可能是笨拙的，因为你传递大量数据。下面演示了如何可以调用一个函数，有点像你会如何映射在.NET中并调用一个函数。

// Invoking functions; Previously you may have needed custom function definitions
    var myFunc = engine.Evaluate("function(x, y) { expand.grid(x=x, y=y) }").AsFunction();
    var v1 = engine.CreateIntegerVector(new[] { 1, 2, 3 });
    var v2 = engine.CreateCharacterVector(new[] { "a", "b", "c" });
    var df = myFunc.Invoke(new SymbolicExpression[] { v1, v2 }).AsDataFrame();
     
      
       1
       2
       3
       4
       5
       6
      
     
      
       1
       2
       3
       4
       5
       6

R.NET1.5.10包含了许多改进，以支持直接调用函数从C＃，用更少的字符串操作，少REngine.Evaluate沟通。

// As of R.NET 1.5.10, more function call syntaxes are supported. var expandGrid = engine.Evaluate("expand.grid").AsFunction(); var d = new Dictionary<string, SymbolicExpression>(); d["x"] = v1; d["y"] = v2; df = expandGrid.Invoke(d).AsDataFrame(); 
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9

我们使用expand.grid的结果继续进行，将下面的代码说明，虽然R.NET试图模仿R的行为来对应数据集。数据集为R的[数据结构][Link 1]的核心部分，所以值得扩展，下面几个例子：

engine.SetSymbol("cases", df);
    // As of R.NET 1.5.10, factor to character expressions work consistently with R
    var letterCases = engine.Evaluate("cases[,'y']").AsCharacter().ToArray();
    // "a","a","a","b","b","b", etc. Same as as.character(cases[,'y']) in R
    // Note that this used to return  "1", "1", "1", "2", "2", etc. with R.NET 1.5.5
     
      
       1
       2
       3
       4
       5
      
     
      
       1
       2
       3
       4
       5

还有其他的方法来提取数据集的列，而不通过R表达式字符串：

// Equivalent:
    letterCases = df[1].AsCharacter().ToArray();
    letterCases = df["y"].AsCharacter().ToArray();
     
      
       1
       2
       3
      
     
      
       1
       2
       3

2维索引返回的行为通常直接反映了R.。唯一的例外是行名失踪，R的行为是值得商榷的，所以R.NET喜欢严格。

// Accessing items by two dimensional indexing
    string s = (string)df[1, 1]; // "a"
    s = (string)df[3, 1]; // "a"
    s = (string)df[3, "y"]; // "b"
    // s = (string)df["4", "y"]; // fails because there are no row names
    df[3, "y"] = "a";
    s = (string)df[3, "y"]; // "a"
    df[3, "y"] = "d";
    s = (string)df[3, "y"]; // null, because we have an <NA> string in R
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9

### 调用R脚本 ###

要重用整个脚本，最简单的方法是使用R中的“sourece”方法

engine.Evaluate("source('c:/src/path/to/myscript.r')");
     
      
       1
      
     
      
       1

### 遗漏值 ###

占位符，展示了不同各种向量类型NA值的相互交互转换情况，在后面的页面中能找到数据类型部分的详细介绍。

### 进一步的例子 ###

纵观根据项目RDotNet.Tests单元[测试][Link 2]将提供R.NET用途和编程成语的进一步信息。展示出的数据传输的速度。

### 运行时性能 ###

占位符，显示出最佳做法，以最大限度地提高运行速度

### 其他例子还记录 ###

占位符   
处理的日期和时间

### 数据类型 ###

R中的所有表达式都表示为Symbolic Expression对象在R.NET对象中。对于数据访问，下面有特殊类定义。请注意，“NA”在R特殊值值用于某些类型在这里没有直接等同于.NET中的对象，但要注意这种行为，以免风险计算不正确。

表如下。如下R.NET类构成了R和.NET框架之间的桥梁。

<table style="width:946px; border-collapse:collapse; border-spacing:0px; border:1px solid rgb(238,238,238); color:rgb(0,0,0); font-family:'microsoft yahei'; font-size:14px; line-height:26px"> 
 <tbody style=""> 
  <tr style=""> 
   <th style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> R</th> 
   <th style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> R.NET</th> 
   <th style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> .NET Framework</th> 
   <th style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> Note</th> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> character vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.CharacterVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.String[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> integer vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.IntegerVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Int32[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> The minimum value in R is -2^31+1 while that of .NET Framework is -2^31. Missing values are int.MinValue</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> real vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.NumericVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Double[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> Missing values are represented as double.NaN</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> complex vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.ComplexVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Numerics.Complex[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Numerics assembly is required for .NET Framework 4.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> raw vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.RawVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Byte[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> logical vector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.LogicalVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Boolean[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> character matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.CharacterMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.String[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> integer matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.IntegerMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Int32[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> The minimum value in R is -2^31+1 while that of .NET Framework is -2^31.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> real matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.NumericMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Double[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> complex matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.ComplexMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Numerics.Complex[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> Reference to System.Numerics assembly is required.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> raw matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.RawMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Byte[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> logical matrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.LogicalMatrix</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Boolean[, ]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> list</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.GenericVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> <span style="">From version 1.1.</span></td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> data frame</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.GenericVector</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> <span style="">From version 1.1.</span>&nbsp;RDotNet.DataFrame class is also available (below).</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> data frame</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.DataFrame</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> <span style="">From version 1.3.</span>&nbsp;And from version 1.5.3,&nbsp;<a href="http://rdotnet.codeplex.com/wikipage?title=Handling%20DataFrames&amp;referringTitle=Documentation" style="color:rgb(255,153,0); text-decoration:none" rel="nofollow">DataFrameRowAttribute and DataFrameColumnAttribute</a>&nbsp;are available for data mapping.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> function</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.Function</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> <span style="">From version 1.4.</span>&nbsp;Including closure, built-in function, and special function.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> factor</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.Factor</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> System.Int32[]</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> <span style="">From version 1.5.2.</span></td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> S4</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> RDotNet.S4Object</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> &nbsp;</td> 
   <td style="padding:8px; line-height:20px; vertical-align:top; border:1px solid rgb(238,238,238)"> Not Available Yet. See S4 branch in the source control.</td> 
  </tr> 
 </tbody> 
</table>

### demo1 ###

[http://rdotnet.codeplex.com/wikipage?title=Examples&referringTitle=Home][http_rdotnet.codeplex.com_wikipage_title_Examples_referringTitle_Home]

### demo2 ###

[http://dynamicdatadisplay.codeplex.com/][http_dynamicdatadisplay.codeplex.com]

[.NET]: http://lib.csdn.net/base/dotnet
[Linux]: http://lib.csdn.net/base/linux
[http_docs.nuget.org]: http://docs.nuget.org/
[https_github.com_jmp75_rdotnet-onboarding]: https://github.com/jmp75/rdotnet-onboarding
[Link 1]: http://lib.csdn.net/base/datastructure
[Link 2]: http://lib.csdn.net/base/softwaretest
[http_rdotnet.codeplex.com_wikipage_title_Examples_referringTitle_Home]: http://rdotnet.codeplex.com/wikipage?title=Examples&referringTitle=Home
[http_dynamicdatadisplay.codeplex.com]: http://dynamicdatadisplay.codeplex.com/