建立副本名称冲突_包的建立(一)

bb1b353ff7ce369378bb8bbb521ee19b.png

这次的内容,涉及到 R 语言包的建立。事实上,CRAN 提供的官方参考指南,并不适合快速阅读,且内容繁杂。比较适合作为后期提高的 教材。而 http://r-pkgs.had.co.nz/ 上 的教程则更适合作为 R 包编写的帮助指南。这里,仅仅讲述整个过程中需要注意的一系列的问题:

021125fffcc3e1c9c3bec58cfe83ccc7.png

目前,我个人只涉及到 Windows 系统,因此本文仅适用于 Windows 系统下,R 包的创建:Rtools 是必须具备的工具,当然这个工具也只适用于 Windows 系统。关于 Rtools 的安装并没有过多可强调的内容。需要明确的是:R 语言目前已经进入了 4.0 的时代,对应的也从 Rtools35 过渡到了 Rtools40.目前所有的配置要求必然是:  以及   旧版的 Rtools 需要在安装时勾选:Add rtools to system PATH, 但新版本并无此操作。仍然需要注意的是:必须安装在 C 盘的默认路径下,不能更改安装路径!在完成安装之后,R 语言环境下,运行代码:
> Sys.which('make')
                              make 
"C:\\rtools40\\usr\\bin\\make.exe" 
返回上述信息,才能证明 Rtools 配置已完成。需要强调的是:不能修改安装路径!且 C 盘文档下的 .Renviron 不能删除!除此之外,还需要:设置 R 的 path 环境变量,这一步已经在 《R语言环境配置》一文讲过,因此,实在没有重复的必要性。并且,这篇文章也不是针对零基础而讲的。仅仅只会涉及到重点内容以及各种易错点。只有环境变量设置成功,后续才能调用 R CMD 进行一系列的操作。至此环境配置已完成,当然,还需要准备:RStudio

acfee62f12a64b146293efcdbadfd8dd.png

R 包的建立,最佳建议方案:在 RStudio 中通过新建项目来完成。法一:File > New Project > New Directory >  R Package ,或者选择:R Package using devtools法二:
library(devtools)
create_package()
或者选择 create_package() 直接创建一个包所需要的基本内容。至于 create_package() 如何使用:RTFM基本的路径设置,绝对路径,相对文件,文件管理,如何保存到合适的位置,以及 R 语言包的建立,不能直接输入任何中文字符,这些都属于基础入门内容。不是现如今应该重复叙述的内容。从这篇文章开始,今后不会再涉及针对基础入门的帮助性文章。

需要说明的是:

1/  devtools 包必须使用,导入 devtools 的同时,会默认加载 usethis包

2/  而 roxygen2 则被 RStudio 的操作环境下使用了,并没有被显式调用。

3/  这三个包,构成了 R 包创建的整个工具支持。

整个项目文件夹下包括了:

     ---R

     ---man

     ---NAMESPACE

     ---DESCRIPTION

以及 Rproj 和 LICENSE 

这些部分是包的创建所必须的,但 Data 和 vignette文件夹并不是默认需要的,这一点需要引起重视。

9e3b3df49547a1ea9ad73c512eb90c9b.png

RStudio 界面的些许变化:只有在创建 R 包的项目文件中,Build 菜单栏才会显示与创建包相关的一系列选项!当然,除了鼠标点击执行以外,利用 代码操作,才是最直接了当的方式。

创建之前,需要把工作路径设置到创建包的路径下!

一般,第一步通常是修改:DESRITION 文件

Package: 
Title: 
Version: 
Date: 
Authors@R: 
    person(given = ,
           family = ,
           role = c("aut", "cre"),
           email = )
Author: [aut,cre]
Depends: R (>= 4.0.0)
Description: 
License: 
Imports: 
Encoding: UTF-8
LazyData: true
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.1.1

相关的内容,需要个人补齐。这一块,不再强调。

Imports 内容,涉及到编写函数时使用到的其他包。必须在 Imports 项中指出,否则建立包时,会产生报错信息。

这一块,倒没有过多需要强调的内容。

d847fdaf89291e978e1a92cb18754005.png

在编写函数之前,需要确保当前环境下,所有的变量被清空:

rm(list = ls())
所有的代码均位于 R 文件夹下,通过一个个 .R 为后缀名的脚本来记录。但目前,仍然无法支持 R 文件夹下涉及子目录,也就意味着,所有的函数都必须通过处于同一级的 R  的脚本来保存。在编写函数之前,需要明确:R 包函数分为两大类:1/   支持导出的函数2/   仅在包内使用的内部函数创建文件及删除文件:
edit_file('./R/read.R')
file.remove('R/read.R')

当然设置路径是包的主路径,而 R 是子目录,所以创建 R 脚本是必须添加上子目录名称,而不需要时,则通过 file.remove() 删除路径。

需要说明的是:file.remove() 操作的文件,将直接被清理,不会进入回收站中,因此需要谨慎对待。

R 文件夹下的脚本名并不一定等于函数名。一个脚本下可以存在多个函数均被导出。

对于导出的函数,需要添加注释内容。而 R 包的内部函数,则不需要注释内容。

所有的注释内容,以 #' 开头,或者可以选择:##’ 开头。

简单的示例:

#' @title 
#' @description 
#' @param 
#' @examples
#' @export
#' @author
scan.str  function(string){
  return(scan(text = string))
}

@ 后面的每一项内容都需要补齐,但 @author, @examples 并不是必须项。

其中,title, description, param, export 则是基础内容,需要完善,而 param 则是针对函数中参数内容的注释。

@return   用于解释函数的返回内容

@importFrom 则是至关重要的内容

例如:

#' @importFrom  utils read.table

read.txt function(text,header =  T,...) {
  return(read.table(text = text, header = header,...))
}

函数中使用到了除 base 包以外的函数,均需要通过 @importFrom 进行指明!

格式为:@importFrom pkgname funtion1 function2 function3 ...

编写完成,保存后,下面进行自动生成相关信息的操作:

> rm(list = ls())
> document()
Updating ... documentation
Loading ...
Writing NAMESPACE
Writing NAMESPACE

document() 用于生成相关的内容:完善 NAMESPACE 文件以及 man 文件夹下的 rd 文件,但在此之前,必须保证当前环境不与所创建的包中的函数相冲突。所以建议习惯性执行:rm() 操作。

---end---

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/538827.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Android 多选列表

原文&#xff1a;http://blog.csdn.net/wljun739/article/details/37655209 点击阅读原文 ----------------------------------------------------------- 1、activity_main.xml[java] view plaincopy<LinearLayout xmlns:android"http://schemas.android.com/apk/res/…

python自带的编辑器怎么换行_Python3基础 print 自带换行功能

镇场诗&#xff1a; ———大梦谁觉&#xff0c;水月中建博客。百千磨难&#xff0c;才知世事无常。 ———今持佛语&#xff0c;技术无量愿学。愿尽所学&#xff0c;铸一良心博客。 —————————————————————————————————————————— 1 …

leetcode 回文数

2019独角兽企业重金招聘Python工程师标准>>> 判断一个整数是否是回文数。回文数是指正序&#xff08;从左向右&#xff09;和倒序&#xff08;从右向左&#xff09;读都是一样的整数。 示例 1: 输入: 121 输出: true 示例 2: 输入: -121 输出: false 解释: 从左向右…

Hadoop控制输出文件命名

原文地址&#xff1a;http://blog.csdn.net/zuochanxiaoheshang/article/details/8769198 点击阅读原文 --------------------------------------------------- Hadoop 控制输出文件命名 在一般情况下&#xff0c;Hadoop 每一个 Reducer 产生一个输出文件&#xff0c;文件以 …

前端路由的两种实现原理

2019独角兽企业重金招聘Python工程师标准>>> History API 这里不细说每一个 API 的用法&#xff0c;大家可以看 MDN 的文档&#xff1a;https://developer.mozilla.org... 重点说其中的两个新增的API history.pushState 和 history.replaceState 这两个 API 都接收三…

3.JDK和JRE和JVM的区别

JDK --Java Development Kit --java 开发工具包 JRE --Java Runtime Environment --java运行时环境 JVM --Java Virtual Machine --java虚拟机 ------------- 更多的Java&#xff0c;Angular&#xff0c;Android&#xff0c;大数据&#xff0c;J2EE&#xff0c;Python…

缓存cache

由于Django是动态网站&#xff0c;所有每次请求均会去数据进行相应的操作&#xff0c;当程序访问量大时&#xff0c;耗时必然会更加明显&#xff0c;最简单解决方式是使用&#xff1a;缓存&#xff0c;缓存将一个某个views的返回值保存至内存或者memcache中&#xff0c;5分钟内…

4.JVM简述

JVM是一种规范。 就是一个虚拟的用于执行bytecodes字节码的计算机 可以用软件来实现&#xff0c;如IBM,SUN,BEA等按照这个规范实现&#xff0c;可以实现比SUN公司更好的JVM&#xff0c;我们自己也可以实现一个。 可以使用硬件来实现&#xff0c;如sun与intel公司研发java的芯…

5.JDK环境配置

下载 进入Oracle官网下载&#xff0c;点击进入 安装 一路下一步。记住安装到哪里了。 配置环境变量 JAVA_HOME 刚才的java安装目录 PATH %JAVA_HOME%\bin PATH里配置多个用英文的分号; 分隔。 *classpath&#xff0c;jdk5.0以上可以不用配置了 测试 windows下&#xf…

6.第一个程序Hello World

新建文件夹 在C盘新建个文件夹 mycode。注意不要用中文。 新建java文件 1、显示隐藏文件名。 2、右键新建文本文件 3、重命名为 Welcome.java。&#xff08;首字母必须大写。如果不显示隐藏文件名&#xff0c;会是Welcome.java.txt不是java文件&#xff09; 4、编写代码 p…

pythonstdin_python 笔试输入:sys.stdin.readline和input

①&#xff1a;输入一行数据并输 出两种方法 # 输入一行数据并输出 import sys # 方法一&#xff1a; str1 input() print(input 输入:,str1,len,len(str1)) print(循环遍历输入得到输入的每个字符的ascii码如下&#xff1a;) for i in str1: print(ord(i)) # 方法二&#xff…

8.对Hello World程序的深入

Welcome.java public class Welcome{public static void main(String[] args){System.out.println("Hello World,I am Java!");}}1、Java对大小写敏感。如果出现了大小写拼写错误&#xff0c;程序无法运行。 关键字class表明Java程序中的全部内容都包含在类中&…

python整数类型没有取值范围限制_详解Python中6种数据类型

Python中数据类型主要有六种&#xff1a;数字类型&#xff0c;字符串类型&#xff0c;元组类型&#xff0c;列表类型&#xff0c;文件类型和字典类型&#xff0c;我们今天先介绍前四种类型。 假如在Python程序中&#xff0c;出现了“010”&#xff0c;那么这个“010”到底是什么…

python爬虫的用途_python爬虫用途

广告关闭 腾讯云11.11云上盛惠 &#xff0c;精选热门产品助力上云&#xff0c;云服务器首年88元起&#xff0c;买的越多返的越多&#xff0c;最高返5000元&#xff01;专业点来说就是应用多台机器同时实现爬虫任务&#xff0c;这多台机器上的爬虫&#xff0c;就是称作分布式爬虫…

二元函数泰勒公式例题_高等数学期末总复习 DAY 5. 罗尔定理证明题 拉格朗日、柯西中值定理 泰勒公式及麦克劳林公式...

DAY 5.DAY 5.1.罗尔定理2.拉格朗日定理3.柯西中值定理4.泰勒公式及麦克劳林公式1.罗尔定理罗尔定理描述如下&#xff1a;如果 R 上的函数 f(x) 满足以下条件&#xff1a;&#xff08;1&#xff09;在闭区间 [a,b] 上连续&#xff0c;&#xff08;2&#xff09;在开区间 (a,b) 内…

android应用程序是什么,简述Android应用程序结构是什么?公共题库

试题分类&#xff1a;Android简述Android应用程序结构是什么?解析:Android应用程序结构是&#xff1a;LinuxKernel(Linux内核)、Libraries(系统运行库或者是c/c核心库)、ApplicationFramework(开发框架包)、Applications(核心应用程序)以下这些控件可以放置按钮&#xff1f;答…

《程序设计与数据结构》第八周学习总结

学号 20172326 《程序设计与数据结构》第八周学习总结 教材学习内容总结 后绑定在程序执行时执行多态性可由继承与接口实现排序有选择法排序与插入法排序搜索分为线性搜索与二分搜索算法&#xff0c;同一类型的不同方法可能解决同一问题&#xff0c;但是&#xff0c;效率与难以…

python获取文件名不含后缀名_大部分Python资料都没有说到的重点-用实战教你解决问题的思路...

前言最近有些刚入门Python的小伙伴问我&#xff0c;他已经学会了大部分语法&#xff0c;基本的列表&#xff0c;元组也会使用&#xff0c;但是在实际中需要做一点小需求的时候&#xff0c;仍然不知所措。解决问题重要的并非是如何写代码&#xff0c;而是如何分析和拆解问题&…

12.JAVA基本数据类型

Java是一种强类型语言&#xff0c;每个变量都必须声明类型。 String 不是java的基本数据类型&#xff01;&#xff01;&#xff01; 除了8种基本数据类型之外&#xff0c;其他的都是引用类型。 引用类型的初始值是null byte&#xff0c;short&#xff0c;int类型的默认值为0 …

opencv android jni,OpenCV - AndroidStudio的JNI工程及引用OpenCV

一把利刃&#xff0c;用不好&#xff0c;会伤到你遍体鳞伤。用得好&#xff0c;便为你披荆斩棘&#xff0c;所向披靡。好与不好之间&#xff0c;便是历练。几经波折&#xff0c;终于跌跌撞撞,集成了OpenCV,并实现了灰度图片&#xff0c;自此一扇新的大门已经打开。至此我手中已…